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.
Mapping is consistent across all workspace commands.
See wco(1)
for details.
Default options can be set on most
workspace commands. See wco(1)
for details.
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:
- -NworkspaceName
- Use the named workspace mapping.
Or override with a temporary
workspace mapping with these three 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.
For more information
on workspace mappings, see wmap(1)
.
- -a[+|-]
- 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.
- -A
- Change the active revision referenced by the snapshot to
the revision specified by the -r option.
- -b
- Break the lock on a file which
is held by another user.
- -B
- 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.)
- -CComment
- Set the check in
comment to this string. The current revision comment is modified unless
an explicit revision is specified (see -r).
- -d
- 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.
- -E
- Operate only on existing local files
and directories.
- -f
- 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.
- -I
- Operate only on locally modified files.
- -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.
- -l
- Add a strict lock to the file and make the local file writable.
- -L
- Operate
only on locally locked files.
- -mMode
- Set file mode access permissions on
the archived file.
- Mode=
- numeric-mode(0444).
- Mode =
- symbolic-mode(u+x,a=r).
- -M
- Print workspace mapping before normal output.
- -n
- No execute mode. Show
the operations that would happen, but do not really 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 attribute setting operations being done.
- -rRevision
- Specify a revision number for use by other options.
- -R
- Recursively
traverse all subdirectories and perform the requested operations on all
files and directories in each subdirectory.
- -sDate
- 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.
- -tLockCmt
- 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.
- -T
- 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.)
- -u
- Unlock the current file and, if no modifications were done to the local
file, set the local file mode to read-only.
- -U
- Recover (undelete) name.
- -V
- Print
internal version and exit.
- -W
- Make the current local file writable.
- -X
- Display
'full archive path' names.
- -yBreak_comment
- 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 .
wci(1)
, wco(1)
, wdiff(1)
, whist(1)
,
wls(1)
, wmap(1)
, wmerge(1)
, wremove(1)
, wrename(1)
, wupdate(1)
.
Table of Contents