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

>>-lspool--+----------+--+-------------------------------+------>
+- –?----+ | .-default----------. |
+- –h----+ '- –fmt--+-delim--character-+-'
'- –help-' '-xml--------------'
>--+----------------+--+------------------+--------------------->
| .-off-. | | .-on--. |
'- –p--+-on--+-' '- –hdr--+-off-+-'
>--+---------------+--+----------------+--+-------+------------->
'- –r--number-' | .-off-. | +- –l-+
'- –v--+-on--+-' '- –s-'
>--+-----------------------+--+---------------+----------------><
'- –type--+-default-+-' | .-----------. |
+-system--+ | V | |
'-user----' +---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:
Pool1,User,
- 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 you want to read the names of one or more storage pools
to display from stdin (for example, – << /work/stgpools_list.txt).
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