Annotation of cci/usr/src/man/man1/vmstat.1, revision 1.1.1.1

1.1       root        1: .TH VMSTAT 1 "26 April 1981"
                      2: .de s1
                      3: .if n .sp
                      4: .if t .sp .1i
                      5: ..
                      6: .de t1
                      7: .if n .ta 5n
                      8: .if t .ta 1i
                      9: ..
                     10: .UC 4
                     11: .SH NAME
                     12: vmstat \- report virtual memory statistics
                     13: .SH SYNOPSIS
                     14: .B vmstat
                     15: [
                     16: .B \-fs
                     17: ]
                     18: [ interval [ count ] ]
                     19: .SH DESCRIPTION
                     20: .I Vmstat
                     21: delves into the system and normally reports certain statistics kept about
                     22: process, virtual memory, disk, trap and cpu activity.
                     23: If given a
                     24: .B \-f
                     25: argument, it instead reports on the number of
                     26: .I forks
                     27: and
                     28: .I vforks
                     29: since system startup and the number of pages of virtual memory involved in each
                     30: kind of fork.
                     31: If given a
                     32: .B \-s
                     33: argument, it instead prints the contents
                     34: of the
                     35: .I sum
                     36: structure, giving the total number of several kinds of paging related
                     37: events which have occurred since boot.
                     38: .PP
                     39: If none of these options are given,
                     40: .I vmstat
                     41: will report in the first line a summary of the virtual memory activity 
                     42: since the system has been booted.
                     43: If
                     44: .I interval
                     45: is specified, then successive lines are summaries over the last
                     46: .I interval
                     47: seconds.
                     48: ``vmstat 5'' will print what the system is doing every five seconds;
                     49: this is a good choice of printing interval since this is how often
                     50: some of the statistics are sampled in the system; others vary every
                     51: second, running the output for a while will make it apparent which
                     52: are recomputed every second.
                     53: If a
                     54: .I count
                     55: is given, the statistics are repeated
                     56: .I count
                     57: times.
                     58: The format fields are:
                     59: .PP
                     60: Procs: information about numbers of processes in various states.
                     61: .s1
                     62: .t1
                     63: .nf
                     64: r      in run queue
                     65: b      blocked for resources (i/o, paging, etc.)
                     66: w      runnable or short sleeper (< 20 secs) but swapped
                     67: .fi
                     68: .s1
                     69: Memory: information about the usage of virtual and real memory.
                     70: Virtual pages are considered active if they belong to processes which
                     71: are running or have run in the last 20 seconds.
                     72: A ``page'' here is 1024 bytes.
                     73: .s1
                     74: .t1
                     75: .nf
                     76: avm    active virtual pages
                     77: fre    size of the free list
                     78: .fi
                     79: .s1
                     80: Page: information about page faults and paging activity.
                     81: These are averaged each five seconds, and given in units per second.
                     82: .s1
                     83: .t1
                     84: .nf
                     85: re     page reclaims (simulating reference bits)
                     86: pi     pages paged in
                     87: po     pages paged out
                     88: fr     pages freed per second
                     89: de     anticipated short term memory shortfall
                     90: sr     pages scanned by clock algorithm, per-second
                     91: .fi
                     92: .s1
                     93: up/hp/rk: Disk operations per second (this field is system dependent).
                     94: Typically paging will be split across several of the available drives.
                     95: The number under each of these is the unit number.
                     96: .s1
                     97: Faults: trap/interrupt rate averages per second over last 5 seconds.
                     98: .s1
                     99: .t1
                    100: .nf
                    101: in     (non clock) device interrupts per second
                    102: sy     system calls per second
                    103: cs     cpu context switch rate (switches/sec)
                    104: .fi
                    105: .s1
                    106: Cpu: breakdown of percentage usage of CPU time
                    107: .s1
                    108: .nf
                    109: us     user time for normal and low priority processes
                    110: sy     system time
                    111: id     cpu idle
                    112: .SH FILES
                    113: /dev/kmem, /vmunix
                    114: .SH SEE ALSO
                    115: The sections starting with ``Interpreting system activity'' in
                    116: .IR "Installing and Operating 4.2bsd" .
                    117: .SH AUTHORS
                    118: William Joy and Ozalp Babaoglu
                    119: .SH BUGS
                    120: There should be a screen oriented program which combines
                    121: .I vmstat
                    122: and
                    123: .IR ps (1)
                    124: in real time
                    125: as well as reporting on other system activity.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.