Lists objects mastered by a replica
lsmaster [ –kind object-selector-kind [ ,... ] ] [ –fmt format-string ] [ –view view-tag ]
[ –inr·eplicas { –all | replica-name [ ,... ] } ] master-replica-selector ...
This command lists objects mastered by a replica. By default, the command uses only the information known to your current replica. If you list objects mastered by a sibling replica, changes that have not been imported at your current replica are not included in the output. For example, a label type is added at replica sanfran_hub, but replica boston_hub has not imported the update packet containing the change. If you enter the command multitool lsmaster sanfran_hub at the boston_hub replica, the output does not include the new type.
To retrieve information from a sibling replica, use –inreplicas. This form of the command contacts the sibling replicas and works only between sites that have IP connections. If lsmaster cannot contact a replica, it prints an error and tries to contact the next replica you specified.
If you have a view context, lsmaster uses the view to resolve object identifiers (OIDs) of file system objects to the names of the objects. If you do not have a view context, lsmaster prints OIDs for file system objects. You can specify a view context with the –view option.
When you specify –inreplicas, lsmaster prints OIDs for objects whose creation operations have not yet been imported at your current replica.
None.
Default
lsmaster lists all objects mastered by the replica.
–kind object-selector-kind[,...]
Limits the listing to the specified object kinds. The list of object kinds must be comma-separated, with no spaces. object-selector-kind can have the following values:
Values for ClearCase:
attype
|
hlink
|
branch
|
hltype
|
brtype
|
lbtype
|
delem (directory element)
|
slink
|
eltype
|
vob
|
felem (file element)
|
|
Values for ClearCase UCM:
activity
baseline
component
folder
project
stream
Values for MultiSite:
replica
Default
For file system objects, the master replica, object kind, and OID of each object are listed. For example:
master replica: boston_hub@/vobs/dev file element:oid:40e022a3.241d11ca ...
For non-file system objects, the master replica, object kind, and name of each object are listed. For example:
master replica: boston_hub@/vobs/dev brtype:main
–fmt format-string
Lists information using the specified format string. For details about using this option, see the fmt_ccase reference page .
Default
The command uses your current view context.
–view view-tag
Specifies a view.
Default
The command uses the information in your current replica.
–inr·eplicas { –all | replica-name[,...] }
With –all, retrieves information from all replicas in the VOB family (except deleted replicas). Otherwise, retrieves information from the sibling replicas you specify. The list of replicas must be comma-separated, with no spaces.
Default
No default; you must specify a replica.
master-replica-selector ...
Lists objects mastered by the specified replica. Specify master-replica-selector in the form [replica:]replica-name[@vob-selector]
In these examples, the lines are broken for readability. You must enter each command on a single physical line.
multitool lsmaster –view v4.1 –fmt "%m:%n\n" sanfran_hub@/vobs/dev directory element:/vobs/dev.@@ ... file element:/vobs/dev/lib/file.c@@ ... symbolic link:/vobs/dev/doc ... hyperlink:Merge@2@/vobs/dev ...
cleartool lsmaster –fmt "%m:%n\n" –kind lbtype boston_hub@\doc label type:LATEST label type:CHECKEDOUT label type:BACKSTOP label type:REL1 ...
cleartool lsmaster –kind eltype,lbtype,brtype sanfran_hub master replica: sanfran_hub@\dev "element type" file_system_object master replica: sanfran_hub@\dev "element type" file master replica: sanfran_hub@\dev "element type" directory ... master replica: sanfran_hub@\dev "branch type" sanfran_main master replica: sanfran_hub@\dev "branch type" v1.0_bugfix ... master replica: sanfran_hub@\dev "label type" LATEST master replica: sanfran_hub@\dev "label type" SANFRAN_V2.0 master replica: sanfran_hub@\dev "label type" V1.0_BUGFIX master replica: sanfran_hub@\dev "label type" TOKYO_BASE master replica: sanfran_hub@\dev "label type" SYDNEY_BASE ...
multitool lsmaster –inreplicas boston_hub –fmt "%n\t%c\n" –kind eltype boston_hub@/vobs/dev In replica "boston_hub" binary_delta_file Predefined element type used to represent a file in binary delta format. ...
multitool lsmaster –inreplicas –all sanfran_hub@/vobs/dev In replica "boston_hub" master replica: sanfran_hub@/vobs/dev "versioned object base" /vobs/dev master replica: sanfran_hub@/vobs/dev "directory element" (oid:40e0000b.241d23ca.b3df.08:00:69:02:05:33) master replica: sanfran_hub@/vobs/dev "directory element" (oid:40e0000b.241d23ca.b3df.08:00:69:02:05:33) ...
Use a view context:
multitool lsmaster –view v4.1 –inreplicas –all sanfran_hub@/vobs/dev In replica "boston_hub" master replica: sanfran_hub@/vobs/dev "versioned object base" /vobs/dev master replica: sanfran_hub@/vobs/dev "directory element" /view/v4.1/vobs/dev/.@@ master replica: sanfran_hub@/vobs/dev "directory element" /view/v4.1/vobs/dev/lib@@ ...
multitool lsmaster –view v4.1 –inreplicas sanfran_hub boston_hub@\doc
multitool lsmaster –inreplicas boston_hub –kind project,baseline,stream boston_hub@/vobs/projects In replica "boston_hub" master replica: boston_hub@/vobs/projects "project" V4.5.BL3 master replica: boston_hub@/vobs/projects "project" doc_localize master replica: boston_hub@/vobs/projects "stream" 4.5.bl2_int master replica: boston_hub@/vobs/projects "project" V4.5.BL2 master replica: boston_hub@/vobs/projects "stream" 4.5.bl2 master replica: boston_hub@/vobs/projects "stream" stream000317.160434 master replica: boston_hub@/vobs/projects "stream" stream000317.173156 master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.12820 master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.12890 master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.17408 master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.17695 master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.19614 ...
chmaster, describe, reqmaster
Introduction to MultiSite and Managing Mastership