Sun Jan 9 16:55:59 2011 UTC ()
document the new wapbl sysctls.


(christos)
diff -r1.53 -r1.54 src/share/man/man7/sysctl.7
cvs diff -r1.53 -r1.54 src/share/man/man7/sysctl.7 (expand / switch to unified diff)

--- src/share/man/man7/sysctl.7 2010/12/14 16:23:59 1.53
+++ src/share/man/man7/sysctl.7 2011/01/09 16:55:59 1.54
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: sysctl.7,v 1.53 2010/12/14 16:23:59 jruoho Exp $ 1.\" $NetBSD: sysctl.7,v 1.54 2011/01/09 16:55:59 christos Exp $
2.\" 2.\"
3.\" Copyright (c) 1993 3.\" Copyright (c) 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors 14.\" 3. Neither the name of the University nor the names of its contributors
@@ -19,27 +19,27 @@ @@ -19,27 +19,27 @@
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE. 28.\" SUCH DAMAGE.
29.\" 29.\"
30.\" @(#)sysctl.3 8.4 (Berkeley) 5/9/95 30.\" @(#)sysctl.3 8.4 (Berkeley) 5/9/95
31.\" 31.\"
32.Dd December 14, 2010 32.Dd January 9, 2010
33.Dt SYSCTL 7 33.Dt SYSCTL 7
34.Os 34.Os
35.Sh NAME 35.Sh NAME
36.Nm sysctl 36.Nm sysctl
37.Nd system information variables 37.Nd system information variables
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39The 39The
40.Xr sysctl 3 40.Xr sysctl 3
41library function and the 41library function and the
42.Xr sysctl 8 42.Xr sysctl 8
43utility are used to get and set values of system variables, maintained 43utility are used to get and set values of system variables, maintained
44by the kernel. 44by the kernel.
45The variables are organized in a tree and identified by a sequence of 45The variables are organized in a tree and identified by a sequence of
@@ -123,34 +123,48 @@ Note that the dynamic implementation of @@ -123,34 +123,48 @@ Note that the dynamic implementation of
123currently in use largely makes this particular 123currently in use largely makes this particular
124.Nm 124.Nm
125interface obsolete. 125interface obsolete.
126See 126See
127.Xr sysctl 8 127.Xr sysctl 8
128.\" and 128.\" and
129.\" .Xr sysctl 9 129.\" .Xr sysctl 9
130for more information. 130for more information.
131.Ss The vfs.* subtree 131.Ss The vfs.* subtree
132A distinguished second level name, 132A distinguished second level name,
133.Li vfs.generic ( VFS_GENERIC ) , 133.Li vfs.generic ( VFS_GENERIC ) ,
134is used to get general information about all filesystems. 134is used to get general information about all filesystems.
135It has the following third level identifiers: 135It has the following third level identifiers:
136.Bl -tag -width compact 136.Bl -tag -width "vfs.generic.maxtypenum (VFS_MAXTYPENUM)"
137.It vfs.generic.maxtypenum ( VFS_MAXTYPENUM ) 137.It vfs.generic.maxtypenum ( VFS_MAXTYPENUM )
138The highest valid filesystem type number. 138The highest valid filesystem type number.
139.It vfs.generic.conf ( VFS_CONF ) 139.It vfs.generic.conf ( VFS_CONF )
140Returns configuration information about the file-system type given as a fourth 140Returns configuration information about the file-system type given as a fourth
141level identifier. 141level identifier.
142.El 142.El
143.Pp 143.Pp
 144A second level name for controlling the
 145.Xr wapbl 4
 146(Write Ahead Physical Block Logging file system journalling)
 147capabilities with the following third level identifiers:
 148.Bl -tag -width "vfs.wapbl.flush_disk_cache"
 149.It vfs.wapbl.flush_disk_cache Controls whether to attempt to flush the
 150disk cache on each commit.
 151It defaults to 1 and it should always be on to ensure data integrity in
 152case of a crash.
 153For slow disks, turning it off can improve performance.
 154.It vfs.wapbl.verbose_commit For each transaction log commit, print the
 155number of bytes written and the time it took to commit as seconds.nanoseconds.
 156.El
 157.Pp
144The remaining second level identifiers are the file-system names, identified 158The remaining second level identifiers are the file-system names, identified
145by the type number returned by a 159by the type number returned by a
146.Xr statvfs 2 160.Xr statvfs 2
147call or from 161call or from
148.Li vfs.generic.conf . 162.Li vfs.generic.conf .
149The third level identifiers available for each filesystem 163The third level identifiers available for each filesystem
150are given in the header file that defines the mount 164are given in the header file that defines the mount
151argument structure for that filesystem. 165argument structure for that filesystem.
152.Ss The hw.* subtree 166.Ss The hw.* subtree
153The string and integer information available for the 167The string and integer information available for the
154.Li hw 168.Li hw
155level is detailed below. 169level is detailed below.
156The changeable column shows whether a process with appropriate 170The changeable column shows whether a process with appropriate