BSD 4_2 development

Work on file usr/man/man1/vmstat.1

Synthesized-from: CSRG/cd1/4.2

diff --git a/usr/man/man1/vmstat.1 b/usr/man/man1/vmstat.1
new file mode 100644 (file)
index 0000000..3d44c56
--- /dev/null
+++ b/usr/man/man1/vmstat.1
@@ -0,0 +1,125 @@
+.TH VMSTAT 1 "26 April 1981"
+.de s1
+.if n .sp
+.if t .sp .1i
+..
+.de t1
+.if n .ta 5n
+.if t .ta 1i
+..
+.UC 4
+.SH NAME
+vmstat \- report virtual memory statistics
+.SH SYNOPSIS
+.B vmstat
+[
+.B \-fs
+]
+[ 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
+.B \-f
+argument, it instead reports on the number of
+.I forks
+and
+.I vforks
+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
+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 
+since the system has been booted.
+If
+.I interval
+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.
+If a
+.I count
+is given, the statistics are repeated
+.I count
+times.
+The format fields are:
+.PP
+Procs: information about numbers of processes in various states.
+.s1
+.t1
+.nf
+r      in run queue
+b      blocked for resources (i/o, paging, etc.)
+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
+are running or have run in the last 20 seconds.
+A ``page'' here is 1024 bytes.
+.s1
+.t1
+.nf
+avm    active virtual pages
+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.
+.s1
+.t1
+.nf
+re     page reclaims (simulating reference bits)
+pi     pages paged in
+po     pages paged out
+fr     pages freed per second
+de     anticipated short term memory shortfall
+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.
+The number under each of these is the unit number.
+.s1
+Faults: trap/interrupt rate averages per second over last 5 seconds.
+.s1
+.t1
+.nf
+in     (non clock) device interrupts per second
+sy     system calls per second
+cs     cpu context switch rate (switches/sec)
+.fi
+.s1
+Cpu: breakdown of percentage usage of CPU time
+.s1
+.nf
+us     user time for normal and low priority processes
+sy     system time
+id     cpu idle
+.SH FILES
+/dev/kmem, /vmunix
+.SH SEE ALSO
+The sections starting with ``Interpreting system activity'' in
+.IR "Installing and Operating 4.2bsd" .
+.SH AUTHORS
+William Joy and Ozalp Babaoglu
+.SH BUGS
+There should be a screen oriented program which combines
+.I vmstat
+and
+.IR ps (1)
+in real time
+as well as reporting on other system activity.