acctsh(1M) MISC. REFERENCE MANUAL PAGES acctsh(1M)
NAME
chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm,
prctmp, prdaily, prtacct, runacct, shutacct, startup, tur-
nacct - 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 argu-
ment 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
invocation of ckpacct. This feature is sensitive to the
frequency at which ckpacct is executed, usually by cron.
dodisk should be invoked by cron to perform the disk
accounting functions. By default, it will use diskusg (see
diskusg(1M)) to do disk accounting on the S5 file system in
/etc/vfstab. If the -o flag is used, it will use acctdusg
Last change: Job Accounting Utilities 1
acctsh(1M) MISC. REFERENCE MANUAL PAGES acctsh(1M)
(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 (nor-
mally /var/adm/acct/nite/ctmp created by acctcon1 (see
acctcon(1M)).
prdaily is invoked by runacct to format a report of the pre-
vious 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 specify-
ing 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 invocation 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
(tacct) file.
runacct performs the accumulation of connect, process, fee,
and disk accounting on a daily basis. It also creates sum-
maries of command usage. For more information, see
runacct(1M).
shutacct is invoked during a system shutdown to turn process
accounting off and append a "reason" record to
/var/adm/wtmp.
Last change: Job Accounting Utilities 2
acctsh(1M) MISC. REFERENCE MANUAL PAGES acctsh(1M)
startup can be invoked when the system is brought to a
multi-user state to turn process accounting on.
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 additional pacct file),
then turns accounting back on again. This procedure 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/pacctincrused if pacct gets large and during execu-
tion 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/niteworking directory
/usr/lib/acct holds all accounting commands listed in
section 1M of this manual
/var/adm/acct/sum summary directory contains information for
monacct
var/adm/acct/fiscal
fiscal reports directory
SEE ALSO
acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M),
acctprc(1M), cron(1M), diskusg(1M), fwtmp(1M), runacct(1M),
acct(4), utmp(4)
acctcom(1) in the User's Reference Manual
acct(2) in the Programmer's Reference Manual
Last change: Job Accounting Utilities 3