SGI Techpubs Library

IRIX 5.3  »  Man Pages
find in page

ct+rmbranch(1A)

 NAME

     ct+rmbranch - remove a branch from the version tree of an element

 SYNOPSIS

     rmbranch [ -f/orce ] [ ] pname ...

 DESCRIPTION

     This command destroys information irretrievably.  Using it carelessly may
     compromise your organization's ability to support old releases.        );

     rmbranch deletes one or more branches from their elements.  For each
     branch, this entails:

     * removal from the entire branch structure from the VOB database:  branch
       object and version objects

     * removal of all meta-data items (labels, attributes, hyperlinks, and
       triggers) that were attached to the deleted objects

     * removal of all event records for the deleted objects

     * (file elements only) removal of the data container(s) that hold the
       deleted versions' file system data

       NOTE: If all of an element's versions are stored in a single data
       container, the deleted versions are removed logically, not physically.

     A 'destroy sub-branch' event record is created for the parent branch of
     the deleted branch.

     Restrictions:  You cannot delete a branch that is checked out.  You can-
     not delete an element's main branch.

 PERMISSIONS AND LOCKS

     Permissions Checking -- For each argument, this command succeeds only if
     you are one of the following: branch creator, element owner, VOB owner,
     or root user.

     Locks -- Even if you have permission to execute this command, it fails if
     any of the following objects have been locked: VOB, element type, ele-
     ment, branch type, branch, pool (non-directory elements only).

     See section "Permissions Checking on cleartool Commands" in the
     cleartool(1A) manual page.

 OPTIONS AND ARGUMENTS

     rmbranch prompts for confirmation before deleting anything.

     -f/orce
          Suppresses the confirmation step.

     -c comment  ,  -cq  ,  -cqe  ,  -nc   (mutually exclusive)
          Specifies a comment to be part of the event record(s) created by
          this command.  You can list the comment with the '' command.

          -c specifies a comment to be included in the event record for each
          argument.  The comment string must be a single token; typically,
          this means enclosing it in quotes.

          -cq prompts for a comment to be included in the event record for
          each argument.  The comment string can span several lines; end it by
          typing an EOF character (typically, <Ctrl-D>), or by entering a line
          that consists of a single period (.) character.

          -cqe prompts for a separate comment for each argument's event
          record.  Each comment string can span several lines; end it by typ-
          ing an EOF character (typically, <Ctrl-D>), or by entering a line
          that consists of a single period (.) character.

          -nc (default) means "no new comment".  cleartool uses the default
          comment, if any.  None.

     pname ...
          One or more VOB-extended pathnames, indicating the branch(es) to be
          deleted. Examples:

          foo.c@@/main/bugfix
          /vobs/proj/include/proj.h@@/main/temp_482

 EXAMPLES

     _________________________________________________________________________
     Delete the maintenance branch of element util.c.

     % cleartool rmbranch util.c@@/main/maintenance

     Branch "util.c@@/main/maintenance" has 0 sub-branches, 2 sub-versions
     Remove branch, all its sub-branches and sub-versions?  [no] 51101 10 ct+rmbranch.1
     Removed branch "util.c@@/main/maintenance".

     _________________________________________________________________________
     Verify, with the lsvtree command, that element msg.c has a patch2 branch.
     Then, delete that branch without prompting for confirmation.

     % cleartool lsvtree -branch /main/patch2 msg.c

     msg.c@@/main/patch2
     msg.c@@/main/patch2/1

     % cleartool rmbranch -force msg.c@@/main/patch2
     Removed branch "msg.c@@/main/patch2".

 SEE ALSO

     cleartool subcommands:
                                                                               );
     lsvtree, mkbranch, mkbrtype, rmver profile_ccase




home/search | what's new | help