Home • Explore • Blog • CI
☰



man-pages
6th chunk of `iostat.man`
cbb316303800c24e73692fb8b4507083e3117662f08df66e0000000100000866
 --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 this variable is set, transfer rates are shown in 512-byte blocks instead of the default 1K blocks.

       S_COLORS
              By default statistics are displayed in color when the output is connected to a terminal.  Use this variable to change the settings. Possible values for this variable are never, always or  auto  (the  latter  is
              equivalent to the default settings).
              Please note that the color (being red, yellow, or some other color) used to display a value is not indicative of any kind of issue simply because of the color. It only indicates different ranges of values.

       S_COLORS_SGR
              Specify  the  colors and other attributes used to display statistics on the terminal.  Its value is a colon-separated list of capabilities that defaults to H=31;1:I=32;22:M=35;1:N=34;1:Z=34;22.  Supported capa‐
              bilities are:

              H=     SGR (Select Graphic Rendition) substring for percentage values greater than or equal to 75%.

              I=     SGR substring for device names.

              M=     SGR substring for percentage values in the range from 50% to
Title: iostat Options: Report Formatting, Time Display, Version, Extended Statistics, and Environment Variables
Summary
This section describes `iostat` command-line options including formatting the report for readability (--pretty), displaying a short version of the report (-s), printing timestamps (-t), showing the version number (-V), displaying extended statistics (-x), omitting the first report (-y), and omitting inactive devices (-z). It also details environment variables like POSIXLY_CORRECT for transfer rate units and S_COLORS/S_COLORS_SGR for customizing colored output.