lsreplica

Lists VOB replicas

Applicability


Product	Command type
VersionVault	cleartool subcommand
MultiSite	multitool subcommand


Platform
UNIX
Linux
Windows

Synopsis

lsrep/lica [ –l/ong | –s/hort | –fmt format ]: [ –sib/lings | [ –sib/lings ] –invob vob-selector| [ –inr/eplicas { –all | replica-name [ ,... ] }] 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.
–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`	Path name 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.

–inr/eplicas { –all | replica-name[,...] }

With –all, lists information about VOB-replica objects recorded in the VOB database of all replicas known to the current replica. Otherwise, lists information about VOB-replica objects recorded in the VOB database of the specified replicas. The list of replicas must be comma-separated, with no spaces.

replica-selector ...

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

`replica-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`	Path name 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.

List the names of all replicas of the VOB containing the current working directory.
multitool lsreplica –short
bangalore boston_hub buenosaires sanfran_hub
List the names of all siblings of the VOB containing the current working directory.
multitool lsreplica –short –siblings
bangalore buenosaires sanfran_hub
Display a long listing of the current VOB's replicas.
multitool lsreplica –long
replica "bangalore" 2007-08-15T15:48:39 by Susan Goechs (susan.user@minuteman) replica type: unfiltered master replica: boston_hub@/vobs/dev request for mastership:enabled owner: susan group: user host: "ramohalli" replica "boston_hub" 2007-05-19T15:47:13 by Susan Goechs (susan.user@minuteman) replica type: unfiltered master replica: boston_hub@/vobs/dev request for mastership:enabled owner: susan group: user host: "minuteman" replica "buenosaires" 2007-08-15T15:48:44 by Susan Goechs (susan.user@minuteman) replica type: unfiltered master replica: boston_hub@/vobs/dev request for mastership:enabled owner: susan group: user host: "mardelplata" replica "sanfran_hub" 2007-05-19T15:49:46 by Susan Goechs (susan.user@minuteman) replica type: unfiltered master replica: sanfran_hub@/vobs/dev request for mastership:enabled owner: susan group: user host: "goldengate"
List all replicas of the VOB whose VOB tag is \doc.
multitool lsreplica –invob \doc
For VOB replica “\doc�?: —03-11T13:42 jcole replica "boston_hub" —03-11T13:45 jcole replica "sanfran_hub" —03-11T13:48 jcole replica "tokyo"
List the name, master replica, and replica host of all replicas in the family /vobs/doc.
cmd-context lsreplica –fmt "Name: %n\n\tMaster replica: %[master]p\n\tReplica host: %[replica_host]p\n" -invob /vobs/doc
Name: boston_hub Master replica: boston@/vobs/doc Replica host: minuteman Name: sanfran_hub Master replica: sanfran_hub@/vobs/doc Replica host: goldengate Name: tokyo Master replica: sanfran_hub@/vobs/doc Replica host: shinjuku