Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. @(#)acct.2 6.2 (Berkeley) 05/22/85 ACCT 2 ""
C 4 NAME
acct - turn accounting on or off
SYNOPSIS
acct(file)
char *file;
DESCRIPTION
The system is prepared to write a record
in an accounting
file for each process as it terminates.
This
call, with a null-terminated string naming an existing file
as argument, turns on accounting;
records for each terminating process are appended to
file . An argument of 0 causes accounting to be turned off.
The accounting file format is given in
acct (5).
This call is permitted only to the super-user.
NOTES
Accounting is automatically disabled when the file system the
accounting file resides on runs out of space; it is enabled when
space once again becomes available.
"RETURN VALUE
On error -1 is returned.
The file must exist and the call may be exercised only by the super-user.
It is erroneous to try to turn on accounting when it is already on.
ERRORS
Acct will fail if one of the following is true:
15
[EPERM]
The caller is not the super-user.
15
[ENOTDIR]
A component of the path prefix is not a directory.
15
[EINVAL]
The pathname contains a character with the high-order bit set.
15
[ENAMETOOLONG]
A component of a pathname exceeded 255 characters,
or an entire path name exceeded 1023 characters.
15
[ENOENT]
The named file does not exist.
15
[EACCES]
Search permission is denied for a component of the path prefix,
or the path name is not a regular file.
15
[ELOOP]
Too many symbolic links were encountered in translating the pathname.
15
[EROFS]
The named file resides on a read-only file system.
15
[EFAULT]
File points outside the process's allocated address space.
"SEE ALSO"
acct(5), sa(8)
BUGS
No accounting is produced for programs running
when a crash occurs.
In particular nonterminating programs are never
accounted for.