rmattr
Removes an attribute from an
object
SYNOPSIS
- rmattr [ –c·omment comment | –cfi·le comment-file-pname | –cq·uery
- | –cqe·ach | –nc·omment ]
{ [ –ver·sion version-selector ]
[ –pna·me ] attribute-type-selector pname ...
| attribute-type-selector object-selector ...
}
DESCRIPTION
The rmattr command removes
one or more attributes from VOB-database objects. Attributes can be attached
to objects by the mkattr command and by
triggers (mktrtype –mkattr).
See the mkattr reference page for a list
of objects to which attributes can be attached.
rmattr deletes an instance
of an attribute type object. To delete the attribute type object itself or
to delete the type object and all its instances, use the rmtype command.
RESTRICTIONS
Identities
You must have one
of the following identities:
- Element
owner
- Element
group member
- Object
owner
- Object
group member
- 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
An error occurs if one
or more of these objects are locked: VOB, element type, element, branch type,
branch, object type, object, attribute type.
Mastership
(Replicated VOBs
only) If the attribute's type is unshared, your current replica must master
the attribute type. If the attribute's type is shared, your current replica
must master the object whose attribute you are removing.
OPTIONS AND ARGUMENTS
Event Records and Comments
- Default
- Creates one or more event records, with commenting
controlled by your .clearcase_profile file (default: –nc).
See the comments reference page. Comments
can be edited with chevent.
- –c·omment comment | –cfi·le comment-file-pname |–cq·uery | –cqe·ach | –nc·omment
- Overrides the default with the option you
specify. See the comments reference page.
Specifying the Attribute to Be Removed
- Default
- None.
- attribute-type-selector
- An existing attribute type. Specify attribute-type-selector in
the form [attype:]type-name[@vob-selector]
Specifying an Object
- Default
- None.
- pname ...
- One or more pathnames, indicating file system
objects from which attributes are to be removed. If you don't use the –version option:
- A
standard or view-extended pathname to an element specifies the version in
the view.
- A
VOB-extended pathname specifies an element, branch, or version—independent
of view.
See the mkattr reference
page for examples of pname arguments.
- –pna·me
- Indicates that pname is
a pathname. You must use this option if pname has
the form of an object selector.
- –ver·sion version-selector
- Specifies the version from which the attribute
is to be removed. See the version_selector reference
page for syntax details.
- object-selector ...
- One or more names of non-file-system objects
from which attributes are to be removed. Specify object-selector in
one of the following forms:
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.
- Remove
the Confidence_Level attribute from the version of msg.c in
the view.
- Remove
the attribute TESTED from the most recent version
of hello.h on the main branch
that has the attribute value "FALSE".
- Remove
the Responsible attribute from the main branch
of hello.c.
- Remove
the Author attribute from a hyperlink of type DesignDoc.