lslv Command

Purpose

Displays information about a logical volume.

Syntax

To Display Logical Volume Information

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

To Display Logical Volume Allocation Map

lslv [ -L ] [ -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 the System Management Interface Tool (SMIT) smit lslv fast path to run this command.

Flags

Item Description
-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:

Item 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 (LV identifier) Identifier of the logical volume.
Permission Access permission; read-only or read-write.
Volume group state (VG 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 (LV 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 on or off.
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 (Sched 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.
BB policy Bad block relocation policy.
Inter-policy Inter-physical allocation policy.
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.
Each LP copy on a separate PV? The strictness value. 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, it 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.
Serialize IO? Serialization of overlapping IOs state of yes or no. If serialization is turned on (yes), then overlapping IOs are not allowed on a block range, and only a single IO in a block range is processed at any one time. Most applications, such as file systems and databases, perform serialization; therefore, serialization should be turned off (no). The default setting for new logical volumes is no.
Stripe width The number of physical volumes being striped across.
Stripe size The number of bytes per stripe.
Infinite Retry Lists the infinite retry option of the logical volume.
Preferred Read Lists the preferred logical volume copy for the read operation.

Examples

  1. To display information about the testlv logical volume, enter:
    lslv testlv
    Information about the testlv logical volume, its logical and physical partitions, and the volume group to which it belongs is displayed as shown in the following example output:
    LOGICAL VOLUME:     testlv                 VOLUME GROUP:   testvg
    LV IDENTIFIER:      000e8b6e0000d900000001476c303bc8.1 PERMISSION:     read/write
    VG STATE:           active/complete        LV STATE:       closed/syncd
    TYPE:               jfs                    WRITE VERIFY:   off
    MAX LPs:            512                    PP SIZE:        128 megabyte(s)
    COPIES:             3                      SCHED POLICY:   parallel
    LPs:                10                     PPs:            30
    STALE PPs:          0                      BB POLICY:      relocatable
    INTER-POLICY:       minimum                RELOCATABLE:    yes
    INTRA-POLICY:       middle                 UPPER BOUND:    32
    MOUNT POINT:        N/A                    LABEL:          None
    MIRROR WRITE CONSISTENCY: on/ACTIVE
    EACH LP COPY ON A SEPARATE PV ?: yes
    Serialize IO ?:     NO
    INFINITE RETRY:     no                     PREFERRED READ: 3 
  2. 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.
  3. 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.
  4. 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.
  5. 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

Item Description
/usr/sbin Contains the lslv command.