Table of Contents
wmap - create or modify a workspace-to-snapshot mapping.
wmap
add [-Nname -hHost -SSnapshot -DDir] [-{a|r|x} path] [-i{unix|win|mac}] [-w{concurrent|locking}]
[-fnqV]
wmap find [-DDir]
wmap list [-Nname] [-hHost] [-SSnapshot] [-DDir]
wmap remove {-Nname | -DDir}
wmap update -Nname [-DDir] [-hHost] [-SSnapshot] [-{a|r|x} path] [-i{unix|win|mac}]
[-w{concurrent|locking}]
wmap update -DDir [-Nname] [-hHost] [-SSnapshot] [-{a|r|x} path] [-i{unix|win|mac}]
[-w{concurrent|locking}]
wmap validate [-Nname] [-hHost] [-SSnapshot] [-DDir]
wmap editserver oldName newName
wmap manipulates workspace
mappings in the user's workspace mapping table. Each workspace mapping defines
the root directory for a workspace, the server and snapshot to map onto
a workspace, the working set for the workspace, and any workspace options.
A workspace mapping associates the directory and file hierarchy of a snapshot
with a corresponding directory hierarchy (or workspace) on a local file
system. The specified local directory maps to the root directory of a snapshot,
and every other snapshot file or directory path maps to the corresponding
location within the workspace hierarchy. In other words, everything is mapped.
- add
- Add a new workspace mapping. Omitted but required values will
be prompted for interactively.
- find
- Find and print a workspace mapping for
a directory. The current directory is used if none is specified.
- list
- List
all selected workspace entries. If no selection filters are specified, all
entries are selected.
- remove
- Remove the selected workspace mapping. Entries
may be uniquely selected by name or by workspace directory.
- update
- Update
the selected workspace mapping with new information. The first name or directory
option selects the workspace mapping to modify.
- validate
- Verify the existence
of the host and snapshot referenced in the selected workspace entries. Update
any correctable information. If no selection filters are specified, all
entries are selected.
- editserver old new
- Edit all mappings to update the
SnapshotCM server name. The new server name will be the canonical name of
the new server, not necessarily the string passed in. This option is designed
to edit workspace mappings following a move of a SnapshotCM server to another
machine.
- -a/archive/path (deprecated)
- Add /archive/path to the working
set, mark non-recursive.
- -DWorkspaceDirectory
- Set the local directory path
to the root of the workspace. This can be a relative or absolute path.
- -E/archive/path
- Exclude the /archive/path hierarchy from the working set. See also the -I
option. The longest path takes precedence.
- -f
- Force the operation even if
it can not be validated. Changes will normally fail if they can not be validated.
- -i{unix|win|mac}
- Set the end-of-line format for writing 'text' (I/O mode) files
in the workspace. Use to override the platform default for situations where
the SnapshotCM workspace is to be accessed from a system type different
than the SnapshotCM execution platform. SnapshotCM supports 3 end-of-line
substitutions:
unix format character: '\n'
win format characters: '\r\n'
mac format character: '\r'
- -I/archive/path
- Include the /archive/path hierarchy
in the working set. See also the -E option. The longest path takes precedence.
- -hHost
- Set the SnapshotCM server containing the snapshot to map. Host can
be a name or IP address.
- -n
- Show the operations that would happen, but do
not execute them.
- -NworkspaceName
- Set the name of a workspace mapping.
- -SSnapshotPath
- Set the full path of the snapshot to map.
- -q
- Quiet, do not display normal
output messages.
- -r/archive/path (deprecated, same as -I)
- Include the /archive/path
hierarchy in the working set.
- -V
- Print internal version and exit.
- -w{concurrent|locking}
- Set the workspace type. In a concurrent workspace, files are normally left
writable and no version control lock is needed to make a change. In a locking
workspace, files are normally read-only, and made writable when a version
control lock is set. The locking workspace type helps coordinate changes
with others using the same snapshot. The concurrent workspace type is great
for workspaces attached to private snapshots, and also works better with
tools not integrated with SnapshotCM.
- -x/archive/path
- Remove /archive/path
from the working set.
Exit status is 0 if the operation succeeds,
1 if it fails, and >1 if there was a bad option or a network error.
To
create a new workspace mapping (named work) of snapshot /Proj/Rev1 on Host
to the directory /work/Rev1, and add all files to the working set, run:
wmap add -Nwork -S/Proj/Rev1 -hHost -D/work/Rev1 -I/
To update the working set
to exclude the /doc hierarchy, run:
wmap update -N work -E/doc
To rename
the workspace mapping to Rev1Work, run:
wmap update -D/work/Rev1 -NRev1Work
$HOME/.SnapshotCM.wmap - user mapping table (unix).
%USERPROFILE%\Application Data\SnapshotCM.wmapbP - user mapping table (windows).
$SNAPSHOTCM_WMAP - environment variable to override above.
wci(1)
,
wco(1)
, wdiff(1)
, whist(1)
, wls(1)
, wmerge(1)
, wremove(1)
, wrename(1)
,
wset(1)
, wupdate(1)
.
Table of Contents