Return to vmstat.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/vmstat.1, revision 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" .

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