volstat(1M) Volume Manager Utilities volstat(1M)
NAME
volstat - Volume Manager statistics reporting utility
SYNOPSIS
volstat [ -i interval [ -c count ]] [ -f fields ] [ -psvd ]
[ object ... ]
DESCRIPTION
The volstat utility prints statistics information on one or
more volumes, plexes, subdisks, or block devices.
The volstat utility reads statistics from the volume device
files in the directory /dev/rvol/ and prints them to
standard output. These statistics represent volume, plex,
subdisk, and block device activity since boot time. If no
object operands are given, then statistics from all volumes
in the configuration database are reported. object can be a
name of a volume, plex, subdisk, or the full pathname of a
block device.
OPTIONS
The following options are recognized:
-i interval
Print the change in volume statistics that occurs after
every interval seconds. The first interval is assumed
to encompass the entire previous history of objects.
-c count
Stop after printing interval statistics count times.
-f fields
Selects the display of statistics collected. The
following options are available:
s Statistics on read and write operations. Displays
six fields: the number of read operations, the
number of write operations, the number of blocks
read, the number of blocks written, the average
time spent on read operations in the interval, and
the average time spent on write operations in the
interval. These statistics are displayed as the
default output format.
a Statistics on atomic copies performed (has meaning
only for volumes). Displays the number of
operations, number of blocks, and the average time
spent per operation.
p Statistics on plex read and plex write ioctls (has
meaning only for volumes). Displays six fields:
the number of plex read operations, the number of
Page 1 (printed 1/21/92)
volstat(1M) Volume Manager Utilities volstat(1M)
plex write operations, the number of blocks read,
the number of blocks written, the average time
spent on plex read operations in the interval, and
the average time spent on plex write operations in
the interval.
v Statistics on verified reads and writes (has
meaning only for volumes). Displays six fields:
the number of verified read operations, the number
of verified write operations, the number of blocks
read, the number of blocks written, and the
average time spent on verified read operations in
the interval, and the average time spent on
verified write operations in the interval.
c Statistics on corrected (fixed) read operations
(has meaning only for volumes). Displays the
number of fixed read and write operations.
f Displays the number of failed read and write
operations.
-v Display statistics for volumes on the objects specified
on the command line. For an object that is a plex or a
subdisk, displays information about the volume with
which the object is associated. For a device that is
all volumes that have some portions of them present on
this device.
-p Display statistics for plexes on the object specified
on the command line. For subdisk objects, displays
information about a plex with which it is associated.
-s Display statistics for subdisks on the objects
specified on the command line.
-d Display statistics for block devices on which object
specified on the command line is fully or partially
located.
OUTPUT FORMAT
Summary statistics for each device are printed in one-line
output records, preceded by two header lines. The output
line consists of blank-separated fields for the device type,
device name (standard), and the fields requested by -f
switch in the order they are specified on the command line.
EXIT CODES
The volstat utility exits with a nonzero status if the
attempted operation fails. A nonzero exit code is not a
Page 2 (printed 1/21/92)
volstat(1M) Volume Manager Utilities volstat(1M)
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), voltrace(1M), and volevent(7).
Page 3 (printed 1/21/92)