lspool

Lists VOB storage pools

Applicability

Product

Command type

VersionVault

cleartool subcommand

Platform

UNIX®

Linux®

Windows®

Synopsis

lspool [ –l/ong | –s/hort | –fmt format-string ] [ –obs/olete ]
[ –inv/ob vob-selector | pool-selector ... ]

Description

The lspool command lists information about one or more VOB storage pools. This listing does not include the elements assigned to the pool; use the find command for this purpose. For example:

cmd-context   find /vobs/include -element 'pool(src_pool_2)' -print

Note: If ACLs are enabled, this command displays a warning if the file system on which the pool resides does not support ACLs.

Obsolete storage p+ools

Storage pools can be rendered obsolete with the lock –obsolete command. The obsolete/nonobsolete status of a pool affects some forms of this command.

Restrictions

None.

Options and arguments

Listing format

Default
A storage pool listing looks like this:

2007-11-20 drp pool "cdft"

–l/ong
Expands the listing to pool parameters and path names.
–s/hort
Restricts the listing to pool names only.
–fmt format-string
Lists information using the specified format string. For details about using this report-writing facility, see the fmt_ccase reference page.

Listing obsolete pools

Default
If you do not specify any pool-name argument, a VOB's obsolete pools are suppressed from the listing.
–obs/olete
Includes obsolete pools in the listing when you do not specify any pool-name argument. Has no effect if you specify one or more pool-name arguments.

Specifying the pools

Default
Lists all storage pools in the VOB containing the current working directory.
–inv/ob vob-selector
The VOB whose storage pools are to be listed. 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).

pool-selector ...
One or more names of storage pools to be listed. A pool is listed whether or not it is obsolete. Specify pool-selector in the form [pool:]pool-name[@vob-selector]

pool-selector ...

pool-name

Name of the storage pool

vob-selector

Object-selector for a VOB, in the same format as –invob.

Examples

The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.

The Windows examples that include 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 UNIX system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.

  • List all storage pools for the VOB containing the current working directory.

    cmd-context   lspool
    —12-08T12:01     jackson     pool "c_pool"
    "pool for c source files"
    —12-15T09:34     jenny       pool "cdft"
    "Predefined pool used to store cleartext versions."
    —12-08T12:21     jackson     pool "cltxt2"
    —12-15T09:34     jenny       pool "ddft"
    "Predefined pool used to store derived objects."
    —12-08T12:21     jackson     pool "do1"
    —12-08T12:21     jackson     pool "my_ctpool"
    "alternate cleartext pool"
    —12-15T09:34     jenny       pool "sdft"
    "Predefined pool used to store versions."
    —12-08T12:19     jackson     pool "staged"

  • List information about a particular storage pool, in long format.

    cmd-context   lspool –long do1
     pool "do1"
    2007-12-08T12:21:13 by jackson.dvt
     owner: jackson
     group: dvt
     kind: derived pool
     pool storage link target pathname
    “/net/oxygen/usr1/vob_pools/tut/d/do1
     pool storage global pathname
    "/net/oxygen/usr/vobstore/tut/tut.vbs/d/do1"
     maximum size: 10000 reclaim size: 8000 age: 168

  • List a particular storage pool, verifying that it is obsolete.

    cmd-context   lspool –short cltxt2
    cltxt2 (obsolete)