lslv Command

AIX Version 4.3 Commands Reference, Volume 3

lslv Command

Purpose

Displays information about a logical volume.

Syntax

To Display Logical Volume Information

lslv [ -l | -m ] [ -n PhysicalVolume ] LogicalVolume

To Display Logical Volume Allocation Map

lslv [ -n PhysicalVolume ] -p PhysicalVolume [ LogicalVolume ]

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. 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 a Web-based System Manager Volumes application (wsm lvm fast path) to run this command. You could also use the System Management Interface Tool (SMIT) smit lslv fast path to run this command.

Flags

-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, either strict or nonstrict`.` 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, it is called nonstrict. A nonstrict allocation states that at least one occurrence of two physical partitions belong to the same logical partition.
`Intra-policy`	Intra-physical allocation policy.
`Upper bound`	Maximum number of physical volumes for allocation.
`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 phyical 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 for hdisk2 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 volume lv03 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 Versions 3.2 and 4 Performance Tuning Guide

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

Setting up and running Web-based System Management in AIX Version 4.3 System Management Guide: Operating System and Devices.

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