HPUX acctsh[1m]
acctsh(1M) acctsh(1M)
NAME
chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp,
prdaily, prtacct, 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 [-l] [-c] [-mmdd] [-l] [-c]
[-mmdd]]
/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 /usr/adm/fee, to be merged with other accounting
records during the night.
ckpacct should be initiated via cron(1M). It periodically checks the
size of /usr/adm/pacct. If the size exceeds blocks, 1000 by default,
turnacct is invoked with argument switch. If the number of free disk
blocks in the /usr file system falls below 500, ckpacct automatically
turns off the collection of process accounting records via the off
argument to turnacct. When at least this number of blocks is
restored, the accounting will be activated again. 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 do disk accounting on the special
files in /etc/checklist. If the -o flag is used, it does a slower
version of disk accounting by login directory. files specifies the
one or more filesystem names where disk accounting is to be done. If
Hewlett-Packard Company - 1 - HP-UX Release 9.0: August 1992
acctsh(1M) acctsh(1M)
files is used, disk accounting will be done on these filesystems only.
If the -o flag is used, files should be mount points of mounted
filesystem. If omitted, they should be the special file names of
mountable filesystems.
lastlogin is invoked by runacct (see runacct(1M)) to update
/usr/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 through12). This default is
useful if monacct is to executed via cron(1M) on the first day of each
month. monacct creates summary files in /usr/adm/acct/fiscal and
restarts summary files in /usr/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
/usr/adm/acct/nite/ctmp created by acctcon1 (see acctcon(1M)).
prdaily is invoked by runacct (see runacct(1M)) to format a report of
the previous day's accounting data. The report resides in
/usr/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 specifed
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 can be used on
current day's accounting data only.
prtacct can be used to format and print any total accounting (tacct)
file.
shutacct should be invoked during a system shutdown (usually in
/etc/shutdown) to turn process accounting off and append a ``reason''
record to /etc/wtmp.
startup should be called by /etc/rc to turn the accounting on whenever
the system is brought up.
turnacct is an interface to accton (see acct(1M)) to turn process
accounting on or off. The switch argument turns accounting off, moves
the current /usr/adm/pacct to the next free name in /usr/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.
Hewlett-Packard Company - 2 - HP-UX Release 9.0: August 1992
acctsh(1M) acctsh(1M)
FILES
/usr/lib/acct holds all accounting commands listed in
section (1M) of this manual
/usr/adm/fee accumulator for fees
/usr/adm/acct/nite working directory
/usr/adm/pacct current file for per-process accounting
/usr/adm/pacct* used if pacct gets large and during
execution of daily accounting procedure
/usr/lib/acct/ptecms.awk contains the limits for exceptional
usage by command name
/usr/lib/acct/ptelus.awk contains the limits for exceptional
usage by login id
/usr/adm/acct/sum summary directory, should be saved
/etc/wtmp login/logoff summary
SEE ALSO
acct(1M), acctcms(1M), acctcom(1M), acctcon(1M), acctmerg(1M),
acctprc(1M), cron(1M), diskusg(1M), fwtmp(1M), runacct(1M), acct(2),
acct(4), utmp(4).
STANDARDS CONFORMANCE
chargefee: SVID2
ckpacct: SVID2
dodisk: SVID2
lastlogin: SVID2
monacct: SVID2
prctmp: SVID2
prdaily: SVID2
prtacct: SVID2
shutacct: SVID2
startup: SVID2
turnacct: SVID2 acctsh.1m .
Hewlett-Packard Company - 3 - HP-UX Release 9.0: August 1992