xref: /freebsd/lib/libc/gen/sysctl.3 (revision dd1d7d1fa0c71ed0f084564f12c836406c46d30a)
158f0484fSRodney W. Grimes.\" Copyright (c) 1993
258f0484fSRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
358f0484fSRodney W. Grimes.\"
458f0484fSRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
558f0484fSRodney W. Grimes.\" modification, are permitted provided that the following conditions
658f0484fSRodney W. Grimes.\" are met:
758f0484fSRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
858f0484fSRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
958f0484fSRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
1058f0484fSRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
1158f0484fSRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
1258f0484fSRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
1358f0484fSRodney W. Grimes.\"    must display the following acknowledgement:
1458f0484fSRodney W. Grimes.\"	This product includes software developed by the University of
1558f0484fSRodney W. Grimes.\"	California, Berkeley and its contributors.
1658f0484fSRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
1758f0484fSRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
1858f0484fSRodney W. Grimes.\"    without specific prior written permission.
1958f0484fSRodney W. Grimes.\"
2058f0484fSRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2158f0484fSRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2258f0484fSRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2358f0484fSRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2458f0484fSRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2558f0484fSRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2658f0484fSRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2758f0484fSRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2858f0484fSRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2958f0484fSRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3058f0484fSRodney W. Grimes.\" SUCH DAMAGE.
3158f0484fSRodney W. Grimes.\"
320014b4c0SPeter Wemm.\"	@(#)sysctl.3	8.4 (Berkeley) 5/9/95
3358f0484fSRodney W. Grimes.\"
34681e5e7aSSteve Price.Dd May 9, 1995
3558f0484fSRodney W. Grimes.Dt SYSCTL 3
3658f0484fSRodney W. Grimes.Os
3758f0484fSRodney W. Grimes.Sh NAME
38dd1d7d1fSPeter Wemm.Nm sysctl ,
39dd1d7d1fSPeter Wemm.Nm sysctlbyname
4058f0484fSRodney W. Grimes.Nd get or set system information
4158f0484fSRodney W. Grimes.Sh SYNOPSIS
4249f94c2dSPoul-Henning Kamp.Fd #include <sys/types.h>
4358f0484fSRodney W. Grimes.Fd #include <sys/sysctl.h>
4458f0484fSRodney W. Grimes.Ft int
4558f0484fSRodney W. Grimes.Fn sysctl "int *name" "u_int namelen" "void *oldp" "size_t *oldlenp" "void *newp" "size_t newlen"
46dd1d7d1fSPeter Wemm.Fn sysctlbyname "const char *name" "void *oldp" "size_t *oldlenp" "void *newp" "size_t newlen"
4758f0484fSRodney W. Grimes.Sh DESCRIPTION
4858f0484fSRodney W. GrimesThe
49bf5a138eSMike Pritchard.Fn sysctl
5058f0484fSRodney W. Grimesfunction retrieves system information and allows processes with
5158f0484fSRodney W. Grimesappropriate privileges to set system information.
5258f0484fSRodney W. GrimesThe information available from
53bf5a138eSMike Pritchard.Fn sysctl
5458f0484fSRodney W. Grimesconsists of integers, strings, and tables.
5558f0484fSRodney W. GrimesInformation may be retrieved and set from the command interface
5658f0484fSRodney W. Grimesusing the
57e1f4e80cSMike Pritchard.Xr sysctl 8
5858f0484fSRodney W. Grimesutility.
5958f0484fSRodney W. Grimes.Pp
6058f0484fSRodney W. GrimesUnless explicitly noted below,
61bf5a138eSMike Pritchard.Fn sysctl
6258f0484fSRodney W. Grimesreturns a consistent snapshot of the data requested.
6358f0484fSRodney W. GrimesConsistency is obtained by locking the destination
6458f0484fSRodney W. Grimesbuffer into memory so that the data may be copied out without blocking.
6558f0484fSRodney W. GrimesCalls to
66bf5a138eSMike Pritchard.Fn sysctl
6758f0484fSRodney W. Grimesare serialized to avoid deadlock.
6858f0484fSRodney W. Grimes.Pp
6958f0484fSRodney W. GrimesThe state is described using a ``Management Information Base'' (MIB)
7058f0484fSRodney W. Grimesstyle name, listed in
7158f0484fSRodney W. Grimes.Fa name ,
7258f0484fSRodney W. Grimeswhich is a
7358f0484fSRodney W. Grimes.Fa namelen
7458f0484fSRodney W. Grimeslength array of integers.
7558f0484fSRodney W. Grimes.Pp
76dd1d7d1fSPeter WemmThe
77dd1d7d1fSPeter Wemm.Fn sysctlbyname
78dd1d7d1fSPeter Wemmfunction accepts an ascii representation of the name and internally
79dd1d7d1fSPeter Wemmlooks up the integer name vector.  Apart from that, it behaves the same
80dd1d7d1fSPeter Wemmas the standard
81dd1d7d1fSPeter Wemm.Fn sysctl
82dd1d7d1fSPeter Wemmfunction.
83dd1d7d1fSPeter Wemm.Pp
8458f0484fSRodney W. GrimesThe information is copied into the buffer specified by
8558f0484fSRodney W. Grimes.Fa oldp .
8658f0484fSRodney W. GrimesThe size of the buffer is given by the location specified by
8758f0484fSRodney W. Grimes.Fa oldlenp
8858f0484fSRodney W. Grimesbefore the call,
89b1f6a5fbSBruce Evansand that location gives the amount of data copied after a successful call
90b1f6a5fbSBruce Evansand after a call that returns with the error code ENOMEM.
9158f0484fSRodney W. GrimesIf the amount of data available is greater
9258f0484fSRodney W. Grimesthan the size of the buffer supplied,
9358f0484fSRodney W. Grimesthe call supplies as much data as fits in the buffer provided
9458f0484fSRodney W. Grimesand returns with the error code ENOMEM.
9558f0484fSRodney W. GrimesIf the old value is not desired,
9658f0484fSRodney W. Grimes.Fa oldp
9758f0484fSRodney W. Grimesand
9858f0484fSRodney W. Grimes.Fa oldlenp
9958f0484fSRodney W. Grimesshould be set to NULL.
10058f0484fSRodney W. Grimes.Pp
10158f0484fSRodney W. GrimesThe size of the available data can be determined by calling
102bf5a138eSMike Pritchard.Fn sysctl
10358f0484fSRodney W. Grimeswith a NULL parameter for
10458f0484fSRodney W. Grimes.Fa oldp .
10558f0484fSRodney W. GrimesThe size of the available data will be returned in the location pointed to by
10658f0484fSRodney W. Grimes.Fa oldlenp .
10758f0484fSRodney W. GrimesFor some operations, the amount of space may change often.
10858f0484fSRodney W. GrimesFor these operations,
10958f0484fSRodney W. Grimesthe system attempts to round up so that the returned size is
11058f0484fSRodney W. Grimeslarge enough for a call to return the data shortly thereafter.
11158f0484fSRodney W. Grimes.Pp
11258f0484fSRodney W. GrimesTo set a new value,
11358f0484fSRodney W. Grimes.Fa newp
11458f0484fSRodney W. Grimesis set to point to a buffer of length
11558f0484fSRodney W. Grimes.Fa newlen
11658f0484fSRodney W. Grimesfrom which the requested value is to be taken.
11758f0484fSRodney W. GrimesIf a new value is not to be set,
11858f0484fSRodney W. Grimes.Fa newp
11958f0484fSRodney W. Grimesshould be set to NULL and
12058f0484fSRodney W. Grimes.Fa newlen
12158f0484fSRodney W. Grimesset to 0.
12258f0484fSRodney W. Grimes.Pp
12358f0484fSRodney W. GrimesThe top level names are defined with a CTL_ prefix in
12458f0484fSRodney W. Grimes.Pa <sys/sysctl.h> ,
12558f0484fSRodney W. Grimesand are as follows.
12658f0484fSRodney W. GrimesThe next and subsequent levels down are found in the include files
12758f0484fSRodney W. Grimeslisted here, and described in separate sections below.
12858f0484fSRodney W. Grimes.Pp
12958f0484fSRodney W. Grimes.Bl -column CTLXMACHDEPXXX "Next level namesXXXXXX" -offset indent
13058f0484fSRodney W. Grimes.It Sy Pa Name	Next level names	Description
13158f0484fSRodney W. Grimes.It CTL\_DEBUG	sys/sysctl.h	Debugging
1320014b4c0SPeter Wemm.It CTL\_VFS	sys/mount.h	Filesystem
13358f0484fSRodney W. Grimes.It CTL\_HW	sys/sysctl.h	Generic CPU, I/O
13458f0484fSRodney W. Grimes.It CTL\_KERN	sys/sysctl.h	High kernel limits
13558f0484fSRodney W. Grimes.It CTL\_MACHDEP	sys/sysctl.h	Machine dependent
13658f0484fSRodney W. Grimes.It CTL\_NET	sys/socket.h	Networking
13758f0484fSRodney W. Grimes.It CTL\_USER	sys/sysctl.h	User-level
13858f0484fSRodney W. Grimes.It CTL\_VM	vm/vm_param.h	Virtual memory
13958f0484fSRodney W. Grimes.El
14058f0484fSRodney W. Grimes.Pp
14158f0484fSRodney W. GrimesFor example, the following retrieves the maximum number of processes allowed
14258f0484fSRodney W. Grimesin the system:
143c492ccdbSMike Pritchard.Pp
14458f0484fSRodney W. Grimes.Bd -literal -offset indent -compact
14558f0484fSRodney W. Grimesint mib[2], maxproc;
14658f0484fSRodney W. Grimessize_t len;
147c492ccdbSMike Pritchard
14858f0484fSRodney W. Grimesmib[0] = CTL_KERN;
14958f0484fSRodney W. Grimesmib[1] = KERN_MAXPROC;
15058f0484fSRodney W. Grimeslen = sizeof(maxproc);
15158f0484fSRodney W. Grimessysctl(mib, 2, &maxproc, &len, NULL, 0);
15258f0484fSRodney W. Grimes.Ed
153c492ccdbSMike Pritchard.Pp
15458f0484fSRodney W. GrimesTo retrieve the standard search path for the system utilities:
155c492ccdbSMike Pritchard.Pp
15658f0484fSRodney W. Grimes.Bd -literal -offset indent -compact
15758f0484fSRodney W. Grimesint mib[2];
15858f0484fSRodney W. Grimessize_t len;
15958f0484fSRodney W. Grimeschar *p;
160c492ccdbSMike Pritchard
16158f0484fSRodney W. Grimesmib[0] = CTL_USER;
16258f0484fSRodney W. Grimesmib[1] = USER_CS_PATH;
16358f0484fSRodney W. Grimessysctl(mib, 2, NULL, &len, NULL, 0);
16458f0484fSRodney W. Grimesp = malloc(len);
16558f0484fSRodney W. Grimessysctl(mib, 2, p, &len, NULL, 0);
16658f0484fSRodney W. Grimes.Ed
16758f0484fSRodney W. Grimes.Sh CTL_DEBUG
16858f0484fSRodney W. GrimesThe debugging variables vary from system to system.
16958f0484fSRodney W. GrimesA debugging variable may be added or deleted without need to recompile
170bf5a138eSMike Pritchard.Fn sysctl
17158f0484fSRodney W. Grimesto know about it.
17258f0484fSRodney W. GrimesEach time it runs,
173bf5a138eSMike Pritchard.Fn sysctl
17458f0484fSRodney W. Grimesgets the list of debugging variables from the kernel and
17558f0484fSRodney W. Grimesdisplays their current values.
17658f0484fSRodney W. GrimesThe system defines twenty
17758f0484fSRodney W. Grimes.Ns ( Va struct ctldebug )
17858f0484fSRodney W. Grimesvariables named
17958f0484fSRodney W. Grimes.Nm debug0
18058f0484fSRodney W. Grimesthrough
18158f0484fSRodney W. Grimes.Nm debug19 .
18258f0484fSRodney W. GrimesThey are declared as separate variables so that they can be
18358f0484fSRodney W. Grimesindividually initialized at the location of their associated variable.
18458f0484fSRodney W. GrimesThe loader prevents multiple use of the same variable by issuing errors
18558f0484fSRodney W. Grimesif a variable is initialized in more than one place.
18658f0484fSRodney W. GrimesFor example, to export the variable
18758f0484fSRodney W. Grimes.Nm dospecialcheck
18858f0484fSRodney W. Grimesas a debugging variable, the following declaration would be used:
18958f0484fSRodney W. Grimes.Bd -literal -offset indent -compact
19058f0484fSRodney W. Grimesint dospecialcheck = 1;
19158f0484fSRodney W. Grimesstruct ctldebug debug5 = { "dospecialcheck", &dospecialcheck };
19258f0484fSRodney W. Grimes.Ed
1934b10cdbcSJeffrey Hsu.Sh CTL_VFS
1940014b4c0SPeter WemmA distinguished second level name, VFS_GENERIC,
1950014b4c0SPeter Wemmis used to get general information about all filesystems.
1960014b4c0SPeter WemmOne of its third level identifiers is VFS_MAXTYPENUM
1970014b4c0SPeter Wemmthat gives the highest valid filesystem type number.
1980014b4c0SPeter WemmIts other third level identifier is VFS_CONF that
1990014b4c0SPeter Wemmreturns configuration information about the filesystem
2000014b4c0SPeter Wemmtype given as a fourth level identifier (see
2010014b4c0SPeter Wemm.Xr getvfsbyname 3
2020014b4c0SPeter Wemmas an example of its use).
2030014b4c0SPeter WemmThe remaining second level identifiers are the
2040014b4c0SPeter Wemmfilesystem type number returned by a
2050014b4c0SPeter Wemm.Xr statfs 2
2060014b4c0SPeter Wemmcall or from VFS_CONF.
2070014b4c0SPeter WemmThe third level identifiers available for each filesystem
2080014b4c0SPeter Wemmare given in the header file that defines the mount
2090014b4c0SPeter Wemmargument structure for that filesystem.
21058f0484fSRodney W. Grimes.Sh CTL_HW
21158f0484fSRodney W. GrimesThe string and integer information available for the CTL_HW level
21258f0484fSRodney W. Grimesis detailed below.
21358f0484fSRodney W. GrimesThe changeable column shows whether a process with appropriate
21458f0484fSRodney W. Grimesprivilege may change the value.
21558f0484fSRodney W. Grimes.Bl -column "Second level nameXXXXXX" integerXXX -offset indent
21658f0484fSRodney W. Grimes.It Sy Pa Second level name	Type	Changeable
21758f0484fSRodney W. Grimes.It HW\_MACHINE	string	no
21858f0484fSRodney W. Grimes.It HW\_MODEL	string	no
21958f0484fSRodney W. Grimes.It HW\_NCPU	integer	no
22058f0484fSRodney W. Grimes.It HW\_BYTEORDER	integer	no
22158f0484fSRodney W. Grimes.It HW\_PHYSMEM	integer	no
22258f0484fSRodney W. Grimes.It HW\_USERMEM	integer	no
22358f0484fSRodney W. Grimes.It HW\_PAGESIZE	integer	no
22438c429d5SBruce Evans.It HW\_FLOATINGPOINT	integer	no
22558f0484fSRodney W. Grimes.\".It HW\_DISKNAMES	integer	no
22658f0484fSRodney W. Grimes.\".It HW\_DISKSTATS	integer	no
22758f0484fSRodney W. Grimes.El
22858f0484fSRodney W. Grimes.Pp
22958f0484fSRodney W. Grimes.Bl -tag -width "123456"
23058f0484fSRodney W. Grimes.It Li HW_MACHINE
23158f0484fSRodney W. GrimesThe machine class.
23258f0484fSRodney W. Grimes.It Li HW_MODEL
23358f0484fSRodney W. GrimesThe machine model
23458f0484fSRodney W. Grimes.It Li HW_NCPU
23558f0484fSRodney W. GrimesThe number of cpus.
2360014b4c0SPeter Wemm.ne 1i
23758f0484fSRodney W. Grimes.It Li HW_BYTEORDER
23858f0484fSRodney W. GrimesThe byteorder (4,321, or 1,234).
23958f0484fSRodney W. Grimes.It Li HW_PHYSMEM
24058f0484fSRodney W. GrimesThe bytes of physical memory.
24158f0484fSRodney W. Grimes.It Li HW_USERMEM
24258f0484fSRodney W. GrimesThe bytes of non-kernel memory.
24358f0484fSRodney W. Grimes.It Li HW_PAGESIZE
24458f0484fSRodney W. GrimesThe software page size.
24538c429d5SBruce Evans.It Li HW_FLOATINGPOINT
24638c429d5SBruce EvansNonzero if the floating point support is in hardware.
24758f0484fSRodney W. Grimes.\".It Fa HW_DISKNAMES
24858f0484fSRodney W. Grimes.\".It Fa HW_DISKSTATS
24958f0484fSRodney W. Grimes.El
25058f0484fSRodney W. Grimes.Sh CTL_KERN
25158f0484fSRodney W. GrimesThe string and integer information available for the CTL_KERN level
25258f0484fSRodney W. Grimesis detailed below.
25358f0484fSRodney W. GrimesThe changeable column shows whether a process with appropriate
25458f0484fSRodney W. Grimesprivilege may change the value.
25558f0484fSRodney W. GrimesThe types of data currently available are process information,
25658f0484fSRodney W. Grimessystem vnodes, the open file entries, routing table entries,
25758f0484fSRodney W. Grimesvirtual memory statistics, load average history, and clock rate
25858f0484fSRodney W. Grimesinformation.
25938c429d5SBruce Evans.Bl -column "KERNXMAXFILESPERPROCXXX" "struct clockrateXXX" -offset indent
26058f0484fSRodney W. Grimes.It Sy Pa Second level name	Type	Changeable
26158f0484fSRodney W. Grimes.It KERN\_ARGMAX	integer	no
26238c429d5SBruce Evans.It KERN\_BOOTFILE	string	yes
26358f0484fSRodney W. Grimes.It KERN\_BOOTTIME	struct timeval	no
26458f0484fSRodney W. Grimes.It KERN\_CLOCKRATE	struct clockinfo	no
26558f0484fSRodney W. Grimes.It KERN\_FILE	struct file	no
26658f0484fSRodney W. Grimes.It KERN\_HOSTID	integer	yes
26758f0484fSRodney W. Grimes.It KERN\_HOSTNAME	string	yes
26858f0484fSRodney W. Grimes.It KERN\_JOB\_CONTROL	integer	no
26958f0484fSRodney W. Grimes.It KERN\_MAXFILES	integer	yes
27038c429d5SBruce Evans.It KERN\_MAXFILESPERPROC	integer	yes
27158f0484fSRodney W. Grimes.It KERN\_MAXPROC	integer	yes
27238c429d5SBruce Evans.It KERN\_MAXPROCPERUID	integer	yes
27358f0484fSRodney W. Grimes.It KERN\_MAXVNODES	integer	yes
27458f0484fSRodney W. Grimes.It KERN\_NGROUPS	integer	no
27538c429d5SBruce Evans.It KERN\_NISDOMAINNAME	string	yes
27638c429d5SBruce Evans.It KERN\_OSRELDATE	integer	no
27758f0484fSRodney W. Grimes.It KERN\_OSRELEASE	string	no
27858f0484fSRodney W. Grimes.It KERN\_OSREV	integer	no
27958f0484fSRodney W. Grimes.It KERN\_OSTYPE	string	no
28058f0484fSRodney W. Grimes.It KERN\_POSIX1	integer	no
28158f0484fSRodney W. Grimes.It KERN\_PROC	struct proc	no
28258f0484fSRodney W. Grimes.It KERN\_PROF	node	not applicable
28358f0484fSRodney W. Grimes.It KERN\_SAVED\_IDS	integer	no
28458f0484fSRodney W. Grimes.It KERN\_SECURELVL	integer	raise only
28538c429d5SBruce Evans.It KERN\_UPDATEINTERVAL	integer	no
28658f0484fSRodney W. Grimes.It KERN\_VERSION	string	no
28758f0484fSRodney W. Grimes.It KERN\_VNODE	struct vnode	no
28858f0484fSRodney W. Grimes.El
2890014b4c0SPeter Wemm.ne 1i
29058f0484fSRodney W. Grimes.Pp
29158f0484fSRodney W. Grimes.Bl -tag -width "123456"
29258f0484fSRodney W. Grimes.It Li KERN_ARGMAX
29358f0484fSRodney W. GrimesThe maximum bytes of argument to
294e1f4e80cSMike Pritchard.Xr execve 2 .
29538c429d5SBruce Evans.It Li KERN_BOOTFILE
29638c429d5SBruce EvansThe full pathname of the file from which the kernel was loaded.
29758f0484fSRodney W. Grimes.It Li KERN_BOOTTIME
29858f0484fSRodney W. GrimesA
29958f0484fSRodney W. Grimes.Va struct timeval
30058f0484fSRodney W. Grimesstructure is returned.
30158f0484fSRodney W. GrimesThis structure contains the time that the system was booted.
30258f0484fSRodney W. Grimes.It Li KERN_CLOCKRATE
30358f0484fSRodney W. GrimesA
30458f0484fSRodney W. Grimes.Va struct clockinfo
30558f0484fSRodney W. Grimesstructure is returned.
30658f0484fSRodney W. GrimesThis structure contains the clock, statistics clock and profiling clock
307127feebeSJohn Hayfrequencies, the number of micro-seconds per hz tick and the skew rate.
30858f0484fSRodney W. Grimes.It Li KERN_FILE
30958f0484fSRodney W. GrimesReturn the entire file table.
31058f0484fSRodney W. GrimesThe returned data consists of a single
31158f0484fSRodney W. Grimes.Va struct filehead
31258f0484fSRodney W. Grimesfollowed by an array of
31358f0484fSRodney W. Grimes.Va struct file ,
31458f0484fSRodney W. Grimeswhose size depends on the current number of such objects in the system.
31558f0484fSRodney W. Grimes.It Li KERN_HOSTID
31658f0484fSRodney W. GrimesGet or set the host id.
31758f0484fSRodney W. Grimes.It Li KERN_HOSTNAME
31858f0484fSRodney W. GrimesGet or set the hostname.
31958f0484fSRodney W. Grimes.It Li KERN_JOB_CONTROL
32058f0484fSRodney W. GrimesReturn 1 if job control is available on this system, otherwise 0.
32158f0484fSRodney W. Grimes.It Li KERN_MAXFILES
32238c429d5SBruce EvansThe maximum number of files that may be open in the system.
32338c429d5SBruce Evans.It Li KERN_MAXFILESPERPROC
32438c429d5SBruce EvansThe maximum number of files that may be open for a single process.
32538c429d5SBruce EvansThis limit only applies to processes with an effective uid of nonzero
32638c429d5SBruce Evansat the time of the open request.
32738c429d5SBruce EvansFiles that have already been opened are not affected if the limit
32838c429d5SBruce Evansor the effective uid is changed.
32958f0484fSRodney W. Grimes.It Li KERN_MAXPROC
33038c429d5SBruce EvansThe maximum number of concurrent processes the system will allow.
33138c429d5SBruce Evans.It Li KERN_MAXPROCPERUID
33238c429d5SBruce EvansThe maximum number of concurrent processes the system will allow
33338c429d5SBruce Evansfor a single effective uid.
33438c429d5SBruce EvansThis limit only applies to processes with an effective uid of nonzero
33538c429d5SBruce Evansat the time of a fork request.
33638c429d5SBruce EvansProcesses that have already been started are not affected if the limit
33738c429d5SBruce Evansis changed.
33858f0484fSRodney W. Grimes.It Li KERN_MAXVNODES
33958f0484fSRodney W. GrimesThe maximum number of vnodes available on the system.
34058f0484fSRodney W. Grimes.It Li KERN_NGROUPS
34158f0484fSRodney W. GrimesThe maximum number of supplemental groups.
34238c429d5SBruce Evans.It Li KERN_NISDOMAINNAME
34338c429d5SBruce EvansThe name of the current YP/NIS domain.
34438c429d5SBruce Evans.It Li KERN_OSRELDATE
34538c429d5SBruce EvansThe system release date in YYYYMM format
34638c429d5SBruce Evans(January 1996 is encoded as 199601).
34758f0484fSRodney W. Grimes.It Li KERN_OSRELEASE
34858f0484fSRodney W. GrimesThe system release string.
34958f0484fSRodney W. Grimes.It Li KERN_OSREV
35058f0484fSRodney W. GrimesThe system revision string.
35158f0484fSRodney W. Grimes.It Li KERN_OSTYPE
35258f0484fSRodney W. GrimesThe system type string.
35358f0484fSRodney W. Grimes.It Li KERN_POSIX1
35458f0484fSRodney W. GrimesThe version of ISO/IEC 9945 (POSIX 1003.1) with which the system
35558f0484fSRodney W. Grimesattempts to comply.
35658f0484fSRodney W. Grimes.It Li KERN_PROC
35758f0484fSRodney W. GrimesReturn the entire process table, or a subset of it.
35858f0484fSRodney W. GrimesAn array of
35958f0484fSRodney W. Grimes.Va struct kinfo_proc
36058f0484fSRodney W. Grimesstructures is returned,
36158f0484fSRodney W. Grimeswhose size depends on the current number of such objects in the system.
36258f0484fSRodney W. GrimesThe third and fourth level names are as follows:
36358f0484fSRodney W. Grimes.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
36458f0484fSRodney W. Grimes.It Pa Third level name	Fourth level is:
36558f0484fSRodney W. Grimes.It KERN\_PROC\_ALL	None
36658f0484fSRodney W. Grimes.It KERN\_PROC\_PID	A process ID
36758f0484fSRodney W. Grimes.It KERN\_PROC\_PGRP	A process group
36858f0484fSRodney W. Grimes.It KERN\_PROC\_TTY	A tty device
36958f0484fSRodney W. Grimes.It KERN\_PROC\_UID	A user ID
37058f0484fSRodney W. Grimes.It KERN\_PROC\_RUID	A real user ID
37158f0484fSRodney W. Grimes.El
37258f0484fSRodney W. Grimes.It Li KERN_PROF
37358f0484fSRodney W. GrimesReturn profiling information about the kernel.
37458f0484fSRodney W. GrimesIf the kernel is not compiled for profiling,
37558f0484fSRodney W. Grimesattempts to retrieve any of the KERN_PROF values will
37658f0484fSRodney W. Grimesfail with EOPNOTSUPP.
37758f0484fSRodney W. GrimesThe third level names for the string and integer profiling information
37858f0484fSRodney W. Grimesis detailed below.
37958f0484fSRodney W. GrimesThe changeable column shows whether a process with appropriate
38058f0484fSRodney W. Grimesprivilege may change the value.
38158f0484fSRodney W. Grimes.Bl -column "GPROFXGMONPARAMXXX" "struct gmonparamXXX" -offset indent
38258f0484fSRodney W. Grimes.It Sy Pa Third level name	Type	Changeable
38358f0484fSRodney W. Grimes.It GPROF\_STATE	integer	yes
38458f0484fSRodney W. Grimes.It GPROF\_COUNT	u_short[\|]	yes
38558f0484fSRodney W. Grimes.It GPROF\_FROMS	u_short[\|]	yes
38658f0484fSRodney W. Grimes.It GPROF\_TOS	struct tostruct	yes
38758f0484fSRodney W. Grimes.It GPROF\_GMONPARAM	struct gmonparam	no
38858f0484fSRodney W. Grimes.El
38958f0484fSRodney W. Grimes.Pp
39058f0484fSRodney W. GrimesThe variables are as follows:
39158f0484fSRodney W. Grimes.Bl -tag -width "123456"
39258f0484fSRodney W. Grimes.It Li GPROF_STATE
39358f0484fSRodney W. GrimesReturns GMON_PROF_ON or GMON_PROF_OFF to show that profiling
39458f0484fSRodney W. Grimesis running or stopped.
39558f0484fSRodney W. Grimes.It Li GPROF_COUNT
39658f0484fSRodney W. GrimesArray of statistical program counter counts.
39758f0484fSRodney W. Grimes.It Li GPROF_FROMS
39858f0484fSRodney W. GrimesArray indexed by program counter of call-from points.
39958f0484fSRodney W. Grimes.It Li GPROF_TOS
40058f0484fSRodney W. GrimesArray of
40158f0484fSRodney W. Grimes.Va struct tostruct
40258f0484fSRodney W. Grimesdescribing destination of calls and their counts.
40358f0484fSRodney W. Grimes.It Li GPROF_GMONPARAM
40458f0484fSRodney W. GrimesStructure giving the sizes of the above arrays.
40558f0484fSRodney W. Grimes.El
4060014b4c0SPeter Wemm.ne 1i
40758f0484fSRodney W. Grimes.It Li KERN_SAVED_IDS
40858f0484fSRodney W. GrimesReturns 1 if saved set-group and saved set-user ID is available.
40958f0484fSRodney W. Grimes.It Li KERN_SECURELVL
41058f0484fSRodney W. GrimesThe system security level.
41158f0484fSRodney W. GrimesThis level may be raised by processes with appropriate privilege.
41258f0484fSRodney W. GrimesIt may only be lowered by process 1.
41358f0484fSRodney W. Grimes.It Li KERN_VERSION
41458f0484fSRodney W. GrimesThe system version string.
41558f0484fSRodney W. Grimes.It Li KERN_VNODE
41658f0484fSRodney W. GrimesReturn the entire vnode table.
41758f0484fSRodney W. GrimesNote, the vnode table is not necessarily a consistent snapshot of
41858f0484fSRodney W. Grimesthe system.
41958f0484fSRodney W. GrimesThe returned data consists of an array whose size depends on the
42058f0484fSRodney W. Grimescurrent number of such objects in the system.
42158f0484fSRodney W. GrimesEach element of the array contains the kernel address of a vnode
42258f0484fSRodney W. Grimes.Va struct vnode *
42358f0484fSRodney W. Grimesfollowed by the vnode itself
42458f0484fSRodney W. Grimes.Va struct vnode .
42538c429d5SBruce Evans.It Li KERN_UPDATEINTERVAL
42638c429d5SBruce EvansThe interval between
42738c429d5SBruce Evans.Xr sync 2
42838c429d5SBruce Evanscalls in the
42938c429d5SBruce Evans.Xr update 4
43038c429d5SBruce Evansprocess.
43158f0484fSRodney W. Grimes.El
43258f0484fSRodney W. Grimes.Sh CTL_MACHDEP
43358f0484fSRodney W. GrimesThe set of variables defined is architecture dependent.
43438c429d5SBruce EvansThe following variables are defined for the i386 architecture.
43538c429d5SBruce Evans.Bl -column "CONSOLE_DEVICEXXX" "struct bootinfoXXX" -offset indent
43658f0484fSRodney W. Grimes.It Sy Pa Second level name	Type	Changeable
43758f0484fSRodney W. Grimes.It Li CPU_CONSDEV	dev_t	no
438fb46136eSAndrey A. Chernov.It Li CPU_ADJKERNTZ	int	yes
439fb46136eSAndrey A. Chernov.It Li CPU_DISRTCSET	int	yes
44038c429d5SBruce Evans.It Li CPU_BOOTINFO	struct bootinfo	no
44138c429d5SBruce Evans.It Li CPU_WALLCLOCK	int	yes
44258f0484fSRodney W. Grimes.El
44358f0484fSRodney W. Grimes.Sh CTL_NET
44458f0484fSRodney W. GrimesThe string and integer information available for the CTL_NET level
44558f0484fSRodney W. Grimesis detailed below.
44658f0484fSRodney W. GrimesThe changeable column shows whether a process with appropriate
44758f0484fSRodney W. Grimesprivilege may change the value.
44858f0484fSRodney W. Grimes.Bl -column "Second level nameXXXXXX" "routing messagesXXX" -offset indent
44958f0484fSRodney W. Grimes.It Sy Pa Second level name	Type	Changeable
45058f0484fSRodney W. Grimes.It PF\_ROUTE	routing messages	no
45158f0484fSRodney W. Grimes.It PF\_INET	internet values	yes
45258f0484fSRodney W. Grimes.El
45358f0484fSRodney W. Grimes.Pp
45458f0484fSRodney W. Grimes.Bl -tag -width "123456"
45558f0484fSRodney W. Grimes.It Li PF_ROUTE
45658f0484fSRodney W. GrimesReturn the entire routing table or a subset of it.
45758f0484fSRodney W. GrimesThe data is returned as a sequence of routing messages (see
45858f0484fSRodney W. Grimes.Xr route 4
45958f0484fSRodney W. Grimesfor the header file, format and meaning).
46058f0484fSRodney W. GrimesThe length of each message is contained in the message header.
46158f0484fSRodney W. Grimes.Pp
46258f0484fSRodney W. GrimesThe third level name is a protocol number, which is currently always 0.
46358f0484fSRodney W. GrimesThe fourth level name is an address family, which may be set to 0 to
46458f0484fSRodney W. Grimesselect all address families.
46558f0484fSRodney W. GrimesThe fifth and sixth level names are as follows:
46658f0484fSRodney W. Grimes.Bl -column "Fifth level nameXXXXXX" "Sixth level is:XXX" -offset indent
46758f0484fSRodney W. Grimes.It Pa Fifth level name	Sixth level is:
46858f0484fSRodney W. Grimes.It NET\_RT\_FLAGS	rtflags
46958f0484fSRodney W. Grimes.It NET\_RT\_DUMP	None
47058f0484fSRodney W. Grimes.It NET\_RT\_IFLIST	None
47158f0484fSRodney W. Grimes.El
47258f0484fSRodney W. Grimes.It Li PF_INET
47358f0484fSRodney W. GrimesGet or set various global information about the internet protocols.
47458f0484fSRodney W. GrimesThe third level name is the protocol.
47558f0484fSRodney W. GrimesThe fourth level name is the variable name.
47658f0484fSRodney W. GrimesThe currently defined protocols and names are:
4770014b4c0SPeter Wemm.ne 1i
47858f0484fSRodney W. Grimes.Bl -column "Protocol nameXXXXXX" "Variable nameXXX" "integerXXX" -offset indent
47958f0484fSRodney W. Grimes.It Pa Protocol name	Variable name	Type	Changeable
48058f0484fSRodney W. Grimes.It ip	forwarding	integer	yes
48158f0484fSRodney W. Grimes.It ip	redirect	integer	yes
48258f0484fSRodney W. Grimes.It ip	ttl	integer	yes
48358f0484fSRodney W. Grimes.It icmp	maskrepl	integer	yes
48458f0484fSRodney W. Grimes.It udp	checksum	integer	yes
48558f0484fSRodney W. Grimes.El
48658f0484fSRodney W. Grimes.Pp
48758f0484fSRodney W. GrimesThe variables are as follows:
48858f0484fSRodney W. Grimes.Bl -tag -width "123456"
48958f0484fSRodney W. Grimes.It Li ip.forwarding
49058f0484fSRodney W. GrimesReturns 1 when IP forwarding is enabled for the host,
49158f0484fSRodney W. Grimesmeaning that the host is acting as a router.
49258f0484fSRodney W. Grimes.It Li ip.redirect
49358f0484fSRodney W. GrimesReturns 1 when ICMP redirects may be sent by the host.
49458f0484fSRodney W. GrimesThis option is ignored unless the host is routing IP packets,
49558f0484fSRodney W. Grimesand should normally be enabled on all systems.
49658f0484fSRodney W. Grimes.It Li ip.ttl
49758f0484fSRodney W. GrimesThe maximum time-to-live (hop count) value for an IP packet sourced by
49858f0484fSRodney W. Grimesthe system.
49958f0484fSRodney W. GrimesThis value applies to normal transport protocols, not to ICMP.
50058f0484fSRodney W. Grimes.It Li icmp.maskrepl
50158f0484fSRodney W. GrimesReturns 1 if ICMP network mask requests are to be answered.
50258f0484fSRodney W. Grimes.It Li udp.checksum
50358f0484fSRodney W. GrimesReturns 1 when UDP checksums are being computed and checked.
50458f0484fSRodney W. GrimesDisabling UDP checksums is strongly discouraged.
50558f0484fSRodney W. Grimes.El
50658f0484fSRodney W. Grimes.Sh CTL_USER
50758f0484fSRodney W. GrimesThe string and integer information available for the CTL_USER level
50858f0484fSRodney W. Grimesis detailed below.
50958f0484fSRodney W. GrimesThe changeable column shows whether a process with appropriate
51058f0484fSRodney W. Grimesprivilege may change the value.
51158f0484fSRodney W. Grimes.Bl -column "USER_COLL_WEIGHTS_MAXXXX" "integerXXX" -offset indent
51258f0484fSRodney W. Grimes.It Sy Pa Second level name	Type	Changeable
51358f0484fSRodney W. Grimes.It USER\_BC\_BASE\_MAX	integer	no
51458f0484fSRodney W. Grimes.It USER\_BC\_DIM\_MAX	integer	no
51558f0484fSRodney W. Grimes.It USER\_BC\_SCALE\_MAX	integer	no
51658f0484fSRodney W. Grimes.It USER\_BC\_STRING\_MAX	integer	no
51758f0484fSRodney W. Grimes.It USER\_COLL\_WEIGHTS\_MAX	integer	no
51858f0484fSRodney W. Grimes.It USER\_CS\_PATH	string	no
51958f0484fSRodney W. Grimes.It USER\_EXPR\_NEST\_MAX	integer	no
52058f0484fSRodney W. Grimes.It USER\_LINE\_MAX	integer	no
52158f0484fSRodney W. Grimes.It USER\_POSIX2\_CHAR\_TERM	integer	no
52258f0484fSRodney W. Grimes.It USER\_POSIX2\_C\_BIND	integer	no
52358f0484fSRodney W. Grimes.It USER\_POSIX2\_C\_DEV	integer	no
52458f0484fSRodney W. Grimes.It USER\_POSIX2\_FORT\_DEV	integer	no
52558f0484fSRodney W. Grimes.It USER\_POSIX2\_FORT\_RUN	integer	no
52658f0484fSRodney W. Grimes.It USER\_POSIX2\_LOCALEDEF	integer	no
52758f0484fSRodney W. Grimes.It USER\_POSIX2\_SW\_DEV	integer	no
52858f0484fSRodney W. Grimes.It USER\_POSIX2\_UPE	integer	no
52958f0484fSRodney W. Grimes.It USER\_POSIX2\_VERSION	integer	no
53058f0484fSRodney W. Grimes.It USER\_RE\_DUP\_MAX	integer	no
53158f0484fSRodney W. Grimes.It USER\_STREAM\_MAX	integer	no
53258f0484fSRodney W. Grimes.It USER\_TZNAME\_MAX	integer	no
53358f0484fSRodney W. Grimes.El
53458f0484fSRodney W. Grimes.Bl -tag -width "123456"
53558f0484fSRodney W. Grimes.Pp
53658f0484fSRodney W. Grimes.It Li USER_BC_BASE_MAX
53758f0484fSRodney W. GrimesThe maximum ibase/obase values in the
53858f0484fSRodney W. Grimes.Xr bc 1
53958f0484fSRodney W. Grimesutility.
54058f0484fSRodney W. Grimes.It Li USER_BC_DIM_MAX
54158f0484fSRodney W. GrimesThe maximum array size in the
54258f0484fSRodney W. Grimes.Xr bc 1
54358f0484fSRodney W. Grimesutility.
54458f0484fSRodney W. Grimes.It Li USER_BC_SCALE_MAX
54558f0484fSRodney W. GrimesThe maximum scale value in the
54658f0484fSRodney W. Grimes.Xr bc 1
54758f0484fSRodney W. Grimesutility.
54858f0484fSRodney W. Grimes.It Li USER_BC_STRING_MAX
54958f0484fSRodney W. GrimesThe maximum string length in the
55058f0484fSRodney W. Grimes.Xr bc 1
55158f0484fSRodney W. Grimesutility.
55258f0484fSRodney W. Grimes.It Li USER_COLL_WEIGHTS_MAX
55358f0484fSRodney W. GrimesThe maximum number of weights that can be assigned to any entry of
55458f0484fSRodney W. Grimesthe LC_COLLATE order keyword in the locale definition file.
55558f0484fSRodney W. Grimes.It Li USER_CS_PATH
55658f0484fSRodney W. GrimesReturn a value for the
55758f0484fSRodney W. Grimes.Ev PATH
55858f0484fSRodney W. Grimesenvironment variable that finds all the standard utilities.
55958f0484fSRodney W. Grimes.It Li USER_EXPR_NEST_MAX
56058f0484fSRodney W. GrimesThe maximum number of expressions that can be nested within
56158f0484fSRodney W. Grimesparenthesis by the
56258f0484fSRodney W. Grimes.Xr expr 1
56358f0484fSRodney W. Grimesutility.
56458f0484fSRodney W. Grimes.It Li USER_LINE_MAX
56558f0484fSRodney W. GrimesThe maximum length in bytes of a text-processing utility's input
56658f0484fSRodney W. Grimesline.
56758f0484fSRodney W. Grimes.It Li USER_POSIX2_CHAR_TERM
56858f0484fSRodney W. GrimesReturn 1 if the system supports at least one terminal type capable of
56958f0484fSRodney W. Grimesall operations described in POSIX 1003.2, otherwise 0.
57058f0484fSRodney W. Grimes.It Li USER_POSIX2_C_BIND
57158f0484fSRodney W. GrimesReturn 1 if the system's C-language development facilities support the
57258f0484fSRodney W. GrimesC-Language Bindings Option, otherwise 0.
57358f0484fSRodney W. Grimes.It Li USER_POSIX2_C_DEV
57458f0484fSRodney W. GrimesReturn 1 if the system supports the C-Language Development Utilities Option,
57558f0484fSRodney W. Grimesotherwise 0.
57658f0484fSRodney W. Grimes.It Li USER_POSIX2_FORT_DEV
57758f0484fSRodney W. GrimesReturn 1 if the system supports the FORTRAN Development Utilities Option,
57858f0484fSRodney W. Grimesotherwise 0.
57958f0484fSRodney W. Grimes.It Li USER_POSIX2_FORT_RUN
58058f0484fSRodney W. GrimesReturn 1 if the system supports the FORTRAN Runtime Utilities Option,
58158f0484fSRodney W. Grimesotherwise 0.
58258f0484fSRodney W. Grimes.It Li USER_POSIX2_LOCALEDEF
58358f0484fSRodney W. GrimesReturn 1 if the system supports the creation of locales, otherwise 0.
58458f0484fSRodney W. Grimes.It Li USER_POSIX2_SW_DEV
58558f0484fSRodney W. GrimesReturn 1 if the system supports the Software Development Utilities Option,
58658f0484fSRodney W. Grimesotherwise 0.
58758f0484fSRodney W. Grimes.It Li USER_POSIX2_UPE
58858f0484fSRodney W. GrimesReturn 1 if the system supports the User Portability Utilities Option,
58958f0484fSRodney W. Grimesotherwise 0.
59058f0484fSRodney W. Grimes.It Li USER_POSIX2_VERSION
59158f0484fSRodney W. GrimesThe version of POSIX 1003.2 with which the system attempts to comply.
59258f0484fSRodney W. Grimes.It Li USER_RE_DUP_MAX
59358f0484fSRodney W. GrimesThe maximum number of repeated occurrences of a regular expression
59458f0484fSRodney W. Grimespermitted when using interval notation.
5950014b4c0SPeter Wemm.ne 1i
59658f0484fSRodney W. Grimes.It Li USER_STREAM_MAX
59758f0484fSRodney W. GrimesThe minimum maximum number of streams that a process may have open
59858f0484fSRodney W. Grimesat any one time.
59958f0484fSRodney W. Grimes.It Li USER_TZNAME_MAX
60058f0484fSRodney W. GrimesThe minimum maximum number of types supported for the name of a
60158f0484fSRodney W. Grimestimezone.
60258f0484fSRodney W. Grimes.El
60358f0484fSRodney W. Grimes.Sh CTL_VM
60458f0484fSRodney W. GrimesThe string and integer information available for the CTL_VM level
60558f0484fSRodney W. Grimesis detailed below.
60658f0484fSRodney W. GrimesThe changeable column shows whether a process with appropriate
60758f0484fSRodney W. Grimesprivilege may change the value.
60858f0484fSRodney W. Grimes.Bl -column "Second level nameXXXXXX" "struct loadavgXXX" -offset indent
60958f0484fSRodney W. Grimes.It Sy Pa Second level name	Type	Changeable
61058f0484fSRodney W. Grimes.It VM\_LOADAVG	struct loadavg	no
61158f0484fSRodney W. Grimes.It VM\_METER	struct vmtotal	no
61258f0484fSRodney W. Grimes.El
61358f0484fSRodney W. Grimes.Pp
61458f0484fSRodney W. Grimes.Bl -tag -width "123456"
61558f0484fSRodney W. Grimes.It Li VM_LOADAVG
61658f0484fSRodney W. GrimesReturn the load average history.
61758f0484fSRodney W. GrimesThe returned data consists of a
61858f0484fSRodney W. Grimes.Va struct loadavg .
61958f0484fSRodney W. Grimes.It Li VM_METER
62058f0484fSRodney W. GrimesReturn the system wide virtual memory statistics.
62158f0484fSRodney W. GrimesThe returned data consists of a
62258f0484fSRodney W. Grimes.Va struct vmtotal .
62358f0484fSRodney W. Grimes.El
62458f0484fSRodney W. Grimes.Sh RETURN VALUES
62558f0484fSRodney W. GrimesIf the call to
626bf5a138eSMike Pritchard.Fn sysctl
6270014b4c0SPeter Wemmis successful, the number of bytes copied out is returned.
62858f0484fSRodney W. GrimesOtherwise \-1 is returned and
62958f0484fSRodney W. Grimes.Va errno
63058f0484fSRodney W. Grimesis set appropriately.
63158f0484fSRodney W. Grimes.Sh ERRORS
63258f0484fSRodney W. GrimesThe following errors may be reported:
63358f0484fSRodney W. Grimes.Bl -tag -width Er
63458f0484fSRodney W. Grimes.It Bq Er EFAULT
63558f0484fSRodney W. GrimesThe buffer
63658f0484fSRodney W. Grimes.Fa name ,
63758f0484fSRodney W. Grimes.Fa oldp ,
63858f0484fSRodney W. Grimes.Fa newp ,
63958f0484fSRodney W. Grimesor length pointer
64058f0484fSRodney W. Grimes.Fa oldlenp
64158f0484fSRodney W. Grimescontains an invalid address.
64258f0484fSRodney W. Grimes.It Bq Er EINVAL
64358f0484fSRodney W. GrimesThe
64458f0484fSRodney W. Grimes.Fa name
64558f0484fSRodney W. Grimesarray is less than two or greater than CTL_MAXNAME.
64658f0484fSRodney W. Grimes.It Bq Er EINVAL
64758f0484fSRodney W. GrimesA non-null
64858f0484fSRodney W. Grimes.Fa newp
64958f0484fSRodney W. Grimesis given and its specified length in
65058f0484fSRodney W. Grimes.Fa newlen
65158f0484fSRodney W. Grimesis too large or too small.
65258f0484fSRodney W. Grimes.It Bq Er ENOMEM
65358f0484fSRodney W. GrimesThe length pointed to by
65458f0484fSRodney W. Grimes.Fa oldlenp
65558f0484fSRodney W. Grimesis too short to hold the requested value.
65658f0484fSRodney W. Grimes.It Bq Er ENOTDIR
65758f0484fSRodney W. GrimesThe
65858f0484fSRodney W. Grimes.Fa name
65958f0484fSRodney W. Grimesarray specifies an intermediate rather than terminal name.
66058f0484fSRodney W. Grimes.It Bq Er EOPNOTSUPP
66158f0484fSRodney W. GrimesThe
66258f0484fSRodney W. Grimes.Fa name
66358f0484fSRodney W. Grimesarray specifies a value that is unknown.
66458f0484fSRodney W. Grimes.It Bq Er EPERM
66558f0484fSRodney W. GrimesAn attempt is made to set a read-only value.
66658f0484fSRodney W. Grimes.It Bq Er EPERM
66758f0484fSRodney W. GrimesA process without appropriate privilege attempts to set a value.
66858f0484fSRodney W. Grimes.El
66958f0484fSRodney W. Grimes.Sh FILES
67058f0484fSRodney W. Grimes.Bl -tag -width <netinet/icmpXvar.h> -compact
67158f0484fSRodney W. Grimes.It Pa <sys/sysctl.h>
67258f0484fSRodney W. Grimesdefinitions for top level identifiers, second level kernel and hardware
67358f0484fSRodney W. Grimesidentifiers, and user level identifiers
67458f0484fSRodney W. Grimes.It Pa <sys/socket.h>
67558f0484fSRodney W. Grimesdefinitions for second level network identifiers
67658f0484fSRodney W. Grimes.It Pa <sys/gmon.h>
67758f0484fSRodney W. Grimesdefinitions for third level profiling identifiers
67858f0484fSRodney W. Grimes.It Pa <vm/vm_param.h>
67958f0484fSRodney W. Grimesdefinitions for second level virtual memory identifiers
68058f0484fSRodney W. Grimes.It Pa <netinet/in.h>
68158f0484fSRodney W. Grimesdefinitions for third level Internet identifiers and
68258f0484fSRodney W. Grimesfourth level IP identifiers
68358f0484fSRodney W. Grimes.It Pa <netinet/icmp_var.h>
68458f0484fSRodney W. Grimesdefinitions for fourth level ICMP identifiers
68558f0484fSRodney W. Grimes.It Pa <netinet/udp_var.h>
68658f0484fSRodney W. Grimesdefinitions for fourth level UDP identifiers
68758f0484fSRodney W. Grimes.El
68858f0484fSRodney W. Grimes.Sh SEE ALSO
68958f0484fSRodney W. Grimes.Xr sysctl 8
69058f0484fSRodney W. Grimes.Sh HISTORY
69158f0484fSRodney W. GrimesThe
692bf5a138eSMike Pritchard.Fn sysctl
6937bdf80e5SMike Pritchardfunction first appeared in
6947bdf80e5SMike Pritchard.Bx 4.4 .
695