Home | History | Annotate | Download | only in iostat
History log of /src/usr.sbin/iostat/iostat.8
RevisionDateAuthorComments
 1.30  28-Jul-2023  wiz ostat: use standard option order (AaBb...)

Fix macro usage while here
 1.29  28-Jul-2023  mrg add iostat -X option, limited alternative statistics.

this is like the "-D" option, except it skips the xfers/s, and
reports MB/s instead of KB/s. allows for far more devices to
be displayed per line by default (about 50% more.)
 1.28  18-Jun-2022  kre Significant changes to output layout methods - except for -x and -y
which have not (yet) been touched (-xD needs *serious* improvements).

While this still has no run-time configurability, it is now easy to
adjust the column widths in the source and recompile. Dynamic (auto)
column width sizing is probably out of the question (requires predicting
the future) but options to allow the widths to be set isn't out of the
question.

The columns are now (mostly) considerably wider than they were before,
hence wider windows are needed to view the same info. In an 80
column window the default display (with tty & cpu included) displays
just 2 drives. 160 columns will fit 7 (but with -I, just 4).

One new option added (-z) suppresses output which is true 0 (but still
prints 0 for values rounded down to 0) for everything except tty stats.
For drive output, the drive must have done nothing during the interval
to get its output data blanked.

Also options -H h -W w to set the output size (page height & width), the
former used to decide when to print headers, and the latter to calculate
the number of drives to print when no drive names were given. Env vars
LINES and COLUMNS are used if the options are not given, with fallback
to the terminal size (if output is to a terminal, and its sizes are
known), and if all else fails, 20 lines, 80 columns. Specifying 0
means unlimited (infinite). So "iostat -W 0" will show all of the
drives, across one (often very) long line. Wedges count as drives.

When drives are specified, the output will now appear in the order they were
given on the command line, rather than the order the system discovered them
during auto-configuration. If specified as an fnmatch(3) pattern, drives that
match will appear in auto-conf order, but that's generally what is wanted.
When none are specified, you still get the first N (however many fits based
upon the options selected) in auto-conf order (usually useless, more so now
given that less will fit).

Lastly, for those who looked at the patch I sent to current-users@
and were horrified at how kludgey it was, rest assured, that was just
a quick hack to demonstrate what the output format changes would look
like. This version (I hope) is not nearly so disgusting.
 1.27  29-Jul-2018  wiz Fix mandoc warnings.
 1.26  29-Jul-2018  sevan Document "in" field in CPU section
Fix ps(1) Xr raised by mandoc -Tlint
 1.25  05-Mar-2017  mlelstv branches: 1.25.10; 1.25.12;
Enhance disk metrics by calculating a weighted sum that is incremented
by the number of concurrent I/O requests. Also introduce a new disk_wait()
function to measure requests waiting in a bufq.
iostat -y now reports data about waiting and active requests.

So far only drivers using dksubr and dk, ccd, wd and xbd collect data about
waiting requests.
 1.24  09-Jul-2015  mrg branches: 1.24.2; 1.24.4;
support fnmatch(3) patterns for disknames. eg, "iostat wd*" works now.
update the default disk number selection to note that it uses the current
terminal size to fit disks, not hard coded 4.
 1.23  11-Jun-2014  joerg branches: 1.23.2;
Remove KVM related options.
 1.22  07-Aug-2003  agc branches: 1.22.60; 1.22.72;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22366, verified by myself.
 1.21  01-May-2003  wiz Increase width now we mention flag arguments.
 1.20  01-May-2003  jmmv In the options list, show which ones require an argument.
New sentence, new line.
 1.19  17-Mar-2003  wiz Bump date for recent change.
 1.18  01-Mar-2003  enami Sync with the behaviour change.
 1.17  01-Nov-2002  mrg iostat(8) and systat(8) support for separate read/write disk statistics.
"iostat -x" now shows these (ala linux/solaris), but this is only splitting
the read/write bytes/transactions, not adding any new metrics. "systat
iostat" now has two new commands to switch between combined/separate mode
for both it's numbers & bar modes.
 1.16  08-Jul-2001  wiz Uppercase cpu.
 1.15  06-May-2001  wiz Change xref for vmstat(8) to vmstat(1).
Whitespace, punctuation and spelling fixes while I'm here.
 1.14  22-Mar-1999  garbled More and more .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.
 1.13  25-Aug-1998  lukem * implement -x; extended disk statistics. option inspired by solaris' iostat.
* fix a few typos
* a bit of KNF and egcs cleanup
* add a HISTORY (hopefully correct)
 1.12  17-Oct-1997  lukem WARNSify
 1.11  08-Mar-1997  mouse alternate -> alternative, per PR 2643
 1.10  25-Oct-1996  scottr `Kb' means kilobits, `Mb' means megabits. Since we're talking about bytes,
not bits, use the uppercase `B' when reporting statistics, and be explicit
about it where appropriate. Noticed by J.T.
 1.9  10-May-1996  thorpej New userland code to read the statistics kept by the NetBSD generic
disk framework, from John M. Vinopal <banshee@gabriella.resort.com>
 1.8  28-Nov-1995  thorpej New-style RCS ids.
 1.7  27-Sep-1995  jtc vmstat is in section 8; PR #1532
 1.6  14-May-1994  cgd clean up import. that was weird.
 1.5  06-Oct-1993  jtc Got bored, converted to use mandoc macros.
 1.4  01-Aug-1993  mycroft Add RCS indentifiers.
 1.3  13-Jun-1993  mycroft Fix up FILES sections.
 1.2  13-Jun-1993  mycroft Update file names.
 1.1  09-Apr-1993  cgd branches: 1.1.1;
added accton, edquota, flcopy, gettable, htable, iostat, quotaon,
repquota, trpt, and trsp, per (currently alpha) patch 125.
 1.1.1.1  14-May-1994  cgd new iostat from Lite
 1.22.72.1  10-Aug-2014  tls Rebase.
 1.22.60.1  20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.23.2.1  08-Nov-2015  riz Pull up following revision(s) (requested by mrg in ticket #1016):
usr.sbin/iostat/iostat.c: revision 1.62
usr.sbin/iostat/iostat.c: revision 1.63
usr.sbin/iostat/iostat.8: revision 1.24
support fnmatch(3) patterns for disknames. eg, "iostat wd*" works now.
update the default disk number selection to note that it uses the current
terminal size to fit disks, not hard coded 4.
extend the "tout" column to 5 characters, it's really common on a modern
machine to have eg, build output way more than 9999 chars/sec.
this doesn't affect the default disk list on an 80-char wide screen.
 1.24.4.1  21-Apr-2017  bouyer Sync with HEAD
 1.24.2.1  20-Mar-2017  pgoyette Sync with HEAD
 1.25.12.1  10-Jun-2019  christos Sync with HEAD
 1.25.10.1  06-Sep-2018  pgoyette Sync with HEAD

Resolve a couple of conflicts (result of the uimin/uimax changes)

RSS XML Feed