Table of Contents
wupdate - apply snapshot changes to workspace
wupdate [-fMnOqvVX]
[-jpatternList] [-o/Path] [-NWorkspaceName] [-hHost -SSnapshot [-DDir] [-E/path|-I/path]
...]
wupdate applies snapshot changes from a SnapshotCM snapshot
into a workspace. Unlike wco, wupdate applies all types of changes. In
addition to creating new files and updating file content and mode (which
wco(1)
also does), wupdate applies renames and deletes to the files and
directories in the workspace. After wupdate completes, the workspace directory
structure will match the snapshot directory structure, and all files will
be updated.
For large projects, a snapshot typically contains more files
than most users care to have in their workspace. For this reason, wupdate
restricts its work to a working set. A working set specifies which files
and directories within the workspace/snapshot that wupdate should update.
A working set is defined as part of the workspace definition (see wmap(1)
).
Default options can be set on most workspace commands.
See wco(1)
for details.
wupdate needs to know which mapping
to use. Normally, the user's workspace mapping table is searched for the
current directory. Override this by specifying an explicit workspace:
- -NworkspaceName
- Use the named workspace mapping.
Or override with a temporary workspace
mapping with these 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.
- -E/archive/path
- Exclude the /archive/path
hierarchy from the working set. See also the -I option. The longest path takes
precedence.
- -I/archive/path
- Include the /archive/path hierarchy in the working
set. See also the -E option. The longest path takes precedence.
- -r/archive/path (same
as -I, deprecated)
- -a/archive/path (deprecated)
- Add /archive/path to the working
set.
For more information on workspace mappings, see wmap(1)
.
- -f
- Force the operation. This allows wupdate to overwrite locally writable files.
It also forces a file content compare to verify that the content is up-to-date.
- -jpatternList
- Process only files whose base name matches patternList.
PatternList
consists of one or more patterns separated by a '|' (pipe/or) symbol. Each
pattern is a shell wild card pattern as follows:
* - match 0 or more characters
? - match any one character
[set] - match any character in set
Individual patterns ending in a slash
('/') match directories only. Individual patterns not ending in a slash match
only files.
If the list begins with an '!' (exclamation/bang) character, the
list selects items not matching any patterns.
- -M
- Print workspace mapping
before normal output.
- -n
- No Execute mode. 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 mode.
Do not display status text showing the check out operations being done.
- -v
- Display file revisions.
- -V
- Print internal version and exit.
- -X
- Display 'full
archive path' names.
Exit status is 0 if all changes were successfully
applied, 1 if a change could not be applied, 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)
, wrename(1)
, wset(1)
.
Table of Contents