acctsh(1M) acctsh(1M)
NAME
acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm,
prctmp, prdaily, prtacct, runacct, shutacct, startup, turnacct - shell
procedures for accounting
SYNOPSIS
/usr/lib/acct/chargefee login-name number
/usr/lib/acct/ckpacct [blocks]
/usr/lib/acct/dodisk [-o] [files ...]
/usr/lib/acct/lastlogin
/usr/lib/acct/monacct number
/usr/lib/acct/nulladm file
/usr/lib/acct/prctmp
/usr/lib/acct/prdaily [-l] [-c] [mmdd]
/usr/lib/acct/prtacct file ["heading"]
/usr/lib/acct/runacct [mmdd] [mmdd state]
/usr/lib/acct/shutacct ["reason"]
/usr/lib/acct/startup
/usr/lib/acct/turnacct on | off | switch
DESCRIPTION
chargefee can be invoked to charge a number of units to login-name. A
record is written to /var/adm/fee, to be merged with other accounting
records by runacct.
ckpacct should be initiated via cron(1M) to periodically check the
size of /var/adm/pacct. If the size exceeds blocks, 1000 by default,
turnacct will be invoked with argument switch. If the number of free
disk blocks in the /var file system falls below 500, ckpacct will
automatically turn off the collection of process accounting records
via the off argument to turnacct. When at least 500 blocks are
restored, the accounting will be activated again on the next invoca-
tion of ckpacct. This feature is sensitive to the frequency at which
ckpacct is executed, usually by cron.
Page 1 Reliant UNIX 5.44 Printed 11/98
acctsh(1M) acctsh(1M)
dodisk should be invoked by cron to perform the disk accounting func-
tions. If the -o flag is used, it will use acctdusg [see acct(1M)] to
do a slower version of disk accounting by login directory. files
specifies the one or more filesystem names where disk accounting will
be done. If files are used, disk accounting will be done on these
filesystems only. If the -o flag is used, files should be mount points
of mounted filesystems. If the -o option is omitted, files should be
the special file names of mountable filesystems.
lastlogin is invoked by runacct to update /var/adm/acct/sum/loginlog,
which shows the last date on which each person logged in.
monacct should be invoked once each month or each accounting period.
number indicates which month or period it is. If number is not given,
it defaults to the current month (01-12). This default is useful if
monacct is to executed via cron(1M) on the first day of each month.
monacct creates summary files in /var/adm/acct/fiscal and restarts the
summary files in /var/adm/acct/sum.
nulladm creates file with mode 664 and ensures that owner and group
are adm. It is called by various accounting shell procedures.
prctmp can be used to print the session record file (normally
/var/adm/acct/nite/ctmp created by acctcon1 [see acctcon(1M)].
prdaily is invoked by runacct to format a report of the previous day's
accounting data. The report resides in /var/adm/acct/sum/rprt/mmdd
where mmdd is the month and day of the report. The current daily
accounting reports may be printed by typing prdaily. Previous days'
accounting reports can be printed by using the mmdd option and speci-
fying the exact report date desired. The -l flag prints a report of
exceptional usage by login id for the specified date. Previous daily
reports are cleaned up and therefore inaccessible after each invoca-
tion of monacct. The -c flag prints a report of exceptional resource
usage by command, and may be used on current day's accounting data
only.
prtacct can be used to format and print any total accounting (binary)
file.
runacct performs the accumulation of connect, process, fee, and disk
accounting on a daily basis. It also creates summaries of command
usage. For more information, see runacct(1M).
shutacct is invoked during a system shutdown to turn process account-
ing off and append a "reason" record to /var/adm/wtmp.
startup can be invoked when the system is brought to a multiuser state
to turn process accounting on.
Page 2 Reliant UNIX 5.44 Printed 11/98
acctsh(1M) acctsh(1M)
turnacct is an interface to accton [see acct(1M)] to turn process
accounting on or off. The switch argument moves the current
/var/adm/pacct to the next free name in /var/adm/pacctincr (where incr
is a number starting with 1 and incrementing by one for each addi-
tional pacct file), then turns accounting back on again. This pro-
cedure is called by ckpacct and thus can be taken care of by the cron
and used to keep pacct to a reasonable size. shutacct uses turnacct to
stop process accounting. startup uses turnacct to start process
accounting.
FILES
/var/adm/fee
accumulator for fees
/var/adm/pacct
current file for per-process accounting
/var/adm/pacctincr
used if pacct gets large and during execution of daily accounting
procedure
/var/adm/wtmp
login/logoff summary
/usr/lib/acct/ptelus.awk
contains the limits for exceptional usage by login ID
/usr/lib/acct/ptecms.awk
contains the limits for exceptional usage by command name
/var/adm/acct/nite
working directory
/usr/lib/acct
holds all accounting commands listed in section 1M
/var/adm/acct/sum
summary directory contains information for monacct
var/adm/acct/fiscal
fiscal reports directory
SEE ALSO
acctcom(1), acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M),
acctprc(1M), cron(1M), fwtmp(1M), runacct(1M), acct(2), acct(4),
utmp(4).
Page 3 Reliant UNIX 5.44 Printed 11/98