Table of Contents
wupdate - apply snapshot changes to workspace
wupdate [-CfMnOqvVX]
[-jpatternList] [-o/Path] [-NWorkspaceName] [-hHost -SSnapshot [-DDir] [-E/path|-I/path]
...]
wupdate applies changes to a workspace so that it reflects
the contents of the given snapshot. 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, and
optionally cleans unversioned files from the workspace (-C option). After
wupdate completes, the versioned workspace files will match the snapshot.
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)
.
- -C
- Clean the workspace by removing all unversioned and non-working set files
and directories in addition to doing the normal update actions on the remaining
items. The -f option is implied.
Use of this option fully and exactly synchronizes
the workspace contents to the mapped snapshots. The resulting workspace
contents are what would result from running wupdate on an empty workspace,
though using -C on a populated workspace is typically much faster and more
efficient.
This option is useful for improving automated build performance.
Exercise caution when running interactively as it will remove all unversioned
and modified files from a workspace in seconds!
- -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.
- -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