lsvob

Lists VOB registry entries

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

• (ClearCase only) List VOBs using the graphical VOB browser:

  lsvob -g·raphical [ -reg·ion network-region ]

• List VOBs in the command window:

  lsvob [ -s·hort | -l·ong ] [ -hos·t hostname ] [ -reg·ion network-region ]

  
  

  [ vob-tag ... | -sto·rage vob-storage-dir-pname ... | -uui·d vob-uuid ]

DESCRIPTION

The lsvob command lists one or more VOBs. To be accessible to cleartool subcommands and Attache commands, including lsvob, a VOB must be registered. That is, it must have an entry in the vob_object file on the registry server host. In addition, each VOB typically has one or more entries in the vob_tag registry file; you cannot mount, or even create, a VOB without assigning a tag to it. (See the mkvob reference page; the registry_ccase reference page describes the ClearCase registry files in detail.)

Default Output

By default, lsvob lists all VOBs registered for the current network region, whether or not they are mounted (active). The default output line for each listed VOB looks like this:

*   \src1     \\sunfield\c\vbstore\src1_vob private

The four output fields report:

• Whether the VOB is mounted (*)
• The VOB-tag
• The VOB storage directory pathname
• Whether the VOB is public or private (see the mkvob reference page)

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

OPTIONS AND ARGUMENTS

LISTING FORMAT.  Default: See the Default Output section.

-l·ong

Expands the listing to include all information stored in the VOB registry regarding the listed VOBs. (See the registry_ccase reference page.)

-s·hort

Restricts the listing to VOB-tags only.

(CLEARCASE ONLY) LISTING THE VOBS GRAPHICALLY. Default: Lists the VOBs in the command window.

-g·raphical

Starts the VOB Browser to list the VOBs.

SPECIFYING THE VOBS.  Default: Lists all VOBs registered for the local network region, both mounted and unmounted, public and private.

-hos·t hostname

Confines the listing to VOBs whose storage directories reside on host hostname.

-reg·ion network-region

Confines the VOB listing to include only the VOBs registered for one or more network regions. (The mkvob and mktag commands have a -region option, which can be used to assign VOB-tags to specific network regions.) Unless you use the -graphical option, the network-region argument can include pattern-matching characters as described in the ClearCase wildcards_ccase reference page and the Attache wildcards reference page. Single-quote the network-region argument, if it includes pattern-matching characters.

vob-tag ...

Specifies one or more VOBs to be listed. A VOB must be registered, but it need not be mounted, to be listed with lsvob. The vob-tag argument can include pattern-matching characters as described in wildcards_ccase or wildcards. Enclose in single quotes any vob-tag argument that includes pattern-matching characters.

-sto·rage vob-storage-dir-pname ...

One or more VOBs, identified by full pathnames to their storage directories.

-uui·d vob-uuid

A VOB to be listed, identified by its universal unique identifier (UUID).

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 VOBs registered for the local network region.

cmd-context lsvob

*   \demo     \\neptune\vbstore\demo_vob public
*   \src1     \\sunfield\users\vbstore\src1_vob public
*   \design   \\luna\vbstore\design_vob public
    \doc      \\sunfield\users\vbstore\doc_vob public
*   \stage    \\pluto\vbstore\stage_vob public
    \bugvob   \\luna\users\anne\vbstore\bug_vob private

• List, using the long display format, the registry information for the VOB with VOB-tag \vob12. The output line Active: YES indicates that the VOB is currently mounted.

cmd-context lsvob -long \vob12

Tag: \vob12
Global path: \\sol\vbstore\vob12.vbs
Server host: sol
Access: public
 Region: us_west
Active: YES
Vob tag replica uuid:cb4caf2f.f48d11cc.abfc.00:01:53:00:e8:c3
Vob on host: sol
Vob server access path: c:\vbstore\vob12.vbs
Vob family uuid: aed00001.9d3e11ca.bc4c.00:01:53:00:e8:c3
Vob replica uuid: cb4caf2f.f48d11cc.abfc.00:01:53:00:e8:c3

• For a particular host, list the VOBs whose VOB-tags match a wildcard pattern.

cmd-context lsvob -host host4 '*anne*'

*   \anne_test2    \\saturn\users\anne\vbstore\test2.vbs public
*   \anne_work     \\saturn\users\anne\vbstore\work.vbs private

• Use a VOB browser to list all VOBs in the rd_east region.

cmd-context lsvob -graphical -region rd_east

SEE ALSO

mktag, mkvob, mount, register, umount, unregister, registry_ccase