docs/65070: acct(2) patch

[Marc Silver]

>Number:         65070
>Category:       docs
>Synopsis:       acct(2) patch
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Fri Apr 02 04:00:40 PST 2004
>Closed-Date:
>Last-Modified:
>Originator:     Marc Silver
>Release:        FreeBSD 4.9-STABLE i386
>Organization:
>Environment:
System: FreeBSD riffraff.plig.net 4.9-STABLE FreeBSD 4.9-STABLE #5: Wed Mar 3 16:21:56 GMT 2004 keet at riffraff.plig.net:/usr/src/sys/compile/RIFFRAFF i386


>Description:
	The man page for acct(2) is missing information on certain
	sysctl(8) variables which affect process accounting.  It's also
	missing a link to the accton(8) command, which should be
	included, imho.

>How-To-Repeat:
	man 2 acct

>Fix:
	Apply the following patch:

--- acct.2-orig	Fri Apr  2 12:35:55 2004
+++ acct.2	Fri Apr  2 12:38:16 2004
@@ -75,9 +75,27 @@
 .Pp
 This call is permitted only to the super-user.
 .Sh NOTES
-Accounting is automatically disabled when the file system the
-accounting file resides on runs out of space; it is enabled when
-space once again becomes available.
+Accounting is automatically disabled when the file system the accounting
+file resides on runs out of space; it is enabled when space once
+again becomes available.  These values can be controlled using the
+following
+.Xr sysctl 8
+variables:
+.Pp
+.Bl -ohang -offset indent
+.It kern.acct_chkfreq
+.Pq Vt int
+Specifies the frequency (in minutes) with which free disk
+space should be checked.
+.It kern.acct_resume
+.Pq Vt int
+The percentage of free disk space above which process
+accounting will resume.
+.It kern.acct_suspend
+.Pq Vt int
+The percentage of free disk space below which process
+accounting will suspend.
+.El
 .Sh RETURN VALUES
 On error -1 is returned.
 The file must exist and the call may be exercised only by the super-user.
@@ -112,7 +130,8 @@
 .El
 .Sh SEE ALSO
 .Xr acct 5 ,
-.Xr sa 8
+.Xr sa 8 ,
+.Xr accton 8
 .Sh HISTORY
 The
 .Fn acct
>Release-Note:
>Audit-Trail:
>Unformatted: