src/share/man/man7/sysctl.7 - diff

Return to sysctl.7 CVS log

Up to [cvs.NetBSD.org] / src / share / man / man7

Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.

Diff for /src/share/man/man7/sysctl.7 between version 1.105 and 1.112

version 1.105, 2017/01/01 23:59:19

version 1.112, 2017/03/25 05:51:28

Line 29

.\"

.\" @(#)sysctl.3 8.4 (Berkeley) 5/9/95

.\"

.Dd November 17, 2016

.Dd March 25, 2017

.Dt SYSCTL 7

.Os

.Sh NAME

Line 188 level is detailed below.

The changeable column shows whether a process with appropriate

privilege may change the value.

.Bl -column "hw.machine_arch" "integer" "Changeable" -offset indent

.It Sy Second level name Sy Type Sy Changeable

.It Sy Second level name Ta Sy Type Ta Sy Changeable

.It hw.alignbytes integer no

.It hw.byteorder integer no

.It hw.cnmagic string yes

Line 272 The changeable column shows whether a pr

privilege may change the value.

.Bl -column "kern.posix_reader_writer_locks" \

"struct kinfo_drivers" "not applicable"

.It Sy Second level name Sy Type Sy Changeable

.It Sy Second level name Ta Sy Type Ta Sy Changeable

.It kern.aio_listio_max integer yes

.It kern.aio_max integer yes

.It kern.arandom integer no

Line 355 privilege may change the value.

.It kern.rtc_offset integer yes

.It kern.saved_ids integer no

.It kern.sbmax integer yes

.\".It kern.sched node not applicable

.It kern.sched node not applicable

.It kern.securelevel integer raise only

.It kern.somaxkva integer yes

.It kern.synchronized_io integer no

Line 434 The third level name is

.Dv kern.coredump.setid

and fourth level variables are described below.

.Bl -column "kern.coredump.setid.group" "integer" "Changeable" -offset indent

.It Sy Fourth level name Sy Type Sy Changeable

.It Sy Fourth level name Ta Sy Type Ta Sy Changeable

.It kern.coredump.setid.dump integer yes

.It kern.coredump.setid.group integer yes

.It kern.coredump.setid.mode integer yes

Line 563 The values of the history tables are in

decoded by the

.Xr vmstat 1

utility's

.Dv -U

.Fl U

and

.Dv u

.Fl u

options;

the -l option can be used to see which tables are available.

the

.Fl l

option can be used to see which tables are available.

.It Li kern.hostid ( Dv KERN_HOSTID )

Get or set the host identifier.

This is aimed to replace the legacy

Line 593 and

Line 595 and

Return information about the SysV IPC parameters.

The third level names for the ipc variables are detailed below.

.Bl -column "kern.ipc.shm_use_phys" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.ipc.sysvmsg integer no

.It kern.ipc.sysvsem integer no

.It kern.ipc.sysvshm integer no

Line 626 otherwise\ 0.

Line 628 otherwise\ 0.

Return System V style IPC configuration and run-time information.

The fourth level name selects the System V style IPC facility.

.Bl -column "KERN_SYSVIPC_MSG_INFO" "struct shm_sysctl_info" -offset indent

.It Sy Fourth level name Sy Type

.It Sy Fourth level name Ta Sy Type

.It KERN_SYSVIPC_MSG_INFO struct msg_sysctl_info

.It KERN_SYSVIPC_SEM_INFO struct sem_sysctl_info

.It KERN_SYSVIPC_SHM_INFO struct shm_sysctl_info

Line 727 The third level names for the mbuf varia

Line 729 The third level names for the mbuf varia

The changeable column shows whether a process with appropriate

privilege may change the value.

.Bl -column "kern.mbuf.nmbclusters" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.\" XXX Changeable? really?

.It kern.mbuf.mblowat integer yes

.It kern.mbuf.mclbytes integer yes

Line 782 See

Line 784 See

Settings related to kernel modules.

The third level names for the settings are described below.

.Bl -column "kern.module.autoload" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.module.autoload integer yes

.It kern.module.autotime integer yes

.It kern.module.verbose integer yes

Line 817 This node is created dynamically when

Line 819 This node is created dynamically when

the corresponding kernel module is loaded.

The third level names for the settings are described below.

.Bl -column "kern.mqueue.mq_max_msgsize" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.mqueue.mq_open_max integer yes

.It kern.mqueue.mq_prio_max integer yes

.It kern.mqueue.mq_max_msgsize integer yes

Line 869 The third level names for the integer p

Line 871 The third level names for the integer p

The changeable column shows whether a process with appropriate

privilege may change the value.

.Bl -column "kern.pipe.maxbigpipes" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.pipe.kvasiz integer yes

.It kern.pipe.maxbigpipes integer yes

.It kern.pipe.maxkvasz integer yes

Line 962 structures is returned,

Line 964 structures is returned,

whose size depends on the current number of such objects in the system.

The third and fourth level numeric names are as follows:

.Bl -column "KERN_PROC_SESSION" "Fourth level is:" -offset indent

.It Sy Third level name Sy Fourth level is:

.It Sy Third level name Ta Sy Fourth level is :

.It KERN_PROC_ALL None

.It KERN_PROC_GID A group ID

.It KERN_PROC_PID A process ID

Line 1007 is detailed below.

Line 1009 is detailed below.

The changeable column shows whether a process with appropriate

privilege may change the value.

.Bl -column "kern.profiling.gmonparam" "struct gmonparam" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.profiling.count u_short[\|] yes

.It kern.profiling.froms u_short[\|] yes

.It kern.profiling.gmonparam struct gmonparam no

Line 1055 Maximum socket buffer size.

Line 1057 Maximum socket buffer size.

.It Li kern.securelevel ( Dv KERN_SECURELVL )

See

.Xr secmodel_securelevel 9 .

.\" .It Li kern.sched

.It Li kern.sched ( dynamic )

.\" XXX: Undocumented.

Influence the scheduling of LWPs, their priorisation and how they are

distributed on and moved between CPUs.

.Bl -column "kern.sched.balance_period" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It kern.sched.cacheht_time integer yes

.It kern.sched.balance_period integer yes

.It kern.sched.average_weight integer yes

.It kern.sched.min_catch integer yes

.It kern.sched.timesoftints integer yes

.It kern.sched.kpreempt_pri integer yes

.It kern.sched.upreempt_pri integer yes

.It kern.sched.maxts integer yes

.It kern.sched.mints integer yes

.It kern.sched.name string no

.It kern.sched.rtts integer no

.It kern.sched.pri_min integer no

.It kern.sched.pri_max integer no

.El

.Pp

The variables are as follows:

.Bl -tag -width "123456"

.It Li kern.sched.cacheht_time ( dynamic )

Cache hotness time in which a LWP is kept on one particular CPU

and not moved to another CPU.

This reduces the overhead of flushing and reloading caches.

Defaults to 3ms.

Needs to be given in

.Dq hz

units, see

.Xr mstohz 9 .

.It Li kern.sched.balance_period ( dynamic )

Interval at which the CPU queues are checked for re-balancing.

Defaults to 300ms.

Needs to be given in

.Dq hz

units, see

.Xr mstohz 9 .

.It Li kern.sched.average_weight ( dynamic )

Can be used to influence how likely LWPs are to be migrated from

one CPU's queue of LWPs that are ready to run to a different, idle CPU.

The value gives the percentage for weighting the average count of

migratable threads from the past against the current number of

migratable threads.

A small value gives more weight to the past, a larger values more weight

on the current situation.

Defaults to 50 and must be between 0 and 100.

.It Li kern.sched.min_catch ( dynamic )

Minimum count of migratable (runable) threads for catching (stealing)

from another CPU.

Defaults to 1 but can be increased to decrease chance of thread

migration between CPUs.

.It Li kern.sched.timesoftints ( dynamic )

Enable tracking of CPU time for soft interrupts

as part of a LWP's real execution time.

Set to a non-zero value to enable,

and see

.Xr ps 1

for printing CPU times.

.It Li kern.sched.kpreempt_pri ( dynamic )

Minimum priority to trigger kernel preemption.

.It Li kern.sched.upreempt_pri ( dynamic )

Minimum priority to trigger user preemption.

.It Li kern.sched.maxts ( dynamic )

Scheduler specific maximal time quantum (in milliseconds).

Must be set to a value larger than

.Dq mints

and between 10 and

.Dq hz

as given by the

.Dv kern.clockrate

sysctl.

Provided by the M2 scheduler.

.It Li kern.sched.mints ( dynamic )

Scheduler specific minimal time quantum (in milliseconds).

Must be set to a value smaller than

.Dq maxts

and between 1 and

.Dq hz

as given by the

.Dq kern.clockrate

sysctl.

Provided by the M2 scheduler.

.It Li kern.sched.name ( dynamic )

Scheduler name.

Provided both by the M2 and the 4BSD scheduler.

.It Li kern.sched.rtts ( dynamic )

Fixed scheduler specific round-robin time quantum in milliseconds.

Provided both by the M2 and the 4BSD scheduler.

.It Li kern.sched.pri_min ( dynamic )

Minimal POSIX real-time priority.

See

.Xr sched 3 .

.It Li kern.sched.pri_max ( dynamic )

Maximal POSIX real-time priority.

See

.Xr sched 3 .

.El

.It Li kern.somaxkva ( Dv KERN_SOMAXKVA )

Maximum amount of kernel memory to be used for socket buffers.

.\" XXX units?

Line 1068 otherwise\ 0.

Line 1166 otherwise\ 0.

.It Li kern.timecounter ( dynamic )

Display and control the timecounter source of the system.

.Bl -column "kern.timecounter.timestepwarnings" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.timecounter.choice string no

.It kern.timecounter.hardware string yes

.It kern.timecounter.timestepwarnings integer yes

Line 1092 The third level names for the tty statis

Line 1190 The third level names for the tty statis

The changeable column shows whether a process

with appropriate privilege may change the value.

.Bl -column "kern.tkstat.cancc" "quad" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.tkstat.cancc quad no

.It kern.tkstat.nin quad no

.It kern.tkstat.nout quad no

Line 1115 The third level names for the tty setup

Line 1213 The third level names for the tty setup

The changeable column shows whether a process

with appropriate privilege may change the value.

.Bl -column "kern.tty.qsize" "int" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.tty.qsize int yes

.El

.Pp

Line 1132 and

Line 1230 and

.It Li kern.uidinfo

Resource usage for the current user.

.Bl -column "kern.uidinfo.proccnt" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.uidinfo.proccnt integer no

.It kern.uidinfo.lwpcnt integer no

.It kern.uidinfo.lockcnt integer no

Line 1167 system.

Line 1265 system.

Runtime information for

.Xr veriexec 8 .

.Bl -column "kern.veriexec.algorithms" "integer" "Changeable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It kern.veriexec.algorithms string no

.It kern.veriexec.count node not applicable

.It kern.veriexec.strict integer yes

Line 1216 followed by the vnode itself

Line 1314 followed by the vnode itself

The set of variables defined is architecture dependent.

Most architectures define at least the following variables.

.Bl -column "machdep.booted_kernel" "Type" "Changeable" -offset indent

.It Sy Second level name Sy Type Sy Changeable

.It Sy Second level name Ta Sy Type Ta Sy Changeable

.It Li machdep.booted_kernel string no

.El

.\" XXX: Document the above.

Line 1229 privilege may change the value.

Line 1327 privilege may change the value.

The second and third levels are typically the protocol family and

protocol number, though this is not always the case.

.Bl -column "Second level name" "IPsec key management values" "Changeable" -offset indent

.It Sy Second level name Sy Type Sy Changeable

.It Sy Second level name Ta Sy Type Ta Sy Changeable

.It net.route routing messages no

.It net.inet IPv4 values yes

.It net.inet6 IPv6 values yes

Line 1249 The fourth level name is an address fami

Line 1347 The fourth level name is an address fami

select all address families.

The fifth and sixth level names are as follows:

.Bl -column "Fifth level name" "Sixth level is:" -offset indent

.It Sy Fifth level name Sy Sixth level is:

.It Sy Fifth level name Ta Sy Sixth level is :

.It NET_RT_FLAGS rtflags

.It NET_RT_DUMP None

.It NET_RT_IFLIST None

Line 1261 The third level name is the protocol.

Line 1359 The third level name is the protocol.

The fourth level name is the variable name.

The currently defined protocols and names are:

.Bl -column "Protocol" "anonportalgo.available" "integer" "Changeable" -offset indent

.It Sy Protocol Variable Sy Type Sy Changeable

.It Sy Protocol Variable Ta Sy Type Ta Sy Changeable

.It arp down integer yes

.It arp keep integer yes

.It arp log_movements integer yes

Line 1643 The third level name is the protocol.

Line 1741 The third level name is the protocol.

The fourth level name is the variable name.

The currently defined protocols and names are:

.Bl -column "Protocol" "anonportalgo.available" "integer" "Changeable" -offset indent

.It Sy Protocol Variable Sy Type Sy Changeable

.It Sy Protocol Variable Ta Sy Type Ta Sy Changeable

.It icmp6 errppslimit integer yes

.It icmp6 mtudisc_hiwat integer yes

.It icmp6 mtudisc_lowat integer yes

Line 1940 Get or set various global information ab

Line 2038 Get or set various global information ab

The third level name is the variable name.

The currently defined variable and names are:

.Bl -column "blockacq_lifetime" "integer" "Changeable" -offset indent

.It Sy Variable Type Sy Changeable

.It Sy Variable Type Ta Sy Changeable

.It debug integer yes

.It enabled integer yes

.It used integer no

Line 1974 Force IPsec processing even when SPD pol

Line 2072 Force IPsec processing even when SPD pol

.It Li used

Based on if IPsec is enabled, and SPD rule existance, show if

IPsec is being used.

Note that currenly once IPsec is being used, it cannot be disabled.

Note that currently once IPsec is being used, it cannot be disabled.

.It Li spi_try

The number of times the kernel will try to obtain an unique SPI

when it generates it from random number generator.

Line 2020 value of PROC_PID_CORENAME is reset to t

Line 2118 value of PROC_PID_CORENAME is reset to t

The second level name is either the magic value PROC_CURPROC, which

points to the current process, or the PID of the target process.

.Bl -column "proc.pid.corename" "string" "not applicable" -offset indent

.It Sy Third level name Sy Type Sy Changeable

.It Sy Third level name Ta Sy Type Ta Sy Changeable

.It proc.pid.corename string yes

.It proc.pid.rlimit node not applicable

.It proc.pid.stopfork int yes

.It proc.pid.stopexec int yes

.It proc.pid.stopexit int yes

.It proc.pid.paxflags int no

.El

.Bl -tag -width "123456"

.It Li proc.pid.corename ( Dv PROC_PID_CORENAME )

Line 2105 Both are of type integer.

Line 2204 Both are of type integer.

If non zero, the process' children will be stopped after

.Xr fork 2

calls.

The children is created in the SSTOP state and is never scheduled

The children are created in the SSTOP state and are never scheduled

for running before being stopped.

This feature helps attaching a process with a debugger such as

This feature helps attaching to a process with a debugger such as

.Xr gdb 1

before it had the opportunity to actually do anything.

before it has the opportunity to actually do anything.

.Pp

This value is inherited by the process's children, and it also

apply to emulation specific system calls that fork a new process, such as

applies to emulation specific system calls that fork a new process, such as

.Fn sproc

.Fn clone .

.It Li proc.pid.stopexec ( Dv PROC_PID_STOPEXEC )

If non zero, the process will be stopped on next

If non zero, the process will be stopped on the next

.Xr exec 3

call.

The process created by

.Xr exec 3

is created in the SSTOP state and is never scheduled for running

before being stopped.

This feature helps attaching a process with a debugger such as

This feature enables attaching to a process with a debugger such as

.Xr gdb 1

before it had the opportunity to actually do anything.

before it has the opportunity to actually do anything.

.Pp

This value is inherited by the process's children.

.It Li proc.pid.stopexit ( Dv PROC_PID_STOPEXIT )

If non zero, the process will be stopped on when it has cause to exit,

If non zero, the process will be stopped when it has cause to exit,

either by way of calling

.Xr exit 3 ,

.Xr _exit 2 ,

or by the receipt of a specific signal.

The process is stopped before any of its resources or vm space is

released allowing examination of the termination state of a process

released allowing examination of the termination state of the process

before it disappears.

This feature can be used to examine the final conditions of the

process's vmspace via

Line 2146 or its resource settings with

Line 2245 or its resource settings with

before it disappears.

.Pp

This value is also inherited by the process's children.

.It Li proc.pid.paxflags ( Dv PROC_PID_PAXFLAGS )

This read-only variable returns the current value of the process's pax

flags (see

.Xr paxctl 8 ) .

.El

.Ss The user.* subtree ( Dv CTL_USER )

The string and integer information available for the

Line 2154 level is detailed below.

Line 2257 level is detailed below.

The changeable column shows whether a process with appropriate

privilege may change the value.

.Bl -column "user.coll_weights_max" "integer" "Changeable" -offset indent

.It Sy Second level name Sy Type Sy Changeable

.It Sy Second level name Ta Sy Type Ta Sy Changeable

.It user.atexit_max integer no

.It user.bc_base_max integer no

.It user.bc_dim_max integer no

Line 2259 level is detailed below.

Line 2362 level is detailed below.

The changeable column shows whether a process with appropriate

privilege may change the value.

.Bl -column "Second level name" "struct uvmexp_sysctl" "Changeable" -offset indent

.It Sy Second level name Sy Type Sy Changeable

.It Sy Second level name Ta Sy Type Ta Sy Changeable

.It vm.anonmax int yes

.It vm.anonmin int yes

.It vm.bufcache int yes

Line 2350 The changeable column shows whether a pr

Line 2453 The changeable column shows whether a pr

privilege may change the value.

.\" XXX sort

.Bl -column "Second level name" "integer" "Changeable" -offset indent

.It Sy Second level name Sy Type Sy Changeable

.It Sy Second level name Ta Sy Type Ta Sy Changeable

.It ddb.radix integer yes

.It ddb.maxoff integer yes

.It ddb.maxwidth integer yes

Line 2405 level contains various security-related

Line 2508 level contains various security-related

the system.

The available second level names are:

.Bl -column "Second level name" "integer" "Changeable" -offset indent

.It Sy Second level name Sy Type Sy Changeable

.It Sy Second level name Ta Sy Type Ta Sy Changeable

.It Li security.curtain integer yes

.It Li security.models node not applicable

.It Li security.pax node not applicable

CVSweb <webmaster@jp.NetBSD.org>