AT&T UNIX™PC Unix System V Users Manual - tenox

ACCT (2) ACCT (2)
NAME
acct - enable or disable process accounting
SYNOPSIS
int acct (path)
char *path;
DESCRIPTION
Acct is used to enable or disable the system's process accounting
routine. If the routine is enabled, an accounting record will be
written on an accounting file for each process that terminates.
Termination can be caused by one of two things: an exit call or a
signal; see exit(2) and signal(2). The effective user ID of the calling
process must be super-user to use this call.
Path points to a path name naming the accounting file. The
accounting file format is given in acct( 4).
The accounting routine is enabled if path is non-zero and no errors
occur during the system call. It is disabled if path is zero and no
errors occur during the system call.
Acct will fail if one or more of the following are true:
The effective user ID of the calling process is not superuser.
[EPERMJ
An attempt is being made to enable accounting when it is
already enabled. [EBUSYJ
A component of the path prefix is not a directory.
[ENOTDffi]
One or more components of the accounting file's path
name do not exist. [ENOENT]
A component of the path prefix denies search permission.
[EACCES]
The file named by path is not an ordinary file. [EACCES]
Mode permission is denied for the named accounting file.
[EACCES]
The named file is a directory. [EISDIR]
The named file resides on a read-only file system. JEROFS]
Path points to an illegal address. JEFAULT]
RETURN VALUE
Upon successful completion, a value of 0 is returned. Otherwise, a
value of - 1 is returned and errno is set to indicate the error.
- 1 -