4.3BSD beta release manual page
[unix-history] / usr / src / usr.sbin / iostat / iostat.8
index 9f68473..a1d24b2 100644 (file)
@@ -2,20 +2,22 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
-.\"    @(#)iostat.8    5.1 (Berkeley) %G%
+.\"    @(#)iostat.8    6.1 (Berkeley) %G%
 .\"
 .\"
-.TH IOSTAT 1 "18 January 1983"
+.TH IOSTAT 1 ""
 .UC 4
 .SH NAME
 iostat \- report I/O statistics
 .SH SYNOPSIS
 .B iostat
 .UC 4
 .SH NAME
 iostat \- report I/O statistics
 .SH SYNOPSIS
 .B iostat
+[ drives ]
 [ interval [ count ] ]
 .SH DESCRIPTION
 .I Iostat
 [ interval [ count ] ]
 .SH DESCRIPTION
 .I Iostat
-iteratively reports the number of characters read and written to terminals,
-and, for each disk, the number of seeks transfers per second, kilobytes
-transfered per second,
+iteratively reports the number of characters read and written to terminals
+per second,
+and, for each disk, the number of transfers per second, kilobytes
+transferred per second,
 and the milliseconds per average seek.
 It also gives the percentage of time the system has
 spent in user mode, in user mode running low priority (niced) processes,
 and the milliseconds per average seek.
 It also gives the percentage of time the system has
 spent in user mode, in user mode running low priority (niced) processes,
@@ -45,6 +47,17 @@ subsequent report is for the last interval only.
 The optional
 .I count
 argument restricts the number of reports.
 The optional
 .I count
 argument restricts the number of reports.
+.PP
+If more than 4 disk drives are configured in the system,
+.I iostat
+displays only the first 4 drives, with priority given
+to Massbus disk drives (i.e. if both Unibus and Massbus
+drives are present and the total number of drives exceeds
+4, then some number of Unibus drives will not be displayed
+in favor of the Massbus drives).  To force
+.I iostat
+to display specific drives, their names may be supplied on
+the command line.
 .SH FILES
 /dev/kmem
 .br
 .SH FILES
 /dev/kmem
 .br