System Administration Commands acctsh(1M)
NAME
acctsh, chargefee, ckpacct, dodisk, lastlogin, monacct, nul-
ladm, 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] [filename]...
/usr/lib/acct/lastlogin
/usr/lib/acct/monacct number
/usr/lib/acct/nulladm filename...
/usr/lib/acct/prctmp filename
/usr/lib/acct/prdaily [-c] [-l] [mmdd]
/usr/lib/acct/prtacct filename ['' heading '']
/usr/lib/acct/shutacct ['' reason '']
/usr/lib/acct/startup
/usr/lib/acct/turnacct on off switch
DESCRIPTION
chargefee Command
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(1M).
ckpacct Command
ckpacct should be initiated using cron(1M) to periodically
check the size of /var/adm/pacct. If the size exceeds
blocks, 500 by default, turnacct will be invoked with
SunOS 5.11 Last change: 15 Mar 2002 1
System Administration Commands acctsh(1M)
argument switch. To avoid a conflict with turnacct switch
execution in runacct, do not run ckpacct and runacct simul-
taneously. 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 the
cron(1M) command.
dodisk Command
dodisk should be invoked by cron(1M) to perform the disk
accounting functions.
lastlogin Command
lastlogin is invoked by runacct(1M) to update
/var/adm/acct/sum/loginlog, which shows the last date on
which each person logged in.
monacct Command
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
using 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 Command
nulladm creates filename with mode 664 and ensures that
owner and group are adm. It is called by various accounting
shell procedures.
prctmp Command
prctmp can be used to print the session record file (nor-
mally /var/adm/acct/nite/ctmp created by acctcon1 (see
acctcon(1M)).
prdaily Command
prdaily is invoked by runacct(1M) 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 specifying the
exact report date desired.
prtacct Command
prtacct can be used to format and print any total accounting
(tacct)file.
SunOS 5.11 Last change: 15 Mar 2002 2
System Administration Commands acctsh(1M)
shutacct Command
shutacct is invoked during a system shutdown to turn process
accounting off and append a reason record to
/var/adm/wtmpx.
startup Command
startup can be invoked when the system is brought to a
multi-user state to turn process accounting on.
turnacct Command
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/pacct.incr (where incr is a number starting with 0
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(1M) command and used to keep pacct to a reasonable
size. shutacct uses turnacct to stop process accounting.
startup uses turnacct to start process accounting.
OPTIONS
The following options are supported:
-c This option prints a report of exceptional resource
usage by command, and may be used on current day's
accounting data only.
-l This option 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.
-o This option uses acctdusg (see acct(1M)) to do a
slower version of disk accounting by login directory.
filenames specifies the one or more filesystem names
where disk accounting will be done. If filenames are
used, disk accounting will be done on these filesys-
tems only. If the -o option is used, filenames should
be mount points of mounted filesystems. If the -o
option is omitted, filenames should be the special
file names of mountable filesystems.
FILES
/etc/logadm.conf Configuration file for the
logadm(1M) command
SunOS 5.11 Last change: 15 Mar 2002 3
System Administration Commands acctsh(1M)
/usr/lib/acct Holds all accounting commands
listed in section 1M of this
manual
/usr/lib/acct/ptecms.awk Contains the limits for excep-
tional usage by command name
/usr/lib/acct/ptelus.awk Contains the limits for excep-
tional usage by login ID
/var/adm/acct/fiscal Fiscal reports directory
/var/adm/acct/nite Working directory
/var/adm/acct/sum Summary directory that con-
tains information for monacct
/var/adm/acct/sum/loginlog File updated by last login
/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/wtmpx History of user access and
administration information
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 15 Mar 2002 4
System Administration Commands acctsh(1M)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWaccu
SEE ALSO
acctcom(1), acct(1M), acctcms(1M), acctcon(1M),
acctmerg(1M), acctprc(1M), cron(1M), fwtmp(1M), logadm(1M),
runacct(1M), acct(2), acct.h(3HEAD), utmpx(4), attributes(5)
NOTES
See runacct(1M) for the main daily accounting shell script,
which performs the accumulation of connect, process, fee,
and disk accounting on a daily basis. It also creates sum-
maries of command usage.
SunOS 5.11 Last change: 15 Mar 2002 5
|
