X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man2%2Facct.2;h=f9efe437fc24b4d1f72a2fa3452d8d332d0b9537;hb=962708055e06376996bc4d148cb7773955f81cc9;hp=1586a72459975f652fb79a3c31484a29908ae8e5;hpb=d9343c5c138d6de6c7a2835e1ce0661322c1307e;p=thirdparty%2Fman-pages.git
diff --git a/man2/acct.2 b/man2/acct.2
index 1586a72459..f9efe437fc 100644
--- a/man2/acct.2
+++ b/man2/acct.2
@@ -1,9 +1,8 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
.\" Copyright (c) 1993 Michael Haardt
.\" (michael@moria.de),
.\" Fri Apr 2 11:32:09 MET DST 1993
.\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" 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
@@ -20,32 +19,53 @@
.\" 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.
+.\" License along with this manual; if not, see
+.\" .
+.\" %%%LICENSE_END
.\"
.\" Modified 1993-07-22 by Rik Faith
.\" Modified 1993-08-10 by Alan Cox
.\" Modified 1998-11-04 by Tigran Aivazian
.\" Modified 2004-05-27, 2004-06-17, 2004-06-23 by Michael Kerrisk
.\"
-.TH ACCT 2 2004-06-23 "Linux" "Linux Programmer's Manual"
+.TH ACCT 2 2016-03-15 "Linux" "Linux Programmer's Manual"
.SH NAME
acct \- switch process accounting on or off
.SH SYNOPSIS
.ad l
.nf
.B #include
-.sp
+.PP
.BI "int acct(const char *" filename );
.fi
.ad b
+.PP
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.PP
+.BR acct ():
+.nf
+ Since glibc 2.21:
+.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8
+ _DEFAULT_SOURCE
+ In glibc 2.19 and 2.20:
+ _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500)
+ Up to and including glibc 2.19:
+ _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500)
+.fi
.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.
+The
+.BR acct ()
+system call enables or disables process accounting.
+If called with the name of an existing file as its argument,
+accounting is turned on,
+and records for each terminating process are appended to
+.I filename
+as it terminates.
An argument of NULL causes accounting to be turned off.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
On success, zero is returned.
On error, \-1 is returned, and
.I errno
@@ -84,10 +104,10 @@ Too many symbolic links were encountered in resolving
was too long.
.TP
.B ENFILE
-The system limit on the total number of open files has been reached.
+The system-wide limit on the total number of open files has been reached.
.TP
.B ENOENT
-The specified filename does not exist.
+The specified file does not exist.
.TP
.B ENOMEM
Out of memory.
@@ -96,7 +116,7 @@ Out of memory.
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.
+.BR CONFIG_BSD_PROCESS_ACCT .
.TP
.B ENOTDIR
A component used as a directory in
@@ -105,17 +125,17 @@ is not in fact a directory.
.TP
.B EPERM
The calling process has insufficient privilege to enable process accounting.
-On Linux the
+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.
+refers to a file on a read-only filesystem.
.TP
.B EUSERS
There are no more free file structures or we ran out of memory.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
SVr4, 4.3BSD (but not POSIX).
.\" SVr4 documents an EBUSY error condition, but no EISDIR or ENOSYS.
.\" Also AIX and HP-UX document EBUSY (attempt is made
@@ -123,7 +143,10 @@ SVr4, 4.3BSD (but not POSIX).
.\" (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.
+No accounting is produced for programs running when a system crash occurs.
In particular, nonterminating processes are never accounted for.
-.SH "SEE ALSO"
+.PP
+The structure of the records written to the accounting file is described in
+.BR acct (5).
+.SH SEE ALSO
.BR acct (5)