volstat(8) — Maintenance
NAME
volstat − Logical Storage Manager (LSM) statistics management utility
SYNOPSIS
/usr/sbin/volstat [-g diskgroup] [-i interval] [-c count] [-f fields] [ -r ] [ -psvd] [ object ... ]
DESCRIPTION
The volstat utility prints and resets statistics information on one or more volumes, plexes, subdisks, or disks.
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 disk activity since boot time. If no object operands are given, then statistics from all volumes in the configuration database are reported. object can be the name of a volume, plex, subdisk, or disk.
OPTIONS
The following options are recognized:
−g diskgroup
Select records from the specified disk group. The diskgroup option argument can be either a disk group name or disk group ID.
-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. Subsequent displays will show statistics with a zero value if there has been no change since the previous interval.
-c countStop after printing interval statistics count times.
-f fieldsSelect the display of statistics collected. The following options are available:
sStatistics 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.
aStatistics on atomic copies performed (has meaning only for volumes). Displays the number of operations, number of blocks, and the average time spent per operation.
pStatistics on plex read and plex write ioctls (has meaning only for volumes). Displays six fields: the number of plex read operations, the number of 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.
vStatistics 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, the average time spent on verified read operations in the interval, and the average time spent on verified write operations in the interval.
cStatistics on corrected (fixed) read operations (has meaning only for volumes). Displays the number of fixed read and write operations.
fDisplays the number of failed read and write operations.
-rReset statistics instead of printing them. This option will follow the same selection rules as printing for any type selection arguments or for any named objects. If an interval was specified on the command line, then the first set of statistics will not be printed since they will have been reset to zero. Subsequent activity will cause printing of statistics as normal.
-vDisplay 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. If an object supplied is a disk, then any volumes that occupy any part of the disk will be selected.
-pDisplay statistics for plexes on the object specified on the command line. For subdisk objects, displays information about a plex with which it is associated.
-sDisplay statistics for subdisks on the objects specified on the command line.
-dDisplay statistics for disks on which the object specified on the command line is fully or partially located.
OUTPUT FORMAT
Summary statistics for each object are printed in one-line output records, preceded by two header lines. The output line consists of blank-separated fields for the object type, object name (standard), and the fields requested by the -f switch in the order they are specified on the command line.
If the -i interval option was supplied, then statistics will be prefaced with a time-stamp showing the current local time on the system.
EXIT CODES
The volstat 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(8) for a list of standard exit codes.
EXAMPLES
To display statistics for all subdisks associated with all volumes, use the command:
/usr/sbin/volstat -s
To display statistics for the plexes and subdisks of a volume named blop, use the following:
/usr/sbin/volstat -ps blop
To reset all statistics for a disk group named foodg, type the following command:
/usr/sbin/volstat -g foodg -r
To display 5 sets of disk statistics at 10 second intervals, use the following:
/usr/sbin/volstat -i 10 -c 5 -d