ClearCase Reference Manual, Release 4.0, Windows

lsreplica

Lists VOB replicas

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command), MultiSite (multitool subcommand)

SYNOPSIS

lsrep·lica [ -l·ong | -s·hort | -fmt format ]: [ -sib·lings
| [ -sib·lings ] -invob vob-selector
| replica-selector ...
]

DESCRIPTION

The lsreplica command lists the VOB replicas in a VOB family. lsreplica lists information on all VOB-replica objects recorded in the VOB database of the local replica (except for deleted replicas, known as ghost replicas). Other replicas may exist, but the packets containing their creation information have not yet been imported at the local replica.

To create a VOB replica, use the mkreplica command.

RESTRICTIONS

Mastership Checking: None.

Permissions Checking: No special permissions are required.

Locks: No locks apply.

OPTIONS AND ARGUMENTS

LISTING FORMAT. Default: Includes creation event information for each replica.

-l·ong: Includes each replica's creation information, mastering replica, mastership request setting, ownership information, and host. If the local replica is in the process of restoration, this option annotates the listings of other replicas from which restoration updates are required. (See the restorereplica reference page.)

-s·hort: Lists only replica names.

-fmt format: Lists information using the specified format string. (See fmt_ccase.)

-sib·lings: Lists the VOB family members of the local replica, but does not list the local replica itself. This option is useful when you are writing scripts that process only remote replicas.

SPECIFYING THE VOB FAMILY. Default: Lists VOB family members of the replica containing the current working directory.

-invob vob-selector: Lists the replicas of the specified VOB family. Specify vob-selector in the form [vob:]pname-in-vob

pname-in-vob

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)

SPECIFYING THE REPLICA. Default: Lists all known replicas of the VOB family.

replica-selector ...: Restricts the listing to one or more replicas. Specify replica-selector in the form [replica:]replica-name[@vob-selector]

replica-name

Name of the replica

vob-selector

VOB family of the replica; can be omitted if the current working directory is within the VOB.

Specify vob-selector in the form [vob:]pname-in-vob

pname-in-vob

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)

EXAMPLES

Examples including 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 command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

List the names of all replicas of the VOB containing the current working directory.

multitool lsreplica -short evanston osaka paris

List the names of all siblings of the VOB containing the current working directory.

multitool lsreplica -short -siblings osaka paris

List all replicas of the VOB whose VOB-tag is \gvob_ech.

cmd-context lsreplica -invob \gvob_ech

`For VOB replica "\gvob_ech":`
`11-Mar.13:42`	`david`	`replica "original"`
`11-Mar.13:45`	`david`	`replica "second_rep"`

List the name, mastering replica, and replica host of all replicas in the VOB family \dev.

cmd-context lsreplica -fmt ^ "Name: %n\n\tMastering replica: %[master]p\n\tReplica host: %[replica_host]p\n" ^ -invob \dev Name: lex Mastering replica: lex@\dev Replica host: minuteman Name: cup Mastering replica: lex@\dev Replica host: surfer