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 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,
bfsdiskusg, sfsdiskusg, vxdiskusg, and ufsdiskusg [see
diskusg(1M)] to do disk accounting on the S5, bfs, sfs, vxfs,
and ufs file systems in /etc/vfstab and acctdusg [see
acct(1M)] on other file systems. Note that when dodisk uses
/etc/vfstab, it will skip remote resources. If the -o flag is
used, it will use acctdusg [see acct(1M)] to do a slower
version of disk accounting by login directory for all file
systems. files specifies the one or more file system names
Copyright 1994 Novell, Inc. Page 1
acctsh(1M) acctsh(1M)
where disk accounting will be done. If files are used, disk
accounting will be done on these file systems only. If the -o
flag is used, files should be mount points of mounted file
systems. If the -o option is omitted, files should be the
special file names of mountable file systems.
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 be 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/rprtmmdd 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 specifying 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
summaries of command usage. For more information, see
runacct(1M).
Copyright 1994 Novell, Inc. Page 2
acctsh(1M) acctsh(1M)
shutacct is invoked during a system shutdown to turn process
accounting off and append a ``reason'' record to
/var/adm/wtmp.
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/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 of this manual
/var/adm/acct/sum summary directory contains information for
monacct
Copyright 1994 Novell, Inc. Page 3
acctsh(1M) acctsh(1M)
var/adm/acct/fiscal
fiscal reports directory
REFERENCES
acct(1M), acct(2), acct(4), acctcms(1M), acctcom(1),
acctcon(1M), acctmerg(1M), acctprc(1M), cron(1M), diskusg(1M),
fwtmp(1M), runacct(1M), utmp(4)
Copyright 1994 Novell, Inc. Page 4