 |
Index for
Section 8 |
|
 |
Alphabetical
listing for A |
|
 |
Bottom of
page |
|
acctprc(8)
NAME
acctprc1, acctprc2, accton - Perform process-accounting procedures
SYNOPSIS
acctprc1 [InFile]
acctprc2
accton [OutFile]
DESCRIPTION
The three acctprc commands, acctprc1, acctprc2, and accton, are used in the
runacct shell procedure to produce process-accounting reports.
acctprc1 [InFile]
The acctprc1 command is used to read records from standard input that are
in a format defined by the acct structure in the /usr/include/sys/acct.h
header file. This process adds the login names that correspond to user
IDs, and then writes corresponding ASCII records to standard output. For
each process, the record format includes the following seven unheaded
columns:
User ID
The user ID column includes both traditional and assigned user
identification numbers listed in the /etc/passwd file.
Login name
The login name is the one used for the user ID in the /etc/passwd file.
Prime-time CPU time
The number of seconds the process consumed when executed during prime-
time hours. Prime-time and nonprime-time hours are defined in the
/usr/sbin/acct/holidays file.
Nonprime-time CPU time
The number of seconds the process consumed when executed during
nonprime-time hours.
Characters
Total number of characters transferred.
Blocks
Total number of blocks read and written.
Memory
Mean memory size (in kilobyte units).
When specified, InFile contains a list of login sessions in a format
defined by the utmp structure in the /usr/include/utmp.h header file. The
login session records are sorted according to user ID and login name. When
InFile is not specified, acctprc1 gets login names from the password file
/etc/passwd. The information in InFile is used to distinguish different
login names that share the same user ID.
acctprc2
The acctprc2 command reads, from standard input, the records written by
acctprc1, summarizes them according to user ID and name, and writes sorted
summaries to standard output as total accounting records in the tacct
format (see the acctmerg command).
accton [OutFile]
When no operands are specified with the accton command, account processing
is turned off. When you specify an existing OutFile file, process
accounting is turned on, and the kernel adds records to that file. You must
specify an Outfile to start process accounting. Many shell script
procedures expect the file name /var/adm/pacct, the standard process-
accounting file.
EXAMPLES
1. To add a user name to each process-accounting record in a binary file
and then write these modified binary-file records to an ASCII file
named out.file, enter the following line to an accounting shell
script:
/usr/sbin/acct/acctprc1 < /var/adm/pacct >out.file
A user name is added to each record. The raw data in the pacct file is
converted to ASCII and added to file out.file.
2. To produce a total binary accounting record of the ASCII output file
out.file produced in example 1, enter the following line to an
accounting shell script:
/usr/sbin/acct/acctprc2 < out.file > /var/adm/acct/nite/daytacct
The resulting binary total accounting file, written in the acct
format, contains records sorted by user ID. This sorted user ID file,
is usually merged with other total accounting records when an acctmerg
command is processed to produce a daily summary accounting record
called /var/adm/acct/sum/daytacct.
3. To turn on process accounting, enter:
/usr/sbin/acct/accton /var/adm/pacct
4. To turn off process accounting, enter:
/usr/sbin/acct/accton
FILES
/usr/sbin/acct/acctprc1
Specifies the command path.
/usr/sbin/acct/acctprc2
Specifies the command path.
/usr/sbin/acct/accton
Specifies the command path.
SEE ALSO
Commands: acct(8), acctcms(8), acctmerg(8), runacct(8)
Functions: acct(2)
|
Index for
Section 8 |
|
|
Alphabetical
listing for A |
|
 |
Top of
page |
|