remove
remove user sessions or deactivate AccuRev objects
Usage
accurev remove group <group-name>
accurev remove ref <reftree>
accurev remove sessions <user-name>
accurev remove stream <stream>
accurev remove user <principal-name>
Description
The remove command hides a reference tree, stream, user, or group. It does not remove the object from the depot — that would violate AccuRev’s TimeSafe property. It omits the object from show command listings — but the show -fi command does display such “invisible” objects.
Many operations on “removed” objects are disabled. For example, you cannot work in a removed workspace or update a removed reference tree, and you cannot perform work as a removed user. But you can promote versions to a removed stream.
If you make a mistake creating an object, you may want to remove it. But since this command does not actually delete the object from the depot, you cannot create a new object with the same name.
Use the reactivate command to undo the removal of an object.
Removing User Sessions
The special command form remove sessions terminates all login sessions for the named user. Unlike other items which can be removed with the accurev remove command, once the login sessions are removed, they cannot be reactivated. The user whose sessions have been removed can log in again as needed, as long as they are otherwise allowed to by the system. This command activates the server_admin_trig trigger, which can be used to place restrictions on who can execute it.
Note: In a replicated environment, you must run the accurev remove sessions command from the AccuRev master, even if the user you whose session you want to end logged in to a replica server.
Deactivating a User’s Workspace
Use the rmws command to deactivate (hide) one of your workspaces. To deactivate another user’s workspace, use the rmws -s command.
Examples
Hide stream gizmo:
> accurev remove stream gizmo
Deactivate user tom:
> accurev remove user tom