[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 3

lspv Command

Purpose

Displays information about a physical volume within a volume group.

Syntax

lspv

OR

lspv [ -L ] [ -l | -p | -M ] [ -n DescriptorPhysicalVolume] [ -vVolumeGroupID] PhysicalVolume

Description

The lspv command displays information about the physical volume if the specific physical volume name is specified. If you do not add flags to the lspv command, the default is to print every known physical volume in the system along with its physical disk name, physical volume identifiers (PVIDs), to which volume group (if any) the physical volume belongs, and the state of the volume group as active if the volume group is varied on or concurrent if it is varied on in concurrent mode.

Note
If the lspv 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 PP RANGE field, the following might be displayed:

PP RANGE: ?

The lspv command attempts to obtain as much information as possible from the description area when it is given a logical volume identifier.

When the PhysicalVolume parameter is used, the following characteristics of the specified physical volume are displayed:

Physical volume Name of the physical volume.
Volume group Name of volume group. Volume group names must be unique systemwide names and can be from 1 to 15 characters long.
PV Identifier The physical volume identifier for this physical disk.
VG Identifier The volume group identifier of which this physical disk is a member.
PVstate State of the physical volume. If the volume group that contains the physical volume is varied on with the varyonvg command, the state is active, missing, or removed. If the physical volume is varied off with the varyoffvg command, the state is varied off.
Allocatable Allocation permission for this physical volume.
Logical volumes Number of logical volumes using the physical volume.
Stale PPs Number of physical partitions on the physical volume that are not current.
VG descriptors Number of volume group descriptors on the physical volume.
PP size Size of physical partitions on the volume.
Total PPs Total number of physical partitions on the physical volume.
Free PPs Number of free physical partitions on the physical volume.
Used PPs Number of used physical partitions on the physical volume.
Free distribution Number of free partitions available in each intra-physical volume section.
Used distribution Number of used partitions in each intra-physical volume section.

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 lspv 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 logical volume on the physical volume:
LVname
Name of the logical volume to which the physical partitions are allocated.
LPs
The number of logical partitions within the logical volume that are contained on this physical volume.
PPs
The number of physical partitions within the logical volume that are contained on this physical volume.
Distribution
The number of physical partitions, belonging to the logical volume, that are allocated within each of the following sections of the physical volume: outer edge, outer middle, center, inner middle and inner edge of the physical volume.
Mount Point
File system mount point for the logical volume, if applicable.
-M Lists the following fields for each logical volume on the physical volume:

PVname:PPnum [LVname: LPnum [:Copynum] [PPstate]]

Where:

PVname
Name of the physical volume as specified by the system.
PPnum
Physical partition number.
LVname
Name of the logical volume to which the physical partitions are allocated. Logical volume names must be system-wide unique names, and can range from 1 to 64 characters.
LPnum
Logical partition number. Logical partition numbers can range from 1 to 64,000.
Copynum
Mirror number.
PPstate
Only the physical partitions on the physical volume that are not current are shown as stale.
-n DescriptorPhysicalVolume Accesses information from the variable descriptor area specified by the DescriptorPhysicalVolume 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 displayed is current. The volume group need not be active when you use this flag.
-p Lists the following fields for each physical partition on the physical volume:
Range
A range of consecutive physical partitions contained on a single region of the physical volume.
State
The current state of the physical partitions: free, used, stale, or vgda.
Note
If a volume group is converted to a big vg format, it may be necessary to use some data partitions for volume group descriptor area. These partitions will be marked vgda.
Region
The intra-physical volume region in which the partitions are located.
LVname
The name of the logical volume to which the physical partitions are allocated.
Type
The type of the logical volume to which the partitions are allocated.
Mount point
File system mount point for the logical volume, if applicable.
-v VolumeGroupID Accesses information based on the VolumeGroupID variable. This flag is needed only when the lspv command does not function due to incorrect information in the Device Configuration Database. The VolumeGroupID variable is the hexadecimal representation of the volume group identifier, which is generated by the mkvg command.

Examples

  1. To display the status and characteristics of physical volume hdisk3, enter:

    lspv hdisk3 
  2. To display the status and characteristics of physical volume hdisk5 by physical partition number, enter:
    lspv -p hdisk5
  3. To display the status and characteristics of physical volume hdisk5 using the volume group ID, enter:
    lspv -v 00014A782B12655F hdisk5
    The following is an example of the output:
    lspv
    hdisk0   0000000012345678		rootvg   active
    hdisk1   10000BC876543258		vg00     concurrent
    hdisk2   ABCD000054C23486		None
    The previous example shows that physical volume hdisk0 contains the volume group rootvg, and it is varied on. Physical volume hdisk1 contains the volume group vg00, and it is varied on in concurrent mode. Physical volume hdisk2 does not contain a varied on volume group.

Files

/usr/sbin Contains the lspv command.

Related Information

The chpv command, lslv command, lsvg command, mklv command, varyonvg command.

Logical Volume Storage Overview in AIX 5L Version 5.2 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.2 Web-based System Manager Administration Guide.

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

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]