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