DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

acct(S)


acct -- enable or disable process accounting

Syntax

cc . . . -lc

int acct (path)
char *path;

Description

acct is used to enable or disable the system process accounting routine. If the routine is enabled, an accounting record is 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(S) and sigaction(S).) The effective user ID of the calling process must be superuser to use this call.

path points to a pathname naming the accounting file. The accounting file format is given in acct(FP).

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 fails if one or more of the following is true:


[EACCES]
The file named by path is not an ordinary file.

[EBUSY]
An attempt is being made to enable accounting when it is already enabled.

[EFAULT]
path points to an illegal address.

[ENOENT]
One or more components of the accounting file path name do not exist.

[ENOTDIR]
A component of the path prefix is not a directory.

[EPERM]
The effective user of the calling process is not super-user.

[EROFS]
The named file resides on a read-only file system.

See also

acct(FP), exit(S), sigaction(S)

Diagnostics

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error.

Standards conformance

acct is not part of any currently supported standard; it was developed by UNIX System Laboratories, Inc. and is maintained by The SCO Group.
© 2003 System Services (S)
SCO OpenServer Release 5.0.7 -- 11 February 2003