Index for Section 8

Alphabetical listing for V

volstat(8)
NAME
  volstat - Logical Storage Manager (LSM) statistics management utility

SYNOPSIS
  /usr/sbin/volstat [-g diskgroup] [-i interval] [-c count] [-f fields] [-r]
  [-psvd] [object ...]

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 count
      Stop after printing interval statistics count times.

  -f fields
      Select 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 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, 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.

  -r  Reset 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.

  -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.  If an object
      supplied is a disk, then any volumes that occupy any part of the disk
      will be selected.

  -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 disks on which the object specified on the
      command line is fully or partially located.

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.

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
   1.  To display statistics for all subdisks associated with all volumes,
       use the command:
	    /usr/sbin/volstat -s

   2.  To display statistics for the plexes and subdisks of a volume named
       blop, use the following:
	    /usr/sbin/volstat -ps blop

   3.  To reset all statistics for a disk group named foodg, type the
       following command:
	    /usr/sbin/volstat -g foodg -r

   4.  To display 5 sets of disk statistics at 10 second intervals, use the
       following:
	    /usr/sbin/volstat -i 10 -c 5 -d



SEE ALSO
  volintro(8), voltrace(8)