From 0014b4c0e1918a58de150539074fdd8454bb1f2b Mon Sep 17 00:00:00 2001
From: Peter Wemm <peter@FreeBSD.org>
Date: Tue, 11 Mar 1997 11:47:52 +0000
Subject: [PATCH] Merge from Lite2: man page updates

---
 lib/libc/gen/devname.3 | 12 +++++++-----
 lib/libc/gen/fnmatch.3 |  4 ++--
 lib/libc/gen/getcap.3  |  4 ++--
 lib/libc/gen/psignal.3 |  4 ++--
 lib/libc/gen/setmode.3 |  4 ++--
 lib/libc/gen/sysctl.3  | 30 +++++++++++++++++++++++++-----
 6 files changed, 40 insertions(+), 18 deletions(-)

diff --git a/lib/libc/gen/devname.3 b/lib/libc/gen/devname.3
index 1ecbc7522aa2..8f9ad922c9d9 100644
--- a/lib/libc/gen/devname.3
+++ b/lib/libc/gen/devname.3
@@ -29,9 +29,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)devname.3	8.1 (Berkeley) 6/4/93
+.\"     @(#)devname.3	8.2 (Berkeley) 4/29/95
 .\"
-.Dd June 4, 1993
+.Dd April 29, 1995
 .Dt DEVNAME 3
 .Os BSD 4.4
 .Sh NAME
@@ -53,9 +53,11 @@ and a file type matching the one encoded in
 .Fa type
 which must be one of S_IFBLK or S_IFCHR.
 If no device matches the specified values, or no information is
-available, the string
-.Dq ??
-is returned.
+available, NULL is returned.
+.Pp
+The traditional display for applications when no device is
+found is the string
+.Dq ?? .
 .Sh SEE ALSO
 .Xr stat 2 ,
 .Xr dev_mkdb 8
diff --git a/lib/libc/gen/fnmatch.3 b/lib/libc/gen/fnmatch.3
index bc007870596d..1da91a88c8cc 100644
--- a/lib/libc/gen/fnmatch.3
+++ b/lib/libc/gen/fnmatch.3
@@ -31,9 +31,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)fnmatch.3	8.2 (Berkeley) 4/16/94
+.\"     @(#)fnmatch.3	8.3 (Berkeley) 4/28/95
 .\"
-.Dd April 16, 1994
+.Dd April 28, 1995
 .Dt FNMATCH 3
 .Os
 .Sh NAME
diff --git a/lib/libc/gen/getcap.3 b/lib/libc/gen/getcap.3
index c9d86aec01ed..548bd552eb47 100644
--- a/lib/libc/gen/getcap.3
+++ b/lib/libc/gen/getcap.3
@@ -32,9 +32,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	@(#)getcap.3	8.3 (Berkeley) 4/19/94
+.\"	@(#)getcap.3	8.4 (Berkeley) 5/13/94
 .\"
-.Dd "April 19, 1994"
+.Dd "May 13, 1994"
 .Dt GETCAP 3 
 .Os
 .Sh NAME
diff --git a/lib/libc/gen/psignal.3 b/lib/libc/gen/psignal.3
index 0f66f521fa7e..a0d473736bb8 100644
--- a/lib/libc/gen/psignal.3
+++ b/lib/libc/gen/psignal.3
@@ -29,9 +29,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)psignal.3	8.1 (Berkeley) 6/4/93
+.\"     @(#)psignal.3	8.2 (Berkeley) 2/27/95
 .\"
-.Dd June 4, 1993
+.Dd February 27, 1995
 .Dt PSIGNAL 3
 .Os BSD 4.2
 .Sh NAME
diff --git a/lib/libc/gen/setmode.3 b/lib/libc/gen/setmode.3
index 35cd5d7946dd..4c85b30e2a38 100644
--- a/lib/libc/gen/setmode.3
+++ b/lib/libc/gen/setmode.3
@@ -29,9 +29,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)setmode.3	8.1 (Berkeley) 6/9/93
+.\"     @(#)setmode.3	8.2 (Berkeley) 4/28/95
 .\"
-.Dd June 9, 1993
+.Dd April 28, 1995
 .Dt SETMODE 3
 .Os
 .Sh NAME
diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3
index 36f91cc4469d..f20ab34faa81 100644
--- a/lib/libc/gen/sysctl.3
+++ b/lib/libc/gen/sysctl.3
@@ -29,9 +29,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	@(#)sysctl.3	8.1 (Berkeley) 6/4/93
+.\"	@(#)sysctl.3	8.4 (Berkeley) 5/9/95
 .\"
-.Dd "June 4, 1993"
+.Dd "May 9, 1995"
 .Dt SYSCTL 3
 .Os
 .Sh NAME
@@ -119,7 +119,7 @@ listed here, and described in separate sections below.
 .Bl -column CTLXMACHDEPXXX "Next level namesXXXXXX" -offset indent
 .It Sy Pa Name	Next level names	Description
 .It CTL\_DEBUG	sys/sysctl.h	Debugging
-.It CTL\_VFS	sys/sysctl.h	File system
+.It CTL\_VFS	sys/mount.h	Filesystem
 .It CTL\_HW	sys/sysctl.h	Generic CPU, I/O
 .It CTL\_KERN	sys/sysctl.h	High kernel limits
 .It CTL\_MACHDEP	sys/sysctl.h	Machine dependent
@@ -181,7 +181,22 @@ int dospecialcheck = 1;
 struct ctldebug debug5 = { "dospecialcheck", &dospecialcheck };
 .Ed
 .Sh CTL_VFS
-There are currently no second level names for the file system.
+A distinguished second level name, VFS_GENERIC,
+is used to get general information about all filesystems.
+One of its third level identifiers is VFS_MAXTYPENUM
+that gives the highest valid filesystem type number.
+Its other third level identifier is VFS_CONF that
+returns configuration information about the filesystem
+type given as a fourth level identifier (see
+.Xr getvfsbyname 3
+as an example of its use).
+The remaining second level identifiers are the
+filesystem type number returned by a
+.Xr statfs 2
+call or from VFS_CONF.
+The third level identifiers available for each filesystem
+are given in the header file that defines the mount
+argument structure for that filesystem.
 .Sh CTL_HW
 The string and integer information available for the CTL_HW level
 is detailed below.
@@ -208,6 +223,7 @@ The machine class.
 The machine model
 .It Li HW_NCPU
 The number of cpus.
+.ne 1i
 .It Li HW_BYTEORDER
 The byteorder (4,321, or 1,234).
 .It Li HW_PHYSMEM
@@ -260,6 +276,7 @@ information.
 .It KERN\_VERSION	string	no
 .It KERN\_VNODE	struct vnode	no
 .El
+.ne 1i
 .Pp
 .Bl -tag -width "123456"
 .It Li KERN_ARGMAX
@@ -376,6 +393,7 @@ describing destination of calls and their counts.
 .It Li GPROF_GMONPARAM
 Structure giving the sizes of the above arrays.
 .El
+.ne 1i
 .It Li KERN_SAVED_IDS
 Returns 1 if saved set-group and saved set-user ID is available.
 .It Li KERN_SECURELVL
@@ -446,6 +464,7 @@ Get or set various global information about the internet protocols.
 The third level name is the protocol.
 The fourth level name is the variable name.
 The currently defined protocols and names are:
+.ne 1i
 .Bl -column "Protocol nameXXXXXX" "Variable nameXXX" "integerXXX" -offset indent
 .It Pa Protocol name	Variable name	Type	Changeable
 .It ip	forwarding	integer	yes
@@ -563,6 +582,7 @@ The version of POSIX 1003.2 with which the system attempts to comply.
 .It Li USER_RE_DUP_MAX
 The maximum number of repeated occurrences of a regular expression
 permitted when using interval notation.
+.ne 1i
 .It Li USER_STREAM_MAX
 The minimum maximum number of streams that a process may have open
 at any one time.
@@ -594,7 +614,7 @@ The returned data consists of a
 .Sh RETURN VALUES
 If the call to
 .Fn sysctl
-is successful, 0 is returned.
+is successful, the number of bytes copied out is returned.
 Otherwise \-1 is returned and
 .Va errno
 is set appropriately.