lsstorage

List file system locations for creating view and VOB storage directories

APPLICABILITY

ClearCase (cleartool subcommand)

SYNOPSIS

lsstorage [ -s·hort | -l·ong ] [ -vie·w | -vob ]

[ -reg·ion network-region ] [ -hos·t hostname ]
[ storage-global-pname ]

DESCRIPTION

This command lists locations in which ClearCase clients can create view and VOB storage directories. These locations are stored in the ClearCase registry.

During a ClearCase server installation, you can choose to make locations on the machine available for creating view and VOB storage directories. When you first log on after the installation restart, the ClearCase Server Storage Configuration Wizard runs automatically and prompts you to specify the locations. You can also specify storage locations on a server with the register command.

To unregister a storage location, use the unregister command with the -viewstorage or -vobstorage option.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required.

Locks: No locks apply.

OPTIONS AND ARGUMENTS

LISTING FORMAT. Default: Lists global paths of storage locations.

-s·hort

Same as default.

-l·ong

For each storage location, lists global path, type (VOB or view), server host, and region.

SPECIFYING VIEW OR VOB STORAGE LOCATIONS. Default: Lists view and VOB storage locations.

-vie·w

Lists only view storage locations.

-vob

Lists only VOB storage locations.

SPECIFYING A NETWORK REGION. Default: Lists all storage locations that exist for the default network region of the user entering the command.

-reg·ion network-region

Lists all storage locations in network-region.

LISTING LOCATIONS ON A SPECIFIC HOST. Default: Lists storage locations for all hosts.

-hos·t host-name

Lists only those storage locations on host host-name.

storage-global-pname

Limits the listing to a particular storage location.

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 all view and VOB storage locations in the current network region.

cmd-context lsstorage
\\artemis\vob_stg
\\baldwin\view_stg
\\bolero\d\views
...

• List all view storage locations in the dev_west region.

cmd-context lsstorage -view -region dev_west
\\hero\views
\\claudio\c\vwstg

• List all view and VOB storage locations on host camillus.

cmd-context lsstorage -host camillus
\\camillus\dev_vobs
\\camillus\dev_vws
\\camillus\test_vws

• List all information about the VOB storage location \\marcellus\vob_stg.

cmd-context lsstorage -long -vob \\marcellus\vob_stg
Global path: \\marcellus\vob_stg
   Type: VOB
   Server host: marcellus
   Region: east_coast

SEE ALSO

register, unregister