Derived object naming
Learn how to name a derived object (DO).
No name collisions occur among derived objects built at the same path name, because each DO is cataloged in the VOB database with a unique identifier, its DO ID. The DO ID references a DO independently of views. The lsdo command can list all DOs created at a specified path name, regardless of which views (if any) can select them:
% cleartool lsdo hello.o
07-May.16:09 akp "hello.o@@07-May.16:09.623" on neptune
06-May.12:47 akp "hello.o@@06-May.12:47.539" on neptune
01-May.21:49 akp "hello.o@@01-May.21:49.282" on neptune
03-Apr.21:40 akp "hello.o@@01-May.21:40.226" on neptune
Together, the standard name (hello.o
) of a DO and its DO ID
(07-May.16:09.623
) constitute a VOB-extended path name to that
particular derived object (see the following figure). (The extended naming symbol is
host specific; most organizations use the default value, @@
.)
Standard software must access a DO through a dynamic view, using a standard path name or view-extended path name. You can use such names with debuggers, profilers, rm, tar, and so on. Only HCL VersionVault programs can reference a DO using a VOB-extended path name, and only the metadata of a DO is accessible in this way. You can use a view-extended path name with the winkin command, to make the file system data of any DO available to your view. For more information, see Winking in a DO manually.
The following example describes a DO with an extended path name
(hello@@07-Mar.11:40.217
) and its configuration record:
% cleartool describe hello@@07-Mar.11:40.217
created 07-Mar-06.11:40.217 by Allison K. Pak (akp.users@phobos)
references: 1 => cobalt:/usr1/tmp/akp/tut/old.vws
% cleartool catcr hello@@07-Mar.11:40.217
Target hello built by akp.user
Host "cobalt" running SunOS 5.10 (sun4u)
Reference Time 07-Mar-06.11:40:41, this audit started
07-Mar-06.11:40:46
View was cobalt:/var/tmp/akp/tut/old.vws
Initial working directory was /vobs/akp_cobalt_hw/src
----------------------------
MVFS objects:
----------------------------
/vobs/akp_cobalt_hw/src/hello@@07-Mar.11:40.217
/vobs/akp_cobalt_hw/src/hello.o@@07-Mar.11:40.213
/vobs/akp_cobalt_hw/src/util.o@@07-Mar.11:40.215
----------------------------
Variables and Options:
----------------------------
MKTUT_CC=cc
----------------------------
Build Script:
----------------------------
cc -o hello hello.o util.o
----------------------------
% ls hello.@@07-Mar.11:40.217
Cannot access hello@@07-Mar.11:40.217: No such file or directory.