Table of Contents
wrename - rename files and directories
wrename [-FMnOqUVX]
[-o/Path] [-sDate] [-NWorkspaceName] [-hHost -SSnapshot [-DDir]] source dest
wrename [ options ] source... directory
wrename changes the name
of source to dest, or moves source(s) into directory. Operations occur both
in the snapshot and the workspace.
Mapping is consistent
across all workspace commands. See wco(1)
for details.
Default
options can be set on most workspace commands. See wco(1)
for details.
The workspace mapping is automatically looked up in the user's workspace
mapping table for the given files. Override this by specifying an explicit
workspace:
- -NworkspaceName
- Use the named workspace mapping.
Or override
with a temporary workspace mapping with these three options:
- -hHost
- Use
the SnapshotCM server on Host for a workspace mapping.
- -SSnapshotPath
- Use
SnapshotPath for a workspace mapping.
- -DWorkspaceDirectory
- The local destination
directory for a workspace mapping. This can be a relative or absolute path.
If this option is not provided with the other two, the local destination
directory defaults to the current directory where the command is executed.
For more information on workspace mappings, see wmap(1)
.
- -F
- Force
the operation. This allows rename to overwrite locally modified files.
- -M
- Print workspace mapping before normal output.
- -n
- Show the operations that
would happen, but do not execute them.
- -o/Path
- Map /Path in the selected
snapshot to the specified (-D) local directory, creating a temporary, partial
workspace mapping for the command. Normally, the root directory of a snapshot
is what is mapped.
- -O
- Map full archive path parameters to the current directory.
Normally, full archive path parameters are mapped to their usual locations
within the workspace. This option creates a temporary, partial workspace
mapping for each full archive path parameter such that the snapshot directory
of the parameter is mapped to the current directory. This behavior is designed
to be consistent with SoftCM, a logical predecessor of SnapshotCM. See also
the -o option which allows use of relative path parameters.
- -q
- Quiet, do not
print normal output.
- -sDate
- Set the modification date for the new revision.
Date silently will be forced to be greater than any existing revision of
file. Useful primarily for importing history from other CM systems. See
wco(1)
for supported date formats.
- -U
- Allow renaming recoverable files and
directories. This can be useful for recovering a file from a deleted directory
without first recovering the containing directory. First rename the file
into an active directory and then recover it.
- -V
- Print internal version and
exit.
- -X
- Display 'full archive path' names.
Exit status is 0 if
all specified names were successfully renamed, 1 if any failures, and >1
if there was a bad option or a network error.
wci(1)
, wco(1)
, wdiff(1)
,
whist(1)
, wls(1)
, wmap(1)
, wmerge(1)
, wremove(1)
, wset(1)
, wupdate(1)
.
Table of Contents