Displays a list of the existing
storage pools and their attributes.

>>-lspool--+--------+--+-----------------------------+---------->
+- -?----+ | .-default----------. |
+- -h----+ '- -fmt--+-delim--character-+-'
'- -help-' '-xml--------------'
>--+--------------+--+----------------+--+-------------+-------->
| .-off-. | | .-on--. | '- -r--number-'
'- -p--+-on--+-' '- -hdr--+-off-+-'
>--+--------------+--+-----+--+---------------------+----------->
| .-off-. | +- -l-+ '- -type--+-default-+-'
'- -v--+-on--+-' '- -s-' +-system--+
'-user----'
>--+---------------+-------------------------------------------><
| .-----------. |
| V | |
+---pool_name-+-+
'- - -----------'
Parameters
- –? | –h | –help
- Displays a detailed description of this command, including syntax, parameter
descriptions, and examples. If you specify a help option, all other command
options are ignored.
- –fmt
- Specifies the format of the output. You can specify one of the following
values:
- default
- Specify this value to display output in a tabular format using spaces
as the delimiter between the columns. This is the default value. For example:
Name Type Size (MB) Used (MB) Used (%) Threshold (%) Volumes
========================================================================
Pool1 User 1400 575 41 90 2
- delim character
- Specify this value to display output in a tabular format using the specified
character to separate the columns. If you use a shell metacharacter (for example,
* or \t) as the delimiting character, enclose the character in single quotation
mark (') or double quotation mark ("). A blank space is not a valid character.
For example, lspool -fmt delim ',' would display output
in the following format:
Pool1,User,1400,575,41,90,2
- xml
- Specify this value to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_StoragePool">
<PROPERTY NAME="Name" TYPE="string"><VALUE TYPE="string">Pool1</VALUE>
</PROPERTY>
<PROPERTY NAME="PoolType" TYPE="uint32"><VALUE TYPE="uint32">0</VALUE>
</PROPERTY>
<PROPERTY NAME="AlertPercentage" TYPE="uint16"><VALUE TYPE="uint16">90
</VALUE></PROPERTY>
<PROPERTY NAME="Size" TYPE="uint64"><VALUE TYPE="uint64">1400</VALUE>
</PROPERTY>
<PROPERTY NAME="SizeAllocated" TYPE="uint64"><VALUE TYPE="uint64">575
</VALUE></PROPERTY>
<PROPERTY NAME="SizeAllocatedPercentage" TYPE="uint16"><VALUE
TYPE="uint16">41</VALUE></PROPERTY>
<PROPERTY NAME="NumberOfVolumes" TYPE="uint32"><VALUE TYPE="uint32">2
</VALUE></PROPERTY>
</INSTANCE>
</IRETURNVALUE>
- –p
- Specifies whether to display one page of text at a time or all text at
once.
- off
- Displays all text at one time. This is the default value when the sfscli command
is run in single-shot mode.
- on
- Displays one page of text at time. Pressing any key displays the next
page. This is the default value when the sfscli command
is run in interactive mode.
- –hdr
- Specifies whether to display the table header.
- on
- Displays the table header. This is the default value.
- off
- Does not display the table header.
- –r number
- Specifies the number of rows per page to display when the –p parameter
is on. The default is 24 rows. You can specify a value from 1 to 100.
- –v
- Specifies whether to enable verbose mode.
- off
- Disables verbose mode. This is the default value.
- on
- Enables verbose mode.
- –l
- Displays additional information about the storage pools.
- –s
- Displays only the names of the storage pools. This is the default.
- –type
- Displays information for only those storage pools that match the specified
type. If not specified, all storage pools are displayed. Possible types are:
- default
- Displays information for the default storage pool.
- system
- Displays information for the system storage pool.
- user
- Displays information for all user storage pools.
- pool_name
- Specifies the names of one or more storage pools to display.
- –
- Specifies that in single-shot command mode you want this
command to receive from the input stream (stdin) the names of one or
more storage pools to display.
Prerequisites
You
must be logged in to the operating system on the engine hosting the
master metadata server to run this command.
Description
If
you do not specify a listing parameter, this command displays the following
default information for each storage pool:
- Name of the storage pool.
- Type of storage pool.
- Size of the storage pool, in MB.
- Amount of space used, in MB.
- Percent of space used.
- Alert threshold.
- Number of volumes in the storage pool.
If you specify the
–l listing parameter, this
command displays the following information in addition to the default information
for each storage pool:
- Partition size, in MB (16, 64, or 256).
- Allocation size, in KB (auto, 4 or 128).
- Pool description.
Example
Display a long listing The following example
lists all the attributes of all the storage pools:
sfscli> lspool -l
Name Type Size (MB) Used (MB) Used (%) Threshold (%) Volumes
===========================================================================
Pool1 User 1400 575 41 90 2
Pool2 User 2000 1000 50 90 3
DEFAULT Default 10000 2500 25 80 10
SYSTEM System 10000 7500 75 80 10
Partition Size (MB) Allocation Size (KB) Description
=========================================================
16 2 Accounting
16 3 Engineering
64 128 DEFAULT pool
64 128 SYSTEM pool