sar(1)                                                     sar(1)



     NAME
          sar - system activity reporter

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

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

     DESCRIPTION
          sar, in the first instance, samples cumulative activity
          counters in the operating system at n intervals of t
          seconds.  If the -o flag option is specified, it saves the
          samples in file in binary format.  The default value of n is
          1.  In the second instance, with no sampling interval speci-
          fied, sar extracts data from a previously-recorded file, ei-
          ther the one specified by the -f flag option or, by default,
          the standard system activity daily data file
          /usr/adm/sa/sadd for the current day dd.  The starting and
          ending times of the report can be bounded via the -s and -e
          time arguments of the form hh[:mm[:ss]].  The -i option
          selects records at sec second intervals.  Otherwise, all in-
          tervals found in the data file are reported.

          In either case, subsets of data to be printed are specified
          by one of the following options:
          -u   Report CPU utilization (the default):
               %usr, %sys, %wio, %idle:  portion of time running in
               user mode, running in system mode, idle with some pro-
               cess waiting for block I/O, and otherwise idle.
          -b   Report 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.
          -y   Report 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.
          -c   Report 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.
          -w   Report system swapping and switching activity:



     April, 1990                                                     1

     sar(1)                                                     sar(1)



               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.
          -a   Report use of file access system routines:
               iget/s, namei/s, dirblk/s.
          -q   Report average queue length while occupied and percen-
               tage 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.
          -v   Report 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.
          -m   Report message and semaphore activities.
               msg/s, sema/s:  primitives per second.
          -A   Report all data.  Equivalent to -uqbwcayvm.

     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

          /usr/adm/sa/sadd     daily data file, where dd are digits
                               representing the day of the month

     SEE ALSO
          sag(1G), sadc(1M).
          ``System Activity Package'' in A/UX Local System Administra-
          tion.










     2                                                     April, 1990