--- cci/usr/src/man/man1/vmstat.1	2019/07/28 12:24:19	1.1.1.1
+++ cci/usr/src/man/man1/vmstat.1	2019/07/28 12:26:40	1.1.1.2
@@ -13,43 +13,77 @@ vmstat \- report virtual memory statisti
 .SH SYNOPSIS
 .B vmstat
 [
-.B \-fs
+.B \-01rfs
 ]
 [ interval [ count ] ]
 .SH DESCRIPTION
 .I Vmstat
 delves into the system and normally reports certain statistics kept about
 process, virtual memory, disk, trap and cpu activity.
-If given a
+.PP
+The POWER 6/32 can support up to 32 disk drives.  
+.I Vmstat
+can only display 16 drives at one time.
+The 
+.B \-0
+argument will display the first 16 mounted disk drives, and the
+.B \-1
+argument will display the second 16 mounted disk drives. 
+These options take effect only if the system has more
+than 16 mounted drives.
+The
+.B \-0
+argument is the default.  
+Any time during the display, you can type in
+a 0, 1 or r to change the display.
+.PP
+The
+.B \-r
+argument, switches between displaying the first and second
+16 mounted disk drives, i.e., 
+it switches back and forth between the 0 and 1 options.
+This option takes effect only if the system has more
+than 16 mounted drives.
+The duration for each set of drives will be [interval]/2.
+.PP
+If given an
 .B \-f
-argument, it instead reports on the number of
+argument, 
+.I vmstat
+reports on the number of
 .I forks
 and
 .I vforks
-since system startup and the number of pages of virtual memory involved in each
+since system startup and the number 
+of pages of virtual memory involved in each
 kind of fork.
 If given a
 .B \-s
 argument, it instead prints the contents
 of the
 .I sum
-structure, giving the total number of several kinds of paging related
+structure, giving the total number 
+of several kinds of paging related
 events which have occurred since boot.
 .PP
 If none of these options are given,
 .I vmstat
-will report in the first line a summary of the virtual memory activity 
+will report in the first line a summary 
+of the virtual memory activity 
 since the system has been booted.
 If
 .I interval
-is specified, then successive lines are summaries over the last
+is specified, then successive lines 
+are summaries over the last
 .I interval
 seconds.
-``vmstat 5'' will print what the system is doing every five 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, running the output for a while will make it apparent which
-are recomputed every second.
+``vmstat 5'' will print what the system
+is doing every five 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.  Running the output for a while will make it
+apparent which statistics are recomputed every second.
 If a
 .I count
 is given, the statistics are repeated
@@ -66,8 +100,9 @@ b	blocked for resources (i/o, paging, et
 w	runnable or short sleeper (< 20 secs) but swapped
 .fi
 .s1
-Memory: information about the usage of virtual and real memory.
-Virtual pages are considered active if they belong to processes which
+Memory: information about the usage of 
+virtual and real memory.  Virtual pages 
+are considered active if they belong to processes which
 are running or have run in the last 20 seconds.
 A ``page'' here is 1024 bytes.
 .s1
@@ -78,11 +113,14 @@ fre	size of the free list
 .fi
 .s1
 Page: information about page faults and paging activity.
-These are averaged each five seconds, and given in units per second.
+These are averaged each five seconds, 
+and given in units per second.
 .s1
 .t1
 .nf
-re	page reclaims (simulating reference bits)
+re	page reclaims less the free lists in the swap 
+	devices and the file system
+at	pages of free lists in the swap devices and the file system
 pi	pages paged in
 po	pages paged out
 fr	pages freed per second
@@ -90,8 +128,10 @@ de	anticipated short term memory shortfa
 sr	pages scanned by clock algorithm, per-second
 .fi
 .s1
-up/hp/rk: Disk operations per second (this field is system dependent).
-Typically paging will be split across several of the available drives.
+x/f/s: Disk operations per second (this 
+field is system dependent).
+Typically paging will be split across 
+several of the available drives.
 The number under each of these is the unit number.
 .s1
 Faults: trap/interrupt rate averages per second over last 5 seconds.