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)