Home • Explore • Blog • CI
☰



man-pages
5th chunk of `iostat.man`
af6196c0d218f2258632d70ce44f9cdca8bbbcb92c508c590000000100000cdf
 individual device in the list then a line of global statistics for the group displayed as group_name and made up of all
              the devices in the list. The ALL keyword means that all the block devices defined by the system shall be included in the group.

       -H     This 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.

       -h     This option is equivalent to specifying --human --pretty.

       --human
              Print 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.  kilobytes, sectors...) associated with the metrics.

       -j { ID | LABEL | PATH | UUID | ... } [ device [...] | ALL ]
              Display persistent device names. Keywords ID, LABEL, etc. specify the type of the persistent name. These keywords are not limited, only prerequisite is that directory with required persistent names  is  present
              in /dev/disk.  Optionally, multiple devices can be specified in the chosen persistent name type.  Because persistent device names are usually long, option --pretty is implicitly set with this option.

       -k     Display statistics in kilobytes per second.

       -m     Display statistics in megabytes per second.

       -N     Display the registered device mapper names for any device mapper devices.  Useful for viewing LVM2 statistics.

       -o JSON
              Display the statistics in JSON (JavaScript Object Notation) format.  JSON output field order is undefined, and new fields may be added in the future.

       -p [ { device[,...] | ALL } ]
              Display  statistics  for  block devices and all their partitions that are used by the system.  If a device name is entered on the command line, then statistics for it and all its partitions are displayed. Last,
              the ALL keyword indicates that statistics have to be displayed for all the block devices and partitions defined by the system, including those that have never been used. If option -j is defined before this  op‐
              tion, devices entered on the command line can be specified with the chosen persistent name type.

       --pretty
              Make  the Device Utilization Report easier to read by a human.  The device name will be printed on the right side. The report may also be broken into sub-reports if there are many metrics to display (use --com‐
              pact option to prevent this).

       -s     Display a short (narrow) version of the report that should fit in 80 characters wide screens.

       -t     Print the time for each report displayed. The timestamp format may depend on the value of the S_TIME_FORMAT environment variable (see below).

       -V     Print version number then exit.

       -x     Display extended statistics.

       -y     Omit first report with statistics since system boot, if displaying multiple records at given interval.

       -z     Tell iostat to omit output for any devices for which there was no activity during the sample period.

ENVIRONMENT
       The iostat command takes into account the following environment variables:

       POSIXLY_CORRECT
              When
Title: iostat Options: Device Grouping, Human-Readable Output, Persistent Device Names, and More
Summary
This section continues describing `iostat` command-line options, including options for device grouping (-g, -H), human-readable output (-h, --human, --pretty), displaying persistent device names (-j), specifying units in kilobytes or megabytes per second (-k, -m), showing device mapper names (-N), outputting in JSON format (-o), displaying statistics for devices and partitions (-p), short report format (-s), printing timestamps (-t), showing version (-V), extended statistics (-x), omitting the first report (-y), and omitting inactive devices (-z). Finally, it mentions the environment variable `POSIXLY_CORRECT`.