summaryrefslogtreecommitdiffstats
path: root/man2/acct.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/acct.2')
-rw-r--r--man2/acct.2125
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.