Content-type: text/html
Manpage of wrename
wrename
Section: User Commands (1)
Updated: SnapshotCM
Index
Return to Main Contents
NAME
wrename - rename files and directories
SYNOPSIS
wrename
[-FMnOqUVX]
[-o/Path]
[-sDate]
[-NWorkspaceName]
[-hHost -SSnapshot [-DDir]]
source dest
wrename [ options ] source... directory
DESCRIPTION
wrename changes the name of source to dest, or
moves source(s) into directory.
Operations occur both in the snapshot and the workspace.
Workspace Mapping
Mapping is consistent across all workspace commands.
See wco(1) for details.
Default Options
Default options can be set on most workspace commands.
See wco(1) for details.
Workspace Options
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).
Options
- -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.
DIAGNOSTICS
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.
SEE ALSO
wci(1), wco(1), wdiff(1), whist(1), wls(1), wmap(1),
wmerge(1), wremove(1), wset(1), wupdate(1).
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- Workspace Mapping
-
- Default Options
-
- Workspace Options
-
- Options
-
- DIAGNOSTICS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 22:22:36 GMT, March 22, 2010