Return to acct.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/acct.2, revision 1.1.1.1

1.1       root        1: .TH ACCT 2 "13 February 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: acct \- turn accounting on or off
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .ft B
                      8: acct(file)
                      9: char *file;
                     10: .ft R
                     11: .fi
                     12: .SH DESCRIPTION
                     13: The system is prepared to write a record
                     14: in an accounting
                     15: .I file
                     16: for each process as it terminates.
                     17: This
                     18: call, with a null-terminated string naming an existing file
                     19: as argument, turns on accounting;
                     20: records for each terminating process are appended to
                     21: .IR file .
                     22: An argument of 0 causes accounting to be turned off.
                     23: .PP
                     24: The accounting file format is given in
                     25: .IR acct (5).
                     26: .PP
                     27: This call is permitted only to the super-user.
                     28: .SH NOTES
                     29: Accounting is automatically disabled when the file system the
                     30: accounting file resides on runs out of space; it is enabled when
                     31: space once again becomes available.
                     32: .SH "RETURN VALUE
                     33: On error \-1 is returned.
                     34: The file must exist and the call may be exercised only by the super-user.
                     35: It is erroneous to try to turn on accounting when it is already on.
                     36: .SH ERRORS
                     37: .I Acct
                     38: will fail if one of the following is true:
                     39: .TP 15
                     40: [EPERM]
                     41: The caller is not the super-user.
                     42: .TP 15
                     43: [EPERM]
                     44: The pathname contains a character with the high-order bit set.
                     45: .TP 15
                     46: [ENOTDIR]
                     47: A component of the path prefix is not a directory.
                     48: .TP 15
                     49: [ENOENT]
                     50: The named file does not exist.
                     51: .TP 15
                     52: [EISDIR]
                     53: The named file is a directory.
                     54: .TP 15
                     55: [EROFS]
                     56: The named file resides on a read-only file system.
                     57: .TP 15
                     58: [EFAULT]
                     59: .I File
                     60: points outside the process's allocated address space.
                     61: .TP 15
                     62: [ELOOP]
                     63: Too many symbolic links were encountered in translating the pathname.
                     64: .TP 15
                     65: [EACCES]
                     66: The file is a character or block special file.
                     67: .SH "SEE ALSO"
                     68: acct(5), sa(8)
                     69: .SH BUGS
                     70: No accounting is produced for programs running
                     71: when a crash occurs.
                     72: In particular nonterminating programs are never
                     73: accounted for.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.