sysctl(3): Update description of various kern.* variables.

Also add xrefs for confstr(3) (as sysconf(3) but for strings) and kvm(3)
(which is a more convenient way to access some of the variables).

PR:		116480
MFC after:	1 week
This commit is contained in:
Jilles Tjoelker 2010-04-25 12:35:39 +00:00
parent c74f160cb0
commit 67c8bc1bfb

View File

@ -28,7 +28,7 @@
.\" @(#)sysctl.3 8.4 (Berkeley) 5/9/95
.\" $FreeBSD$
.\"
.Dd February 21, 2010
.Dd April 25, 2010
.Dt SYSCTL 3
.Os
.Sh NAME
@ -325,7 +325,7 @@ information.
.It "KERN_BOOTFILE string yes"
.It "KERN_BOOTTIME struct timeval no"
.It "KERN_CLOCKRATE struct clockinfo no"
.It "KERN_FILE struct file no"
.It "KERN_FILE struct xfile no"
.It "KERN_HOSTID integer yes"
.It "KERN_HOSTUUID string yes"
.It "KERN_HOSTNAME string yes"
@ -342,14 +342,14 @@ information.
.It "KERN_OSREV integer no"
.It "KERN_OSTYPE string no"
.It "KERN_POSIX1 integer no"
.It "KERN_PROC struct proc no"
.It "KERN_PROC node not applicable"
.It "KERN_PROF node not applicable"
.It "KERN_QUANTUM integer yes"
.It "KERN_SAVED_IDS integer no"
.It "KERN_SECURELVL integer raise only"
.It "KERN_UPDATEINTERVAL integer no"
.It "KERN_VERSION string no"
.It "KERN_VNODE struct vnode no"
.It "KERN_VNODE struct xvnode no"
.El
.Bl -tag -width 6n
.It Li KERN_ARGMAX
@ -370,10 +370,8 @@ This structure contains the clock, statistics clock and profiling clock
frequencies, the number of micro-seconds per hz tick and the skew rate.
.It Li KERN_FILE
Return the entire file table.
The returned data consists of a single
.Va struct filehead
followed by an array of
.Va struct file ,
The returned data consists of an array of
.Va struct xfile ,
whose size depends on the current number of such objects in the system.
.It Li KERN_HOSTID
Get or set the host ID.
@ -525,10 +523,8 @@ Note, the vnode table is not necessarily a consistent snapshot of
the system.
The returned data consists of an array whose size depends on the
current number of such objects in the system.
Each element of the array contains the kernel address of a vnode
.Va struct vnode *
followed by the vnode itself
.Va struct vnode .
Each element of the array consists of a
.Va struct xvnode .
.El
.Ss CTL_NET
The string and integer information available for the CTL_NET level
@ -854,6 +850,8 @@ An attempt is made to set a read-only value.
A process without appropriate privilege attempts to set a value.
.El
.Sh SEE ALSO
.Xr confstr 3 ,
.Xr kvm 3 ,
.Xr sysconf 3 ,
.Xr sysctl 8
.Sh HISTORY