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

See Also

reactivate, rmws, show