lspv
lspv Command
Purpose
Displays information about a physical volume within a volume group.
Syntax
lspv [ -l | -p | -M ] [ -n DescriptorPhysicalVolume ] [ -v VolumeGroupID
] [ 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), and which volume group (if any) it belongs to.
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 System Management Interface Tool (SMIT) to run this
command. To use SMIT, enter:
smit lspv
Flags
-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. Physical partition numbers can range
from 1 to 1016.
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, or
stale.
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
hdisk1 10000BC876543258 vg00
hdisk2 ABCD000054C23486 None
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 Version 4 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.
System Management Interface Tool (SMIT) Overview in AIX Version 4
System Management Guide: Operating System and Devices explains the
structure, main menus, and tasks that are done with SMIT.