Product | Command Type |
---|---|
ClearCase | cleartool subcommand |
ClearCase LT | cleartool subcommand |
Attache | command |
MultiSite | multitool subcommand |
Platform |
---|
UNIX |
Windows |
ClearCase, Attache, and MultiSite only-Describe objects in graphical format:
ClearCase LT on Windows only-Describe objects in graphical format:
Describe objects:
The describe command lists information about VOBs and the objects they contain. For example:
Attributes and/or version labels attached to a particular version
Hyperlinks attached to a particular object
Predecessor version of a particular version
Views that have checkouts.
Views that have unshared derived objects in a particular VOB (describe -long vob:) (ClearCase and Attache dynamic views only)
Family feature level of a VOB or the replica feature level of a MultiSite VOB replica. This information is of interest only to MultiSite users.
describe produces several kinds of listings:
File-system data - Provides information on elements, branches, versions, derived objects, and VOB symbolic links.
The description of an element (for example, describe hello.h@@) includes a listing of the storage pools to which the element is currently assigned. (See mkpool and chpool for more information.)
A version's description includes the version-ID of its predecessor version.
An ordinary derived object is listed with derived object
in its header. A derived object that has been checked in as a version of an element (DO version) is listed with derived object version
in its header.
Type object - Provides information on a VOB's type objects (for example, on a specified list of label types). This form of the command displays the same information as lstype -long.
Hyperlink object - Provides information on a hyperlink object.
Storage pool - Provides information on a VOB's source, derived object, and cleartext storage pools. This form of the command displays the same information as lspool -
long.
VOB object - Provides information on the object that represents the VOB itself. This includes such information as its storage area, creation date, owner, and related views.
VOB replica - Provides information on the object that represents a VOB replica, including the replica's master replica, host, mastership request setting, feature level, and TCP connectivity to the current replica. For more information on replicas, see the Administrator's Guide.
UCM objects - Provides information on UCM objects: activities, baselines, components, folders, projects, and streams. This form of the command displays information similar to that displayed by the UCM commands lsactivity -long, lsbl -long, lscomp -long, lsfolder -long, lsproject -long, and lsstream -long.
For an MVFS object, describe lists the object's protections. For information on access control, see the Administrator's Guide and the reference pages for protect and protectvob.
File-system objects can be hyperlinked to objects in another VOB. If the other VOB is currently unavailable (perhaps it has been unmounted), describe tries to be helpful:
cleartool: Error: Unable to locate versioned object base with object id:
"51023fa9.68b711cc.b358.08:00:69:02:1d:c7".
.
.
.
Hyperlinks:
@183@/usr/proj /usr/proj/elem2.c@@/main/2 -> <object not available>
The description of a version can include the annotation [version has no data]
. A file element version can be created without data, using checkin -cr; an existing version's data can be removed with rmver -data.
By default, a version inherits a hyperlink attached to any of its ancestor versions, on the same branch or on a parent branch. Inherited hyperlinks are listed only if you use the -ihlink option.
A hyperlink stops being passed down to its descendents if it is superseded by another hyperlink of the same type, explicitly attached to some descendent version. You can use a null-ended hyperlink (from-object, but no to-object ) as the superseding hyperlink to effectively cancel hyperlink inheritance.
NOTE: Derived objects may be present only in ClearCase and Attache dynamic views.
describe maintains a cache of tags of inaccessible views. For each view-tag, describe records the time of the first unsuccessful contact. Before trying to access a view, describe checks the cache. If the view's tag is not listed in the cache, describe tries to contact the view. If the view's tag is listed in the cache, describe compares the time elapsed since the last attempt with the time-out period specified by the CCASE_DNVW_RETRY environment variable. If the elapsed time is greater than the time-out period, describe removes the view-tag from the cache and tries to contact the view again.
The default timeout period is 60 minutes. To specify a different time-out period, set CCASE_DNVW_RETRY to another integer value (representing minutes). To disable the cache, set CCASE_DNVW_RETRY to 0.
The describe command shows additional information for objects in MultiSite replicated VOBs:
For objects that have mastership, describe shows the master replica of the object.
NOTE: If the object is a local instance of a global type and you do not specify -local, describe shows the master replica of the global type.
For attribute types, hyperlink types, and label types, describe shows the instance mastership of the type (whether the type's mastership can be shared by multiple replicas).
For branches and branch types, describe shows the mastership request setting of the object. This setting controls whether users at other sites can request mastership of the object.
For more information about replicated VOBs, see the Administrator's Guide.
DESCRIBING OBJECTS GRAPHICALLY. Default: Describes objects in nongraphical form.
DESCRIBING LOCAL COPIES OF GLOBAL TYPES. Default: describe displays information about the global type object for the specified object-selector.
REPORT FORMAT. Default: Lists the object's name and some additional information.
DESCRIBING OBJECTS IN OTHER VIEWS. Default: If you use a view-extended pathname to specify an object in (or as seen through) another view, describe lists that view's name for the object:
version: "M:\gamma\vob1\project\src\util.c"
EXCERPTING DESCRIPTION INFORMATION. Default: describe lists the predecessor (if the object is a version), and reports on all of the object's version labels, attributes, and hyperlinks. With one or more of the following options, the report includes the extended pathname of the object and the requested information only-for example, only a listing of the predecessor version and version label.
SPECIFYING THE OBJECTS TO BE DESCRIBED. Default: describe expects at least one argument that names an element, branch, version, VOB link, derived object, or hyperlink (pname, DO-name, or hlink-selector). You can use -version or -ancestor to control the way pname arguments are interpreted.
| |
| |
|
vob-selector | [vob:]pname-in-vob | |
pname-in-vob can be the pathname of the VOB-tag (whether or not the VOB is mounted) or of any file-system object within the VOB (if the VOB is mounted). It cannot be the pathname of the VOB storage directory. | ||
attribute-type-selector | attype:type-name[@vob-selector] | |
branch-type-selector | brtype:type-name[@vob-selector] | |
element-type-selector | eltype:type-name[@vob-selector] | |
hyperlink-type-selector | hltype:type-name[@vob-selector] | |
label-type-selector | lbtype:type-name[@vob-selector] | |
trigger-type-selector | trtype:type-name[@vob-selector] | |
pool-selector | pool:pool-name[@vob-selector] | |
hlink-selector | hlink:hlink-id[@vob-selector] | |
oid-obj-selector | oid:object-oid[@vob-selector] | |
The following object selectors are valid only if you use MultiSite: | ||
replica-selector | replica:replica-name[@vob-selector] | |
replica-uuid-selector | oid:replica-oid@replicauuid:replica-oid NOTE: The replica you specify must be located at your current site. | |
The following object selectors are valid only if you use UCM: | ||
activity-selector | activity:activity-name[@vob-selector] | |
baseline-selector | baseline:baseline-name[@vob-selector] | |
component-selector | component:component-name[@vob-selector] | |
folder-selector | folder:folder-name[@vob-selector] | |
project-selector | project:project-name[@vob-selector] | |
stream-selector | stream:stream-name[@vob-selector] |
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. In Attache, cmd-context represents the workspace 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.
Describe the version of element msg.c selected by your view.
cmd-context describe msg.c
version "msg.c@@/main/3"
created 08-Dec-98.12:12:55 by Chuck Jackson (test user) (cj.dvt@oxygen)
Element Protection:
User : sgd : r--
Group: user : r--
Other: : r--
element type: c_source
predecessor version: /main/2
Labels:
REL6
REL1
Describe a branch of an element, specifying it with an extended pathname.
cmd-context describe util.c@@\main\rel2_bugfix
branch "util.c@@\main\rel2_bugfix"
created 08-Dec-98.12:15:40 by Bev Jackson (test user) (bev.dvt@oxygen)
branch type: rel2_bugfix
Element Protection:
User : sgd : r--
Group: user : r--
Other: : r--
element type: text_file
branched from version: \main\31
Describe the label type REL3.
cmd-context describe lbtype:REL3
label type "REL3"
created 08-Dec-98.12:13:36 by Bev Jackson (test user) (bev.dvt@oxygen)
owner: bev
group: dvt
scope: this VOB (ordinary type)
constraint: one version per branch
Create a Tested attribute type and apply the attribute to the version of element util.c selected by your current view. Then, use describe to display the newly applied attribute value, and use the -fmt option to format the output.
cmd-context mkattype -nc -default '"TRUE"' Tested
cmd-context mkattr -default Tested util.c
cmd-context describe -aattr -all -fmt "Name: %Xn\nType of object: %m\n" util.c
Name: util.c@@/main/CHECKEDOUT
Type of object: version
Attributes:
Tested = "TRUE"
Describe ddft, the current VOB's default derived object storage pool.
cmd-context describe pool:ddft
pool "ddft"
created 15-Dec-98.09:34:00 by jenny.adm@oxygen
"Predefined pool used to store derived objects."
owner: jenny
group: dvt
kind: derived pool
pool storage global pathname "\\oxygen\users\vb_store\tut\tut.vbs\d\ddft"
maximum size: 0 reclaim size: 0 age: 96
Describe how the current view names an element that is named hello.mod in the jackson_fix view.
cmd-context describe -cview /view/jackson_fix/usr/hw/src/hello.mod
version "/usr/hw/src/hello.c@@/main/4"
created 08-Dec-98.12:16:29 by Chuck Jackson (test user) (cj.dvt@oxygen)
Element Protection:
User : sgd : r--
Group: user : r--
Other: : r--
element type: text_file
predecessor version: /main/3
Describe the VOB containing the current working directory. List views with checkouts or unshared derived objects in that VOB.
cmd-context describe -long vob:.
versioned object base "\hw"
created 15-Dec-98.09:34:00 by jenny.adm@oxygen
"VOB dedicated to development of "hello, world" program"
VOB family feature level: 2
VOB storage host:pathname "oxygen:c:\users\vb_store\tut\tut.vbs"
VOB storage global pathname "\\oxygen\users\vb_store\tut\tut.vbs"
VOB ownership:
owner jackson
group dvt
VOB holds objects from the following views:
oxygen:\vb_store\tut\old.vws [uuid
249356fe.d50f11cb.a3fd.00:01:56:01:0a:4f]
Describe a hyperlink.
cmd-context describe hlink:Merge@516262@/vobs/proj
hyperlink "Merge@516262@/vobs/proj"
created 14-Jul-98.16:43:35 by Bill Bo (bill.user@uranus)
Merge@516262@/vobs/proj /vobs/proj/lib/cvt/cvt_cmd.c@@/main/v1.1_port/8
->
/vobs/proj/lib/cvt/cvt_cmd.c@@/main/71
Describe a derived object in the current view.
cmd-context describe -cview util.o
derived object "util.o@@11-Apr.12:03.33"
created 11-Apr-98.12:03:33 by Anne Duvo (anne.dev@oxygen)
references: 2 (shared)
derived pool: ddft
=> saturn:/usr/anne/views/anne_main.vws
=> oxygen:/usr/jackson/views/jackson_proj2.vws
Describe a derived object in the current working directory.
cmd-context describe util.obj
derived object "util.o@@11-Apr.12:03.33"
created 11-Apr-98.12:03:33 by Anne Duvo (anne.dev@oxygen)
references: 2 (shared)
derived pool: ddft
=> saturn:\users\anne\views\anne_main.vws
=> oxygen:\users\jackson\views\jackson_proj2.vws
For a particular element, list its name, element type, attached triggers, and cleartext and source pools.
cmd-context describe -fmt ^
"%n\n\t%[type]p\n\t%[triggers]p\n\t%[pool]Cp,%[pool]p\n" file.txt@@
file.txt@@
text_file
(CI_TRIG, CO_TRIG)
cdft,sdft
For a branch type in a replicated VOB, list the master replica of the branch type.
cmd-context describe -fmt "%n\t%[master]p\n" brtype:main
main lex@/vobs/dev
For the current VOB, list the OID, replication status, MS-DOS text mode setting, and creation comment.
cmd-context describe -fmt "%On\n%[vob_replication]p\n%[msdostext_mode]p\n%c" ^
vob:.
46cf5bfd.240d11d3.a37e.00:01:80:7b:09:69
unreplicated
disabled
storage of header files
Describe the local copy of global label type REL6.
cmd-context describe -local lbtype:REL6
label type "REL6"
created 28-Jul-99.14:00:26 by Suzanne Gets (smg.user@neon)
"Automatically created label type from global definition in VOB
"/vobs/admin"."
owner: smg
group: user
scope: this VOB (local copy of global type)
constraint: one version per element
Hyperlinks:
GlobalDefinition -> lbtype:REL6@/vobs/admin
Describe the current VOB, its hyperlinks being of particular interest.
cmd-context describe -long vob:.
versioned object base "/vobs/doc"
created 07-Nov-91.16:46:28 by ratl.user
"ClearCase documentation VOB."
VOB family feature level: 1
VOB storage host:pathname "mercury:\usr3\vobstorage\doc_vob"
VOB storage global pathname "\\mercury\usr3\vobstorage\doc_vob"
VOB ownership:
owner 4294967294
group user
Hyperlinks:
AdminVOB -> vob:\vobs\admin
This VOB has a hyperlink named AdminVOB; it points from the current VOB to the VOB vob:\vobs\admin. If it were pointing to the current VOB, the listing would show
Hyperlinks:
AdminVOB <- vob:\vobs\admin
Now describe the hyperlink AdminVOB.
cmd-context describe hltype:AdminVOB
hyperlink type "AdminVOB"
created 07-Nov-91.16:46:28 by ratl.user
"Predefined hyperlink type used to link a VOB to another VOB with
administrative information."
owner: 4294967294
group: user
scope: this VOB (ordinary type)
List the name, master replica, and host of a replica by specifing its OID. (Note that the oid: object-selector must be entered on a single line.)
cmd-context describe -fmt "%n\n%[master]p\n%[replica_host]p\n" \
oid:87f6265f.72d911d4.a5cd.00:01:80:c0:4b:e7@replicauuid:87f6265f.72d911d4.a5cd.00:01:8
0:c0:4b:e7
boston_hub
boston_hub@/vobs/dev
minuteman
chflevel, chpool, fmt_ccase, lsactivity, lsbl, lscomp, lsdo, lshistory, lspool, lsproject, lsstream, lstype, merge, mkpool, protect, protectvob, rmview, version_selector
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |