[src/trunk]: src * Document the vendor.* sysctl branch

[hubertf <hubertf%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/1e3b9d3c283e
branches:  trunk
changeset: 501989:1e3b9d3c283e
user:      hubertf <hubertf%NetBSD.org@localhost>
date:      Wed Jan 10 03:03:02 2001 +0000

description:
* Document the vendor.* sysctl branch
 * in sysctl.3, sort the list of CTL_ prefixes and sync with sysctl.h

diffstat:

 lib/libc/gen/sysctl.3 |  18 ++++++++++++------
 sbin/sysctl/sysctl.8  |   8 +++++++-
 2 files changed, 19 insertions(+), 7 deletions(-)

diffs (67 lines):

diff -r 7a178b8e0c9f -r 1e3b9d3c283e lib/libc/gen/sysctl.3
--- a/lib/libc/gen/sysctl.3     Wed Jan 10 03:01:41 2001 +0000
+++ b/lib/libc/gen/sysctl.3     Wed Jan 10 03:03:02 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysctl.3,v 1.71 2000/12/21 01:10:52 itojun Exp $
+.\"    $NetBSD: sysctl.3,v 1.72 2001/01/10 03:03:02 hubertf Exp $
 .\"
 .\" Copyright (c) 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -121,15 +121,17 @@
 .Pp
 .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\_KERN  sys/sysctl.h    High kernel limits
+.It CTL\_VM    uvm/uvm_param.h Virtual memory
 .It CTL\_VFS   sys/mount.h     Filesystem
+.It CTL\_NET   sys/socket.h    Networking
+.It CTL\_DEBUG sys/sysctl.h    Debugging
 .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
-.It CTL\_NET   sys/socket.h    Networking
+.It CTL\_USER  sys/sysctl.h    User-level
+.It CTL\_DDB   sys/sysctl.h    In-kernel debugger
 .It CTL\_PROC  sys/sysctl.h    Per-process
-.It CTL\_USER  sys/sysctl.h    User-level
-.It CTL\_VM    uvm/uvm_param.h Virtual memory
+.It CTL\_VENDOR        ?       Vendor specific
 .El
 .Pp
 For example, the following retrieves the maximum number of processes allowed
@@ -1308,6 +1310,10 @@
 DDB.  See
 .Xr ddb 4
 for more details.
+.Sh CTL_VENDOR
+The "vendor" toplevel name is reserved to be used by vendors who wish to
+have their own private MIB tree. Intended use is to store values under
+.Dq vendor.<yourname>.* .
 .Sh RETURN VALUES
 If the call to
 .Nm
diff -r 7a178b8e0c9f -r 1e3b9d3c283e sbin/sysctl/sysctl.8
--- a/sbin/sysctl/sysctl.8      Wed Jan 10 03:01:41 2001 +0000
+++ b/sbin/sysctl/sysctl.8      Wed Jan 10 03:03:02 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysctl.8,v 1.61 2000/12/21 01:10:52 itojun Exp $
+.\"    $NetBSD: sysctl.8,v 1.62 2001/01/10 03:03:02 hubertf Exp $
 .\"
 .\" Copyright (c) 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -346,8 +346,14 @@
 .It user.posix2_version        integer no
 .It user.re_dup_max    integer no
 .It vfs.generic.usermount      integer yes
+.It vendor.<vendor>.*  ?       vendor specific
 .It vm.loadavg struct  no
 .El
+.Pp
+Entries found under
+.Dq vendor.<vendor>
+are left to be specified (and used) by vendors
+using the NetBSD operating system in their products. 
 .Sh EXAMPLES
 .Pp
 For example, to retrieve the maximum number of processes allowed