Table of Contents
wmap - create or modify a workspace-to-snapshot mapping.
wmap
add [-Nname -hHost -SSnapshot -DDir] [-P/mountPath -s/SnapshotDir] [-w{concurrent|locking}]
[-i{unix|win|mac}] [-{E|I|a} path] ... [-fnqV]
wmap addmount -Nname -hHost -SSnapshot -P/mountPath] [-s/snapshotDir] [-w{concurrent|locking}]
[-i{unix|win|mac}] [-{E|I|a} path] ...
wmap find [-DDir]
wmap list [-Nname] [-hHost] [-SSnapshot] [-DDir]
wmap remove {-Nname | -DDir}
wmap removemount -Nname -P/mountPath
wmap update -Nname [-DDir] [-hHost] [-SSnapshot] [-{a|r|x} path] [-w{concurrent|locking}]
[-i{unix|win|mac}] [-{E|I|a} path] ...
wmap update -DDir [-Nname] [-hHost] [-SSnapshot] [-{a|r|x} path] [-w{concurrent|locking}]
[-i{unix|win|mac}] [-{E|I|a} path] ...
wmap updatemount -Nname -P/mountPath [-hHost -SSnapshot] [-s/snapshotDir] [-w{concurrent|locking}]
[-i{unix|win|mac}] [-{E|I|a} path] ...
wmap validate [-Nname] [-hHost] [-SSnapshot] [-DDir]
wmap editserver oldName newName
A workspace is where a user
interacts with versions of files stored in the SnapshotCM repository. A
workspace consists of a local directory hierarchy, plus some mapping information
that associates (or maps) one or more snapshots into the workspace.
wmap
creates and manipulates the user's workspace mapping information. A workspace
mapping specifies the local directory for a workspace, which snapshots
to mount, where in the workspace to mount them, and any mount options.
A workspace must have at least one mounted snapshot. Snapshots can be mounted
anywhere in a workspace, including on the root directory of the worskpace,
or within another snapshot mount hierarchy. In this case, the more specific
mount hides the containing mount.
- add
- Add a new workspace mapping.
Omitted but required values will be prompted for interactively.
- addmount
- Add an additional mount to a workspace. 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.
- removemount
- Remove the selected mount definition from the workspace.
- update
- Update the
selected workspace mapping with new information. The first name or directory
option selects the workspace mapping to modify.
- updatemount
- Update the selected
mount definition with new information.
- 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/workspace/path (deprecated)
- Add /workspace/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/workspace/path
- Exclude the /workspace/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/workspace/path
- Include the /workspace/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.
- -M/mountPath
- Specify workspace directory on which
to mount the snapshot. The path is a full path name from the workspace root
directory. The default is "/" (snapshot maps to whole workspace).
- -n
- Show
the operations that would happen, but do not execute them.
- -NworkspaceName
- Set the name of a workspace mapping.
- -s/snapshotDirPath
- Specify which portion
of the snapshot to mount. Default is to mount "/" (the whole snapshot).
- -SSnapshotPath
- Set the full path of the snapshot to map.
- -q
- Quiet, do not display normal
output messages.
- -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/workspace/path
- Remove /workspace/path
from the working set.
Earlier versions of SnapshotCM only supported
mapping one full snapshot to a full workspace. This version allows multiple
snapshots to be mounted. For this to work, each snapshot must be mounted
in a different location. Use the -P/mountPath option to specify where to
mount
This version also allows part of a snapshot, specified with the
-s option, to be mounted.
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 -hHost -S/Proj/Rev1 -D/work/Rev1 -P/ -s/ -I/
To update the working
set to exclude the /doc hierarchy, run:
wmap addmount -Nwork -hHost -S/Proj/Rev2
-P/mountDir -s/
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.wmap - 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