lsvg Command
Purpose
Displays information about volume groups.
Syntax
lsvg [-map | -lv | -pv ] [ -field FieldName ] [ -fmt Delimiter ] VolumeGroup...
Description
The lsvg command displays information about volume
groups. If you use the VolumeGroup parameter, only
the information for that volume group is displayed. If you do not use the VolumeGroup parameter, a list of the names of all defined
volume groups is displayed.
When information from the Device Configuration database is unavailable,
some of the fields will contain a question mark (?) in place of the missing
data. The lsvg command attempts to obtain as much information
as possible from the description area when the command is given a logical
volume identifier.
Full scripting support is provided to the lsvg command by using the -field FieldNames and -fmt Delimiter flags. The -field flag will allow the user to
select which output fields to display and in what order, while the -fmt flag provides scriptable output. The output fields will be displayed
in the order they appear on the command line.
If you do not specify any flags, the following information will be displayed:
| Volume group |
Name of the volume group. Volume group names must be
unique and can range from 1 to 15 characters. |
| Volume group state |
State of the volume group. If the volume group is active,
the state is either active/complete (indicating all physical volumes
are active) or active/partial (indicating some physical volumes
are not active). If the volume group is not active, the state is inactive. |
| Permission |
Access permission: read-only or read-write. |
| Max LVs |
Maximum number of logical volumes allowed in the volume
group. |
| LVs |
Number of logical volumes currently in the volume group. |
| Open LVs |
Number of logical volumes within the volume group that
are currently open. |
| Total PVs |
Total number of physical volumes within the volume group. |
| Active PVs |
Number of physical volumes that are currently active. |
| VG identifier |
The volume group identifier. |
| PP size |
Size of each physical partition. |
| Total PPs |
Total number of physical partitions within the volume
group. |
| Free PPs |
Number of physical partitions not allocated. |
| Alloc PPs |
Number of physical partitions currently allocated to
logical volumes. |
| Quorum |
Number of physical volumes needed for a majority. |
| VGDS |
Number of volume group descriptor areas within the volume
group. |
| Auto-on |
Automatic activation at IPL (yes or no). |
| Concurrent |
States whether the volume group is Concurrent Capable
or Non-Concurrent Capable. |
| Auto-Concurrent |
States whether you should auto activate the Concurrent
Capable volume group in concurrent or non-concurrent mode. For volume groups
that are Non-Concurrent Capable, this value defaults to Disabled. |
| VG Mode |
The mode of the volume group: Concurrent or Non-Concurrent. |
| Node ID |
Node id of this node if volume group is in concurrent
node. |
| Active Nodes |
Node ids of other concurrent nodes that have this volume
group active. |
| Max PPs Per PV |
Maximum number of physical partitions per physical volume
allowed for this volume group. |
| Max PVs |
Maximum number of physical volumes allowed in this volume
group. |
| LTG size |
Logical track group size, in number of kilobytes, of
the volume group. |
| BB POLICY |
Bad block relocation policy of the volume group. |
| SNAPSHOT VG |
Snapshot volume group name if the snapshot volume group
is active else snapshot volume group identifier. |
| PRIMARY VG |
Original volume group name of a snapshot volume group
if the original volume group is active else original volume group identifier. |
Flags
| -field |
Specifies the list of fields to display. The following
fields are supported if no flags are specified:
- vgname
- Name of the volume group. Volume group names must be unique systemwide
and can range from 1 to 15 characters.
- vgstate
- State of the volume group. If the volume group is activated with the activatevg 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 de-activated with the deactivatevg command, the state is inactive.
- access
- Access permission: read-only or read-write.
- maxlvs
- Maximum number of logical volumes allowed in the volume group.
- numlvs
- Number of logical volumes currently in the volume group.
- openlvs
- Number of logical volumes within the volume group that are currently
open.
- totalpvs
- Total number of physical volumes within the volume group.
- stalepvs
- Number of PVs which are not current. The data is stale.
- stalepps
- Number of PPs which are not current. The data is stale.
- activepvs
- Number of physical volumes that are currently active.
- vgid
- The volume group identifier.
- ppsize
- Size of each physical partition.
- totalpps
- Total number of physical partitions within the volume group.
- freepps
- Number of physical partitions not allocated.
- usedpps
- Number of physical partitions currently allocated to logical volumes.
- quorum
- Number of physical volumes needed for a majority.
- vgds
- Number of volume group descriptor areas within the volume group.
- auton
- Automatic activation at IPL (yes or no).
- pppervg
- Maximum number of physical partitions allowed in this volume group.
- ppperpv
- Maximum number of physical partitions per physical volume allowed for
this volume group.
- maxpvs
- Maximum number of physical volumes allowed in this volume group. This
information is displayed only for 32 and 128 PV volume groups.
- ltgsize
- Logical track group size of the volume group. The maximum amount of
data that can be transferred in one I/O request to the disks of the volume
group. The LTG size will be displayed in kilobytes unless the LTG size is
greater than 1 MB, in which case megabytes will be used. it is capable of
dynamically determining the LTG size based-on the disk topology and it is
listed as Dynamic. If that capability is disabled by the user with the option,
then it will be listed as Static.
- bbpolicy
- Bad block relocation policy of the volume group.
- hotspare
-
- autosync
-
|
|
The following fields are supported if the -lv flag
is specified:
- lvname
- A logical volume within the volume group.
- type
- Logical volume type.
- lps
- Number of logical partitions in the logical volume.
- pvs
- Number of physical partitions used by the logical volume.
- lvstate
- State of the logical volume. Opened/stale indicates the logical
volume is open but contains partitions that are not current. Opened/syncd indicates the logical volume is open and synchronized. Closed indicates the logical volume has not been opened.
- mount
- File system mount point for the logical volume, if applicable.
The following fields are supported if the -pv flag is specified:
- pvname
- A physical volume within the volume group.
- pvstate
- State of the physical volume.
- totalpps
- Number of physical partitions on the physical volume.
- freepps
- Number of free physical partitions on the physical volume.
- dist
- 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.
|
| -fmt |
Specifies a delimiter character to separate output fields. |
| -pv |
Lists the following information for each physical volume
within the group specified by the VolumeGroup parameter:
- Physical volume
- A physical volume within the group.
- PVstate
- State of the physical volume.
- Total PPs
- Total number of physical partitions on the physical volume.
- Free PPs
- Number of free physical partitions on the physical volume.
- 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.
|
| -lv |
Lists the following information for each logical volume
within the group specified by the VolumeGroup parameter:
- LV
- A logical volume within the volume group.
- Type
- Logical volume type.
- LPs
- Number of logical partitions in the logical volume.
- PPs
- Number of physical partitions used by the logical volume.
- PVs
- Number of physical volumes used by the logical volume.
- Logical volume state
- State of the logical volume. Opened/stale indicates the logical
volume is open but contains partitions that are not current. Opened/syncd indicates the logical volume is open and synchronized. Closed indicates the logical volume has not been opened.
- Mount Point
- File system mount point for the logical volume, if applicable.
|
| -map |
Lists the following fields for each logical volume on
the physical volume: PVname:PPnum [LVname: LPnum [:Copynum] [PPstate]]
- 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.
|
Exit Status
See Virtual I/O Server command exit status.
Examples
- To display the names of all volume groups within the system, type:
lsvg
- To display information about volume group vg02,
type:
lsvg vg02
The characteristics and status of both the logical
and physical partitions of volume group vg02 are displayed.
- To display the names, characteristics, and status of all the logical volumes
in volume group vg02, type:
lsvg -lv vg02
Related Information
The mkvg command, the chvg command, the extendvg command, the reducevg command, the mirrorios command,
the unmirrorios command,
the activatevg command,
the deactivatevg command,
the importvg command, the exportvg command, and the syncvg command.