Provides the accounting file format for each process.
The accounting files provide a means to monitor the use of the system. These files also serve as a method for billing each process for processor usage, materials, and services. The acct system call produces accounting files. The /usr/include/sys/acct.h file defines the records in these files, which are written when a process exits.
The acct structure in the acct.h header file contains the following fields:
| ac_flag | Specifies one of the following accounting flags for the process for which the accounting record is written: | ||
| AFORK | The process was created using a fork command but an exec subroutine has not yet followed. The exec subroutine turns off the AFORK flag.
| ||
| ac_stat | Specifies the exit status. A flag that indicates how the process terminated. | ||
| ac_uid | Specifies the user ID of the process for which the accounting record is written. | ||
| ac_gid | Specifies the group ID of the process for which the accounting record is written. | ||
| ac_tty | Specifies the terminal from which the process was started. | ||
| ac_btime | Specifies the beginning time. The time at which the process started. | ||
| ac_utime | Specifies the amount of user time, in seconds, used by the process. | ||
| ac_stime | Specifies the amount of system time, in seconds, used by the process. | ||
| ac_etime | Specifies the amount of time, in seconds, elapsed since the command ran. | ||
| ac_mem | Specifies the average amount of memory used by the process. Every clock interrupt (or clock tick,100 times per second), the sys_timer routine is called to update the user data for the current process. If the process is in user mode, both its u_utime value and memory usage values are incremented; otherwise, only its u_stime value is incremented. The sys_timer routine calls the vms_rusage routine to obtain the kilobytes of real memory being used by TEXTSEG (#1), the PRIVSEG (#2), and the big-data segments (#3-11), if used. These values are added to the total memory usage value at each clock tick during which the process is not in kernel mode. When the process ends, the acctexit routine computes how many clock ticks occurred while the process executed (in both user and kernel modes) and divides the total memory usage value by this number to give an average memory usage for the process. This value is recorded as a two-byte unsigned short integer. | ||
| ac_io | Specifies the number of characters transferred by the process. | ||
| ac_rw | Specifies the number of blocks read or written by the process. | ||
| ac_comm | Specifies the name of the command that started the process. A child process created by a fork subroutine receives this information from the parent process. An exec subroutine resets this field. |
The tacct structure, which is not part of the acct.h header file, represents the total accounting format used by the various accounting commands:
struct tacct {
uid_t ta_uid; /* user-ID */
char ta_name[8]; /* login name */
float ta_cpu[2]; /* cum. CPU time, p/np (mins) */
float ta_kcore[2]; /* cum. kcore-mins, p/np */
float ta_io[2]; /* cum. chars xferred (512s) */
float ta_rw[2]; /* cum. blocks read/written */
float ta_con[2]; /* cum. connect time, p/np, mins */
float ta_du; /* cum. disk usage */
long ta_qsys; /* queuing sys charges (pgs) */
float ta_fee; /* fee for special services */
long ta_pc; /* count of processes */
unsigned short ta_sc; /* count of login sessions */
unsigned short ta_dc; /* count of disk samples */
};
This file is part of the Base Operating System (BOS) Runtime.
The acctcms command, acctcom command, acctcon1 or acctcon2 command, acctdisk command, acctmerg command, acctprc1, acctprc2, or accton command, runacct command.
The acct subroutine, fork subroutine, exec subroutine.
The Header Files Overview in AIX Version 4.3 Files Reference.
The Accounting Files and the Accounting Overview in AIX Version 4.3 System Management Guide: Operating System and Devices.