vmstat(C)                       19 June 1992                       vmstat(C)


 Name

    vmstat - report paging and system statistics

 Syntax

    vmstat [ -fs ] [ -n namelist ] [ -l lines ] [ interval [ count ]]

 Description

    vmstat reports some statistics kept by the system on processes, demand
    paging, and cpu and trap activity.  Three types of reports are available:

    (default)   A summary of the number of processes in various states, pag-
                ing activity, system activity, and cpu cycle consumption.

    -f          Number of fork(S)s done.

    -s          A verbose listing of paging and trap activity.

    If no interval or count is specified, the totals since system bootup are
    displayed.

    If an interval is given, the number of events that have occurred in the
    last interval seconds is shown.  If no count is specified, this display
    is repeated forever every interval seconds.  Otherwise, when a count is
    also specified, the information is displayed count times.

    Other flags that may be specified include:

    -n namelist Use file namelist as an alternate symbol table instead of
                /unix.

    -l lines    For the default display, repeat the header every lines
                reports (default is 20).

    The fields in the default report are:

    procs       The number of processes which are:

                r     In the run queue.
                b     Blocked waiting for resources.
                w     Swapped out.

                These values always reflect the current situation, even if
                the totals since boot are being displayed.

    paging      Reports on the performance of the demand paging system.
                Unless the totals since boot are being displayed, this infor-
                mation is averaged over the preceding interval seconds:

                frs   Free swap space.
                dmd   Demand zero and demand fill pages.
                sw    Pages on swap.
                cch   Pages in cache.
                fil   Pages on file.
                pft   Protection faults.
                frp   Pages freed.
                pos   Processes swapped out successfully.
                pif   Processes swapped out unsuccessfully.
                rso   Regions swapped out.
                rsi   Regions swapped in.

    system      Reports on the general system activity.  Unless the totals
                since boot are being shown, these figures are averaged over
                the last interval seconds:

                sy    Number of system calls.
                cs    Number of context switches.

    cpu         Percentage of cpu cycles spent in various operating modes:

                us    User.
                su    System.
                id    Idle.

    The -f and -s reports are a series of lines of the form:

       number description

    which means that number of the items described by description happened
    (either since boot or in the last interval seconds, as appropriate).
    These reports should be self-explanatory.

 Files


    /unix       Default namelist.
    /dev/kmem   Default source of statistics.

 See also

    fork(S), ps(C), pstat(C)

 Authorization

    The behavior of this utility is affected by assignment of the mem author-
    ization.  If you do not have this authorization, the command will not
    work.  Refer to the ``Using a secure system'' chapter of the User's Guide
    for more details.

 Value added

    vmstat is an extension of AT&T System V provided by The Santa Cruz Opera-
    tion, Inc.