Table of 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.
-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) .


Table of Contents