Commands Reference, Volume 3

lslv Command

Purpose

Displays information about a logical volume.

Syntax

To Display Logical Volume Information

lslv [ -L ] [ -l| -m ] [ -nPhysicalVolume ] LogicalVolume

To Display Logical Volume Allocation Map

lslv [ -L ] [ -nPhysicalVolume ] -pPhysicalVolume [ LogicalVolume ]

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. The logical volume can be a name or identifier.

Note: If the lslv command cannot find information for a field in the Device Configuration Database, it will insert a question mark (?) in the value field. As an example, if there is no information for the LABEL field, the following is displayed:
LABEL: ?
The command attempts to obtain as much information as possible from the description area when it is given a logical volume identifier.

You can use the Volumes application in Web-based System Manager (wsm) to change volume characteristics. You could also use the System Management Interface Tool (SMIT) smit lslv fast path to run this command.

Flags

-L	Specifies no waiting to obtain a lock on the Volume group. Note : If the volume group is being changed, using the -L flag gives unreliable date.
-l	Lists the following fields for each physical volume in the logical volume: `PV` Physical volume name. `Copies` The following three fields: The number of logical partitions containing at least one physical partition (no copies) on the physical volume The number of logical partitions containing at least two physical partitions (one copy) on the physical volume The number of logical partitions containing three physical partitions (two copies) on the physical volume `In band` The percentage of physical partitions on the physical volume that belong to the logical volume and were allocated within the physical volume region specified by Intra-physical allocation policy. `Distribution` The number of physical partitions allocated within each section of the physical volume: outer edge, outer middle, center, inner middle, and inner edge of the physical volume.
-m	Lists the following fields for each logical partition: `LPs` Logical partition number. `PV1` Physical volume name where the logical partition's first physical partition is located. `PP1` First physical partition number allocated to the logical partition. `PV2` Physical volume name where the logical partition's second physical partition (first copy) is located. `PP2` Second physical partition number allocated to the logical partition. `PV3` Physical volume name where the logical partition's third physical partition (second copy) is located. `PP3` Third physical partition number allocated to the logical partition.
-n PhysicalVolume	Accesses information from the specific descriptor area of PhysicalVolume variable. The information may not be current since the information accessed with the -n flag has not been validated for the logical volumes. If you do not use the -n flag, the descriptor area from the physical volume that holds the validated information is accessed and therefore the information that is displayed is current. The volume group need not be active when you use this flag.
-p PhysicalVolume	Displays the logical volume allocation map for the PhysicalVolume variable. If you use the LogicalVolume parameter, any partition allocated to that logical volume is listed by logical partition number. Otherwise, the state of the partition is listed as one of the following: `used` Indicates that the partition is allocated to another logical volume. `free` Indicates that the specified partition is not being used on the system. `stale` Indicates that the specified partition is no longer consistent with other partitions. The computer lists the logical partitions number with a question mark if the partition is stale.

If no flags are specified, the following status is displayed:

`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 varyonvg 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 varyonvg 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, 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 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.

Examples

To display information about logical volume lv03, enter:
```
lslv lv03 
```
Information about logical volume lv03, its logical and physical partitions, and the volume group to which it belongs is displayed.
To display the logical volume allocation map for hdisk2, enter:
```
lslv -p hdisk2
```
An allocation map forhdisk2 is displayed, showing the state of each partition. Since no LogicalVolume parameter was included, the map does not contain logical partition numbers specific to any logical volume.
To display information about logical volumelv03 by physical volume, enter:
```
lslv -l lv03
```
The characteristics and status of lv03 are displayed, with the output arranged by physical volume.
To display information about physical volume hdisk3 gathered from the descriptor area on hdisk2, enter:
```
lslv -n hdisk2 -p hdisk3 lv02
```
An allocation map, using the descriptor area on hdisk2, is displayed. Because the LogicalVolume parameter is included, the number of each logical partition allocated to that logical volume is displayed on the map.
To display information about a specific logical volume, using the identifier, enter:
```
lslv 00000256a81634bc.2
```
All available characteristics and status of this logical volume are displayed.

File

/usr/sbin

Contains the lslv command.

Related Information

The chlv command, lspv command, lsvg command, mklv command, reorgvg command, varyonvg command.

Monitoring and Tuning Disk I/O in AIX 5L Version 5.1 Performance Management Guide

The Logical Volume Storage Overview in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices explains the Logical Volume Manager, physical volumes, logical volumes, volume groups, organization, ensuring data integrity, and allocation characteristics.

For information on installing the Web-based System Manager, see Chapter 2: Installation and System Requirements in AIX 5L Version 5.1 Web-based System Manager Administration Guide.

System Management Interface Tool (SMIT) Overview in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices explains the structure, main menus, and tasks that are done with SMIT.