From bcacc7116b6f00df100b3912bab7a046ef5149a4 Mon Sep 17 00:00:00 2001 From: joerg Date: Thu, 9 Apr 2009 03:40:24 +0000 Subject: [PATCH] groff is applying more than enough space between column, so don't increase it even more. Do ensure that the columns are as large as the largest value though. Do not indent the kern.* table as it can't fit comfortable on the screen otherwise. --- share/man/man7/sysctl.7 | 190 ++++++++++++++++++++-------------------- 1 file changed, 93 insertions(+), 97 deletions(-) diff --git a/share/man/man7/sysctl.7 b/share/man/man7/sysctl.7 index 2aade502044d..805a5b219417 100644 --- a/share/man/man7/sysctl.7 +++ b/share/man/man7/sysctl.7 @@ -1,4 +1,4 @@ -.\" $NetBSD: sysctl.7,v 1.20 2009/03/01 21:50:55 wiz Exp $ +.\" $NetBSD: sysctl.7,v 1.21 2009/04/09 03:40:24 joerg Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -74,21 +74,21 @@ The top level names are defined with a CTL_ prefix in and are as follows. The next and subsequent levels down are found in the include files listed here, and described in separate sections below. -.Bl -column securityXX CTLXSECURITYXX "Next level namesXX" DescriptionXX +.Bl -column security CTL_SECURITY "Next level names" "High kernel limits" .It Sy Name Constant Next level names Description -.It kern CTL\_KERN sys/sysctl.h High kernel limits -.It vm CTL\_VM uvm/uvm_param.h Virtual memory -.It vfs CTL\_VFS sys/mount.h Filesystem -.It net CTL\_NET sys/socket.h Networking -.It debug CTL\_DEBUG sys/sysctl.h Debugging -.It hw CTL\_HW sys/sysctl.h Generic CPU, I/O -.It machdep CTL\_MACHDEP sys/sysctl.h Machine dependent -.It user CTL\_USER sys/sysctl.h User-level -.It ddb CTL\_DDB sys/sysctl.h In-kernel debugger -.It proc CTL\_PROC sys/sysctl.h Per-process -.It vendor CTL\_VENDOR ? Vendor specific -.It emul CTL\_EMUL sys/sysctl.h Emulation settings -.It security CTL\_SECURITY sys/sysctl.h Security settings +.It kern CTL_KERN sys/sysctl.h High kernel limits +.It vm CTL_VM uvm/uvm_param.h Virtual memory +.It vfs CTL_VFS sys/mount.h Filesystem +.It net CTL_NET sys/socket.h Networking +.It debug CTL_DEBUG sys/sysctl.h Debugging +.It hw CTL_HW sys/sysctl.h Generic CPU, I/O +.It machdep CTL_MACHDEP sys/sysctl.h Machine dependent +.It user CTL_USER sys/sysctl.h User-level +.It ddb CTL_DDB sys/sysctl.h In-kernel debugger +.It proc CTL_PROC sys/sysctl.h Per-process +.It vendor CTL_VENDOR ? Vendor specific +.It emul CTL_EMUL sys/sysctl.h Emulation settings +.It security CTL_SECURITY sys/sysctl.h Security settings .El .Sh The debug.* subtree The debugging variables vary from system to system. @@ -152,7 +152,7 @@ The string and integer information available for the level is detailed below. The changeable column shows whether a process with appropriate privilege may change the value. -.Bl -column "Second level nameXXXXXX" "struct disk_sysctlXXX" -offset indent +.Bl -column "hw.acpi.supported_states" "integer" "Changeable" -offset indent .It Sy Second level name Type Changeable .It hw.acpi.supported_states string no .It hw.alignbytes integer no @@ -235,7 +235,6 @@ The machine CPU class. The machine model. .It Li hw.ncpu ( HW_NCPU ) The number of CPUs. -.ne 1i .It Li hw.pagesize ( HW_PAGESIZE ) The software page size. .It Li hw.physmem ( HW_PHYSMEM ) @@ -257,7 +256,7 @@ The types of data currently available are process information, system vnodes, the open file entries, routing table entries, virtual memory statistics, load average history, and clock rate information. -.Bl -column "kern.posix_reader_writer_locks" "struct clockrateXXX" -offset indent +.Bl -column "kern.posix_reader_writer_locks" "struct kinfo_drivers" "not applicable" .It Sy Second level name Type Changeable .It kern.argmax integer no .It kern.autonicetime integer yes @@ -267,8 +266,8 @@ information. .It kern.ccpu integer no .It kern.clockrate struct clockinfo no .It kern.consdev integer no -.It kern.cp\_id struct no -.It kern.cp\_time uint64_t[\|] no +.It kern.cp_id struct no +.It kern.cp_time uint64_t[\|] no .It kern.defcorename string yes .It kern.domainname string yes .It kern.drivers struct kinfo_drivers no @@ -276,16 +275,16 @@ information. .It kern.forkfsleep integer yes .It kern.fscale integer no .It kern.fsync integer no -.It kern.hardclock\_ticks integer no +.It kern.hardclock_ticks integer no .It kern.hostid integer yes .It kern.hostname string yes -.It kern.iov\_max integer no -.It kern.job\_control integer no +.It kern.iov_max integer no +.It kern.job_control integer no .It kern.labeloffset integer no .It kern.labelsector integer no -.It kern.login\_name\_max integer no +.It kern.login_name_max integer no .It kern.logsigexit integer yes -.It kern.mapped\_files integer no +.It kern.mapped_files integer no .It kern.maxfiles integer yes .It kern.maxpartitions integer no .It kern.maxphys integer no @@ -294,9 +293,9 @@ information. .It kern.maxvnodes integer yes .It kern.mbuf node not applicable .It kern.memlock integer no -.It kern.memlock\_range integer no -.It kern.memory\_protection integer no -.It kern.monotonic\_clock integer no +.It kern.memlock_range integer no +.It kern.memory_protection integer no +.It kern.monotonic_clock integer no .It kern.msgbuf integer no .It kern.msgbufsize integer no .It kern.ngroups integer no @@ -306,23 +305,23 @@ information. .It kern.ostype string no .It kern.pipe node not applicable .It kern.posix1 integer no -.It kern.posix\_barriers integer no -.It kern.posix\_reader\_writer\_locks integer no -.It kern.posix\_semaphores integer no -.It kern.posix\_spin\_locks integer no -.It kern.posix\_threads integer no -.It kern.posix\_timers integer no +.It kern.posix_barriers integer no +.It kern.posix_reader_writer_locks integer no +.It kern.posix_semaphores integer no +.It kern.posix_spin_locks integer no +.It kern.posix_threads integer no +.It kern.posix_timers integer no .It kern.proc struct kinfo_proc no .It kern.proc2 struct kinfo_proc2 no -.It kern.proc\_args string no +.It kern.proc_args string no .It kern.prof node not applicable .It kern.rawpartition integer no -.It kern.root\_device string no -.It kern.root\_partition integer no -.It kern.rtc\_offset integer yes -.It kern.saved\_ids integer no +.It kern.root_device string no +.It kern.root_partition integer no +.It kern.rtc_offset integer yes +.It kern.saved_ids integer no .It kern.securelevel integer raise only -.It kern.synchronized\_io integer no +.It kern.synchronized_io integer no .It kern.ipc node not applicable .It kern.timecounter node not applicable .It kern.timex struct no @@ -331,8 +330,6 @@ information. .It kern.version string no .It kern.vnode struct vnode no .El -.ne 1i -.Pp .Bl -tag -width "123456" .It Li kern.argmax ( KERN_ARGMAX ) The maximum bytes of argument to @@ -489,7 +486,7 @@ structures in the networking code, see The third level names for the mbuf variables are detailed below. The changeable column shows whether a process with appropriate privilege may change the value. -.Bl -column "kern.mbuf.nmbclusters" "struct integerXXX" -offset indent +.Bl -column "kern.mbuf.nmbclusters" "integer" "Changeable" -offset indent .It Sy Third level name Type Changeable .\" XXX Changeable? really? .It kern.mbuf.mblowat integer yes @@ -556,7 +553,7 @@ Pipe settings. The third level names for the integer pipe settings is detailed below. The changeable column shows whether a process with appropriate privilege may change the value. -.Bl -column "kern.pipe.maxbigpipesXXX" "integerXXX" -offset indent +.Bl -column "kern.pipe.maxbigpipes" "integer" "Changeable" -offset indent .It Sy Third level name Type Changeable .It kern.pipe.kvasiz integer yes .It kern.pipe.maxbigpipes integer yes @@ -630,17 +627,17 @@ An array of 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 "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent +.Bl -column "KERN_PROC_SESSION" "Fourth level is:" -offset indent .It Sy Third level name Fourth level is: -.It KERN\_PROC\_ALL None -.It KERN\_PROC\_GID A group ID -.It KERN\_PROC\_PID A process ID -.It KERN\_PROC\_PGRP A process group -.It KERN\_PROC\_RGID A real group ID -.It KERN\_PROC\_RUID A real user ID -.It KERN\_PROC\_SESSION A session ID -.It KERN\_PROC\_TTY A tty device -.It KERN\_PROC\_UID A user ID +.It KERN_PROC_ALL None +.It KERN_PROC_GID A group ID +.It KERN_PROC_PID A process ID +.It KERN_PROC_PGRP A process group +.It KERN_PROC_RGID A real group ID +.It KERN_PROC_RUID A real user ID +.It KERN_PROC_SESSION A session ID +.It KERN_PROC_TTY A tty device +.It KERN_PROC_UID A user ID .El .It Li kern.proc2 ( KERN_PROC2 ) As for KERN_PROC, but an array of @@ -655,11 +652,11 @@ of a process. Multiple strings are returned separated by NUL characters. The third level name is the process ID. The fourth level name is as follows: -.Bl -column "Third level nameXXXXXX" -offset indent -.It KERN\_PROC\_ARGV The argv strings -.It KERN\_PROC\_ENV The environ strings -.It KERN\_PROC\_NARGV The number of argv strings -.It KERN\_PROC\_NENV The number of environ strings +.Bl -column "KERN_PROG_NARGV" "The number of environ strings" -offset indent +.It KERN_PROC_ARGV The argv strings +.It KERN_PROC_ENV The environ strings +.It KERN_PROC_NARGV The number of argv strings +.It KERN_PROC_NENV The number of environ strings .El .It Li kern.profiling ( KERN_PROF ) Return profiling information about the kernel. @@ -671,7 +668,7 @@ The third level names for the string and integer profiling information is detailed below. The changeable column shows whether a process with appropriate privilege may change the value. -.Bl -column "kern.profiling.gmonparam" "struct gmonparam" -offset indent +.Bl -column "kern.profiling.gmonparam" "struct gmonparam" "Changeable" -offset indent .It Sy Third level name Type Changeable .It kern.profiling.count u_short[\|] yes .It kern.profiling.froms u_short[\|] yes @@ -725,22 +722,22 @@ otherwise 0. .It Li kern.ipc ( KERN_SYSVIPC ) Return information about the SysV IPC parameters. The third level names for the ipc variables are detailed below. -.Bl -column "KERN_SYSVIPC_MSGXXX" "integerXXX" "noXXX" -offset indent -.It Sy Third level name Type Changeable -.It kern.ipc.sysvmsg integer no -.It kern.ipc.sysvsem integer no -.It kern.ipc.sysvshm integer no -.It kern.ipc.sysvipc_info struct no -.It kern.ipc.shmmax integer yes -.It kern.ipc.shmmni integer yes -.It kern.ipc.shmseg integer yes -.It kern.ipc.shmmaxpgs integer yes -.It kern.ipc.shm_use_phys integer yes -.It kern.ipc.msgmni integer yes -.It kern.ipc.msgseg integer yes -.It kern.ipc.semmni integer yes -.It kern.ipc.semmns integer yes -.It kern.ipc.semmnu integer yes +.Bl -column "kern.ipc.shm_use_phys" "integer" "Changeable" -offset indent +.It Sy Third level name Type Changeable +.It kern.ipc.sysvmsg integer no +.It kern.ipc.sysvsem integer no +.It kern.ipc.sysvshm integer no +.It kern.ipc.sysvipc_info struct no +.It kern.ipc.shmmax integer yes +.It kern.ipc.shmmni integer yes +.It kern.ipc.shmseg integer yes +.It kern.ipc.shmmaxpgs integer yes +.It kern.ipc.shm_use_phys integer yes +.It kern.ipc.msgmni integer yes +.It kern.ipc.msgseg integer yes +.It kern.ipc.semmni integer yes +.It kern.ipc.semmns integer yes +.It kern.ipc.semmnu integer yes .El .Bl -tag -width "123456" .It Li kern.ipc.sysvmsg ( KERN_SYSVIPC_MSG ) @@ -758,11 +755,11 @@ otherwise 0. .It Li kern.ipc.sysvipc_info ( KERN_SYSVIPC_INFO ) 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_INFOXXX" "struct shm_sysctl_infoXXX" -offset indent +.Bl -column "KERN_SYSVIPC_MSG_INFO" "struct shm_sysctl_info" -offset indent .It Sy Fourth level name 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 +.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 .El .Pp .Bl -tag -width "123456" @@ -810,7 +807,7 @@ Max number of undo structures in system. .El .It Li kern.timecounter ( dynamic ) Display and control the timecounter source of the system. -.Bl -column "kern.timecounter.timestepwarnings" "string" -offset indent +.Bl -column "kern.timecounter.timestepwarnings" "integer" "Changeable" -offset indent .It Sy Third level name Type Changeable .It kern.timecounter.choice string no .It kern.timecounter.hardware string yes @@ -834,7 +831,7 @@ on ttys. The third level names for the tty statistic variables are detailed below. The changeable column shows whether a process with appropriate privilege may change the value. -.Bl -column "KERNXTKSTATXRAWCCXXX" "struct integerXXX" -offset indent +.Bl -column "kern.tkstat.cancc" "quad" "Changeable" -offset indent .It Sy Third level name Type Changeable .It kern.tkstat.cancc quad no .It kern.tkstat.nin quad no @@ -922,7 +919,7 @@ Same syntax as kern.defcorename. .Sh The machdep.* subtree The set of variables defined is architecture dependent. Most architectures define at least the following variables. -.Bl -column "CONSOLE_DEVICEXXX" "integerXXX" -offset indent +.Bl -column "Second level name" "Type" "Changeable" -offset indent .It Sy Second level name Type Changeable .It Li CPU_CONSDEV dev_t no .El @@ -934,7 +931,7 @@ The changeable column shows whether a process with appropriate 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 nameX" "IPsec key management valuesX" -offset indent +.Bl -column "Second level name" "IPsec key management values" "Changeable" -offset indent .It Sy Second level name Type Changeable .It net.route routing messages no .It net.inet IPv4 values yes @@ -955,11 +952,11 @@ The third level name is a protocol number, which is currently always 0. The fourth level name is an address family, which may be set to 0 to select all address families. The fifth and sixth level names are as follows: -.Bl -column "Fifth level nameXXXXXX" "Sixth level is:XXX" -offset indent +.Bl -column "Fifth level name" "Sixth level is:" -offset indent .It Sy Fifth level name Sixth level is: -.It NET\_RT\_FLAGS rtflags -.It NET\_RT\_DUMP None -.It NET\_RT\_IFLIST None +.It NET_RT_FLAGS rtflags +.It NET_RT_DUMP None +.It NET_RT_IFLIST None .El .It Li net.inet ( PF_INET ) Get or set various global information about the IPv4 @@ -967,7 +964,7 @@ Get or set various global information about the IPv4 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 name" "sack.globalmaxholes" "integer" -offset 4n +.Bl -column "Protocol name" "sack.globalmaxholes" "integer" "Changeable" -offset 4n .It Sy Protocol name Variable name Type Changeable .It arp down integer yes .It arp keep integer yes @@ -1331,7 +1328,7 @@ Get or set various global information about the IPv6 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 name" "Variable nameXX" "integer" "yes" -offset indent +.Bl -column "Protocol name" "do_loopback_cksum" "integer" "Changeable" -offset indent .It Sy Protocol name Variable name Type Changeable .It icmp6 errppslimit integer yes .It icmp6 mtudisc_hiwat integer yes @@ -1597,7 +1594,7 @@ For variables net.*.ipsec6, please refer to Get or set various global information about the IPsec key management. The third level name is the variable name. The currently defined variable and names are: -.Bl -column "blockacq_lifetime" "integer" "yes" -offset indent +.Bl -column "blockacq_lifetime" "integer" "Changeable" -offset indent .It Sy Variable name Type Changeable .It debug integer yes .It spi_try integer yes @@ -1610,6 +1607,7 @@ The currently defined variable and names are: .It esp_auth integer yes .It ah_keymin integer yes .El +.Pp The variables are as follows: .Bl -tag -width "123456" .It Li debug @@ -1660,7 +1658,7 @@ When a set-user-ID or set-group-ID binary is executed, the value of PROC_PID_CORENAME is reset to the system default value. 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 "USER_COLL_WEIGHTS_MAXXXX" "integerXXX" "yes" -offset indent +.Bl -column "proc.pid.corename" "string" "not applicable" -offset indent .It Sy Third level name Type Changeable .It proc.pid.corename string yes .It proc.pid.rlimit node not applicable @@ -1669,7 +1667,6 @@ points to the current process, or the PID of the target process. .It proc.pid.stopexit int yes .El .Bl -tag -width "123456" -.Pp .It Li proc.pid.corename ( PROC_PID_CORENAME ) The template used for the core dump file name (see .Xr core 5 @@ -1778,7 +1775,7 @@ The string and integer information available for the level is detailed below. The changeable column shows whether a process with appropriate privilege may change the value. -.Bl -column "USER_COLL_WEIGHTS_MAXXXX" "integerXXX" -offset indent +.Bl -column "user.coll_weights_max" "integer" "Changeable" -offset indent .It Sy Second level name Type Changeable .It user.atexit_max integer no .It user.bc_base_max integer no @@ -1804,7 +1801,6 @@ privilege may change the value. .It user.tzname_max integer no .El .Bl -tag -width "123456" -.Pp .It Li user.atexit_max ( USER_ATEXIT_MAX ) The maximum number of functions that may be registered with .Xr atexit 3 . @@ -1880,7 +1876,7 @@ The string and integer information available for the level is detailed below. The changeable column shows whether a process with appropriate privilege may change the value. -.Bl -column "Second level nameXXXXXX" "struct uvmexp_sysctlXXX" -offset indent +.Bl -column "Second level name" "struct uvmexp_sysctl" "Changeable" -offset indent .It Sy Second level name Type Changeable .It vm.anonmax int yes .It vm.anonmin int yes @@ -1960,7 +1956,7 @@ level is detailed below. The changeable column shows whether a process with appropriate privilege may change the value. .\" XXX sort -.Bl -column "ddb.fromconsoleXXX" "integerXXX" -offset indent +.Bl -column "Second level name" "integer" "Changeable" -offset indent .It Sy Second level name Type Changeable .It ddb.radix integer yes .It ddb.maxoff integer yes