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, @@.)

Figure 1: Extended path name of a derived object

extended pathname

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.