Table of Contents

Name

wupdate - apply snapshot changes to workspace

Synopsis

wupdate [-CfMnOqvVX] [-jpatternList] [-o/Path] [-NWorkspaceName] [-hHost -SSnapshot [-DDir] [-E/path|-I/path] ...]

Description

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

Default options can be set on most workspace commands. See wco(1) for details.

Workspace Options

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) .

Options

-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.

Diagnostics

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.

See Also

wci(1) , wco(1) , wdiff(1) , whist(1) , wls(1) , wmap(1) , wmerge(1) , wremove(1) , wrename(1) , wset(1) .


Table of Contents