MirOS Manual: acct(2)

ACCT(2)                    BSD Programmer's Manual                     ACCT(2)

NAME

     acct - enable or disable process accounting

SYNOPSIS

     #include <unistd.h>

     int
     acct(const char *file);

DESCRIPTION

     The acct() call enables or disables the collection of system accounting
     records. If file is NULL, accounting is disabled. If file is an existing,
     NUL-terminated pathname, record collection is enabled and for every pro-
     cess initiated which terminates under normal conditions an accounting
     record is appended to file. Abnormal conditions of termination are re-
     boots or other fatal system problems. Records for processes which never
     terminate cannot be produced by acct(). acct() is only available on ker-
     nels compiled with the ACCOUNTING option.

     For more information on the record structure used by acct(), see
     /usr/include/sys/acct.h and acct(5).

     This call is permitted only to the superuser.

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 VALUES

     On success, zero is returned. Otherwise, -1 is returned and errno is set
     to indicate the error.

ERRORS

     acct() will fail if one of the following is true:

     [EPERM]       The caller is not the superuser.

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

     [ENAMETOOLONG]
                   A component of a pathname exceeded {NAME_MAX} characters,
                   or an entire path name exceeded {PATH_MAX} characters.

     [ENOENT]      The named file does not exist.

     [EACCES]      Search permission is denied for a component of the path
                   prefix, or the path name is not a regular file.

     [ELOOP]       Too many symbolic links were encountered in translating the
                   pathname.

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

     [EFAULT]      file points outside the process's allocated address space.

     [EIO]         An I/O error occurred while reading from or writing to the
                   file system.

SEE ALSO

     acct(5), accton(8), sa(8)

HISTORY

     An acct() function call appeared in Version 7 AT&T UNIX.

MirOS BSD #10-current            June 4, 1993                                1

Generated on 2014-04-02 20:57:59 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.