Annotation of 43BSDTahoe/man/man1/vmstat.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)vmstat.1    6.4 (Berkeley) 2/27/88
                      6: .\"
                      7: .TH VMSTAT 1 "February 27, 1988"
                      8: .UC 4
                      9: .de s1
                     10: .if n .sp
                     11: .if t .sp .1i
                     12: ..
                     13: .de t1
                     14: .if n .ta 5n
                     15: .if t .ta 1i
                     16: ..
                     17: .SH NAME
                     18: vmstat \- report virtual memory statistics
                     19: .SH SYNOPSIS
                     20: .B vmstat
                     21: [
                     22: .B \-fsim
                     23: ]
                     24: [ drives ]
                     25: [ interval [ count ] ]
                     26: .SH DESCRIPTION
                     27: .I Vmstat
                     28: delves into the system and normally reports certain statistics kept about
                     29: process, virtual memory, disk, trap and cpu activity.
                     30: If given a
                     31: .B \-f
                     32: argument, it instead reports on the number of
                     33: .I forks
                     34: and
                     35: .I vforks
                     36: since system startup and the number of pages of virtual memory involved in each
                     37: kind of fork.
                     38: If given a
                     39: .B \-s
                     40: argument, it instead prints the contents
                     41: of the
                     42: .I sum
                     43: structure, giving the total number of several kinds of paging related
                     44: events which have occurred since boot.
                     45: If given a
                     46: .B \-i
                     47: argument, it instead reports on the number of
                     48: .I interrupts
                     49: taken by each device since system startup.
                     50: If given a
                     51: .B \-m
                     52: argument, it instead reports on the usage of
                     53: kernel dynamic memory listed first by 
                     54: .I size
                     55: of allocation and then by
                     56: .I type
                     57: of usage.
                     58: .PP
                     59: If none of these options are given,
                     60: .I vmstat
                     61: will report in the first line a summary of the virtual memory activity 
                     62: since the system has been booted.
                     63: If
                     64: .I interval
                     65: is specified, then successive lines are summaries over the last
                     66: .I interval
                     67: seconds.
                     68: ``vmstat 5'' will print what the system is doing every five seconds;
                     69: this is a good choice of printing interval since this is how often
                     70: some of the statistics are sampled in the system; others vary every
                     71: second, running the output for a while will make it apparent which
                     72: are recomputed every second.
                     73: If a
                     74: .I count
                     75: is given, the statistics are repeated
                     76: .I count
                     77: times.
                     78: The format fields are:
                     79: .PP
                     80: Procs: information about numbers of processes in various states.
                     81: .s1
                     82: .t1
                     83: .nf
                     84: r      in run queue
                     85: b      blocked for resources (i/o, paging, etc.)
                     86: w      runnable or short sleeper (< 20 secs) but swapped
                     87: .fi
                     88: .s1
                     89: Memory: information about the usage of virtual and real memory.
                     90: Virtual pages are considered active if they belong to processes which
                     91: are running or have run in the last 20 seconds.
                     92: A ``page'' here is 1024 bytes.
                     93: .s1
                     94: .t1
                     95: .nf
                     96: avm    active virtual pages
                     97: fre    size of the free list
                     98: .fi
                     99: .s1
                    100: Page: information about page faults and paging activity.
                    101: These are averaged each five seconds, and given in units per second.
                    102: .s1
                    103: .t1
                    104: .nf
                    105: re     page reclaims (simulating reference bits)
                    106: at     pages attached (found in free list)
                    107: pi     pages paged in
                    108: po     pages paged out
                    109: fr     pages freed per second
                    110: de     anticipated short term memory shortfall
                    111: sr     pages scanned by clock algorithm, per-second
                    112: .fi
                    113: .s1
                    114: up/hp/rk/ra: Disk operations per second (this field is system dependent).
                    115: Typically paging will be split across several of the available drives.
                    116: The number under each of these is the unit number.
                    117: .s1
                    118: Faults: trap/interrupt rate averages per second over last 5 seconds.
                    119: .s1
                    120: .t1
                    121: .nf
                    122: in     (non clock) device interrupts per second
                    123: sy     system calls per second
                    124: cs     cpu context switch rate (switches/sec)
                    125: .fi
                    126: .s1
                    127: Cpu: breakdown of percentage usage of CPU time
                    128: .s1
                    129: .nf
                    130: us     user time for normal and low priority processes
                    131: sy     system time
                    132: id     cpu idle
                    133: .fi
                    134: .PP
                    135: If more than 4 disk drives are configured in the system,
                    136: .I vmstat
                    137: displays only the first 4 drives, with priority given
                    138: to Massbus disk drives (i.e. if both Unibus and Massbus
                    139: drives are present and the total number of drives exceeds
                    140: 4, then some number of Unibus drives will not be displayed
                    141: in favor of the Massbus drives).  To force
                    142: .I vmstat
                    143: to display specific drives, their names may be supplied on
                    144: the command line.
                    145: .SH FILES
                    146: /dev/kmem, /vmunix
                    147: .SH SEE ALSO
                    148: .IR systat (1),
                    149: .IR iostat (1)
                    150: .PP
                    151: The sections starting with ``Interpreting system activity'' in
                    152: .IR "Installing and Operating 4.2bsd" .

unix.superglobalmegacorp.com

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