ClearCase (cleartool subcommand), MultiSite (multitool subcommand), Attache (command)
The describe command lists information about VOBs and the objects they contain. For example:
describe produces several kinds of listings:
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.
-
long.
For an MVFS object, describe expands the output to include the object's access mode. (An access mode defines read, write, and execute privileges for the three user categories: owner, group, and others.) For more information on access control, see Administering ClearCase.
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.
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.
For more information, see CACHING UNAVAILABLE VIEWS in the clearmake reference page.
The describe command shows additional information for objects in replicated VOBs:
NOTE: If the object is a local instance of a global type and you do not specify -local, describe shows the mastering replica of the global type.
For more information about replicated VOBs, see ClearCase MultiSite Manual.
Permissions Checking: No special permissions required. Locks: No locks apply.
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: "/view/gamma/usr/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.
-predecessor | Only the version-ID of the predecessor version is listed. |
-alabel | Only the version labels are listed. |
-aattr | Only the attribute values are listed. |
-ahlink | The listing includes the pathnames of the objects hyperlinked to pname, annotated with " For example: |
-> /usr/proj/include/db.h@@/main/52 | |
Inherited hyperlinks are not included in this listing. | |
-ihlink | The listing includes the hyperlinks inherited by pname, which must specify a version. Pathnames of the from-object and to- object are listed, one of which is an ancestor of pname, or is pname itself. (That is, -ihlink also includes hyperlinks that are attached to pname itself.) |
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.
| |
| |
|
foo.c | (version of foo.c selected by current view) |
foo.o | (derived object foo.o built in or winked in to current view) |
/view/gamma/usr/proj/src/foo.c | (version of foo.c selected by another view; however, the current view must select some version of foo.c) |
/view/gamma/usr/proj/src/foo.o | (derived object foo.o built in another view) |
foo.c@@/main/5 | (version 5 on main branch of foo.c) |
foo.o@@11-Nov.09:19.219 | (derived object, specified by DO-ID) |
foo.c@@/REL3 | (version of foo.c with version label REL3; however, the view must select some version of foo.c) |
foo.c@@ | (the element foo.c) |
foo.c@@/main | (the main branch of element foo.c) |
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 selector is valid only if you use MultiSite: | ||
replica-selector | replica:replica-name[@vob-selector] | |
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] | |
These examples are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.
In cleartool single-command mode, cmd-context represents the shell prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.
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
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
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
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"
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 "/net/oxygen/usr/vobstore/tut/tut.vbs/d/ddft"
maximum size: 0 reclaim size: 0 age: 96
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
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:/usr/vobstore/tut/tut.vbs"
VOB storage global pathname "/usr/vobstore/tut/tut.vbs"
VOB ownership:
owner jackson
group dvt
VOB holds objects from the following views:
oxygen:/usr/vobstore/tut/old.vws [uuid 249356fe.d50f11cb.a3fd.00:01:56:01:0a:4f]
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
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
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
cmd-context describe -fmt "%n\t%[master]p\n" brtype:main
main lex@/vobs/dev
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
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
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 "/net/mercury/usr3/vobstorage/doc_vob"
VOB storage host:pathname mercury:\usr3\vobstorage\doc_vob
VOB storage global pathname \\mercury\usr3\vobstorage\doc_vob
VOB ownership:
owner ratl
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: ratl
group: user
scope: this VOB (ordinary type)
chflevel, chpool, fmt_ccase, lsactivity, lsbl, lscomp, lsdo, lshistory, lspool, lsproject, lsstream, lstype, merge, mkpool, rmview, version_selector
Feedback
on the documentation in this site? We welcome any comments!
Copyright © 1999 by Rational Software Corporation. All rights reserved. |