1 files changed, 93 insertions, 4 deletions
diff --git a/usr.bin/vmstat/vmstat.8 b/usr.bin/vmstat/vmstat.8
index ec6c323..6c06202 100644
--- a/usr.bin/vmstat/vmstat.8
+++ b/usr.bin/vmstat/vmstat.8
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)vmstat.8	8.1 (Berkeley) 6/6/93
-.\"	$Id: vmstat.8,v 1.8 1997/08/23 21:42:46 steve Exp $
+.\"	$Id: vmstat.8,v 1.9 1997/08/25 06:40:05 charnier Exp $
 .\"
 .Dd June 6, 1996
 .Dt VMSTAT 8
@@ -46,6 +46,8 @@
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Op Fl w Ar wait
+.Op Fl n Ar devs
+.Op Fl p Ar type,if,pass
 .Op Ar disks
 .Sh DESCRIPTION
 .Nm Vmstat
@@ -86,6 +88,76 @@ instead of the default
 .It Fl m
 Report on the usage of kernel dynamic memory listed first by size of
 allocation and then by type of usage.
+.It Fl n
+Change the maximum number of disks to display from the default of 3.
+.It Fl p
+Specify which types of devices to display.  There are three different
+categories of devices:
+
+.Bl -tag -width indent -compact
+.It device type:
+.Bl -tag -width 123456789 -compact
+.It da 
+Direct Access devices
+.It sa
+Sequential Access devices
+.It printer
+Printers
+.It proc
+Processor devices
+.It worm
+Write Once Read Multiple devices
+.It cd
+CD devices
+.It scanner
+Scanner devices
+.It optical
+Optical Memory devices
+.It changer
+Medium Changer devices
+.It comm
+Communication devices
+.It array
+Storage Array devices
+.It enclosure
+Enclosure Services devices
+.It floppy
+Floppy devices
+.El
+.Pp
+.It interface:
+.Bl -tag -width 123456789 -compact
+.It IDE
+Integrated Drive Electronics devices
+.It SCSI
+Small Computer System Interface devices
+.It other
+Any other device interface
+.El
+.Pp
+.It passthrough:
+.Bl -tag -width 123456789 -compact
+.It pass
+Passthrough devices
+.El
+.El
+.Pp
+The user must specify at least one device type, and may specify at most
+one device type from each category.  Multiple device types in a single
+device type statement must be separated by commas. 
+.Pp
+Any number of
+.Fl p
+arguments may be specified on the command line.  All
+.Fl p
+arguments are ORed together to form a matching expression against which
+all devices in the system are compared.  Any device that fully matches
+any
+.Fl p
+argument will be included in the 
+.Nm
+output, up to three devices, or the maximum number of devices specified
+by the user.
 .It Fl s
 Display the contents of the
 .Em sum
@@ -156,14 +228,25 @@ pages scanned by clock algorithm, per-second
 .It disks
 Disk operations per second (this field is system dependent).
 Typically paging will be split across the available drives.
-The header of the field is the first character of the disk name and
+The header of the field is the first two characters of the disk name and
 the unit number.
-If more than four disk drives are configured in the system,
+If more than three disk drives are configured in the system,
 .Nm
-displays only the first four drives.
+displays only the first three drives, unless the user specifies the
+.Fl n
+argument to increase the number of drives displayed.  This will probably
+cause the display to exceed 80 columns, however.
 To force
 .Nm
 to display specific drives, their names may be supplied on the command line.
+.Nm
+defaults to show disks first, and then various other random devices in the
+system to add up to three devices, if there are that many devices in the
+system.  If devices are specified on the command line, or if a device type
+matching pattern is specified (see above),
+.Nm
+will only display the given devices or the devices matching the pattern,
+and will not randomly select other devices in the system.
 .It faults
 Trap/interrupt rate averages per second over last 5 seconds.
 .Pp
@@ -195,6 +278,12 @@ seconds; this is a good choice of printing interval since this is how often
 some of the statistics are sampled in the system.
 Others vary every second and running the output for a while will make it
 apparent which are recomputed every second.
+.Pp
+The command:
+.Dl vmstat -p da -p cd -w 1
+will tell vmstat to select the first three direct access or CDROM devices
+and display statistics on those devices, as well as other systems
+statistics every second.
 .Sh FILES
 .Bl -tag -width /dev/kmemxxx -compact
 .It Pa /kernel