OS Manuals

/usr/bin/iostat

Performance monitoring tools

From sysstat 12.8.0-r0 (os), captured 2026-11-05 by running iostat --help (exit 1). permalink

Usage: /usr/bin/iostat [ options ] [ <interval> [ <count> ] ]
Options are:
[ -c ] [ -d ] [ -h ] [ -k | -m | -G ] [ -N ] [ -s ] [ -t ] [ -U ] [ -V ] [ -x ] [ -y ] [ -z ]
[ { -f | +f } <directory> ] [ -j { ID | LABEL | PATH | UUID | ... } ]
[ --compact ] [ --dec={ 0 | 1 | 2 } ] [ --human ] [ --pretty ] [ -o JSON ]
[ [ -H ] -g <group_name> ] [ -p [ <device> [,...] | ALL ] ]
[ <device> [...] | ALL ]
Options (21)
OptionDescriptionSource
-cDisplay the CPU utilization report.man
--compactDon't break the Device Utilization Report into sub-reports so that all the metrics get displayed on a single line.man
-dDisplay the device utilization report.man
--decSpecify the number of decimal places to use (0 to 2, default value is 2).man
-f directory+f directoryman
-GDisplay statistics in gibibytes per second.man
-HThis option must be used with option -g and indicates that only global statistics for the group are to be displayed, and not statistics for individual devices in the group.man
-hThis option is equivalent to specifying --human --pretty.man
--humanPrint sizes in human readable format (e.g. 1.0k, 1.2M, etc.) The units displayed with this option supersede any other default units (e.g. kibibytes, sectors...) associated with the metrics.man
-kDisplay statistics in kibibytes per second.man
-mDisplay statistics in mebibytes per second.man
-NDisplay the registered device mapper names for any device mapper devices.man
-o JSONDisplay the statistics in JSON (JavaScript Object Notation) format.man
--prettyMake the Device Utilization Report easier to read by a human.man
-sDisplay a short (narrow) version of the report that should fit in 80 characters wide screens.man
-tPrint the time for each report displayed.man
-UDisplay timestamp (UTC - Coordinated Universal Time) in seconds from the epoch.man
-VPrint version number then exit.man
-xDisplay extended statistics.man
-yOmit first report with statistics since system boot, if displaying multiple records at given interval.man
-zTell iostat to omit output for any devices for which there was no activity during the sample period.man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.