volinfo(1M) Volume Manager Utilities volinfo(1M)
NAME
volinfo - Prints accessibility and usability of volumes
SYNOPSIS
volinfo [ -p ] [ vol ... ]
DESCRIPTION
The volinfo utility reports a usage-type-dependent condition
on one or more volumes. A report for each volume specified
by the vol operand is written to the standard output. If no
vol operands are given, then a volume condition report is
provided for each volume in the configuration database.
OPTION
The following option is recognized:
-p Reports the name and plex state of each plex in each
reported volume.
VOLUME CONDITIONS
The volume condition is a usage-type-dependent summary of
the state of a volume. This condition is derived from the
volume's kernel-enabled state and the usage-type-dependent
states of the volumes plexes.
The volinfo utility reports the following conditions:
Startable
A startable volume is one for which a volume start
operation would likely succeed.
Unstartable
An unstartable volume is one that is not started and
either is not correctly configured or doesn't meet the
prerequisites for starting because of errors or other
conditions.
Started
A started volume has been started and can be used.
Started Unusable
A started unusable volume has been started but is not
operationally accessible. This condition may result
from errors that have occurred since the volume was
started, or may be a result of administrative actions.
OUTPUT FORMAT
Summary reports for each volume are printed in one-line
output records, preceded by one header line. The volume
output line consists of blank-separated fields for the
volume name, volume condition, and the type of the volume.
Page 1 (printed 1/21/92)
volinfo(1M) Volume Manager Utilities volinfo(1M)
The output format for each plex is a one-line output record
consisting of blank-separated fields for the plex name and
the plex state. The plex records are indented from the
volume records.
SYNOPSIS FOR FSGEN AND GEN USAGE-TYPES
volinfo [ -U usetype ] [ -o useopt ] [ -p ] vol ...
FSGEN AND GEN DESCRIPTION
The volinfo utility for the fsgen and gen usage-types
displays general volume status. See volinfo(1M) for
information on usage and expected output.
FSGEN AND GEN OPTIONS
The following options are recognized:
-U usetype
For fsgen:
A usage-type name passed in from the switchout volinfo
utility. If this option is specified, then the value
for usetype must be fsgen.
For gen:
The gen usage-type volinfo utility can be used by
another usage-type that has similar characteristics as
long as the name of the other usage-type is specified
with this option.
-o useopt
Give usage-type-specific options to the usage-type
utility. This option is currently unused by volinfo
and is ignored.
-p Report the name and plex state of each plex in each
reported volume.
-Z The switchout volinfo utility sets the -Z option if the
user did not specify any volume name operands. In this
case the switchout utility gets the list of all volume
names from the current configuration database. With
the -Z option, the volinfo utility ignores volumes that
do not exist or that do not have a usage type of fsgen.
FSGEN AND GEN VOLUME CONDITIONS
The volume condition is printed according to the following
rules:
1. If the state field for any plex is EMPTY, then the
volume is Unstartable.
2. If the volume is ENABLED and if the volume has at least
one plex with a kernel state of ENABLED, with the
PL_PFLAG_NOERROR flag cleared, and with an I/O mode of
Page 2 (printed 1/21/92)
volinfo(1M) Volume Manager Utilities volinfo(1M)
read-write, then the volume is Started.
3. If the volume is ENABLED, but the previous test fails,
then the volume is Started Unusable.
4. If the volume contains both non-volatile ACTIVE and
CLEAN plexes, then the volume is Unstartable. A plex is
considered volatile if any of its associated subdisks
have the volatile flag turned on.
5. If the volume does not contain any non-volatile ACTIVE
or CLEAN plexes, then the volume is Unstartable.
6. If the volume has more than one non-volatile ACTIVE
plex, but none of those plexes are complete, then the
volume is Unstartable. A plex is complete if all blocks
in the plex address space have a backing subdisk and if
the plex is at least as long as the volume.
7. If no other test succeeds then the volume is Startable.
EXIT CODES
The volinfo utility exits with a nonzero status if the
attempted operation fails. A nonzero exit code is not a
complete indicator of the problems encountered, but rather
denotes the first condition that prevented further execution
of the utility. See volintro(1M) for a list of standard
exit codes.
SEE ALSO
volintro(1M).
Page 3 (printed 1/21/92)