Table of Contents


wset - set attributes on SnapshotCM archive files.


wset [-ABdEfIlLMnOqRTuUVWX] [-a+|-a-] [-b [-yBreak_comment]] [-CComment] [-jpatternList] [-kkv|-kk|-kv|-ko] [-mMode] [-o/Path] [-rRevision] [-sDate] [-tLockComment] [-NWorkspaceName] [-hHost -SSnapshot [-DDir]] name ...


wset performs miscellaneous utility functions. Use wset to change the mode, I/O type and keyword expansion attributes on files and directories, set and remove locks, change the active revision in a snapshot, update comments on existing revisions, and break other users' locks.

Workspace Mapping

Mapping is consistent across all workspace commands. See wco(1) for details.

Default Options

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

Workspace Options

The workspace mapping is automatically looked up in the user's workspace mapping table for the given files. Override this by specifying an explicit workspace:
Use the named workspace mapping.

Or override with a temporary workspace mapping with these three options:

Use the SnapshotCM server on Host for a workspace mapping.
Use SnapshotPath for a workspace mapping.
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.

For more information on workspace mappings, see wmap(1) .


Add (+) names to or remove (-) names from the list of pending imports. Pending imports are non-checked in items which are marked for import and have a status showing that a check in is needed.
Change the active revision referenced by the snapshot to the revision specified by the -r option.
Break the lock on a file which is held by another user.
Set the I/O mode to 'binary'. This becomes the default I/O mode which will be used for all future check in and check out operations on the file. (Also, see -T option.)
Set the check in comment to this string. The current revision comment is modified unless an explicit revision is specified (see -r).
If file is a directory, operate on it only, not the files within it. Combine with -R to operate on all directories in a hierarchy, but not any files.
Operate only on existing local files and directories.
Operate on files only.
-kkv, -kk, -kv, -ko
Set the default value of file keyword expansion mode. This is the default keyword expansion mode which will be used for future check out operations on the file. See wco(1) for more information.
Operate only on locally modified files.
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.

Add a strict lock to the file and make the local file writable.
Operate only on locally locked files.
Set file mode access permissions on the archived file.
Mode =
Print workspace mapping before normal output.
No execute mode. Show the operations that would happen, but do not really execute them.
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.
Quiet mode. Do not display status text showing the attribute setting operations being done.
Specify a revision number for use by other options.
Recursively traverse all subdirectories and perform the requested operations on all files and directories in each subdirectory.
Set the modification date for the new revision. Date silently will be forced to be greater than any existing revision of file. Useful primarily for importing history from other CM systems. See wco(1) for supported date formats.
Specifies a new lock's comment and avoids lock comment prompting when combined with -l or when set in the default options file. Otherwise, changes the comment on an existing lock to LockCmt.
Set the default value of file I/O mode to 'text'. This is the default I/O mode which will be used for all future check in and check out operations on the file contents. (Also, see -B option.)
Unlock the current file and, if no modifications were done to the local file, set the local file mode to read-only.
Recover (undelete) name.
Print internal version and exit.
Make the current local file writable.
Display 'full archive path' names.
Specify the break-lock comment.


Exit status is 0 if all specified files attributes were successfully set, 1 if a file's attribute could not be set, and >1 if there was a bad option or a network error.


To change the selected snapshot to reference revision 23 of file, run:

wset -A -r23 file

To lock all *.mak files in a hierarchy, run:

wset -l -R -j*.mak .

See Also

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

Table of Contents