Return to acct.2 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / sys

Annotation of 43BSDReno/lib/libc/sys/acct.2, revision 1.1.1.1

1.1       root        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: .\"
                      5: .\"    @(#)acct.2      6.4 (Berkeley) 5/22/86
                      6: .\"
                      7: .TH ACCT 2 "May 22, 1986"
                      8: .UC 4
                      9: .SH NAME
                     10: acct \- turn accounting on or off
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .ft B
                     14: acct(file)
                     15: char *file;
                     16: .ft R
                     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).
                     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
                     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.
                     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
                     49: [ENOTDIR]
                     50: A component of the path prefix is not a directory.
                     51: .TP 15
                     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
                     59: [ENOENT]
                     60: The named file does not exist.
                     61: .TP 15
                     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.
                     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.
                     75: .TP 15
                     76: [EIO]
                     77: An I/O error occurred while reading from or writing to the file system.
                     78: .SH "SEE ALSO"
                     79: acct(5), sa(8)
                     80: .SH BUGS
                     81: No accounting is produced for programs running
                     82: when a crash occurs.
                     83: In particular non-terminating programs are never
                     84: accounted for.

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