Commit | Line | Data |
---|---|---|
16bf0669 KM |
1 | .\" Copyright (c) 1980 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
4 | .\" | |
e9d005d5 | 5 | .\" @(#)acct.2 6.4 (Berkeley) %G% |
16bf0669 | 6 | .\" |
a1144fb9 | 7 | .TH ACCT 2 "" |
16bf0669 KM |
8 | .UC 4 |
9 | .SH NAME | |
10 | acct \- turn accounting on or off | |
11 | .SH SYNOPSIS | |
12 | .nf | |
79f85414 KM |
13 | .ft B |
14 | acct(file) | |
15 | char *file; | |
16 | .ft R | |
16bf0669 KM |
17 | .fi |
18 | .SH DESCRIPTION | |
19 | The system is prepared to write a record | |
20 | in an accounting | |
21 | .I file | |
22 | for each process as it terminates. | |
23 | This | |
24 | call, with a null-terminated string naming an existing file | |
25 | as argument, turns on accounting; | |
26 | records for each terminating process are appended to | |
27 | .IR file . | |
28 | An argument of 0 causes accounting to be turned off. | |
29 | .PP | |
30 | The accounting file format is given in | |
31 | .IR acct (5). | |
79f85414 KM |
32 | .PP |
33 | This call is permitted only to the super-user. | |
34 | .SH NOTES | |
35 | Accounting is automatically disabled when the file system the | |
36 | accounting file resides on runs out of space; it is enabled when | |
37 | space once again becomes available. | |
38 | .SH "RETURN VALUE | |
16bf0669 KM |
39 | On error \-1 is returned. |
40 | The file must exist and the call may be exercised only by the super-user. | |
41 | It is erroneous to try to turn on accounting when it is already on. | |
79f85414 KM |
42 | .SH ERRORS |
43 | .I Acct | |
44 | will fail if one of the following is true: | |
45 | .TP 15 | |
46 | [EPERM] | |
47 | The caller is not the super-user. | |
48 | .TP 15 | |
79f85414 KM |
49 | [ENOTDIR] |
50 | A component of the path prefix is not a directory. | |
51 | .TP 15 | |
b5984ffe KM |
52 | [EINVAL] |
53 | The pathname contains a character with the high-order bit set. | |
54 | .TP 15 | |
55 | [ENAMETOOLONG] | |
56 | A component of a pathname exceeded 255 characters, | |
57 | or an entire path name exceeded 1023 characters. | |
58 | .TP 15 | |
79f85414 KM |
59 | [ENOENT] |
60 | The named file does not exist. | |
61 | .TP 15 | |
b5984ffe KM |
62 | [EACCES] |
63 | Search permission is denied for a component of the path prefix, | |
64 | or the path name is not a regular file. | |
65 | .TP 15 | |
66 | [ELOOP] | |
67 | Too many symbolic links were encountered in translating the pathname. | |
79f85414 KM |
68 | .TP 15 |
69 | [EROFS] | |
70 | The named file resides on a read-only file system. | |
71 | .TP 15 | |
72 | [EFAULT] | |
73 | .I File | |
74 | points outside the process's allocated address space. | |
fd690c8b KM |
75 | .TP 15 |
76 | [EIO] | |
77 | An I/O error occurred while reading from or writing to the file system. | |
79f85414 KM |
78 | .SH "SEE ALSO" |
79 | acct(5), sa(8) | |
16bf0669 KM |
80 | .SH BUGS |
81 | No accounting is produced for programs running | |
82 | when a crash occurs. | |
e9d005d5 | 83 | In particular non-terminating programs are never |
16bf0669 | 84 | accounted for. |