Return to vmstat.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / vmstat

Annotation of 43BSDReno/usr.bin/vmstat/vmstat.1, revision 1.1

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

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