diff options
Diffstat (limited to 'man2/acct.2')
-rw-r--r-- | man2/acct.2 | 125 |
1 files changed, 125 insertions, 0 deletions
diff --git a/man2/acct.2 b/man2/acct.2 new file mode 100644 index 000000000..145aa9327 --- /dev/null +++ b/man2/acct.2 @@ -0,0 +1,125 @@ +.\" Hey Emacs! This file is -*- nroff -*- source. +.\" +.\" Copyright (c) 1993 Michael Haardt +.\" (michael@moria.de), +.\" Fri Apr 2 11:32:09 MET DST 1993 +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, write to the Free +.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, +.\" USA. +.\" +.\" Modified 1993-07-22 by Rik Faith <faith@cs.unc.edu> +.\" Modified 1993-08-10 by Alan Cox <iiitac@pyramid.swansea.ac.uk> +.\" Modified 1998-11-04 by Tigran Aivazian <tigran@sco.com> +.\" Modified 2004-05-27, 2004-06-17, 2004-06-23 by Michael Kerrisk +.\" +.TH ACCT 2 2004-06-23 "Linux 2.6.7" "Linux Programmer's Manual" +.SH NAME +acct \- switch process accounting on or off +.SH SYNOPSIS +.ad l +.nf +.B #include <unistd.h> +.sp +.BI "int acct(const char *" filename ); +.fi +.ad b +.SH DESCRIPTION +When called with the name of an existing file as argument, accounting is +turned on, records for each terminating process are appended to +\fIfilename\fP as it terminates. An argument of \fBNULL\fP causes +accounting to be turned off. +.SH "RETURN VALUE" +On success, zero is returned. On error, \-1 is returned, and +.I errno +is set appropriately. +.SH ERRORS +.TP +.B EACCES +Write permission is denied for the specified file, +or search permission is denied for one of the directories +in the path prefix of +.I filename +(see also +.BR path_resolution (2)), +or +.I filename +is not a regular file. +.TP +.B EFAULT +.I filename +points outside your accessible address space. +.TP +.B EIO +Error writing to the file +.IR filename . +.TP +.B EISDIR +.I filename +is a directory. +.TP +.B ELOOP +Too many symbolic links were encountered in resolving +.IR filename . +.TP +.B ENAMETOOLONG +.I filename +was too long. +.TP +.B ENFILE +The system limit on the total number of open files has been reached. +.TP +.B ENOENT +The specified filename does not exist. +.TP +.B ENOMEM +Out of memory. +.TP +.B ENOSYS +BSD process accounting has not been enabled when the operating system +kernel was compiled. +The kernel configuration parameter controlling this feature is +CONFIG_BSD_PROCESS_ACCT. +.TP +.B ENOTDIR +A component used as a directory in +.I filename +is not in fact a directory. +.TP +.B EPERM +The calling process has insufficient privilege to enable process accounting. +On Linux the +.B CAP_SYS_PACCT +capability is required. +.TP +.B EROFS +.I filename +refers to a file on a read-only file system. +.TP +.B EUSERS +There are no more free file structures or we ran out of memory. +.SH "CONFORMING TO" +SVr4 (but not POSIX). SVr4 documents an EBUSY error condition, +but no EISDIR or ENOSYS. Also AIX and HPUX document EBUSY (attempt is made +to enable accounting when it is already enabled), as does Solaris +(attempt is made to enable accounting using the same file that is +currently being used). +.SH NOTES +No accounting is produced for programs running when a crash occurs. In +particular, nonterminating processes are never accounted for. |