lsreplica


Lists VOB replicas

Applicability

Product
Command type
ClearCase
cleartool subcommand
MultiSite
multitool subcommand

Platform
UNIX
Windows

Synopsis

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

Description

This command lists information about all VOB-replica objects recorded in the VOB database of the current replica (except for deleted replicas). Other replicas may exist, but the packets that contain their creation information have not yet been imported at the current replica.

Restrictions

None.

Options and Arguments

Listing Format

Default
Includes creation event information for each replica.

–l·ong
Lists each replica’s creation information, master replica, mastership request setting, ownership information, and host. If the current 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. For details about using this report-writing facility, see the fmt_ccase reference page in the Command Reference.

–sib·lings
Lists the family members of the current replica, but does not list the current replica itself. Use this option in scripts that process only sibling replicas.

Specifying the VOB Family

Default
Lists family members of the replica containing the current working directory.

–invob vob-selector
Lists the replicas in the specified 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 in the 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

In these examples, the lines are broken for readability. You must enter each command on a single physical line.

See Also

mkreplica