rmvob

Removes a VOB storage directory

APPLICABILITY

ProductCommand type
ClearCasecleartool subcommand
ClearCase LTcleartool subcommand

Platform
UNIX
Windows

SYNOPSIS

rmvob [ –f·orce ] vob-storage-dir-pname ...

DESCRIPTION

The rmvob command deletes one or more VOB storage directories. Confirmation for each VOB is required, unless you use the –force option. In addition to removing the VOB storage directory, rmvob removes all relevant entries from the network's VOB registry. However, rmvob does not unmount the VOBs.

Caution: Be sure that the current working directory is not within the VOB storage area that you are deleting.

Note: If you mistakenly remove a VOB storage area with operating system commands, you must unregister the VOB with the rmtag and unregister commands.

Procedures for Removing VOBs

To remove a nonreplicated VOB, follow the procedure in the Administrator's Guide. To remove a replicated VOB, follow the procedure in the Administrator's Guide for Rational ClearCase MultiSite. rmvob fails if the VOB replica masters any objects, unless you specify the –force option.

RESTRICTIONS

Identities

You must have one of the following identities:

  • VOB owner
  • root (UNIX)
  • Member of the ClearCase administrators group (ClearCase on Windows)
  • Local administrator of the ClearCase LT server host (ClearCase LT on Windows)

Locks

No locks apply.

Mastership

(Replicated VOBs only) No mastership restrictions.

OPTIONS AND ARGUMENTS

–f·orce
Suppresses the confirmation step. If the VOB is replicated, this option allows rmvob to remove the VOB storage directory even if the replica masters any objects.

vob-storage-dir-pname ...
The pathnames of one or more VOB storage directories to be removed.

EXAMPLES

The UNIX examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.

The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the UNIX shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.

Note: In the UNIX examples that follow, arguments and output that show multicomponent VOB tags are not applicable to ClearCase LT, which recognizes only single-component VOB tags. In this manual, a multicomponent VOB tag is by convention a two-component VOB tag of the form /vobs/vob-tag-leaf—for example, /vobs/src. A single-component VOB tag consists of a leaf only—for example, /src. In all other respects, the examples are valid for ClearCase LT.

  • On a UNIX system, unmount and delete the VOB storage area /usr/vobstore/project.vbs mounted on /vobs/project.

cmd-context  umount /vobs/project
cmd-context  rmvob /usr/vobstore/project.vbs 
Remove versioned object base "/usr/vobstore/project.vbs"? [no] yes 
Removed versioned object base "/usr/vobstore/project.vbs".

  • On a Windows system, unmount and delete the VOB storage area c:\users\vbstore\project.vbs mounted on \project.

    cmd-context  umount \project
    cmd-context  rmvob c:\users\vbstore\project.vbs 
    Remove versioned object base "c:\users\vbstore\project.vbs"? [no] yes
    Removed versioned object base "c:\users\vbstore\project.vbs". 

SEE ALSO

mkvob, rmtag, umount, unregister



Copyright© 2003 Rational Software. All Rights Reserved.