Table of Contents
wremove - remove files and empty directories.
wremove [-AdfFLMnOqRUVX]
[-jpatternList] [-o/Path] [-O[R1]-[R2]|Date] [-sDate] [-NWorkspaceName] [-hHost
-SSnapshot [-DDir]] name ...
wremove removes the indicated names
from both the snapshot and workspace, and records the delete in the item's
history. The delete can then be copied to other snapshots, just as with
any other change to a file or directory.
A name can be removed without recording
the delete in the item's history. See the discussion under the -U option for
when you might want to use this option.
Individual revisions can also be
removed. See the -O option description below.
Note: a file is not fully deleted
from the archive until all snapshot references to it are removed. Prior
to the last remove, and for some time after, a file can be recovered. See
also the -U option to wset(1)
.
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
- Only
remove names from the snapshot. Normally, workspace names are also removed.
(Also see -L option.)
- -d
- Operate only on directories, skip any files. Combine
with -R to remove all empty directories.
- -f
- Operate only on files, don't try
to remove directories.
- -F
- Force the operation. This allows you to delete locally
modified files, and unlink files and delete revisions without being prompted
for confirmation.
- -jpatternList
- Remove 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.
- -L
- Only remove names from the
local workspace.
- -M
- Print workspace mapping before normal output.
- -n
- 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 [R1]-[R2]|Date
- Remove inactive
revisions in the specified range. A revision is considered inactive if it
is not referenced by a snapshot, not a merge or branch point, and not the
newest revision.
One may specify a revision range or a cutoff date. For a
revision range, the inclusive range of revisions is removed. If R1 is omitted,
it defaults to the first revision. If R2 is omitted, it defaults to the
last revision. The dash character is required for a range, else the arg
is parsed as a date string, and revisions older than the date are removed.
R1 and R2 can be revision numbers, or full snapshot paths, in which case
the revision referenced by that snapshot is used.
If one or more active
revisions are selected for removal, they will be silently skipped: only
the inactive revisions will be removed. This allows removing all inactive
revisions older than a given date without having to worry about which are
active.
Once a revision is removed, it cannot be recovered.
- -q
- Quiet, do not
print normal output.
- -R
- Operate recursively on all files and directories
in the hierarchy.
- -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.
- -U
- Unlink name. Unlink removes name so that it
is as if name never existed in snapshot. Unlinked names cannot be recovered,
and the unlink is not added to the item's history. Use unlink to undo an
inadvertent copy of a name into a snapshot. To cleanly split a snapshot,
first make a snapshot copy, then unlink the extra files in each copy. Use
the normal remove, not unlink, when you want the removal change to be promoted
or copied to other snapshots and workspaces.
- -V
- Print internal version and
exit.
- -X
- Display 'full archive path' names.
Exit status is 0 if
all specified names were successfully removed, 1 if any failures, and >1
if there was a bad option or a network error.
To remove all *.dsp
files from your snapshot and workspace, run:
wremove -j*.dsp -R .
wci(1)
,
wco(1)
, wdiff(1)
, whist(1)
, wls(1)
, wmap(1)
, wmerge(1)
, wrename(1)
, wset(1)
,
wupdate(1)
.
Table of Contents