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
- List
only files whose name (or path) matches patternList. PatternList consists
of one or more patterns separated by a '|' (pipe/or) symbol. Each pattern can
contain shell wild cards as follows:
* - match 0 or more characters
? - match any one character
[set] - match any character in set
[!set] - match any character not in set
A pattern not ending in a slash ('/') matches only files. A pattern ending
in a slash matches only directories. A pattern containing a slash other
than at the end is matched against the full workspace path. Otherwise pattern
is matched against the last component of the path. If patternList begins
with an '!' (exclamation/bang) character, the normal selection is negated.
- -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