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
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)