xref: /netbsd-src/share/man/man7/sysctl.7 (revision 479d8f7d843cc1b22d497efdf1f27a50ee8418d4)
1.\"	$NetBSD: sysctl.7,v 1.106 2017/01/05 09:50:40 wiz Exp $
2.\"
3.\" Copyright (c) 1993
4.\"	The Regents of the University of California.  All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors
15.\"    may be used to endorse or promote products derived from this software
16.\"    without specific prior written permission.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
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
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
28.\" SUCH DAMAGE.
29.\"
30.\"	@(#)sysctl.3	8.4 (Berkeley) 5/9/95
31.\"
32.Dd November 17, 2016
33.Dt SYSCTL 7
34.Os
35.Sh NAME
36.Nm sysctl
37.Nd system information variables
38.Sh DESCRIPTION
39The
40.Xr sysctl 3
41library function and the
42.Xr sysctl 8
43utility are used to get and set values of system variables, maintained
44by the kernel.
45The variables are organized in a tree and identified by a sequence of
46numbers, conventionally separated by dots with the topmost identifier
47at the left side.
48The numbers have corresponding text names.
49The
50.Xr sysctlnametomib 3
51function or the
52.Fl M
53argument to the
54.Xr sysctl 8
55utility can be used to convert the text representation to the
56numeric one.
57.Pp
58The individual sysctl variables are described below, both the textual
59and numeric form where applicable.
60The textual names can be used as argument to the
61.Xr sysctl 8
62utility and in the file
63.Pa /etc/sysctl.conf .
64The numeric names are usually defined as preprocessor constants and
65are intended for use by programs.
66Every such constant expands to one integer, which identifies the
67sysctl variable relative to the upper level of the tree.
68See the
69.Xr sysctl 3
70manual page for programming examples.
71.Ss Top level names
72The top level names are defined with a
73.Va CTL_
74prefix in
75.In sys/sysctl.h ,
76and are as follows.
77The next and subsequent levels down are found in the include files
78listed here, and described in separate sections below.
79.Bl -column "security" ".Dv CTL_SECURITY" ".In uvm/uvm_param.h" "High kernel limits"
80.It Sy Name  Ta Sy Constant     Ta Sy Next level names Ta Sy Description
81.It kern     Ta Dv CTL_KERN     Ta In sys/sysctl.h     Ta High kernel limits
82.It vm       Ta Dv CTL_VM       Ta In uvm/uvm_param.h  Ta Virtual memory
83.It vfs      Ta Dv CTL_VFS      Ta In sys/mount.h      Ta Filesystem
84.It net      Ta Dv CTL_NET      Ta In sys/socket.h     Ta Networking
85.It debug    Ta Dv CTL_DEBUG    Ta In sys/sysctl.h     Ta Debugging
86.It hw       Ta Dv CTL_HW       Ta In sys/sysctl.h     Ta Generic CPU, I/O
87.It machdep  Ta Dv CTL_MACHDEP  Ta In sys/sysctl.h     Ta Machine dependent
88.It user     Ta Dv CTL_USER     Ta In sys/sysctl.h     Ta User-level
89.It ddb      Ta Dv CTL_DDB      Ta In sys/sysctl.h     Ta In-kernel debugger
90.It proc     Ta Dv CTL_PROC     Ta In sys/sysctl.h     Ta Per-process
91.It vendor   Ta Dv CTL_VENDOR   Ta ?                   Ta Vendor specific
92.It emul     Ta Dv CTL_EMUL     Ta In sys/sysctl.h     Ta Emulation settings
93.It security Ta Dv CTL_SECURITY Ta In sys/sysctl.h     Ta Security settings
94.El
95.Ss The debug.* subtree
96The debugging variables vary from system to system.
97A debugging variable may be added or deleted without need to recompile
98.Nm
99to know about it.
100Each time it runs,
101.Nm
102gets the list of debugging variables from the kernel and
103displays their current values.
104The system defines twenty
105.Vt ( struct ctldebug )
106variables named
107.Dv debug0
108through
109.Dv debug19 .
110They are declared as separate variables so that they can be
111individually initialized at the location of their associated variable.
112The loader prevents multiple use of the same variable by issuing errors
113if a variable is initialized in more than one place.
114For example, to export the variable
115.Va dospecialcheck
116as a debugging variable, the following declaration would be used:
117.Pp
118.Bd -literal -offset indent -compact
119int dospecialcheck = 1;
120struct ctldebug debug5 = { "dospecialcheck", \*[Am]dospecialcheck };
121.Ed
122.Pp
123Note that the dynamic implementation of
124.Nm
125currently in use largely makes this particular
126.Nm
127interface obsolete.
128See
129.Xr sysctl 8
130.\" and
131.\" .Xr sysctl 9
132for more information.
133.Ss The vfs.* subtree
134A distinguished second level name,
135.Li vfs.generic ( Dv VFS_GENERIC ) ,
136is used to get general information about all file systems.
137It has the following third level identifiers:
138.Bl -tag -width "123456"
139.It Li vfs.generic.maxtypenum ( Dv VFS_MAXTYPENUM )
140The highest valid file system type number.
141.It Li vfs.generic.conf ( Dv VFS_CONF )
142Returns configuration information about the file system type given as a fourth
143level identifier.
144.It Li vfs.generic.usermount ( Dv VFS_USERMOUNT )
145Determines if non superuser mounts are allowed, defaults to
146.Dv 0 .
147.It Li vfs.generic.magiclinks ( Dv VFS_MAGICLINKS )
148Controls if expansion of variables is going to be performed on pathnames
149or not.
150Defaults to no variable expansion,
151.Dv 0 .
152Variables are of the form
153.Li @name
154and the variables supported are described in
155.Xr symlink 7
156under
157.Dq "MAGIC SYMLINKS" .
158.El
159.Pp
160A second level name for controlling the
161.Xr wapbl 4
162(Write Ahead Physical Block Logging file system journalling)
163capabilities with the following third level identifiers:
164.Bl -tag -width "123456"
165.It Li vfs.wapbl.flush_disk_cache
166Controls whether to attempt to flush the disk cache on each commit.
167It defaults to 1 and it should always be on to ensure integrity
168of file system metadata in the event of a power loss.
169For slow disks, turning it off can improve performance.
170.It Li vfs.wapbl.verbose_commit
171For each transaction log commit, print the number of bytes written
172and the time it took to commit as seconds.nanoseconds.
173.El
174.Pp
175The remaining second level identifiers are the file system names, identified
176by the type number returned by a
177.Xr statvfs 2
178call or from
179.Li vfs.generic.conf .
180.Pp
181The third level identifiers available for each file system
182are given in the header file that defines the mount
183argument structure for that file system.
184.Ss The hw.* subtree
185The string and integer information available for the
186.Li hw
187level is detailed below.
188The changeable column shows whether a process with appropriate
189privilege may change the value.
190.Bl -column "hw.machine_arch" "integer" "Changeable" -offset indent
191.It Sy Second level name	Sy Type	Sy Changeable
192.It hw.alignbytes	integer	no
193.It hw.byteorder	integer	no
194.It hw.cnmagic	string	yes
195.It hw.disknames	string	no
196.It hw.diskstats	struct	no
197.It hw.machine	string	no
198.It hw.machine_arch	string	no
199.It hw.model	string	no
200.It hw.ncpu	integer	no
201.It hw.ncpuonline	integer	no
202.It hw.pagesize	integer	no
203.It hw.physmem	integer	no
204.It hw.physmem64	quad	no
205.It hw.usermem	integer	no
206.It hw.usermem64	quad	no
207.El
208.Bl -tag -width "123456"
209.It Li hw.alignbytes ( Dv HW_ALIGNBYTES )
210Alignment constraint for all possible data types.
211This shows the value
212.Dv ALIGNBYTES
213in
214.In machine/param.h ,
215at the kernel compilation time.
216.It Li hw.byteorder ( Dv HW_BYTEORDER )
217The byteorder (4321, or 1234).
218.It Li hw.cnmagic ( Dv HW_CNMAGIC )
219The console magic key sequence.
220.It Li hw.disknames ( Dv HW_DISKNAMES )
221The list of (space separated) disk device names on the system.
222.It Li hw.iostatnames ( Dv HW_IOSTATNAMES )
223A space separated list of devices that will have I/O statistics
224collected on them.
225.It Li hw.iostats ( Dv HW_IOSTATS )
226Return statistical information on the NFS mounts, disk and tape
227devices on the system.
228An array of
229.Vt struct io_sysctl
230structures is returned,
231whose size depends on the current number of such objects in the system.
232The third level name is the size of the
233.Vt struct io_sysctl .
234The type of object can be determined by examining the
235.Va type
236element of
237.Vt struct io_sysctl .
238Which can be
239.Dv IOSTAT_DISK
240(disk drive),
241.Dv IOSTAT_TAPE
242(tape drive), or
243.Dv IOSTAT_NFS
244(NFS mount).
245.It Li hw.machine ( Dv HW_MACHINE )
246The machine class.
247.It Li hw.machine_arch ( Dv HW_MACHINE_ARCH )
248The machine CPU class.
249.It Li hw.model ( Dv HW_MODEL )
250The machine model.
251.It Li hw.ncpu ( Dv HW_NCPU )
252The number of CPUs configured.
253.It Li hw.ncpuonline ( Dv HW_NCPUONLINE )
254The number of CPUs online.
255.It Li hw.pagesize ( Dv HW_PAGESIZE )
256The software page size.
257.It Li hw.physmem ( Dv HW_PHYSMEM )
258The bytes of physical memory as a 32-bit integer.
259.It Li hw.physmem64 ( Dv HW_PHYSMEM64 )
260The bytes of physical memory as a 64-bit integer.
261.It Li hw.usermem ( Dv HW_USERMEM )
262The bytes of non-kernel memory as a 32-bit integer.
263.It Li hw.usermem64 ( Dv HW_USERMEM64 )
264The bytes of non-kernel memory as a 64-bit integer.
265.El
266.Ss The kern.* subtree
267This subtree includes data generally related to the kernel.
268The string and integer information available for the
269.Li kern
270level is detailed below.
271The changeable column shows whether a process with appropriate
272privilege may change the value.
273.Bl -column "kern.posix_reader_writer_locks" \
274"struct kinfo_drivers" "not applicable"
275.It Sy Second level name	Sy Type	Sy Changeable
276.It kern.aio_listio_max	integer	yes
277.It kern.aio_max	integer	yes
278.It kern.arandom	integer	no
279.It kern.argmax	integer	no
280.It kern.boothowto	integer	no
281.It kern.boottime	struct timeval	no
282.It kern.buildinfo	string	no
283.\".It kern.bufq	node	not applicable
284.It kern.ccpu	integer	no
285.It kern.clockrate	struct clockinfo	no
286.It kern.consdev	integer	no
287.It kern.coredump	node	not applicable
288.It kern.cp_id	struct	no
289.It kern.cp_time	uint64_t[\|]	no
290.It kern.cryptodevallowsoft	integer	yes
291.It kern.defcorename	string	yes
292.It kern.detachall	integer	yes
293.It kern.domainname	string	yes
294.It kern.drivers	struct kinfo_drivers	no
295.It kern.dump_on_panic	integer	yes
296.It kern.file	struct file	no
297.It kern.forkfsleep	integer	yes
298.It kern.fscale	integer	no
299.It kern.fsync	integer	no
300.It kern.hardclock_ticks	integer	no
301.It kern.hostid	integer	yes
302.It kern.hostname	string	yes
303.It kern.iov_max	integer	no
304.It kern.ipc	node	not applicable
305.It kern.job_control	integer	no
306.It kern.labeloffset	integer	no
307.It kern.labelsector	integer	no
308.It kern.login_name_max	integer	no
309.It kern.logsigexit	integer	yes
310.It kern.mapped_files	integer	no
311.It kern.maxfiles	integer	yes
312.It kern.maxlwp	integer	yes
313.It kern.maxpartitions	integer	no
314.It kern.maxphys	integer	no
315.It kern.maxproc	integer	yes
316.It kern.maxptys	integer	yes
317.It kern.maxvnodes	integer	yes
318.It kern.messages	integer yes
319.It kern.mbuf	node	not applicable
320.It kern.memlock	integer	no
321.It kern.memlock_range	integer	no
322.It kern.memory_protection	integer	no
323.It kern.module	node	not applicable
324.It kern.monotonic_clock	integer	no
325.It kern.mqueue	node	not applicable
326.It kern.msgbuf	integer	no
327.It kern.msgbufsize	integer	no
328.It kern.ngroups	integer	no
329.\".It kern.no_sa_support	integer	yes
330.It kern.ntptime	struct ntptimeval	no
331.It kern.osrelease	string	no
332.It kern.osrevision	integer	no
333.It kern.ostype	string	no
334.\".It kern.panic_now	integer	yes
335.It kern.pipe	node	not applicable
336.It kern.pool	struct pool_sysctl	no
337.\" .It kern.posix	node	not applicable
338.It kern.posix1version	integer	no
339.It kern.posix_aio	integer	no
340.It kern.posix_barriers	integer	no
341.It kern.posix_reader_writer_locks	integer	no
342.\".It kern.posix_sched	integer	yes
343.It kern.posix_semaphores	integer	no
344.It kern.posix_spin_locks	integer	no
345.It kern.posix_threads	integer	no
346.It kern.posix_timers	integer	no
347.It kern.proc	struct kinfo_proc	no
348.It kern.proc2	struct kinfo_proc2	no
349.It kern.proc_args	string	no
350.It kern.profiling	node	not applicable
351.\".It kern.pset	node	not applicable
352.It kern.rawpartition	integer	no
353.It kern.root_device	string	no
354.It kern.root_partition	integer	no
355.It kern.rtc_offset	integer	yes
356.It kern.saved_ids	integer	no
357.It kern.sbmax	integer	yes
358.\".It kern.sched	node	not applicable
359.It kern.securelevel	integer	raise only
360.It kern.somaxkva	integer	yes
361.It kern.synchronized_io	integer	no
362.It kern.timecounter	node	not applicable
363.It kern.timex	struct	no
364.It kern.tkstat	node	not applicable
365.It kern.tty	node	not applicable
366.It kern.urandom	integer	no
367.It kern.usercrypto	integer	yes
368.It kern.userasymcrypto	integer	yes
369.It kern.veriexec	node	not applicable
370.It kern.version	string	no
371.It kern.vnode	struct vnode	no
372.El
373.Bl -tag -width "123456"
374.It Li kern.aio_listio_max
375The maximum number of asynchronous
376.Tn I/O
377operations in a single list I/O call.
378Like with all variables related to
379.Xr aio 3 ,
380the variable may be created and removed dynamically
381upon loading or unloading the corresponding kernel module.
382.It Li kern.aio_max
383The maximum number of asynchronous I/O operations.
384.It Li kern.arandom
385This variable picks a random number each time it is queried.
386The used random number generator
387.Pf ( Tn RNG )
388is based on
389.Xr arc4random 3 .
390.It Li kern.argmax ( Dv KERN_ARGMAX )
391The maximum bytes of argument to
392.Xr execve 2 .
393.It Li kern.boothowto
394Flags passed from the boot loader; see
395.Xr reboot 2
396for the meanings of the flags.
397.It Li kern.boottime ( Dv KERN_BOOTTIME )
398A
399.Vt struct timeval
400structure is returned.
401This structure contains the time that the system was booted.
402.It Li kern.bufq
403This variable contains information on the
404.Xr bufq 9
405subsystem.
406Currently, the only third level name implemented is
407.Dv kern.bufq.strategies
408which provides a list of buffer queue strategies currently available.
409.It Li kern.buildinfo
410When the kernel is built, the build environment may optionally provide
411arbitrary information to be stored in this variable.
412.It Li kern.ccpu ( Dv KERN_CCPU )
413The scheduler exponential decay value.
414.It Li kern.clockrate ( Dv KERN_CLOCKRATE )
415A
416.Vt struct clockinfo
417structure is returned.
418This structure contains the clock, statistics clock and profiling clock
419frequencies, the number of micro-seconds per hz tick, and the clock
420skew rate.
421Refer to
422.Xr hz 9
423for additional details.
424.It Li kern.consdev ( Dv KERN_CONSDEV )
425Console device.
426.It Li kern.coredump
427Settings related to set-id processes coredumps.
428By default, set-id processes do not dump core in situations where
429other processes would.
430The settings in this node allows an administrator to change this
431behavior.
432.Pp
433The third level name is
434.Dv kern.coredump.setid
435and fourth level variables are described below.
436.Bl -column "kern.coredump.setid.group" "integer" "Changeable" -offset indent
437.It Sy Fourth level name	Sy Type	Sy Changeable
438.It kern.coredump.setid.dump	integer	yes
439.It kern.coredump.setid.group	integer	yes
440.It kern.coredump.setid.mode	integer	yes
441.It kern.coredump.setid.owner	integer	yes
442.It kern.coredump.setid.path	string	yes
443.El
444.Bl -tag -width "123456"
445.It Li kern.coredump.setid.dump
446If non-zero, set-id processes will dump core.
447.It Li kern.coredump.setid.group
448The group-id for the set-id processes' coredump.
449.It Li kern.coredump.setid.mode
450The mode for the set-id processes' coredump.
451See
452.Xr chmod 1 .
453.It Li kern.coredump.setid.owner
454The user-id that will be used as the owner of the set-id processes'
455coredump.
456.It Li kern.coredump.setid.path
457The path to which set-id processes' coredumps will be saved to.
458Same syntax as kern.defcorename.
459.El
460.It Li kern.cp_id ( Dv KERN_CP_ID )
461Mapping of CPU number to CPU id.
462.It Li kern.cp_time ( Dv KERN_CP_TIME )
463Returns an array of
464.Dv CPUSTATES
465.Vt uint64_t Ns s .
466This array contains the
467number of clock ticks spent in different CPU states.
468On multi-processor systems, the sum across all CPUs is returned unless
469appropriate space is given for one data set for each CPU.
470Data for a specific CPU can also be obtained by adding the number of the
471CPU at the end of the MIB, enlarging it by one.
472.It Li kern.cryptodevallowsoft
473This variable controls userland access to hardware versus software transforms
474in the
475.Xr crypto 4
476system.
477The available values are as follows:
478.Bl -tag -width XX0 -offset indent
479.It Dv \*[Lt] 0
480Always force userlevel requests to use software transforms.
481.It Dv = 0
482If present, use hardware and grant userlevel requests for
483non-accelerated transforms (handling the latter in software).
484.It Dv \*[Gt] 0
485Allow user requests only for transforms which are hardware-accelerated.
486.El
487.It Li kern.defcorename ( Dv KERN_DEFCORENAME )
488Default template for the name of core dump files (see also
489.Li proc.pid.corename
490in the per-process variables
491.Li proc.* ,
492and
493.Xr core 5
494for format of this template).
495The default value is
496.Pa %n.core
497and can be changed with the kernel configuration option
498.Cd options DEFCORENAME
499(see
500.Xr options 4
501).
502.It Li kern.detachall
503Detach all devices at shutdown.
504.It Li kern.domainname ( Dv KERN_DOMAINNAME )
505Get or set the YP domain name.
506.It Li kern.drivers ( Dv KERN_DRIVERS )
507Return an array of
508.Vt struct kinfo_drivers
509that contains the name and major device numbers of all the device drivers
510in the current kernel.
511The
512.Va d_name
513field is always a NUL terminated string.
514The
515.Va d_bmajor
516field will be set to \-1 if the driver doesn't have a block device.
517.It Li kern.dump_on_panic ( Dv KERN_DUMP_ON_PANIC )
518Perform a crash dump on system
519.Xr panic 9 .
520.It Li kern.file ( Dv KERN_FILE )
521Return the entire file table.
522The returned data consists of a single
523.Vt struct filelist
524followed by an array of
525.Vt struct file ,
526whose size depends on the current number of such objects in the system.
527.It Li kern.forkfsleep ( Dv KERN_FORKFSLEEP )
528If
529.Xr fork 2
530system call fails due to limit on number of processes (either
531the global maxproc limit or user's one), wait for this many
532milliseconds before returning
533.Er EAGAIN
534error to process.
535Useful to keep heavily forking runaway processes in bay.
536Default zero (no sleep).
537Maximum is 20 seconds.
538.It Li kern.fscale ( Dv KERN_FSCALE )
539The kernel fixed-point scale factor.
540.It Li kern.fsync ( Dv KERN_FSYNC )
541Return 1 if the
542.St -p1003.1b-93
543File Synchronization Option is available
544on this system,
545otherwise\ 0.
546.It Li kern.hardclock_ticks ( Dv KERN_HARDCLOCK_TICKS )
547Returns the number of
548.Xr hardclock 9
549ticks.
550.It Li kern.hist
551This variable contains kernel history data if the kernel was
552configured for any of the options
553.Dv UVHMIST ,
554.Dv USB_DEBUG ,
555.Dv BIOHIST ,
556or
557.Dv SCDEBUG .
558(See
559.Xr options 4
560for more details.)
561The third-level names correspond to each available history table.
562The values of the history tables are in an internal format, and can be
563decoded by the
564.Xr vmstat 1
565utility's
566.Fl U
567and
568.Fl u
569options;
570the
571.Fl l
572option can be used to see which tables are available.
573.It Li kern.hostid ( Dv KERN_HOSTID )
574Get or set the host identifier.
575This is aimed to replace the legacy
576.Xr gethostid 3
577and
578.Xr sethostid 3
579system calls.
580.It Li kern.hostname ( Dv KERN_HOSTNAME )
581Get or set the
582.Xr hostname 1 .
583.It Li kern.iov_max ( Dv KERN_IOV_MAX )
584Return the maximum number of
585.Vt iovec
586structures that a process has available for use with
587.Xr preadv 2 ,
588.Xr pwritev 2 ,
589.Xr readv 2 ,
590.Xr recvmsg 2 ,
591.Xr sendmsg 2
592and
593.Xr writev 2 .
594.It Li kern.ipc ( Dv KERN_SYSVIPC )
595Return information about the SysV IPC parameters.
596The third level names for the ipc variables are detailed below.
597.Bl -column "kern.ipc.shm_use_phys" "integer" "Changeable" -offset indent
598.It Sy Third level name	Sy Type	Sy Changeable
599.It kern.ipc.sysvmsg	integer	no
600.It kern.ipc.sysvsem	integer	no
601.It kern.ipc.sysvshm	integer	no
602.It kern.ipc.sysvipc_info	struct	no
603.It kern.ipc.shmmax	integer	yes
604.It kern.ipc.shmmni	integer	yes
605.It kern.ipc.shmseg	integer	yes
606.It kern.ipc.shmmaxpgs	integer	yes
607.It kern.ipc.shm_use_phys	integer	yes
608.It kern.ipc.msgmni	integer	yes
609.It kern.ipc.msgseg	integer	yes
610.It kern.ipc.semmni	integer	yes
611.It kern.ipc.semmns	integer	yes
612.It kern.ipc.semmnu	integer	yes
613.El
614.Bl -tag -width "123456"
615.It Li kern.ipc.sysvmsg ( Dv KERN_SYSVIPC_MSG )
616Returns 1 if System V style message queue functionality is available
617on this system,
618otherwise\ 0.
619.It Li kern.ipc.sysvsem ( Dv KERN_SYSVIPC_SEM )
620Returns 1 if System V style semaphore functionality is available
621on this system,
622otherwise\ 0.
623.It Li kern.ipc.sysvshm ( Dv KERN_SYSVIPC_SHM )
624Returns 1 if System V style share memory functionality is available
625on this system,
626otherwise\ 0.
627.It Li kern.ipc.sysvipc_info ( Dv KERN_SYSVIPC_INFO )
628Return System V style IPC configuration and run-time information.
629The fourth level name selects the System V style IPC facility.
630.Bl -column "KERN_SYSVIPC_MSG_INFO" "struct shm_sysctl_info" -offset indent
631.It Sy Fourth level name	Sy Type
632.It KERN_SYSVIPC_MSG_INFO	struct msg_sysctl_info
633.It KERN_SYSVIPC_SEM_INFO	struct sem_sysctl_info
634.It KERN_SYSVIPC_SHM_INFO	struct shm_sysctl_info
635.El
636.Bl -tag -width "123456"
637.It Li KERN_SYSVIPC_MSG_INFO
638Return information on the System V style message facility.
639The
640.Sy msg_sysctl_info
641structure is defined in
642.In sys/msg.h .
643.It Li KERN_SYSVIPC_SEM_INFO
644Return information on the System V style semaphore facility.
645The
646.Sy sem_sysctl_info
647structure is defined in
648.In sys/sem.h .
649.It Li KERN_SYSVIPC_SHM_INFO
650Return information on the System V style shared memory facility.
651The
652.Sy shm_sysctl_info
653structure is defined in
654.In sys/shm.h .
655.El
656.It Li kern.ipc.shmmax ( Dv KERN_SYSVIPC_SHMMAX )
657Max shared memory segment size in bytes.
658.It Li kern.ipc.shmmni ( Dv KERN_SYSVIPC_SHMMNI )
659Max number of shared memory identifiers.
660.It Li kern.ipc.shmseg ( Dv KERN_SYSVIPC_SHMSEG )
661Max shared memory segments per process.
662.It Li kern.ipc.shmmaxpgs ( Dv KERN_SYSVIPC_SHMMAXPGS )
663Max amount of shared memory in pages.
664.It Li kern.ipc.shm_use_phys ( Dv KERN_SYSVIPC_SHMUSEPHYS )
665Locking of shared memory in physical memory.
666If 0, memory can be swapped
667out, otherwise it will be locked in physical memory.
668.It Li kern.ipc.msgmni
669Max number of message queue identifiers.
670.It Li kern.ipc.msgseg
671Max number of number of message segments.
672.It Li kern.ipc.semmni
673Max number of number of semaphore identifiers.
674.It Li kern.ipc.semmns
675Max number of number of semaphores in system.
676.It Li kern.ipc.semmnu
677Max number of undo structures in system.
678.El
679.It Li kern.job_control ( Dv KERN_JOB_CONTROL )
680Return 1 if job control is available on this system, otherwise\ 0.
681.It Li kern.labeloffset ( Dv KERN_LABELOFFSET )
682The offset within the sector specified by
683.Dv KERN_LABELSECTOR
684of the
685.Xr disklabel 5 .
686.It Li kern.labelsector ( Dv KERN_LABELSECTOR )
687The sector number containing the
688.Xr disklabel 5 .
689.It Li kern.login_name_max ( Dv KERN_LOGIN_NAME_MAX )
690The size of the storage required for a login name, in bytes,
691including the terminating NUL.
692.It Li kern.logsigexit ( Dv KERN_LOGSIGEXIT )
693If this flag is non-zero, the kernel will
694.Xr log 9
695all process exits due to signals which create a
696.Xr core 5
697file, and whether the coredump was created.
698.It Li kern.mapped_files ( Dv KERN_MAPPED_FILES )
699Returns 1 if the
700.St -p1003.1b-93
701Memory Mapped Files Option is available on this system,
702otherwise\ 0.
703.It Li kern.maxfiles ( Dv KERN_MAXFILES )
704The maximum number of open files that may be open in the system.
705.It Li kern.maxpartitions ( Dv KERN_MAXPARTITIONS )
706The maximum number of partitions allowed per disk.
707.It Li kern.maxlwp
708The maximum number of Lightweight Processes (threads) the system allows
709per uid.
710.It Li kern.maxphys ( Dv KERN_MAXPHYS )
711Maximum raw I/O transfer size.
712.It Li kern.maxproc ( Dv KERN_MAXPROC )
713The maximum number of simultaneous processes the system will allow.
714.It Li kern.maxptys ( Dv KERN_MAXPTYS )
715The maximum number of pseudo terminals.
716This value can be both raised and lowered, though it cannot
717be set lower than number of currently used ptys.
718See also
719.Xr pty 4 .
720.It Li kern.maxvnodes ( Dv KERN_MAXVNODES )
721The maximum number of vnodes available on the system.
722This can only be raised.
723.It Li kern.mbuf ( Dv KERN_MBUF )
724Return information about the mbuf control variables.
725Mbufs are data structures which store network packets and other data
726structures in the networking code, see
727.Xr mbuf 9 .
728The third level names for the mbuf variables are detailed below.
729The changeable column shows whether a process with appropriate
730privilege may change the value.
731.Bl -column "kern.mbuf.nmbclusters" "integer" "Changeable" -offset indent
732.It Sy Third level name	Sy Type	Sy Changeable
733.\" XXX Changeable? really?
734.It kern.mbuf.mblowat	integer	yes
735.It kern.mbuf.mclbytes	integer	yes
736.It kern.mbuf.mcllowat	integer	yes
737.It kern.mbuf.msize	integer	yes
738.It kern.mbuf.nmbclusters	integer	yes
739.El
740.Pp
741The variables are as follows:
742.Bl -tag -width "123456"
743.It Li kern.mbuf.mblowat ( Dv MBUF_MBLOWAT )
744The mbuf low water mark.
745.It Li kern.mbuf.mclbytes ( Dv MBUF_MCLBYTES )
746The mbuf cluster size.
747.It Li kern.mbuf.mcllowat ( Dv MBUF_MCLLOWAT )
748The mbuf cluster low water mark.
749.It Li kern.mbuf.msize ( Dv MBUF_MSIZE )
750The mbuf base size.
751.It Li kern.mbuf.nmbclusters ( Dv MBUF_NMBCLUSTERS )
752The limit on the number of mbuf clusters.
753The variable can only be increased, and only increased on machines with
754direct-mapped pool pages.
755.El
756.It Li kern.memlock ( Dv KERN_MEMLOCK )
757Returns 1 if the
758.St -p1003.1b-93
759Process Memory Locking Option is available on this system,
760otherwise\ 0.
761.It Li kern.memlock_range ( Dv KERN_MEMLOCK_RANGE )
762Returns 1 if the
763.St -p1003.1b-93
764Range Memory Locking Option is available on this system,
765otherwise\ 0.
766.It Li kern.memory_protection ( Dv KERN_MEMORY_PROTECTION )
767Returns 1 if the
768.St -p1003.1b-93
769Memory Protection Option is available on this system,
770otherwise\ 0.
771.It Li kern.messages
772Kernel console message verbosity.
773See
774.Sy \<sys/reboot.h\>
775.Bl -column "verbosity" "setting" -offset indent
776.It Sy Verbosity       Setting
777.It \ \ \ \ 0  Silent Sy AB_SILENT
778.It \ \ \ \ 1  Quiet Sy AB_QUIET
779.It \ \ \ \ 2  Normal Sy AB_NORMAL
780.It \ \ \ \ 3  Verbose Sy AB_VERBOSE
781.It \ \ \ \ 4  Debug Sy AB_DEBUG
782.El
783.It Li kern.module
784Settings related to kernel modules.
785The third level names for the settings are described below.
786.Bl -column "kern.module.autoload" "integer" "Changeable" -offset indent
787.It Sy Third level name	Sy Type	Sy Changeable
788.It kern.module.autoload	integer	yes
789.It kern.module.autotime	integer	yes
790.It kern.module.verbose	integer	yes
791.El
792.Pp
793The variables are as follows:
794.Bl -tag -width "123456"
795.It Li kern.module.autoload
796A boolean that controls whether kernel modules are loaded automatically.
797See
798.Xr module 7
799for additional details.
800.It Li kern.module.autotime
801An integer that controls the delay before an attempt is made to
802automatically unload a module that was auto-loaded.
803Setting this value to zero disables the auto-unload function.
804.It Li kern.module.verbose
805A boolean that enables or disables verbose
806debug messages related to kernel modules.
807.El
808.It Li kern.monotonic_clock ( Dv KERN_MONOTONIC_CLOCK )
809Returns the standard version the implementation of the
810.St -p1003.1b-93
811Monotonic Clock Option conforms to,
812otherwise\ 0.
813.It Li kern.mqueue
814Settings related to
815.Tn POSIX
816message queues; see
817.Xr mqueue 3 .
818This node is created dynamically when
819the corresponding kernel module is loaded.
820The third level names for the settings are described below.
821.Bl -column "kern.mqueue.mq_max_msgsize" "integer" "Changeable" -offset indent
822.It Sy Third level name	Sy Type	Sy Changeable
823.It kern.mqueue.mq_open_max	integer	yes
824.It kern.mqueue.mq_prio_max	integer	yes
825.It kern.mqueue.mq_max_msgsize	integer	yes
826.It kern.mqueue.mq_def_maxmsg	integer	yes
827.It kern.mqueue.mq_max_maxmsg	integer	yes
828.El
829.Pp
830The variables are:
831.Bl -tag -width "123456"
832.It Li kern.mqueue.mq_open_max
833The maximum number of message queue descriptors any single process can open.
834.It Li kern.mqueue.mq_prio_max
835The maximum priority of a message.
836.It Li kern.mqueue.mq_max_msgsize
837The maximum size of a message in a message queue.
838.It Li kern.mqueue.mq_def_maxmsg
839The default maximum message count.
840.It Li kern.mqueue.mq_max_maxmsg
841The maximum number of messages in a message queue.
842.El
843.It Li kern.msgbuf ( Dv KERN_MSGBUF )
844The kernel message buffer, rotated so that the head of the circular kernel
845message buffer is at the start of the returned data.
846The returned data may contain NUL bytes.
847.It Li kern.msgbufsize ( Dv KERN_MSGBUFSIZE )
848The maximum number of characters that the kernel message buffer can hold.
849.It Li kern.ngroups ( Dv KERN_NGROUPS )
850The maximum number of supplemental groups.
851.\" .It Li kern.no_sa_support
852.\" XXX: Undocumented.
853.It Li kern.ntptime ( Dv KERN_NTPTIME )
854A
855.Vt struct ntptimeval
856structure is returned.
857This structure contains data used by the
858.Xr ntpd 8
859program.
860.It Li kern.osrelease ( Dv KERN_OSRELEASE )
861The system release string.
862.It Li kern.osrevision ( Dv KERN_OSREV )
863The system revision string.
864.It Li kern.ostype ( Dv KERN_OSTYPE )
865The system type string.
866.\".It Li kern.panic_now
867.\" XXX: Undocumented.
868.It Li kern.pipe ( Dv KERN_PIPE )
869Pipe settings.
870The third level names for the  integer pipe settings is detailed below.
871The changeable column shows whether a process with appropriate
872privilege may change the value.
873.Bl -column "kern.pipe.maxbigpipes" "integer" "Changeable" -offset indent
874.It Sy Third level name	Sy Type	Sy Changeable
875.It kern.pipe.kvasiz	integer	yes
876.It kern.pipe.maxbigpipes	integer	yes
877.It kern.pipe.maxkvasz	integer	yes
878.It kern.pipe.limitkva	integer	yes
879.It kern.pipe.nbigpipes	integer	yes
880.El
881.Pp
882The variables are as follows:
883.Bl -tag -width "123456"
884.It Li kern.pipe.kvasiz ( Dv KERN_PIPE_KVASIZ )
885Amount of kernel memory consumed by pipe buffers.
886.It Li kern.pipe.maxbigpipes ( Dv KERN_PIPE_MAXBIGPIPES )
887Maximum number of
888.Dq big
889pipes.
890.It Li kern.pipe.maxkvasz ( Dv KERN_PIPE_MAXKVASZ )
891Maximum amount of kernel memory to be used for pipes.
892.It Li kern.pipe.limitkva ( Dv KERN_PIPE_LIMITKVA )
893Limit for direct transfers via page loan.
894.It Li kern.pipe.nbigpipes ( Dv KERN_PIPE_NBIGPIPES )
895Number of
896.Dq big
897pipes.
898.El
899.It Li kern.pool
900Provides statistics about the
901.Xr pool 9
902and
903.Xr pool_cache 9
904subsystems.
905.\" XXX: Undocumented .It Li kern.posix ( ? )
906.\"	 This is a node in which the only variable is semmax.
907.It Li kern.posix1version ( Dv KERN_POSIX1 )
908The version of ISO/IEC 9945
909.Pq St -p1003.1
910with which the system attempts to comply.
911.It Li kern.posix_aio
912The version of
913.St -p1003.1
914and its Asynchronous I/O option to which the system attempts to conform.
915.It Li kern.posix_barriers ( Dv KERN_POSIX_BARRIERS )
916The version of
917.St -p1003.1
918and its
919Barriers
920option to which the system attempts to conform,
921otherwise\ 0.
922.It Li kern.posix_reader_writer_locks ( Dv KERN_POSIX_READER_WRITER_LOCKS )
923The version of
924.St -p1003.1
925and its
926Read-Write Locks
927option to which the system attempts to conform,
928otherwise\ 0.
929.\".It Li kern.posix_sched
930.\" XXX: Undocumented.
931.It Li kern.posix_semaphores ( Dv KERN_POSIX_SEMAPHORES )
932The version of
933.St -p1003.1
934and its
935Semaphores
936option to which the system attempts to conform,
937otherwise\ 0.
938.It Li kern.posix_spin_locks ( Dv KERN_POSIX_SPIN_LOCKS )
939The version of
940.St -p1003.1
941and its
942Spin Locks
943option to which the system attempts to conform,
944otherwise\ 0.
945.It Li kern.posix_threads ( Dv KERN_POSIX_THREADS )
946The version of
947.St -p1003.1
948and its
949Threads
950option to which the system attempts to conform,
951otherwise\ 0.
952.It Li kern.posix_timers ( Dv KERN_POSIX_TIMERS )
953The version of
954.St -p1003.1
955and its
956Timers
957option to which the system attempts to conform,
958otherwise\ 0.
959.It Li kern.proc ( Dv KERN_PROC )
960Return the entire process table, or a subset of it.
961An array of
962.Vt struct kinfo_proc
963structures is returned,
964whose size depends on the current number of such objects in the system.
965The third and fourth level numeric names are as follows:
966.Bl -column "KERN_PROC_SESSION" "Fourth level is:" -offset indent
967.It Sy Third level name	Sy Fourth level is:
968.It KERN_PROC_ALL	None
969.It KERN_PROC_GID	A group ID
970.It KERN_PROC_PID	A process ID
971.It KERN_PROC_PGRP	A process group
972.It KERN_PROC_RGID	A real group ID
973.It KERN_PROC_RUID	A real user ID
974.It KERN_PROC_SESSION	A session ID
975.It KERN_PROC_TTY	A tty device
976.It KERN_PROC_UID	A user ID
977.El
978.It Li kern.proc2 ( Dv KERN_PROC2 )
979As for
980.Dv KERN_PROC ,
981but an array of
982.Vt struct kinfo_proc2
983structures are returned.
984The fifth level name is the size of the
985.Vt struct kinfo_proc2
986and the sixth level name is the number of structures to return.
987.It Li kern.proc_args ( Dv KERN_PROC_ARGS )
988Return the argv or environment strings (or the number thereof)
989of a process.
990Multiple strings are returned separated by NUL characters.
991The third level name is the process ID.
992The fourth level name is as follows:
993.Bl -column "KERN_PROG_PATHNAME" "The full pathname of the executable" -offset indent
994.It Dv KERN_PROC_ARGV	The argv strings
995.It Dv KERN_PROC_ENV	The environ strings
996.It Dv KERN_PROC_NARGV	The number of argv strings
997.It Dv KERN_PROC_NENV	The number of environ strings
998.It Dv KERN_PROC_PATHNAME	The full pathname of the executable
999.El
1000.It Li kern.profiling ( Dv KERN_PROF )
1001Return profiling information about the kernel.
1002If the kernel is not compiled for profiling,
1003attempts to retrieve any of the
1004.Dv KERN_PROF
1005values will fail with
1006.Er EOPNOTSUPP .
1007The third level names for the string and integer profiling information
1008is detailed below.
1009The changeable column shows whether a process with appropriate
1010privilege may change the value.
1011.Bl -column "kern.profiling.gmonparam" "struct gmonparam" "Changeable" -offset indent
1012.It Sy Third level name	Sy Type	Sy Changeable
1013.It kern.profiling.count	u_short[\|]	yes
1014.It kern.profiling.froms	u_short[\|]	yes
1015.It kern.profiling.gmonparam	struct gmonparam	no
1016.It kern.profiling.state	integer	yes
1017.It kern.profiling.tos	struct tostruct	yes
1018.El
1019.Pp
1020The variables are as follows:
1021.Bl -tag -width "123456"
1022.It Li kern.profiling.count ( Dv GPROF_COUNT )
1023Array of statistical program counter counts.
1024.It Li kern.profiling.froms ( Dv GPROF_FROMS )
1025Array indexed by program counter of call-from points.
1026.It Li kern.profiling.gmonparams ( Dv GPROF_GMONPARAM )
1027Structure giving the sizes of the above arrays.
1028.It Li kern.profiling.state ( Dv GPROF_STATE )
1029Profiling state.
1030If set to
1031.Dv GMON_PROF_ON ,
1032starts profiling.
1033If set to
1034.Dv GMON_PROF_OFF ,
1035stops profiling.
1036.It Li kern.profiling.tos ( Dv GPROF_TOS )
1037Array of
1038.Vt struct tostruct
1039describing destination of calls and their counts.
1040.El
1041.\" .It Li kern.pset
1042.\" XXX: Undocumented.
1043.It Li kern.rawpartition ( Dv KERN_RAWPARTITION )
1044The raw partition of a disk (a == 0).
1045.It Li kern.root_device ( Dv KERN_ROOT_DEVICE )
1046The name of the root device (e.g.,
1047.Dq wd0 ) .
1048.It Li kern.root_partition ( Dv KERN_ROOT_PARTITION )
1049The root partition on the root device (a == 0).
1050.It Li kern.rtc_offset ( Dv KERN_RTC_OFFSET )
1051Return the offset of real time clock from UTC in minutes.
1052.It Li kern.saved_ids ( Dv KERN_SAVED_IDS )
1053Returns 1 if saved set-group and saved set-user ID is available.
1054.It Li kern.sbmax ( Dv KERN_SBMAX )
1055Maximum socket buffer size.
1056.\" XXX units?
1057.It Li kern.securelevel ( Dv KERN_SECURELVL )
1058See
1059.Xr secmodel_securelevel 9 .
1060.\" .It Li kern.sched
1061.\" XXX: Undocumented.
1062.It Li kern.somaxkva ( Dv KERN_SOMAXKVA )
1063Maximum amount of kernel memory to be used for socket buffers.
1064.\" XXX units?
1065.It Li kern.synchronized_io ( Dv KERN_SYNCHRONIZED_IO )
1066Returns 1 if the
1067.St -p1003.1b-93
1068Synchronized I/O Option is available on this system,
1069otherwise\ 0.
1070.It Li kern.timecounter ( dynamic )
1071Display and control the timecounter source of the system.
1072.Bl -column "kern.timecounter.timestepwarnings" "integer" "Changeable" -offset indent
1073.It Sy Third level name	Sy Type	Sy Changeable
1074.It kern.timecounter.choice	string	no
1075.It kern.timecounter.hardware	string	yes
1076.It kern.timecounter.timestepwarnings	integer	yes
1077.El
1078.Pp
1079The variables are as follows:
1080.Bl -tag -width "123456"
1081.It Li kern.timecounter.choice ( dynamic )
1082The list of available timecounters with their quality and frequency.
1083.It Li kern.timecounter.hardware ( dynamic )
1084The currently selected timecounter source.
1085.It Li kern.timecounter.timestepwarnings ( dynamic )
1086If non-zero display a message each time the time is stepped.
1087.El
1088.It Li kern.timex ( Dv KERN_TIMEX )
1089Not available.
1090.It Li kern.tkstat ( Dv KERN_TKSTAT )
1091Return information about the number of characters sent and received
1092on ttys.
1093The third level names for the tty statistic variables are detailed below.
1094The changeable column shows whether a process
1095with appropriate privilege may change the value.
1096.Bl -column "kern.tkstat.cancc" "quad" "Changeable" -offset indent
1097.It Sy Third level name	Sy Type	Sy Changeable
1098.It kern.tkstat.cancc	quad	no
1099.It kern.tkstat.nin	quad	no
1100.It kern.tkstat.nout	quad	no
1101.It kern.tkstat.rawcc	quad	no
1102.El
1103.Pp
1104The variables are as follows:
1105.Bl -tag -width "123456"
1106.It Li kern.tkstat.cancc ( Dv KERN_TKSTAT_CANCC )
1107The number of canonical input characters.
1108.It Li kern.tkstat.nin ( Dv KERN_TKSTAT_NIN )
1109The total number of input characters.
1110.It Li kern.tkstat.nout ( Dv KERN_TKSTAT_NOUT )
1111The total number of output characters.
1112.It Li kern.tkstat.rawcc ( Dv KERN_TKSTAT_RAWCC )
1113The number of raw input characters.
1114.El
1115.It Li kern.tty
1116The third level names for the tty setup variables are detailed below.
1117The changeable column shows whether a process
1118with appropriate privilege may change the value.
1119.Bl -column "kern.tty.qsize" "int" "Changeable" -offset indent
1120.It Sy Third level name	Sy Type	Sy Changeable
1121.It kern.tty.qsize	int	yes
1122.El
1123.Pp
1124The variables are as follows:
1125.Bl -tag -width "123456"
1126.It Li kern.tty.qsize
1127Control/display the size of the default input and output queues selected
1128during tty creation.
1129Is converted to a power of two and its range is between
1130.Dv 1024
1131and
1132.Dv 65536 .
1133.El
1134.It Li kern.uidinfo
1135Resource usage for the current user.
1136.Bl -column "kern.uidinfo.proccnt" "integer" "Changeable" -offset indent
1137.It Sy Third level name	Sy Type	Sy Changeable
1138.It kern.uidinfo.proccnt	integer	no
1139.It kern.uidinfo.lwpcnt	integer	no
1140.It kern.uidinfo.lockcnt	integer	no
1141.It kern.uidinfo.sbsize	integer	no
1142.El
1143.Bl -tag -width "123456"
1144.It Li kern.uidinfo.proccnt
1145Returns the number of active processes for the current user.
1146.It Li kern.uidinfo.lwpcnt
1147Returns the number of active threads for the current user; the first thread
1148of each process is not counted.
1149.It Li kern.uidinfo.lockcnt
1150Number of locks held by the current user.
1151.It Li kern.uidinfo.sbsize
1152Number of bytes in socket buffers allocated to the current user.
1153.El
1154.It Li kern.urandom ( Dv KERN_URND )
1155Random integer value.
1156.It Li kern.usercrypto
1157When enabled, allows userland to
1158.Xr open 2
1159the
1160.Pa /dev/crypto
1161special device, used by the
1162.Xr crypto 4
1163system.
1164.It Li kern.userasymcrypto
1165Enables or disables the use of software asymmetric crypto support in the
1166.Xr crypto 4
1167system.
1168.It Li kern.veriexec
1169Runtime information for
1170.Xr veriexec 8 .
1171.Bl -column "kern.veriexec.algorithms" "integer" "Changeable" -offset indent
1172.It Sy Third level name	Sy Type	Sy Changeable
1173.It kern.veriexec.algorithms	string	no
1174.It kern.veriexec.count	node	not applicable
1175.It kern.veriexec.strict	integer	yes
1176.It kern.veriexec.verbose	integer	yes
1177.El
1178.Bl -tag -width "123456"
1179.It Li kern.veriexec.algorithms
1180Returns a string with the supported algorithms in Veriexec.
1181.It Li kern.veriexec.count
1182Sub-nodes are added to this node as new mounts are monitored by Veriexec.
1183Each mount will be under its own
1184.No tableN
1185node.
1186Under each node there will be three variables, indicating the mount
1187point, the file system type, and the number of entries.
1188.It Li kern.veriexec.strict
1189Controls the strict level of Veriexec.
1190See
1191.Xr security 7
1192for more information on each level's implications.
1193.It Li kern.veriexec.verbose
1194Controls the verbosity level of Veriexec.
1195If 0, only the minimal
1196indication required will be given about what's happening - fingerprint
1197mismatches, removal of entries from the tables, modification of a
1198fingerprinted file.
1199If 1, more messages will be printed (ie., when a file with a valid
1200fingerprint is accessed).
1201Verbose level 2 is debug mode.
1202.El
1203.It Li kern.version ( Dv KERN_VERSION )
1204The system version string.
1205.It Li kern.vnode ( Dv KERN_VNODE )
1206Return the entire vnode table.
1207Note, the vnode table is not necessarily a consistent snapshot of
1208the system.
1209The returned data consists of an array whose size depends on the
1210current number of such objects in the system.
1211Each element of the array contains the kernel address of a vnode
1212.Vt struct vnode *
1213followed by the vnode itself
1214.Vt struct vnode .
1215.\" XXX: Undocumented: kern.lwp: no children?
1216.El
1217.Ss The machdep.* subtree
1218The set of variables defined is architecture dependent.
1219Most architectures define at least the following variables.
1220.Bl -column "machdep.booted_kernel" "Type" "Changeable" -offset indent
1221.It Sy Second level name	Sy Type	Sy Changeable
1222.It Li machdep.booted_kernel	string	no
1223.El
1224.\" XXX: Document the above.
1225.Ss The net.* subtree
1226The string and integer information available for the
1227.Li net
1228level is detailed below.
1229The changeable column shows whether a process with appropriate
1230privilege may change the value.
1231The second and third levels are typically the protocol family and
1232protocol number, though this is not always the case.
1233.Bl -column "Second level name" "IPsec key management values" "Changeable" -offset indent
1234.It Sy Second level name	Sy Type	Sy Changeable
1235.It net.route	routing messages	no
1236.It net.inet	IPv4 values	yes
1237.It net.inet6	IPv6 values	yes
1238.It net.key	IPsec key management values	yes
1239.El
1240.Bl -tag -width "123456"
1241.It Li net.route ( Dv PF_ROUTE )
1242.\" XXX really?
1243Return the entire routing table or a subset of it.
1244The data is returned as a sequence of routing messages (see
1245.Xr route 4
1246for the header file, format and meaning).
1247The length of each message is contained in the message header.
1248.Pp
1249The third level name is a protocol number, which is currently always\ 0.
1250The fourth level name is an address family, which may be set to 0 to
1251select all address families.
1252The fifth and sixth level names are as follows:
1253.Bl -column "Fifth level name" "Sixth level is:" -offset indent
1254.It Sy Fifth level name	Sy Sixth level is:
1255.It NET_RT_FLAGS	rtflags
1256.It NET_RT_DUMP	None
1257.It NET_RT_IFLIST	None
1258.El
1259.It Li net.inet ( Dv PF_INET )
1260Get or set various global information about the IPv4
1261.Pq Internet Protocol version 4 .
1262The third level name is the protocol.
1263The fourth level name is the variable name.
1264The currently defined protocols and names are:
1265.Bl -column "Protocol" "anonportalgo.available" "integer" "Changeable" -offset indent
1266.It Sy Protocol	Variable	Sy Type	Sy Changeable
1267.It arp	down	integer	yes
1268.It arp	keep	integer	yes
1269.It arp	log_movements	integer	yes
1270.It arp	log_permanent_modify	integer	yes
1271.It arp	log_unknown_network	integer	yes
1272.It arp	log_wrong_iface	integer	yes
1273.It carp	allow	integer	yes
1274.It carp	preempt	integer	yes
1275.It carp	log	integer	yes
1276.It carp	arpbalance	integer	yes
1277.It icmp	errppslimit	integer	yes
1278.It icmp	maskrepl	integer	yes
1279.It icmp	rediraccept	integer	yes
1280.It icmp	redirtimeout	integer	yes
1281.It icmp	bmcastecho	integer	yes
1282.It ip	allowsrcrt	integer	yes
1283.It ip 	anonportalgo.selected	string	yes
1284.It ip 	anonportalgo.available	string	yes
1285.It ip 	anonportalgo.reserve	struct	yes
1286.It ip	anonportmax	integer	yes
1287.It ip	anonportmin	integer	yes
1288.It ip	checkinterface	integer	yes
1289.It ip	dad_count	integer	yes
1290.It ip	directed-broadcast	integer	yes
1291.It ip	do_loopback_cksum	integer	yes
1292.It ip	forwarding	integer	yes
1293.It ip	forwsrcrt	integer	yes
1294.It ip	gifttl	integer	yes
1295.It ip	grettl	integer	yes
1296.It ip	hashsize	integer	yes
1297.It ip	hostzerobroadcast	integer	yes
1298.It ip	lowportmin	integer	yes
1299.It ip	lowportmax	integer	yes
1300.It ip	maxflows	integer	yes
1301.It ip	maxfragpackets	integer	yes
1302.It ip	mtudisc	integer	yes
1303.It ip	mtudisctimeout	integer	yes
1304.It ip	random_id	integer	yes
1305.It ip	redirect	integer	yes
1306.It ip	subnetsarelocal	integer	yes
1307.It ip	ttl	integer	yes
1308.It tcp	rfc1323	integer	yes
1309.It tcp	sendspace	integer	yes
1310.It tcp	recvspace	integer	yes
1311.It tcp	mssdflt	integer	yes
1312.It tcp	syn_cache_limit	integer	yes
1313.It tcp	syn_bucket_limit	integer	yes
1314.It tcp	syn_cache_interval	integer	yes
1315.It tcp	init_win	integer	yes
1316.It tcp	init_win_local	integer	yes
1317.It tcp	mss_ifmtu	integer	yes
1318.It tcp	win_scale	integer	yes
1319.It tcp	timestamps	integer	yes
1320.It tcp	compat_42	integer	yes
1321.It tcp	cwm	integer	yes
1322.It tcp	cwm_burstsize	integer	yes
1323.It tcp	ack_on_push	integer	yes
1324.It tcp	keepidle	integer	yes
1325.It tcp	keepintvl	integer	yes
1326.It tcp	keepcnt	integer	yes
1327.It tcp	slowhz	integer	no
1328.It tcp	keepinit	integer	yes
1329.It tcp	log_refused	integer	yes
1330.It tcp	rstppslimit	integer	yes
1331.It tcp	ident	struct	no
1332.It tcp	drop	struct	no
1333.It tcp	sack.enable	integer	yes
1334.It tcp	sack.globalholes	integer	no
1335.It tcp	sack.globalmaxholes	integer	yes
1336.It tcp	sack.maxholes	integer	yes
1337.It tcp	ecn.enable	integer	yes
1338.It tcp	ecn.maxretries	integer	yes
1339.It tcp	congctl.selected	string	yes
1340.It tcp	congctl.available	string	yes
1341.It tcp	abc.enable	integer	yes
1342.It tcp	abc.aggressive	integer	yes
1343.It udp	checksum	integer	yes
1344.It udp	do_loopback_cksum	integer	yes
1345.It udp	recvspace	integer	yes
1346.It udp	sendspace	integer	yes
1347.El
1348.Pp
1349The variables are as follows:
1350.Bl -tag -width "123456"
1351.It Li arp.down
1352Failed ARP entry lifetime.
1353.It Li arp.keep
1354Valid ARP entry lifetime.
1355.It Li carp.allow
1356If set to 0, incoming
1357.Xr carp 4
1358packets will not be processed.
1359If set to any other value, processing will occur.
1360Enabled by default.
1361.It Li carp.arpbalance
1362If set to any value other than 0, the ARP balancing functionality of
1363.Xr carp 4
1364is enabled.
1365When ARP requests are received for an IP address which is part of any virtual
1366host, carp will hash the source IP in the ARP request to select one of the
1367virtual hosts from the set of all the virtual hosts which have that IP address.
1368The master of that host will respond with the correct virtual MAC address.
1369Disabled by default.
1370.It Li carp.log
1371If set to any value other than 0,
1372.Xr carp 4
1373will log errors.
1374Disabled by default.
1375.It Li carp.preempt
1376If set to 0,
1377.Xr carp 4
1378will not attempt to become master if it is receiving advertisements from
1379another active master.
1380If set to any other value, carp will become master of the virtual host if it
1381believes it can send advertisements more frequently than the current master.
1382Disabled by default.
1383.It Li ip.allowsrcrt
1384If set to 1, the host accepts source routed packets.
1385.It Li ip.anonportalgo.available
1386The available RFC 6056 port randomization algorithms.
1387.It Li ip.anonportalgo.reserve
1388A bitmask of ports that will not be used during anonymous or privileged
1389port selection.
1390.It Li ip.anonportalgo.selected
1391The currently selected RFC 6056 port randomization algorithm.
1392.It Li ip.anonportmax
1393The highest port number to use for TCP and UDP ephemeral port allocation.
1394This cannot be set to less than 1024 or greater than 65535, and must
1395be greater than
1396.Li ip.anonportmin .
1397.It Li ip.anonportmin
1398The lowest port number to use for TCP and UDP ephemeral port allocation.
1399This cannot be set to less than 1024 or greater than 65535.
1400.It Li ip.checkinterface
1401If set to non-zero, the host will reject packets addressed to it
1402that arrive on an interface not bound to that address.
1403Currently, this must be disabled if ipnat is used to translate the
1404destination address to another local interface, or if addresses
1405are added to the loopback interface instead of the interface where
1406the packets for those packets are received.
1407.It Li ip.dad_count
1408The number of
1409.Xr arp 4
1410probes sent for Address Conflict Detection.
1411Set to 0 to disable this.
1412.It Li ip.directed-broadcast
1413If set to 1, enables directed broadcast behavior for the host.
1414.It Li ip.do_loopback_cksum
1415Perform IP checksum on loopback.
1416.It Li ip.forwarding
1417If set to 1, enables IP forwarding for the host,
1418meaning that the host is acting as a router.
1419.It Li ip.forwsrcrt
1420If set to 1, enables forwarding of source-routed packets for the host.
1421This value may only be changed if the kernel security level is less than 1.
1422.It Li ip.gifttl
1423The maximum time-to-live (hop count) value for an IPv4 packet generated by
1424.Xr gif 4
1425tunnel interface.
1426.It Li ip.grettl
1427The maximum time-to-live (hop count) value for an IPv4 packet generated by
1428.Xr gre 4
1429tunnel interface.
1430.It Li ip.hashsize
1431The size of IPv4 Fast Forward hash table.
1432This value must be a power of 2 (64, 256...).
1433A larger hash table size results in fewer collisions.
1434Also see
1435.Li ip.maxflows .
1436.It Li ip.hostzerobroadcast
1437All zeroes address is broadcast address.
1438.It Li ip.lowportmax
1439The highest port number to use for TCP and UDP reserved port allocation.
1440This cannot be set to less than 0 or greater than 1024, and must
1441be greater than
1442.Li ip.lowportmin .
1443.It Li ip.lowportmin
1444The lowest port number to use for TCP and UDP reserved port allocation.
1445This cannot be set to less than 0 or greater than 1024, and must
1446be smaller than
1447.Li ip.lowportmax .
1448.It Li ip.maxflows
1449IPv4 Fast Forwarding is enabled by default.
1450If set to 0, IPv4 Fast Forwarding is disabled.
1451.Li ip.maxflows
1452controls the maximum amount of flows which can be created.
1453The default value is 256.
1454.It Li ip.maxfragpackets
1455The maximum number of fragmented packets the node will accept.
14560 means that the node will not accept any fragmented packets.
1457\-1 means that the node will accept as many fragmented packets as it receives.
1458The flag is provided basically for avoiding possible DoS attacks.
1459.It Li ip.mtudisc
1460If set to 1, enables Path MTU Discovery (RFC 1191).
1461When Path MTU Discovery is enabled, the transmitted TCP segment
1462size will be determined by the advertised maximum segment size
1463(MSS) from the remote end, as constrained by the path MTU.
1464If MTU Discovery is disabled, the transmitted segment size will
1465never be greater than
1466.Li tcp.mssdflt
1467(the local maximum segment size).
1468.It Li ip.mtudisctimeout
1469The number of seconds in which a route added by the Path MTU
1470Discovery engine will time out.
1471When the route times out, the Path
1472MTU Discovery engine will attempt to probe a larger path MTU.
1473.It Li ip.random_id
1474Assign random ip_id values.
1475.It Li ip.redirect
1476If set to 1, ICMP redirects may be sent by the host.
1477This option is ignored unless the host is routing IP packets,
1478and should normally be enabled on all systems.
1479.It Li ip.subnetsarelocal
1480If set to 1, subnets are to be considered local addresses.
1481.It Li ip.ttl
1482The maximum time-to-live (hop count) value for an IP packet sourced by
1483the system.
1484This value applies to normal transport protocols, not to ICMP.
1485.It Li icmp.errppslimit
1486The variable specifies the maximum number of outgoing ICMP error messages,
1487per second.
1488ICMP error messages that exceeded the value are subject to rate limitation
1489and will not go out from the node.
1490Negative value disables rate limitation.
1491.It Li icmp.maskrepl
1492If set to 1, ICMP network mask requests are to be answered.
1493.It Li icmp.rediraccept
1494If set to non-zero, the host will accept ICMP redirect packets.
1495Note that routers will never accept ICMP redirect packets,
1496and the variable is meaningful on IP hosts only.
1497.It Li icmp.redirtimeout
1498The variable specifies lifetime of routing entries generated by incoming
1499ICMP redirect.
1500This defaults to 600 seconds.
1501.It Li icmp.returndatabytes
1502Number of bytes to return in an ICMP error message.
1503.It Li icmp.bmcastecho
1504If set to 1, enables responding to ICMP echo or timestamp request to the
1505broadcast address.
1506.It Li tcp.ack_on_push
1507If set to 1, TCP is to immediately transmit an ACK upon reception of
1508a packet with PUSH set.
1509This can avoid losing a round trip time in some rare situations,
1510but has the caveat of potentially defeating TCP's delayed ACK algorithm.
1511Use of this option is generally not recommended, but
1512the variable exists in case your configuration really needs it.
1513.It Li tcp.compat_42
1514If set to 1, enables work-arounds for bugs in the 4.2BSD TCP implementation.
1515Use of this option is not recommended, although it may be
1516required in order to communicate with extremely old TCP implementations.
1517.It Li tcp.cwm
1518If set to 1, enables use of the Hughes/Touch/Heidemann Congestion Window
1519Monitoring algorithm.
1520This algorithm prevents line-rate bursts of packets that could
1521otherwise occur when data begins flowing on an idle TCP connection.
1522These line-rate bursts can contribute to network and router congestion.
1523This can be particularly useful on World Wide Web servers
1524which support HTTP/1.1, which has lingering connections.
1525.It Li tcp.cwm_burstsize
1526The Congestion Window Monitoring allowed burst size, in terms
1527of packet count.
1528.It Li tcp.delack_ticks
1529Number of ticks to delay sending an ACK.
1530.It Li tcp.do_loopback_cksum
1531Perform TCP checksum on loopback.
1532.It Li tcp.init_win
1533A value indicating the TCP initial congestion window.
1534The valid range
1535is 0 to 10 (maximum specified by RFC6928),
1536with a default of 4 (approximately 4K per RFC3390).
1537.It Li tcp.init_win_local
1538Like
1539.Li tcp.init_win ,
1540but used when communicating with hosts on a local network.
1541.It Li tcp.keepcnt
1542Number of keepalive probes sent before declaring a connection dead.
1543If set to zero, there is no limit;
1544keepalives will be sent until some kind of
1545response is received from the peer.
1546.It Li tcp.keepidle
1547Time a connection must be idle before keepalives are sent (if keepalives
1548are enabled for the connection).
1549See also tcp.slowhz.
1550.It Li tcp.keepintvl
1551Time after a keepalive probe is sent until, in the absence of any response,
1552another probe is sent.
1553See also tcp.slowhz.
1554.It Li tcp.log_refused
1555If set to 1, refused TCP connections to the host will be logged.
1556.It Li tcp.keepinit
1557Timeout in seconds during connection establishment.
1558.It Li tcp.mss_ifmtu
1559If set to 1, TCP calculates the outgoing maximum segment size based on
1560the MTU of the appropriate interface.
1561If set to 0, it is calculated based on the greater of the MTU of the
1562interface, and the largest (non-loopback) interface MTU on the system.
1563.It Li tcp.mssdflt
1564The default maximum segment size both advertised to the peer
1565and to use when either the peer does not advertise a maximum segment size to
1566us during connection setup or Path MTU Discovery
1567.Li ( ip.mtudisc )
1568is disabled.
1569Do not change this value unless you really know what you are doing.
1570.It Li tcp.recvspace
1571The default TCP receive buffer size.
1572.It Li tcp.rfc1323
1573If set to 1, enables RFC 1323 extensions to TCP.
1574.It Li tcp.rstppslimit
1575The variable specifies the maximum number of outgoing TCP RST packets,
1576per second.
1577TCP RST packet that exceeded the value are subject to rate limitation
1578and will not go out from the node.
1579Negative value disables rate limitation.
1580.It Li tcp.ident
1581Return the user ID of a connected socket pair.
1582(RFC1413 Identification Protocol lookups.)
1583.It Li tcp.drop
1584Drop a TCP socket pair connection.
1585.It Li tcp.sack.enable
1586If set to 1, enables RFC 2018 Selective ACKnowledgement.
1587.It Li tcp.sack.globalholes
1588Global number of TCP SACK holes.
1589.It Li tcp.sack.globalmaxholes
1590Global maximum number of TCP SACK holes.
1591.It Li tcp.sack.maxholes
1592Maximum number of TCP SACK holes allowed per connection.
1593.It Li tcp.ecn.enable
1594If set to 1, enables RFC 3168 Explicit Congestion Notification.
1595.It Li tcp.ecn.maxretries
1596Number of times to retry sending the ECN-setup packet.
1597.It Li tcp.sendspace
1598The default TCP send buffer size.
1599.It Li tcp.slowhz
1600The units for tcp.keepidle and tcp.keepintvl; those variables are in ticks
1601of a clock that ticks tcp.slowhz times per second.
1602(That is, their values
1603must be divided by the tcp.slowhz value to get times in seconds.)
1604.It Li tcp.syn_bucket_limit
1605The maximum number of entries allowed per hash bucket in the TCP
1606compressed state engine.
1607.It Li tcp.syn_cache_limit
1608The maximum number of entries allowed in the TCP compressed state
1609engine.
1610.It Li tcp.timestamps
1611If rfc1323 is enabled, a value of 1 indicates RFC 1323 time stamp options,
1612used for measuring TCP round trip times, are enabled.
1613.It Li tcp.win_scale
1614If rfc1323 is enabled, a value of 1 indicates RFC 1323 window scale options,
1615for increasing the TCP window size, are enabled.
1616.It Li tcp.congctl.available
1617The available TCP congestion control algorithms.
1618.It Li tcp.congctl.selected
1619The currently selected TCP congestion control algorithm.
1620.It Li tcp.abc.enable
1621If set to 1, use RFC 3465 Appropriate Byte Counting (ABC).
1622If set to 0, use traditional Packet Counting.
1623.It Li tcp.abc.aggressive
1624Choose the L parameter found in RFC 3465.
1625L is the maximum cwnd increase for an ack during slow start.
1626If set to 1, use L=2*SMSS.
1627If set to 0, use L=1*SMSS.
1628It has no effect unless tcp.abc.enable is set to 1.
1629.It Li udp.checksum
1630If set to 1, UDP checksums are being computed.
1631Received non-zero UDP checksums are always checked.
1632Disabling UDP checksums is strongly discouraged.
1633.It Li udp.recvspace
1634The default UDP receive buffer size.
1635.It Li udp.sendspace
1636The default UDP send buffer size.
1637.El
1638.Pp
1639For variables net.*.ipsec, please refer to
1640.Xr ipsec 4 .
1641.It Li net.inet6 ( Dv PF_INET6 )
1642Get or set various global information about the IPv6
1643.Pq Internet Protocol version 6 .
1644The third level name is the protocol.
1645The fourth level name is the variable name.
1646The currently defined protocols and names are:
1647.Bl -column "Protocol" "anonportalgo.available" "integer" "Changeable" -offset indent
1648.It Sy Protocol	Variable	Sy Type	Sy Changeable
1649.It icmp6	errppslimit	integer	yes
1650.It icmp6	mtudisc_hiwat	integer	yes
1651.It icmp6	mtudisc_lowat	integer	yes
1652.It icmp6	nd6_debug	integer	yes
1653.It icmp6	nd6_delay	integer	yes
1654.It icmp6	nd6_maxnudhint	integer	yes
1655.It icmp6	nd6_mmaxtries	integer	yes
1656.It icmp6	nd6_prune	integer	yes
1657.It icmp6	nd6_umaxtries	integer	yes
1658.It icmp6	nd6_useloopback	integer	yes
1659.It icmp6	nodeinfo	integer	yes
1660.It icmp6	rediraccept	integer	yes
1661.It icmp6	redirtimeout	integer	yes
1662.It ip6	accept_rtadv	integer	yes
1663.It ip6	addctlpolicy	struct in6_addrpolicy	no
1664.It ip6	anonportalgo.selected	string	yes
1665.It ip6	anonportalgo.available	string	yes
1666.It ip6	anonportalgo.reserve	struct	yes
1667.It ip6	anonportmax	integer	yes
1668.It ip6	anonportmin	integer	yes
1669.It ip6	auto_flowlabel	integer	yes
1670.It ip6	dad_count	integer	yes
1671.It ip6	defmcasthlim	integer	yes
1672.It ip6	forwarding	integer	yes
1673.It ip6	gifhlim	integer	yes
1674.It ip6	hashsize	integer	yes
1675.It ip6	hlim	integer	yes
1676.It ip6	hdrnestlimit	integer	yes
1677.It ip6	kame_version	string	no
1678.It ip6	keepfaith	integer	yes
1679.It ip6	log_interval	integer	yes
1680.It ip6	lowportmax	integer	yes
1681.It ip6	lowportmin	integer	yes
1682.It ip6	maxdynroutes	integer	yes
1683.It ip6	maxifprefixes	integer	yes
1684.It ip6	maxifdefrouters	integer	yes
1685.It ip6	maxflows	integer	yes
1686.It ip6	maxfragpackets	integer	yes
1687.It ip6	maxfrags	integer	yes
1688.It ip6	neighborgcthresh	integer	yes
1689.It ip6	redirect	integer	yes
1690.It ip6	rr_prune	integer	yes
1691.It ip6	use_deprecated	integer	yes
1692.It ip6	v6only	integer	yes
1693.It udp6	do_loopback_cksum	integer	yes
1694.It udp6	recvspace	integer	yes
1695.It udp6	sendspace	integer	yes
1696.El
1697.Pp
1698The variables are as follows:
1699.Bl -tag -width "123456"
1700.It Li ip6.accept_rtadv
1701If set to non-zero, the node will accept ICMPv6 router advertisement packets
1702and autoconfigures address prefixes and default routers.
1703The node must be a host
1704.Pq not a router
1705for the option to be meaningful.
1706.It Li ip6.anonportalgo.available
1707The available RFC 6056 port randomization algorithms.
1708.It Li ip6.anonportalgo.reserve
1709A bitmask of ports that will not be used during anonymous or privileged
1710port selection.
1711.It Li ip6.anonportalgo.selected
1712The currently selected RFC 6056 port randomization algorithm.
1713.It Li ip6.anonportmax
1714The highest port number to use for TCP and UDP ephemeral port allocation.
1715This cannot be set to less than 1024 or greater than 65535, and must
1716be greater than
1717.Li ip6.anonportmin .
1718.It Li ip6.anonportmin
1719The lowest port number to use for TCP and UDP ephemeral port allocation.
1720This cannot be set to less than 1024 or greater than 65535.
1721.It Li ip6.auto_flowlabel
1722On connected transport protocol packets,
1723fill IPv6 flowlabel field to help intermediate routers to identify packet flows.
1724.It Li ip6.dad_count
1725The variable configures number of IPv6 DAD
1726.Pq duplicated address detection
1727probe packets.
1728The packets will be generated when IPv6 interface addresses are configured.
1729.It Li ip6.defmcasthlim
1730The default hop limit value for an IPv6 multicast packet sourced by the node.
1731This value applies to all the transport protocols on top of IPv6.
1732There are APIs to override the value, as documented in
1733.Xr ip6 4 .
1734.It Li ip6.forwarding
1735If set to 1, enables IPv6 forwarding for the node,
1736meaning that the node is acting as a router.
1737If set to 0, disables IPv6 forwarding for the node,
1738meaning that the node is acting as a host.
1739IPv6 specification defines node behavior for
1740.Dq router
1741case and
1742.Dq host
1743case quite differently, and changing this variable during operation
1744may cause serious trouble.
1745It is recommended to configure the variable at bootstrap time,
1746and bootstrap time only.
1747.It Li ip6.gifhlim
1748The maximum hop limit value for an IPv6 packet generated by
1749.Xr gif 4
1750tunnel interface.
1751.It Li ip6.hdrnestlimit
1752The number of IPv6 extension headers permitted on incoming IPv6 packets.
1753If set to 0, the node will accept as many extension headers as possible.
1754.It Li ip6.hashsize
1755The size of IPv6 Fast Forward hash table.
1756This value must be a power of 2 (64, 256, ...).
1757A larger hash table size results in fewer collisions.
1758Also see
1759.Li ip6.maxflows .
1760.It Li ip6.hlim
1761The default hop limit value for an IPv6 unicast packet sourced by the node.
1762This value applies to all the transport protocols on top of IPv6.
1763There are APIs to override the value, as documented in
1764.Xr ip6 4 .
1765.It Li ip6.kame_version
1766The string identifies the version of KAME IPv6 stack implemented in the kernel.
1767.It Li ip6.keepfaith
1768If set to non-zero, it enables
1769.Dq FAITH
1770TCP relay IPv6-to-IPv4 translator code in the kernel.
1771Refer
1772.Xr faith 4
1773and
1774.Xr faithd 8
1775for detail.
1776.It Li ip6.log_interval
1777The variable controls amount of logs generated by IPv6 packet
1778forwarding engine, by setting interval between log output
1779.Pq in seconds .
1780.It Li ip6.lowportmax
1781The highest port number to use for TCP and UDP reserved port allocation.
1782This cannot be set to less than 0 or greater than 1024, and must
1783be greater than
1784.Li ip6.lowportmin .
1785.It Li ip6.lowportmin
1786The lowest port number to use for TCP and UDP reserved port allocation.
1787This cannot be set to less than 0 or greater than 1024, and must
1788be smaller than
1789.Li ip6.lowportmax .
1790.It Li ip6.maxdynroutes
1791Maximum number of routes created by redirect.
1792Set it to negative to disable.
1793The default value is 4096.
1794.It Li ip6.maxifprefixes
1795Maximum number of prefixes created by route advertisements per interface.
1796Set it to negative to disable.
1797The default value is 16.
1798.It Li ip6.maxifdefrouters 16
1799Maximum number of default routers created by route advertisements per interface.
1800Set it to negative to disable.
1801The default value is 16.
1802.It Li ip6.maxflows
1803IPv6 Fast Forwarding is enabled by default.
1804If set to 0, IPv6 Fast Forwarding is disabled.
1805.Li ip6.maxflows
1806controls the maximum amount of flows which can be created.
1807The default value is 256.
1808.It Li ip6.maxfragpackets
1809The maximum number of fragmented packets the node will accept.
18100 means that the node will not accept any fragmented packets.
1811\-1 means that the node will accept as many fragmented packets as it receives.
1812The flag is provided basically for avoiding possible DoS attacks.
1813.It Li ip6.maxfrags
1814The maximum number of fragments the node will accept.
18150 means that the node will not accept any fragments.
1816\-1 means that the node will accept as many fragments as it receives.
1817The flag is provided basically for avoiding possible DoS attacks.
1818.It Li ip6.neighborgcthresh
1819Maximum number of entries in neighbor cache per interface.
1820Set to negative to disable.
1821The default value is 2048.
1822.It Li ip6.redirect
1823If set to 1, ICMPv6 redirects may be sent by the node.
1824This option is ignored unless the node is routing IP packets,
1825and should normally be enabled on all systems.
1826.It Li ip6.rr_prune
1827The variable specifies interval between IPv6 router renumbering prefix
1828babysitting, in seconds.
1829.It Li ip6.use_deprecated
1830The variable controls use of deprecated address, specified in RFC 2462 5.5.4.
1831.It Li ip6.v6only
1832The variable specifies initial value for
1833.Dv IPV6_V6ONLY
1834socket option for
1835.Dv AF_INET6
1836socket.
1837Please refer to
1838.Xr ip6 4
1839for detail.
1840.It Li icmp6.errppslimit
1841The variable specifies the maximum number of outgoing ICMPv6 error messages,
1842per second.
1843ICMPv6 error messages that exceeded the value are subject to rate limitation
1844and will not go out from the node.
1845Negative value disables rate limitation.
1846.It Li icmp6.mtudisc_hiwat
1847.It Li icmp6.mtudisc_lowat
1848The variables define the maximum number of routing table entries,
1849created due to path MTU discovery
1850.Pq prevents denial-of-service attacks with ICMPv6 too big messages .
1851When IPv6 path MTU discovery happens, we keep path MTU information into
1852the routing table.
1853If the number of routing table entries exceed the value,
1854the kernel will not attempt to keep the path MTU information.
1855.Li icmp6.mtudisc_hiwat
1856is used when we have verified ICMPv6 too big messages.
1857.Li icmp6.mtudisc_lowat
1858is used when we have unverified ICMPv6 too big messages.
1859Verification is performed by using address/port pairs kept in connected pcbs.
1860Negative value disables the upper limit.
1861.It Li icmp6.nd6_debug
1862If set to non-zero, kernel IPv6 neighbor discovery code will generate
1863debugging messages.
1864The debug outputs are useful to diagnose IPv6 interoperability issues.
1865The flag must be set to 0 for normal operation.
1866.It Li icmp6.nd6_delay
1867The variable specifies
1868.Dv DELAY_FIRST_PROBE_TIME
1869timing constant in IPv6 neighbor discovery specification
1870.Pq RFC 2461 ,
1871in seconds.
1872.It Li icmp6.nd6_maxnudhint
1873IPv6 neighbor discovery permits upper layer protocols to supply reachability
1874hints, to avoid unnecessary neighbor discovery exchanges.
1875The variable defines the number of consecutive hints the neighbor discovery
1876layer will take.
1877For example, by setting the variable to 3, neighbor discovery layer
1878will take 3 consecutive hints in maximum.
1879After receiving 3 hints, neighbor discovery layer will perform
1880normal neighbor discovery process.
1881.It Li icmp6.nd6_mmaxtries
1882The variable specifies
1883.Dv MAX_MULTICAST_SOLICIT
1884constant in IPv6 neighbor discovery specification
1885.Pq RFC 2461 .
1886.It Li icmp6.nd6_prune
1887The variable specifies interval between IPv6 neighbor cache babysitting,
1888in seconds.
1889.It Li icmp6.nd6_umaxtries
1890The variable specifies
1891.Dv MAX_UNICAST_SOLICIT
1892constant in IPv6 neighbor discovery specification
1893.Pq RFC 2461 .
1894.It Li icmp6.nd6_useloopback
1895If set to non-zero, kernel IPv6 stack will use loopback interface for
1896local traffic.
1897.It Li icmp6.nodeinfo
1898The variable enables responses to ICMPv6 node information queries.
1899If you set the variable to 0, responses will not be generated for
1900ICMPv6 node information queries.
1901Since node information queries can have a security impact, it is
1902possible to fine tune which responses should be answered.
1903Two separate bits can be set.
1904.Bl -tag -width "12345"
1905.It 1
1906Respond to ICMPv6 FQDN queries, e.g.
1907.Li ping6 -w .
1908.It 2
1909Respond to ICMPv6 node addresses queries, e.g.
1910.Li ping6 -a .
1911.El
1912.It Li icmp6.rediraccept
1913If set to non-zero, the host will accept ICMPv6 redirect packets.
1914Note that IPv6 routers will never accept ICMPv6 redirect packets,
1915and the variable is meaningful on IPv6 hosts
1916.Pq non-router
1917only.
1918.It Li icmp6.redirtimeout
1919The variable specifies lifetime of routing entries generated by incoming
1920ICMPv6 redirect.
1921.It Li udp6.do_loopback_cksum
1922Perform UDP checksum on loopback.
1923.It Li udp6.recvspace
1924Default UDP receive buffer size.
1925.It Li udp6.sendspace
1926Default UDP send buffer size.
1927.El
1928.Pp
1929We reuse net.*.tcp for
1930.Tn TCP
1931over
1932.Tn IPv6 ,
1933and therefore we do not have variables net.*.tcp6.
1934Variables net.inet6.udp6 have identical meaning to net.inet.udp.
1935Please refer to
1936.Li PF_INET
1937section above.
1938For variables net.*.ipsec6, please refer to
1939.Xr ipsec 4 .
1940.It Li net.key ( Dv PF_KEY )
1941Get or set various global information about the IPsec key management.
1942The third level name is the variable name.
1943The currently defined variable and names are:
1944.Bl -column "blockacq_lifetime" "integer" "Changeable" -offset indent
1945.It Sy Variable	Type	Sy Changeable
1946.It debug	integer	yes
1947.It enabled	integer	yes
1948.It used	integer	no
1949.It spi_try	integer	yes
1950.It spi_min_value	integer	yes
1951.It spi_max_value	integer	yes
1952.It larval_lifetime	integer	yes
1953.It blockacq_count	integer	yes
1954.It blockacq_lifetime	integer	yes
1955.It esp_keymin	integer	yes
1956.It esp_auth	integer	yes
1957.It ah_keymin	integer	yes
1958.El
1959.Pp
1960The variables are as follows:
1961.Bl -tag -width "123456"
1962.It Li debug
1963Turn on debugging message from within the kernel.
1964The value is a bitmap, as defined in
1965.In netkey/key_debug.h .
1966.It Li enabled
1967Control processing of IPsec control messages.
1968.Bl -tag -width indent
1969.It 0
1970Never allow IPsec processing
1971.It 1
1972Allow IPsec processing when SPD policies are present.
1973.It 2
1974Force IPsec processing even when SPD policies are not present.
1975.El
1976.It Li used
1977Based on if IPsec is enabled, and SPD rule existance, show if
1978IPsec is being used.
1979Note that currenly once IPsec is being used, it cannot be disabled.
1980.It Li spi_try
1981The number of times the kernel will try to obtain an unique SPI
1982when it generates it from random number generator.
1983.It Li spi_min_value
1984Minimum SPI value when generating it within the kernel.
1985.It Li spi_max_value
1986Maximum SPI value when generating it within the kernel.
1987.It Li larval_lifetime
1988Lifetime for LARVAL SAD entries, in seconds.
1989.It Li blockacq_count
1990Number of ACQUIRE PF_KEY messages to be blocked after an ACQUIRE message.
1991It avoids flood of ACQUIRE PF_KEY from being sent from the kernel to the
1992key management daemon.
1993.It Li blockacq_lifetime
1994Lifetime of ACQUIRE PF_KEY message.
1995.It Li esp_keymin
1996Minimum ESP key length, in bits.
1997The value is used when the kernel creates proposal payload
1998on ACQUIRE PF_KEY message.
1999.It Li esp_auth
2000Whether ESP authentication should be used or not.
2001Non-zero value indicates that ESP authentication should be used.
2002The value is used when the kernel creates proposal payload
2003on ACQUIRE PF_KEY message.
2004.It Li ah_keymin
2005Minimum AH key length, in bits,
2006The value is used when the kernel creates proposal payload
2007on ACQUIRE PF_KEY message.
2008.El
2009.El
2010.Ss The proc.* subtree
2011The string and integer information available for the
2012.Li proc
2013level is detailed below.
2014The changeable column shows whether a process with appropriate
2015privilege may change the value.
2016These values are per-process,
2017and as such may change from one process to another.
2018When a process is created,
2019the default values are inherited from its parent.
2020When a set-user-ID or set-group-ID binary is executed, the
2021value of PROC_PID_CORENAME is reset to the system default value.
2022The second level name is either the magic value PROC_CURPROC, which
2023points to the current process, or the PID of the target process.
2024.Bl -column "proc.pid.corename" "string" "not applicable" -offset indent
2025.It Sy Third level name	Sy Type	Sy Changeable
2026.It proc.pid.corename	string	yes
2027.It proc.pid.rlimit	node	not applicable
2028.It proc.pid.stopfork	int	yes
2029.It proc.pid.stopexec	int	yes
2030.It proc.pid.stopexit	int	yes
2031.El
2032.Bl -tag -width "123456"
2033.It Li proc.pid.corename ( Dv PROC_PID_CORENAME )
2034The template used for the core dump file name (see
2035.Xr core 5
2036for details).
2037The base name must either be
2038.Pa core
2039or end with the suffix
2040.Pa .core
2041(the super-user may set arbitrary names).
2042By default it points to
2043.Dv KERN_DEFCORENAME .
2044.It Li proc.pid.rlimit ( Dv PROC_PID_LIMIT )
2045Return resources limits, as defined for the
2046.Xr getrlimit 2
2047and
2048.Xr setrlimit 2
2049system calls.
2050The fourth level name is one of:
2051.Bl -tag -width "123456"
2052.It Li proc.pid.rlimit.cputime ( Dv PROC_PID_LIMIT_CPU )
2053The maximum amount of CPU time (in seconds) to be used by each process.
2054.It Li proc.pid.rlimit.filesize ( Dv PROC_PID_LIMIT_FSIZE )
2055The largest size (in bytes) file that may be created.
2056.It Li proc.pid.rlimit.datasize ( Dv PROC_PID_LIMIT_DATA )
2057The maximum size (in bytes) of the data segment for a process;
2058this defines how far a program may extend its break with the
2059.Xr sbrk 2
2060system call.
2061.It Li proc.pid.rlimit.stacksize ( Dv PROC_PID_LIMIT_STACK )
2062The maximum size (in bytes) of the stack segment for a process;
2063this defines how far a program's stack segment may be extended.
2064Stack extension is performed automatically by the system.
2065.It Li proc.pid.rlimit.coredumpsize ( Dv PROC_PID_LIMIT_CORE )
2066The largest size (in bytes)
2067.Pa core
2068file that may be created.
2069.It Li proc.pid.rlimit.memoryuse ( Dv PROC_PID_LIMIT_RSS )
2070The maximum size (in bytes) to which a process's resident set size may
2071grow.
2072This imposes a limit on the amount of physical memory to be given to
2073a process; if memory is tight, the system will prefer to take memory
2074from processes that are exceeding their declared resident set size.
2075.It Li proc.pid.rlimit.memorylocked ( Dv PROC_PID_LIMIT_MEMLOCK )
2076The maximum size (in bytes) which a process may lock into memory
2077using the
2078.Xr mlock 2
2079function.
2080.It Li proc.pid.rlimit.maxproc ( Dv PROC_PID_LIMIT_NPROC )
2081The maximum number of simultaneous processes for this user id.
2082.It Li proc.pid.rlimit.descriptors ( Dv PROC_PID_LIMIT_NOFILE )
2083The maximum number of open files for this process.
2084.It Li proc.pid.rlimit.sbsize ( Dv PROC_PID_LIMIT_SBSIZE )
2085The maximum size (in bytes) of the socket buffers
2086set by the
2087.Xr setsockopt 2
2088.Dv SO_RCVBUF
2089and
2090.Dv SO_SNDBUF
2091options.
2092.It Li proc.pid.rlimit.vmemoryuse ( Dv PROC_PID_LIMIT_AS )
2093The maximum size (in bytes) which a process can obtain.
2094.It Li proc.pid.rlimit.maxlwp ( Dv PROC_PID_LIMIT_NTHR )
2095The maximum number of threads that cen be created and running at one time in
2096the process.
2097The first thread of each process is not counted against this.
2098.El
2099.Pp
2100The fifth level name is one of
2101.Li soft ( Dv PROC_PID_LIMIT_TYPE_SOFT )
2102or
2103.Li hard ( Dv PROC_PID_LIMIT_TYPE_HARD ) ,
2104to select respectively the soft or hard limit.
2105Both are of type integer.
2106.It Li proc.pid.stopfork ( Dv PROC_PID_STOPFORK )
2107If non zero, the process' children will be stopped after
2108.Xr fork 2
2109calls.
2110The children is created in the SSTOP state and is never scheduled
2111for running before being stopped.
2112This feature helps attaching a process with a debugger such as
2113.Xr gdb 1
2114before it had the opportunity to actually do anything.
2115.Pp
2116This value is inherited by the process's children, and it also
2117apply to emulation specific system calls that fork a new process, such as
2118.Fn sproc
2119or
2120.Fn clone .
2121.It Li proc.pid.stopexec ( Dv PROC_PID_STOPEXEC )
2122If non zero, the process will be stopped on next
2123.Xr exec 3
2124call.
2125The process created by
2126.Xr exec 3
2127is created in the SSTOP state and is never scheduled for running
2128before being stopped.
2129This feature helps attaching a process with a debugger such as
2130.Xr gdb 1
2131before it had the opportunity to actually do anything.
2132.Pp
2133This value is inherited by the process's children.
2134.It Li proc.pid.stopexit ( Dv PROC_PID_STOPEXIT )
2135If non zero, the process will be stopped on when it has cause to exit,
2136either by way of calling
2137.Xr exit 3 ,
2138.Xr _exit 2 ,
2139or by the receipt of a specific signal.
2140The process is stopped before any of its resources or vm space is
2141released allowing examination of the termination state of a process
2142before it disappears.
2143This feature can be used to examine the final conditions of the
2144process's vmspace via
2145.Xr pmap 1
2146or its resource settings with
2147.Xr sysctl 8
2148before it disappears.
2149.Pp
2150This value is also inherited by the process's children.
2151.El
2152.Ss The user.* subtree ( Dv CTL_USER )
2153The string and integer information available for the
2154.Li user
2155level is detailed below.
2156The changeable column shows whether a process with appropriate
2157privilege may change the value.
2158.Bl -column "user.coll_weights_max" "integer" "Changeable" -offset indent
2159.It Sy Second level name	Sy Type	Sy Changeable
2160.It user.atexit_max	integer	no
2161.It user.bc_base_max	integer	no
2162.It user.bc_dim_max	integer	no
2163.It user.bc_scale_max	integer	no
2164.It user.bc_string_max	integer	no
2165.It user.coll_weights_max	integer	no
2166.It user.cs_path	string	no
2167.It user.expr_nest_max	integer	no
2168.It user.line_max	integer	no
2169.It user.posix2_c_bind	integer	no
2170.It user.posix2_c_dev	integer	no
2171.It user.posix2_char_term	integer	no
2172.It user.posix2_fort_dev	integer	no
2173.It user.posix2_fort_run	integer	no
2174.It user.posix2_localedef	integer	no
2175.It user.posix2_sw_dev	integer	no
2176.It user.posix2_upe	integer	no
2177.It user.posix2_version	integer	no
2178.It user.re_dup_max	integer	no
2179.It user.stream_max	integer	no
2180.It user.stream_max	integer	no
2181.It user.tzname_max	integer	no
2182.El
2183.Bl -tag -width "123456"
2184.It Li user.atexit_max ( Dv USER_ATEXIT_MAX )
2185The maximum number of functions that may be registered with
2186.Xr atexit 3 .
2187.It Li user.bc_base_max ( Dv USER_BC_BASE_MAX )
2188The maximum ibase/obase values in the
2189.Xr bc 1
2190utility.
2191.It Li user.bc_dim_max ( Dv USER_BC_DIM_MAX )
2192The maximum array size in the
2193.Xr bc 1
2194utility.
2195.It Li user.bc_scale_max ( Dv USER_BC_SCALE_MAX )
2196The maximum scale value in the
2197.Xr bc 1
2198utility.
2199.It Li user.bc_string_max ( Dv USER_BC_STRING_MAX )
2200The maximum string length in the
2201.Xr bc 1
2202utility.
2203.It Li user.coll_weights_max ( Dv USER_COLL_WEIGHTS_MAX )
2204The maximum number of weights that can be assigned to any entry of
2205the LC_COLLATE order keyword in the locale definition file.
2206.It Li user.cs_path ( USER_CS_PATH )
2207Return a value for the
2208.Ev PATH
2209environment variable that finds all the standard utilities.
2210.It Li user.expr_nest_max ( Dv USER_EXPR_NEST_MAX )
2211The maximum number of expressions that can be nested within
2212parenthesis by the
2213.Xr expr 1
2214utility.
2215.It Li user.line_max ( Dv USER_LINE_MAX )
2216The maximum length in bytes of a text-processing utility's input
2217line.
2218.It Li user.posix2_char_term ( Dv USER_POSIX2_CHAR_TERM )
2219Return 1 if the system supports at least one terminal type capable of
2220all operations described in
2221.St -p1003.2 ,
2222otherwise\ 0.
2223.It Li user.posix2_c_bind ( Dv USER_POSIX2_C_BIND )
2224Return 1 if the system's C-language development facilities support the
2225C-Language Bindings Option, otherwise\ 0.
2226.It Li user.posix2_c_dev ( Dv USER_POSIX2_C_DEV )
2227Return 1 if the system supports the C-Language Development Utilities Option,
2228otherwise\ 0.
2229.It Li user.posix2_fort_dev ( Dv USER_POSIX2_FORT_DEV )
2230Return 1 if the system supports the FORTRAN Development Utilities Option,
2231otherwise\ 0.
2232.It Li user.posix2_fort_run ( Dv USER_POSIX2_FORT_RUN )
2233Return 1 if the system supports the FORTRAN Runtime Utilities Option,
2234otherwise\ 0.
2235.It Li user.posix2_localedef ( Dv USER_POSIX2_LOCALEDEF )
2236Return 1 if the system supports the creation of locales, otherwise\ 0.
2237.It Li user.posix2_sw_dev ( Dv USER_POSIX2_SW_DEV )
2238Return 1 if the system supports the Software Development Utilities Option,
2239otherwise\ 0.
2240.It Li user.posix2_upe ( Dv USER_POSIX2_UPE )
2241Return 1 if the system supports the User Portability Utilities Option,
2242otherwise\ 0.
2243.It Li user.posix2_version ( Dv USER_POSIX2_VERSION )
2244The version of
2245.St -p1003.2
2246with which the system attempts to comply.
2247.It Li user.re_dup_max ( Dv USER_RE_DUP_MAX )
2248The maximum number of repeated occurrences of a regular expression
2249permitted when using interval notation.
2250.It Li user.stream_max ( Dv USER_STREAM_MAX )
2251The minimum maximum number of streams that a process may have open
2252at any one time.
2253.It Li user.tzname_max ( Dv USER_TZNAME_MAX )
2254The minimum maximum number of types supported for the name of a
2255timezone.
2256.El
2257.Ss The vm.* subtree ( Dv CTL_VM )
2258The string and integer information available for the
2259.Li vm
2260level is detailed below.
2261The changeable column shows whether a process with appropriate
2262privilege may change the value.
2263.Bl -column "Second level name" "struct uvmexp_sysctl" "Changeable" -offset indent
2264.It Sy Second level name	Sy Type	Sy Changeable
2265.It vm.anonmax	int	yes
2266.It vm.anonmin	int	yes
2267.It vm.bufcache	int	yes
2268.It vm.bufmem	int	no
2269.It vm.bufmem_hiwater	int	yes
2270.It vm.bufmem_lowater	int	yes
2271.It vm.execmax	int	yes
2272.It vm.execmin	int	yes
2273.It vm.filemax	int	yes
2274.It vm.filemin	int	yes
2275.It vm.loadavg	struct loadavg	no
2276.It vm.maxslp	int	no
2277.It vm.nkmempages	int	no
2278.It vm.uspace	int	no
2279.It vm.uvmexp	struct uvmexp	no
2280.It vm.uvmexp2	struct uvmexp_sysctl	no
2281.It vm.vmmeter	struct vmtotal	no
2282.It vm.proc.map	struct kinfo_vmentry	no
2283.El
2284.Bl -tag -width "123456"
2285.It Li vm.anonmax ( Dv VM_ANONMAX )
2286The percentage of physical memory which will be reclaimed
2287from other types of memory usage to store anonymous application data.
2288.It Li vm.anonmin ( Dv VM_ANONMIN )
2289The percentage of physical memory which will be always be available for
2290anonymous application data.
2291.It Li vm.bufcache ( Dv VM_BUFCACHE )
2292The percentage of physical memory which will be available
2293for the buffer cache.
2294.It Li vm.bufmem ( Dv VM_BUFMEM )
2295The amount of kernel memory that is being used by the buffer cache.
2296.It Li vm.bufmem_lowater ( Dv VM_BUFMEM_LOWATER )
2297The minimum amount of kernel memory to reserve for the
2298buffer cache.
2299.It Li vm.bufmem_hiwater ( Dv VM_BUFMEM_HIWATER )
2300The maximum amount of kernel memory to be used for the
2301buffer cache.
2302.It Li vm.execmax ( Dv VM_EXECMAX )
2303The percentage of physical memory which will be reclaimed
2304from other types of memory usage to store cached executable data.
2305.It Li vm.execmin ( Dv VM_EXECMIN )
2306The percentage of physical memory which will be always be available for
2307cached executable data.
2308.It Li vm.filemax ( Dv VM_FILEMAX )
2309The percentage of physical memory which will be reclaimed
2310from other types of memory usage to store cached file data.
2311.It Li vm.filemin ( Dv VM_FILEMIN )
2312The percentage of physical memory which will be always be available for
2313cached file data.
2314.It Li vm.loadavg ( Dv VM_LOADAVG )
2315Return the load average history.
2316The returned data consists of a
2317.Vt struct loadavg .
2318.It Li vm.maxslp ( Dv VM_MAXSLP )
2319The value of the maxslp kernel global variable.
2320.It Li vm.vmmeter ( Dv VM_METER )
2321Return system wide virtual memory statistics.
2322The returned data consists of a
2323.Vt struct vmtotal .
2324.It vm.user_va0_disable
2325A flag which controls whether user processes can map virtual address\ 0.
2326.It Li vm.proc.map ( Dv VM_PROC )
2327The third level is
2328.dv VM_PROC_MAP ,
2329the fourth is the pid of the process to display the vm object entries for, and
2330the fifth is the size of
2331.Vt struct kinfo_vmentry .
2332Returns an array of
2333.Vt struct kinfo_vmentry
2334objects.
2335.It Li vm.uspace ( Dv VM_USPACE )
2336The number of bytes allocated for each kernel stack.
2337.It Li vm.uvmexp ( Dv VM_UVMEXP )
2338Return system wide virtual memory statistics.
2339The returned data consists of a
2340.Vt struct uvmexp .
2341.It Li vm.uvmexp2 ( Dv VM_UVMEXP2 )
2342Return system wide virtual memory statistics.
2343The returned data consists of a
2344.Vt struct uvmexp_sysctl .
2345.\" XXX vm.idlezero
2346.El
2347.Ss The ddb.* subtree ( Dv CTL_DDB )
2348The information available for the
2349.Li ddb
2350level is detailed below.
2351The changeable column shows whether a process with appropriate
2352privilege may change the value.
2353.\" XXX sort
2354.Bl -column "Second level name" "integer" "Changeable" -offset indent
2355.It Sy Second level name	Sy Type	Sy Changeable
2356.It ddb.radix	integer	yes
2357.It ddb.maxoff	integer	yes
2358.It ddb.maxwidth	integer	yes
2359.It ddb.lines	integer	yes
2360.It ddb.tabstops	integer	yes
2361.It ddb.onpanic	integer	yes
2362.It ddb.fromconsole	integer	yes
2363.It ddb.tee_msgbuf	integer	yes
2364.It ddb.commandonenter	string	yes
2365.El
2366.Bl -tag -width "123456"
2367.It Li ddb.radix ( Dv DDBCTL_RADIX )
2368The input and output radix.
2369.It Li ddb.maxoff ( Dv DDBCTL_MAXOFF )
2370The maximum symbol offset.
2371.It Li ddb.maxwidth ( Dv DDBCTL_MAXWIDTH )
2372The maximum output line width.
2373.It Li ddb.lines ( Dv DDBCTL_LINES )
2374Number of display lines.
2375.It Li ddb.tabstops ( Dv DDBCTL_TABSTOPS )
2376Tab width.
2377.It Li ddb.onpanic ( Dv DDBCTL_ONPANIC )
2378If greater than zero, DDB will be entered if the kernel panics.
2379A value of 1 causes the system to enter DDB on panic, while a value of 2
2380causes the kernel to attempt to print out a stack trace before entering DDB.
2381A value of 0 causes the kernel to attempt to print a stack trace, then
2382reboot, while a value of \-1 means neither a stack trace will be printed
2383nor DDB entered.
2384.It Li ddb.fromconsole ( Dv DDBCTL_FROMCONSOLE )
2385If not zero, DDB may be entered by sending a break on a serial
2386console or by a special key sequence on a graphics console.
2387.It Li ddb.tee_msgbuf
2388If not zero, DDB will output also to the kernel message buffer.
2389.It Li ddb.commandonenter
2390If not empty, a command to be executed on each enter to the
2391.Tn DDB .
2392.\"
2393.\" XXX: (a) ddb.commandonenter is missing in ddb(4);
2394.\"	 (b) No DDBCTL definitions for tee_msgbuf and commandonenter.
2395.El
2396.Pp
2397Some of these
2398.Tn MIB
2399nodes are also available as variables from within the debugger.
2400See
2401.Xr ddb 4
2402for more details.
2403.Ss The security.* subtree ( Dv CTL_SECURITY )
2404The
2405.Li security
2406level contains various security-related settings for
2407the system.
2408The available second level names are:
2409.Bl -column "Second level name" "integer" "Changeable" -offset indent
2410.It Sy Second level name	Sy Type	Sy Changeable
2411.It Li security.curtain	integer	yes
2412.It Li security.models	node	not applicable
2413.It Li security.pax	node	not applicable
2414.El
2415.Pp
2416Available settings are detailed below.
2417.Bl -tag -width "123456"
2418.It Li security.curtain
2419If non-zero, will filter return objects according to the user
2420.Tn ID
2421requesting information about them, preventing users from
2422accessing any objects they do not own.
2423.Pp
2424At the moment, it affects
2425.Xr ps 1 ,
2426.Xr netstat 1
2427(for
2428.Dv PF_INET ,
2429.Dv PF_INET6 ,
2430and
2431.Dv PF_UNIX
2432PCBs), and
2433.Xr w 1 .
2434.It Li security.models
2435.Nx
2436supports pluggable security models.
2437Every security model used, whether if loaded as a module or built with the system,
2438is required to add an entry to this node with at least one element,
2439.Dq name ,
2440indicating the name of the security model.
2441.Pp
2442In addition to the name, any settings and other information private to the
2443security model will be available under this node.
2444See
2445.Xr secmodel 9
2446for more information.
2447.It Li security.pax
2448Settings for PaX -- exploit mitigation features.
2449For more information on any of the PaX features, please see
2450.Xr paxctl 8
2451and
2452.Xr security 7 .
2453The available third and fourth level names are:
2454.Bl -column "security.pax.segvguard.suspend_timeout" "integer" "Changeable" \
2455-offset 2n
2456.It Sy Third and fourth level names Ta Sy Type Ta Sy Changeable
2457.It Li security.pax.aslr.enabled	integer	yes
2458.\".It Li security.pax.aslr.exec_len	integer	yes
2459.It Li security.pax.aslr.global	integer	yes
2460.\".It Li security.pax.aslr.mmap_len	integer	yes
2461.\".It Li security.pax.aslr.stack_len	integer	yes
2462.It Li security.pax.mprotect.enabled	integer	yes
2463.It Li security.pax.mprotect.global	integer	yes
2464.It Li security.pax.mprotect.ptrace	integer	yes
2465.It Li security.pax.segvguard.enabled	integer	yes
2466.It Li security.pax.segvguard.expiry_timeout	integer	yes
2467.It Li security.pax.segvguard.global	integer	yes
2468.It Li security.pax.segvguard.max_crashes	integer	yes
2469.It Li security.pax.segvguard.suspend_timeout	integer	yes
2470.El
2471.Bl -tag -width "123456"
2472.It Li security.pax.aslr.enabled
2473Enable PaX ASLR (Address Space Layout Randomization).
2474.Pp
2475The value of this
2476knob must be non-zero for PaX ASLR to be enabled, even if a program is set to
2477explicit enable.
2478.\".It Li security.pax.aslr.exec_len
2479.\" XXX: Undocumented.
2480.It Li security.pax.aslr.global
2481Specifies the default global policy for programs without an
2482explicit enable/disable flag.
2483.Pp
2484When non-zero, all programs will get PaX ASLR, except those exempted with
2485.Xr paxctl 8 .
2486Otherwise, all programs will not get PaX ASLR, except those specifically
2487marked as such with
2488.Xr paxctl 8 .
2489.\".It Li security.pax.aslr.mmap_len
2490.\" XXX: Undocumented.
2491.\" .It Li security.pax.aslr.stack_len
2492.\" XXX: Undocumented.
2493.It Li security.pax.mprotect.enabled
2494Enable PaX MPROTECT restrictions.
2495.Pp
2496These are
2497.Xr mprotect 2
2498restrictions to better enforce a W^X policy.
2499The value of this
2500knob must be non-zero for PaX MPROTECT to be enabled, even if a
2501program is set to explicit enable.
2502.It Li security.pax.mprotect.global
2503Specifies the default global policy for programs without an
2504explicit enable/disable flag.
2505.Pp
2506When non-zero, all programs will get the PaX MPROTECT restrictions,
2507except those exempted with
2508.Xr paxctl 8 .
2509Otherwise, all programs will not get the PaX MPROTECT restrictions,
2510except those specifically marked as such with
2511.Xr paxctl 8 .
2512.It Li security.pax.mprotect.ptrace
2513This variable allows
2514.Xr ptrace 2
2515to override PaX MPROTECT permissions.
2516It can have the following values:
2517.Bl -tag -width XX -compact
2518.It 0
2519Does not let override any permissions.
2520.It 1
2521Disables PaX MPROTECT from processes that start executing while traced (default).
2522.It 2
2523Bypasses PaX MPROTECT for all processes being traced.
2524.El
2525.It Li security.pax.segvguard.enabled
2526Enable PaX Segvguard.
2527.Pp
2528PaX Segvguard can detect and prevent certain exploitation attempts, where
2529an attacker may try for example to brute-force function return addresses
2530of respawning daemons.
2531.Pp
2532.Em Note :
2533The
2534.Nx
2535interface and implementation of the Segvguard is still experimental, and may
2536change in future releases.
2537.It Li security.pax.segvguard.expiry_timeout
2538If the max number was not reached within this timeout (in seconds), the entry
2539will expire.
2540.It Li security.pax.segvguard.global
2541Specifies the default global policy for programs without an
2542explicit enable/disable flag.
2543.Pp
2544When non-zero, all programs will get the PaX Segvguard,
2545except those exempted with
2546.Xr paxctl 8 .
2547Otherwise, no program will get the PaX Segvguard restrictions,
2548except those specifically marked as such with
2549.Xr paxctl 8 .
2550.It Li security.pax.segvguard.max_crashes
2551The maximum number of segfaults a program can receive before suspension.
2552.It Li security.pax.segvguard.suspend_timeout
2553Number of seconds to suspend a user from running a faulting program when the
2554limit was exceeded.
2555.El
2556.El
2557.Ss The vendor.* subtree ( Dv CTL_VENDOR )
2558The
2559.Li vendor
2560toplevel name is reserved to be used by vendors who wish to
2561have their own private MIB tree.
2562Intended use is to store values under
2563.Dq vendor.\*[Lt]yourname\*[Gt].* .
2564.Sh SEE ALSO
2565.Xr sysctl 3 ,
2566.Xr ipsec 4 ,
2567.Xr tcp 4 ,
2568.Xr security 7 ,
2569.Xr sysctl 8
2570.Sh HISTORY
2571The
2572.Nm
2573variables first appeared in
2574.Bx 4.4 .
2575