NAME

acctdisk, acctdusg, accton, acctwtmp − overview of accounting and miscellaneous accounting commands

SYNOPSIS

/usr/lib/acct/acctdisk

/usr/lib/acct/acctdusg [−u file] [−p file]

/usr/lib/acct/accton [file]

/usr/lib/acct/acctwtmp reason

DESCRIPTION

Accounting software is structured as a set of tools (consisting of both C programs and shell procedures) that can be used to build accounting systems.  The shell procedures, described in acctsh(1M), are built on top of the C programs.

Connect time accounting is handled by various programs that write records into /etc/utmp, as described in utmp(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 HP-UX system kernel.  Upon termination of a process, one record per process is written to a file (normally /usr/adm/pacct).  The programs in acctprc(1M) summarize this data for charging purposes; acctcms(1M) is used to summarize command usage. Current process data can be examined using acctcom(1M).

Process accounting and connect time accounting (or any accounting records in the format described in acct(4)) can be merged and summarized into total accounting records by acctmerg (see tacct format in acct(4)). prtacct (see acctsh(1M)) is used to format any or all accounting records.

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. 

acctdusg reads its standard input (usually from find / −print) and computes disk resource consumption (including indirect blocks) by login.  Only files found under login directories (as determined from the password file) are accounted for.  All files under a login directory are assumed to belong to that user regardless of actual owner.  If −u is given, records consisting of those file names for which acctdusg charges no one are placed in file (a potential source for finding users trying to avoid disk charges).  If −p is given, file is the name of the password file.  This option is not needed if the password file is /etc/passwd.  (See diskusg(1M) for more details.)

accton turns process accounting off if the optional file argument is omitted.  If file is given, it must be the name of an existing file, to which the kernel appends process accounting records (see acct(2) and acct(4)).

acctwtmp writes a utmp(4) record to its standard output. The record contains the current time and a string of characters that describe the reason for writing the record.  A record type of ACCOUNTING is assigned (see utmp(4)). The string argument reason must be 11 or fewer characters, numbers, $, or spaces.  For example, the following are suggestions for use in reboot and shutdown procedures, respectively:

acctwtmp ‘uname‘ >> /etc/wtmp
acctwtmp "file save" >> /etc/wtmp

In the HP Clustered environment, accounting software collects data on a per-machine basis.  Accounting data for the entire cluster can be merged using the acctmerg(1M) command.

FILES

/usr/lib/acct holds all accounting commands listed in section (1M) of this manual

/usr/adm/pacct current process accounting file

/etc/passwd used for login name to user ID conversions

/etc/wtmp login/logoff history file

SEE ALSO

acctcms(1M), acctcom(1M), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), diskusg(1M), fwtmp(1M), runacct(1M), acct(2), acct(4), utmp(4),

System Accounting topics in HP-UX System Administrator manuals. 

STANDARDS CONFORMANCE

acctdisk: SVID2

accton: SVID2

acctwtmp: SVID2

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992