lslv command
Purpose
Displays information about a logical volume.
Description
The lslv command displays the characteristics and status of the LogicalVolume or lists the logical volume allocation map for the physical partitions on the PhysicalVolume in which the logical volume is located. The logical volume can be a name or identifier.
If no flags are specified, the following status is displayed:
Flag name | Description |
---|---|
Logical volume | Name of the logical volume. Logical volume names must be unique systemwide and can range from 1 to 15 characters. |
Volume group | Name of the volume group. Volume group names must be unique systemwide and can range from 1 to 15 characters. |
Logical volume identifier | Identifier of the logical volume. |
Permission | Access permission; read-only or read-write. |
Volume group state | State of the volume group. If the volume group is activated with the activatevg command, the state is either active/complete (indicating all physical volumes are active) or active/partial (indicating all physical volumes are not active). If the volume group is not activated with the activatevg command, the state is inactive. |
Logical volume state | State of the logical volume. The Opened/stale status indicates the logical volume is open but contains physical partitions that are not current. Opened/syncd indicates the logical volume is open and synchronized. Closed indicates the logical volume has not been opened. |
Type | Logical volume type. |
Write verify | Write verify state of On or Off. |
Mirror write consistency | Mirror write consistency state of Yes or No. |
Max LPs | Maximum number of logical partitions the logical volume can hold. |
PP size | Size of each physical partition. |
Copies | Number of physical partitions created for each logical partition when allocating. |
Schedule policy | Sequential or parallel scheduling policy. |
LPs | Number of logical partitions currently in the logical volume. |
PPs | Number of physical partitions currently in the logical volume. |
Stale partitions | Number of physical partitions in the logical volume that are not current. |
Bad blocks | Bad block relocation policy. |
Inter-policy | Inter-physical allocation policy. |
Strictness | Current state of allocation. Possible values are strict, nonstrict, or superstrict. A strict allocation states that no copies for a logical partition are allocated on the same physical volume. If the allocation does not follow the strict criteria, is called nonstrict. A nonstrict allocation states that at least one occurrence of two physical partitions belong to the same logical partition. A superstrict allocation states that no partition from one mirror copy may reside the same disk as another mirror copy. |
Intra-policy | Intra-physical allocation policy. |
Upper bound | If the logical volume is super strict, upper bound is the maximum number of disks in a mirror copy. |
Relocatable | Indicates whether the partitions can be relocated if a reorganization of partition allocation takes place. |
Mount point | File system mount point for the logical volume, if applicable. |
Label | Specifies the label field for the logical volume. |
PV distribution | The distribution of the logical volume within the volume group. The physical volumes used, the number of logical partitions on each physical volume, and the number of physical partitions on each physical volume are shown. |
striping width | The number of physical volumes being striped across. |
strip size | The number of bytes per stripe. |
The -free flag displays logical volumes that are available to be used as backing devices for virtual storage.
Full scripting support is available by using the -field FieldNames and -fmt Delimiter flags. The -field flag will allow the user to select which output fields to display and in what order, while the -fmt flag provides scriptable output. The output fields will be displayed in the order they appear on the command line.
Flags
Flag name | Description |
---|---|
-free | Lists only logical volumes that are available for use as a backing device for virtual SCSI. |
-field | Specifies the list of fields to display. The
following fields are supported if no flags are specified:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The following fields are supported if the -pv flag
is specified:
|
|
The following fields are supported if the -map flag
is specified:
|
|
The following fields are supported if the -free flag
is specified:
|
|
-fmt | Specifies a delimiter character to separate output fields. |
-map | Lists the following fields for each logical
partition:
|
-pv | Lists the following fields for each physical
volume in the logical volume:
|
Exit Status
Examples
- To display information about logical volume lv03, type:
Information about logical volume lv03, its logical and physical partitions, and the volume group to which it belongs is displayed.lslv lv03
- To display information about logical volume lv03 by physical
volume, type:
The characteristics and status of lv03 are displayed, with the output arranged by physical volume.lslv -pv lv03
- To display a list of logical volumes that can be used as backing
devices, type:
lslv -free
The system displays the following message:
LV NAME SIZE(megabytes) VOLUME GROUP lv00 64 rootvg lv01 64 rootvg
- To display only the type and volume group of logical volume hd6
and separate the data by a : (colon) , type:
lslv hd6 -field type vgname -fmt :
The system displays the following message:
paging:rootvg