System Administration Commands acct(1M)
NAME
acct, acctdisk, acctdusg, accton, acctwtmp, closewtmp,
utmp2wtmp - overview of accounting and miscellaneous
accounting commands
SYNOPSIS
/usr/lib/acct/acctdisk
/usr/lib/acct/acctdusg [-u filename] [-p filename]
/usr/lib/acct/accton [filename]
/usr/lib/acct/acctwtmp reason filename
/usr/lib/acct/closewtmp
/usr/lib/acct/utmp2wtmp
DESCRIPTION
Accounting software is structured as a set of tools (con-
sisting of both C programs and shell procedures) that can be
used to build accounting systems. acctsh(1M) describes the
set of shell procedures built on top of the C programs.
Connect time accounting is handled by various programs that
write records into /var/adm/wtmpx, as described in utmpx(4).
The programs described in acctcon(1M) convert this file into
session and charging records, which are then summarized by
acctmerg(1M).
Process accounting is performed by the system kernel. Upon
termination of a process, one record per process is written
to a file (normally /var/adm/pacct). The programs in
acctprc(1M) summarize this data for charging purposes;
acctcms(1M) is used to summarize command usage. Current pro-
cess data may be examined using acctcom(1).
Process accounting records and connect time accounting
records (or any accounting records in the tacct format
described in acct.h(3HEAD)) can be merged and summarized
into total accounting records by acctmerg (see tacct format
in acct.h(3HEAD)). prtacct (see acctsh(1M)) is used to for-
mat any or all accounting records.
SunOS 5.11 Last change: 22 Feb 1999 1
System Administration Commands acct(1M)
acctdisk reads lines that contain user ID, login name, and
number of disk blocks and converts them to total accounting
records that can be merged with other accounting records.
acctdisk returns an error if the input file is corrupt or
improperly formatted.
acctdusg reads its standard input (usually from find /
-print) and computes disk resource consumption (including
indirect blocks) by login.
accton without arguments turns process accounting off. If
filename is given, it must be the name of an existing file,
to which the kernel appends process accounting records (see
acct(2) and acct.h(3HEAD)).
acctwtmp writes a utmpx(4) record to filename. The record
contains the current time and a string of characters that
describe the reason. A record type of ACOUNTING is assigned
(see utmpx(4)) reason must be a string of 11 or fewer char-
acters, numbers, $, or spaces. For example, the following
are suggestions for use in reboot and shutdown procedures,
respectively:
acctwtmp "acctg on" /var/adm/wtmpx
acctwtmp "acctg off" /var/adm/wtmpx
For each user currently logged on, closewtmp puts a false
DEADPROCES record in the /var/adm/wtmpx file. runacct (see
runacct(1M)) uses this false DEADPROCES record so that the
connect accounting procedures can track the time used by
users logged on before runacct was invoked.
For each user currently logged on, runacct uses utmp2wtmp to
create an entry in the file /var/adm/wtmpx, created by
runacct. Entries in /var/adm/wtmpx enable subsequent invoca-
tions of runacct to account for connect times of users
currently logged in.
OPTIONS
The following options are supported:
-u filename Places in filename records consisting of
those filenames for which acctdusg charges no
one (a potential source for finding users
trying to avoid disk charges).
SunOS 5.11 Last change: 22 Feb 1999 2
System Administration Commands acct(1M)
-p filename Specifies a password file, filename. This
option is not needed if the password file is
/etc/passwd.
ENVIRONMENT VARIABLES
If any of the LC* variables (LCTYPE, LCMESAGES, LCTIME,
LCOLATE, LCNUMERIC, and LCMONETARY) (see environ(5))
are not set in the environment, the operational behavior of
acct for each corresponding locale category is determined by
the value of the LANG environment variable. If LCAL is
set, its contents are used to override both the LANG and the
other LC* variables. If none of the above variables are set
in the environment, the "C" (U.S. style) locale determines
how acct behaves.
LCTYPE Determines how acct handles characters. When
LCTYPE is set to a valid value, acct can
display and handle text and filenames containing
valid characters for that locale. acct can
display and handle Extended Unix Code (EUC)
characters where any character can be 1, 2, or
3 bytes wide. acct can also handle EUC charac-
ters of 1, 2, or more column widths. In the "C"
locale, only characters from ISO 8859-1 are
valid.
LCTIME Determines how acct handles date and time for-
mats. In the "C" locale, date and time handling
follows the U.S. rules.
FILES
/etc/passwd Used for login name to user ID conver-
sions.
/usr/lib/acct Holds all accounting commands listed in
sub-class 1M of this manual.
/var/adm/pacct Current process accounting file.
/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: 22 Feb 1999 3
System Administration Commands acct(1M)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWaccu
SEE ALSO
acctcom(1), acctcms(1M), acctcon(1M), acctmerg(1M),
acctprc(1M), acctsh(1M), fwtmp(1M), runacct(1M), acct(2),
acct.h(3HEAD), passwd(4), utmpx(4), attributes(5),
environ(5)
SunOS 5.11 Last change: 22 Feb 1999 4
|
