qiostat (1)


qiostat - VxFS Quick I/O for Databases statistics utility


qiostat [ -i interval [ -c count] ] [ -l ]
[ -r ] filename ...




qiostat prints and resets statistics on one or more VERITAS Quick I/O for Databases device files.

qiostat reads statistics for the specified Quick I/O files and prints them to standard output. These statistics show I/O activity since the last time the file was opened from the Quick I/O interface, and are valid as long as the file remains open. Statistics reset to zero when the last file open from the Quick I/O interface is closed.


-c count Stops after printing statistics count times.
-i interval Prints updated I/O statistics every interval seconds. The first set of statistics reported are the totals since the last reset. Subsequent displays show the changes since the last report.
-l Prints the statistics in long format. Also prints the caching statistics when Cached Quick I/O is enabled.
-r Resets statistics instead of printing them. This follows the same selection rules as printing for any device file. If interval is also specified, the first set of statistics are not printed because they were already reset to zero; subsequent activity prints statistics as usual.

Output Format

Summary statistics for each object are printed in single line output records, preceded by two header lines. The output line consists of blank-separated fields for the file name, and statistics on read and write operations:
o number of read operations
o number of write operations
o number of blocks read
o number of blocks written
o average time spent on read operations in the interval
o average time spent on write operations in the interval

If the -i interval option is supplied, statistics are prefaced with a time stamp showing the current local time on the system.

If the -l option is specified, statistics are printed in two lines per object:

cust0 2 1 8 4 5.0 10.0
2 1 50.0

The first line is the same as described above. The second line shows the caching statistics. Cached Quick I/O performs buffered reads and returns cached data (if available) without doing reads from the disk. Writes are performed as modified direct writes, that is, after the direct write to disk is scheduled, the file system updates the copy of data in cache (if it exists) with the same data being written to disk. In the column headings of the second line:

o NREQUESTIO is the total number of reads issued by the user.
o NDISKIO is the total number of reads of the disk required because the data was not available in cache, plus the read ahead I/O if you enabled the read ahead option on the file system.
o HIT RATIO is the percentage of the read requests that did not have to perform physical I/O and were satisfied from the cache. HIT RATIO is calculated as follows:
NRANGEIO is the number of reads requested by the user of the disk required because the data was not available in cache.


qiostat exits with a non-zero status if the attempted operation fails. A non-zero exit code is not a complete indicator of the problems encountered, but rather denotes the first condition that prevented further execution of the command.


Display statistics for all device files on the file system /mnt/oracle:
qiostat /mnt/oracle/*
Display five sets of I/O statistics at 10 second intervals:
qiostat -i 10 -c 5 /mnt/oracle/*
Print cache statistics:
qiostat -l /mnt/oracle/*


qioadmin(1), qiomkfile(1)

VxFS 5.1 SP1 qiostat (1)