sar(1)                                                     sar(1)



NAME
     sar - reports system activity

SYNOPSIS
     sar [-a] [-A] [-b] [-c] [-m] [-q] [-u] [-v] [-w] [-y]
     [-ofile] t [n]

     sar [-a] [-A] [-b] [-c] [-etime] [-ffile] [-isec] [-m] [-q]
     [-stime] [-u] [-v] [-w] [-y]

ARGUMENTS
     -a   Reports use of file access system routines:
          iget/s, namei/s, dirblk/s.

     -A   Reports all data.  This option is equivalent to the -u,
          -q, -b, -w, -c, -a, -y, -v, and -m options.

     -b   Reports buffer activity:
          bread/s, bwrit/s:  transfers per second of data between
          system buffers and disk or other block devices.
          lread/s, lwrit/s:  accesses of system buffers.
          %rcache, %wcache:  cache hit ratios, for example,
          1-bread/lread.
          pread/s, pwrit/s:  transfers via raw (physical) device
          mechanism.

     -c   Reports system calls.
          scall/s:  system calls of all types.
          sread/s, swrit/s, fork/s, exec/s:  specific system
          calls.
          rchar/s, wchar/s:  characters transferred by read and
          write system calls.

     -etime
          Specifies the ending time of the report.  The format
          for time is hh[:mm[:ss]].

     -ffile
          Extracts data from the given previously-recorded file.

     -isec
          Selects records at sec second intervals.  If this
          option is not specified, all intervals found in the
          data file are reported.

     -m   Reports message and semaphore activities.
          msg/s, sema/s:  primitives per second.

     n    Specifies n intervals.  The default value for this
          option is 1.

     -ofile



January 1992                                                    1

sar(1)                                                     sar(1)



          Saves the samples in file in binary format.

     -q   Reports average queue length while occupied and
          percentage of time occupied:
          runq-sz, %runocc:  run queue of processes in memory and
          runnable.
          swpq-sz, %swpocc-:  swap queue of processes swapped out
          but ready to run.

     -stime
          Specifies the starting time of the report.  The format
          for time is hh[:mm[:ss]].

     t    Specifies t seconds.

     -u   Reports CPU utilization (the default):
          %usr, %sys, %wio, %idle:  portion of time running in
          user mode, running in system mode, idle with some
          process waiting for block I/O, and otherwise idle.

     -v   Reports status of process, inode, file, file record
          lock and file record header tables.
          proc-sz, inod-sz, file-sz, lock-sz, fhdr-sz:
          entries/size for each table, evaluated once at sampling
          point;
          proc-ov, inod-ov, file-ov:  overflows occurring between
          sampling points.

     -w   Reports system swapping and switching activity:
          swpin/s, swpot/s, bswin/s, bswot/s:  bswin/s, bswot/s:
          number of transfers and number of 512 byte units
          transferred for swapins (including initial loading of
          some programs) and swapouts;
          pswch/s:  process switches.

     -y   Reports TTY device activity:
          rawch/s, canch/s, outch/s:  input character rate, input
          character rate processed by canon, and output character
          rate.
          rcvin/s, xmtin/s, mdmin/s:  receive, transmit and modem
          interrupt rates.

DESCRIPTION
     sar, in the first instance, samples cumulative activity
     counters in the operating system at n intervals of t
     seconds.

     In the second instance, with no sampling interval specified,
     sar extracts data from a previously-recorded file, either
     the one specified by the -f option or, by default, the
     standard system activity daily data file /usr/adm/sa/sadd
     for the current day dd.



2                                                    January 1992

sar(1)                                                     sar(1)



EXAMPLES
     The command:

        sar

     shows today's CPU activity so far.  The command:

        sar -o temp 60 10

     watches CPU activity evolve for 10 minutes and saves data.

FILES
     /usr/bin/sar
          Executable file
     /usr/adm/sa/saday-of-month
          Daily data file, where day-of-month are digits
          representing the day of the month

SEE ALSO
     sag(1G)

     sadc(1M) in A/UX System Administrator's Reference

     ``System Activity Package'' in A/UX Local System
     Administration






























January 1992                                                    3