Content-type: text/html Manpage of wupdate

wupdate

Section: User Commands (1)
Updated: SnapshotCM
Index Return to Main Contents
 

NAME

wupdate - apply snapshot changes to workspace

 

SYNOPSIS

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

 

DESCRIPTION

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

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

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

 

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

 

Index

NAME
SYNOPSIS
DESCRIPTION
Default Options
Workspace Options
Options
DIAGNOSTICS
SEE ALSO
This document was created by man2html, using the manual pages.
Time: 22:22:37 GMT, March 22, 2010