Module Name: src
Committed By: jruoho
Date: Sat Apr 3 14:40:34 UTC 2010
Modified Files:
src/lib/libc/sys: acct.2
Log Message:
Trivia: one .Pp after .El, speak about NULL instead of nil pointers, etc.
To generate a diff of this commit:
cvs rdiff -u -r1.16 -r1.17 src/lib/libc/sys/acct.2
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/sys/acct.2
diff -u src/lib/libc/sys/acct.2:1.16 src/lib/libc/sys/acct.2:1.17
--- src/lib/libc/sys/acct.2:1.16 Thu May 13 10:20:57 2004
+++ src/lib/libc/sys/acct.2 Sat Apr 3 14:40:34 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: acct.2,v 1.16 2004/05/13 10:20:57 wiz Exp $
+.\" $NetBSD: acct.2,v 1.17 2010/04/03 14:40:34 jruoho Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -44,21 +44,19 @@
.Sh DESCRIPTION
The
.Fn acct
-call enables or disables the collection of system accounting
-records.
-If the argument
+call enables or disables the collection of system accounting records.
+If
.Fa file
-is a nil pointer, accounting is disabled.
+is
+.Dv NULL ,
+accounting is disabled.
If
.Fa file
-is an
-.Em existing
-pathname (null-terminated), record collection is enabled and for
-every process initiated which terminates under normal
+is an existing, NUL-terminated, pathname, record collection is enabled,
+and for every process initiated which terminates under normal
conditions an accounting record is appended to
.Fa file .
-Abnormal conditions of termination are reboots
-or other fatal system problems.
+Abnormal conditions of termination are reboots or other fatal system problems.
Records for processes which never terminate can not be
produced by
.Fn acct .
@@ -80,8 +78,10 @@
creates a kernel thread called
.Dq acctwatch .
.Sh RETURN VALUES
-On error \-1 is returned.
-The file must exist and the call may be exercised only by the super-user.
+On success, zero is returned.
+Otherwise, \-1 is returned and
+.Va errno
+is set to indicate the error.
.Sh ERRORS
.Fn acct
will fail if one of the following is true:
@@ -111,6 +111,7 @@
.It Bq Er EIO
An I/O error occurred while reading from or writing to the file system.
.El
+.Pp
Also,
.Fn acct
fails if failed to create kernel thread described above.
