| SA(8) | System Manager's Manual | SA(8) | 
sa —
| sa | [ -abcdDfijkKlmnqrstu]
      [-vcutoff]
      [file ...] | 
sa utility reports on, cleans up, and generally
  maintains system accounting files.
sa is able to condense the information in
    /var/account/acct into the summary files
    /var/account/savacct and
    /var/account/usracct, which contain system
    statistics according to command name and login id, respectively. This
    condensation is desirable because on a large system,
    /var/account/acct can grow by hundreds of blocks per
    day. The summary files are normally read before the accounting file, so that
    reports include all available information.
If file names are supplied, they are read instead of /var/account/acct. After each file is read, if the summary files are being updated, an updated summary will be saved to disk. Only one report is printed, after the last file is processed.
The labels used in the output indicate the following, except where otherwise specified by individual options:
aviocpcpucpkk*secrestiouThe options to sa are:
-asa places
      all names containing unprintable characters and those used only once under
      the name ``***other''.-b-c-d-D-f-v option.-i-j-k-K-l-m-n-q-r-s-t-u-v
    cutoffBy default, per-command statistics will be printed. The number of
    calls, the total elapsed time in minutes, total CPU and user time in
    minutes, average number of I/O operations, and CPU-time averaged core usage
    will be printed. If the -m option is specified,
    per-user statistics will be printed, including the user name, the number of
    commands invoked, total CPU time used (in minutes), total number of I/O
    operations, and CPU storage integral for each user. If the
    -u option is specified, the uid, user and system
    time (in seconds), CPU storage integral, I/O usage, and command name will be
    printed for each entry in the accounting data file.
If the -u flag is specified, all flags
    other than -q are ignored. If the
    -m flag is specified, only the
    -b, -d,
    -i, -k,
    -q, and -s flags are
    honored.
sa utility exits 0 on success,
  and >0 if an error occurs.
sa was written for NetBSD 1.0
  from the specification provided by various systems' manual pages. Its date of
  origin is unknown to the author.
sa
  was modeled after the original version, there are some intentional differences
  and undoubtedly some unintentional ones as well. In particular, the
  -q option has been added, and the
  -m option now understands more options than it used
  to.
The formats of the summary files created by this version of
    sa are very different than the those used by the
    original version. This is not considered a problem, however, because the
    accounting record format has changed as well (since user ids are now 32
    bits).
The field labels should be more consistent.
NetBSD's VM system does not record the CPU storage integral.
| February 25, 1994 | NetBSD 9.4 |