Skip to content

Commit 2a680c5

Browse files
concussiousbsdimp
authored andcommitted
sysctl.8: mark sysctls as vars per style.mdoc(7)
+ while here, fix alignment and tag SPDX MFC after: 3 days Reviewed by: imp Pull Request: #1421
1 parent 83e93d5 commit 2a680c5

File tree

1 file changed

+78
-76
lines changed

1 file changed

+78
-76
lines changed

sbin/sysctl/sysctl.8

Lines changed: 78 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
.\"-
2+
.\" SPDX-License-Identifier: BSD-3-Clause
3+
.\"
14
.\" Copyright (c) 1993
25
.\" The Regents of the University of California. All rights reserved.
36
.\"
@@ -50,11 +53,10 @@ privilege to set kernel state.
5053
The state to be retrieved or set is described using a
5154
.Dq Management Information Base
5255
.Pq Dq MIB
53-
style name, described as a dotted set of
54-
components.
56+
style name, described as a dotted set of components.
5557
.Pp
5658
The following options are available:
57-
.Bl -tag -width indent
59+
.Bl -tag -width "-f filename"
5860
.It Fl A
5961
Equivalent to
6062
.Fl o a
@@ -202,77 +204,77 @@ String and integer values can be set using
202204
.Nm .
203205
.Bl -column security.bsd.unprivileged_read_msgbuf integerxxx
204206
.It Sy "Name Type Changeable"
205-
.It "kern.ostype string no"
206-
.It "kern.osrelease string no"
207-
.It "kern.osrevision integer no"
208-
.It "kern.version string no"
209-
.It "kern.maxvnodes integer yes"
210-
.It "kern.maxproc integer no"
211-
.It "kern.maxprocperuid integer yes"
212-
.It "kern.maxfiles integer yes"
213-
.It "kern.maxfilesperproc integer yes"
214-
.It "kern.argmax integer no"
215-
.It "kern.securelevel integer raise only"
216-
.It "kern.hostname string yes"
217-
.It "kern.hostid integer yes"
218-
.It "kern.clockrate struct no"
219-
.It "kern.posix1version integer no"
220-
.It "kern.ngroups integer no"
221-
.It "kern.job_control integer no"
222-
.It "kern.saved_ids integer no"
223-
.It "kern.boottime struct no"
224-
.It "kern.domainname string yes"
225-
.It "kern.filedelay integer yes"
226-
.It "kern.dirdelay integer yes"
227-
.It "kern.metadelay integer yes"
228-
.It "kern.osreldate integer no"
229-
.It "kern.bootfile string yes"
230-
.It "kern.corefile string yes"
231-
.It "kern.logsigexit integer yes"
232-
.It "security.bsd.suser_enabled integer yes"
233-
.It "security.bsd.see_other_uids integer yes"
234-
.It "security.bsd.see_other_gids integer yes"
235-
.It "security.bsd.see_jail_proc integer yes"
236-
.It "security.bsd.unprivileged_proc_debug integer yes"
237-
.It "security.bsd.unprivileged_read_msgbuf integer yes"
238-
.It "vm.loadavg struct no"
239-
.It "hw.machine string no"
240-
.It "hw.model string no"
241-
.It "hw.ncpu integer no"
242-
.It "hw.byteorder integer no"
243-
.It "hw.physmem integer no"
244-
.It "hw.usermem integer no"
245-
.It "hw.pagesize integer no"
246-
.It "hw.floatingpoint integer no"
247-
.It "hw.machine_arch string no"
248-
.It "hw.realmem integer no"
249-
.It "machdep.adjkerntz integer yes"
250-
.It "machdep.disable_rtc_set integer yes"
251-
.It "machdep.guessed_bootdev string no"
252-
.It "user.cs_path string no"
253-
.It "user.bc_base_max integer no"
254-
.It "user.bc_dim_max integer no"
255-
.It "user.bc_scale_max integer no"
256-
.It "user.bc_string_max integer no"
257-
.It "user.coll_weights_max integer no"
258-
.It "user.expr_nest_max integer no"
259-
.It "user.line_max integer no"
260-
.It "user.re_dup_max integer no"
261-
.It "user.posix2_version integer no"
262-
.It "user.posix2_c_bind integer no"
263-
.It "user.posix2_c_dev integer no"
264-
.It "user.posix2_char_term integer no"
265-
.It "user.posix2_fort_dev integer no"
266-
.It "user.posix2_fort_run integer no"
267-
.It "user.posix2_localedef integer no"
268-
.It "user.posix2_sw_dev integer no"
269-
.It "user.posix2_upe integer no"
270-
.It "user.stream_max integer no"
271-
.It "user.tzname_max integer no"
272-
.It "user.localbase string no"
207+
.It Va "kern.ostype string no"
208+
.It Va "kern.osrelease string no"
209+
.It Va "kern.osrevision integer no"
210+
.It Va "kern.version string no"
211+
.It Va "kern.maxvnodes integer yes"
212+
.It Va "kern.maxproc integer no"
213+
.It Va "kern.maxprocperuid integer yes"
214+
.It Va "kern.maxfiles integer yes"
215+
.It Va "kern.maxfilesperproc integer yes"
216+
.It Va "kern.argmax integer no"
217+
.It Va "kern.securelevel integer raise only"
218+
.It Va "kern.hostname string yes"
219+
.It Va "kern.hostid integer yes"
220+
.It Va "kern.clockrate struct no"
221+
.It Va "kern.posix1version integer no"
222+
.It Va "kern.ngroups integer no"
223+
.It Va "kern.job_control integer no"
224+
.It Va "kern.saved_ids integer no"
225+
.It Va "kern.boottime struct no"
226+
.It Va "kern.domainname string yes"
227+
.It Va "kern.filedelay integer yes"
228+
.It Va "kern.dirdelay integer yes"
229+
.It Va "kern.metadelay integer yes"
230+
.It Va "kern.osreldate integer no"
231+
.It Va "kern.bootfile string yes"
232+
.It Va "kern.corefile string yes"
233+
.It Va "kern.logsigexit integer yes"
234+
.It Va "security.bsd.suser_enabled integer yes"
235+
.It Va "security.bsd.see_other_uids integer yes"
236+
.It Va "security.bsd.see_other_gids integer yes"
237+
.It Va "security.bsd.see_jail_proc integer yes"
238+
.It Va "security.bsd.unprivileged_proc_debug integer yes"
239+
.It Va "security.bsd.unprivileged_read_msgbuf integer yes"
240+
.It Va "vm.loadavg struct no"
241+
.It Va "hw.machine string no"
242+
.It Va "hw.model string no"
243+
.It Va "hw.ncpu integer no"
244+
.It Va "hw.byteorder integer no"
245+
.It Va "hw.physmem integer no"
246+
.It Va "hw.usermem integer no"
247+
.It Va "hw.pagesize integer no"
248+
.It Va "hw.floatingpoint integer no"
249+
.It Va "hw.machine_arch string no"
250+
.It Va "hw.realmem integer no"
251+
.It Va "machdep.adjkerntz integer yes"
252+
.It Va "machdep.disable_rtc_set integer yes"
253+
.It Va "machdep.guessed_bootdev string no"
254+
.It Va "user.cs_path string no"
255+
.It Va "user.bc_base_max integer no"
256+
.It Va "user.bc_dim_max integer no"
257+
.It Va "user.bc_scale_max integer no"
258+
.It Va "user.bc_string_max integer no"
259+
.It Va "user.coll_weights_max integer no"
260+
.It Va "user.expr_nest_max integer no"
261+
.It Va "user.line_max integer no"
262+
.It Va "user.re_dup_max integer no"
263+
.It Va "user.posix2_version integer no"
264+
.It Va "user.posix2_c_bind integer no"
265+
.It Va "user.posix2_c_dev integer no"
266+
.It Va "user.posix2_char_term integer no"
267+
.It Va "user.posix2_fort_dev integer no"
268+
.It Va "user.posix2_fort_run integer no"
269+
.It Va "user.posix2_localedef integer no"
270+
.It Va "user.posix2_sw_dev integer no"
271+
.It Va "user.posix2_upe integer no"
272+
.It Va "user.stream_max integer no"
273+
.It Va "user.tzname_max integer no"
274+
.It Va "user.localbase string no"
273275
.El
274276
.Sh FILES
275-
.Bl -tag -width ".In netinet/icmp_var.h" -compact
277+
.Bl -tag -width "<netinet/icmp_var.h>" -compact
276278
.It In sys/sysctl.h
277279
definitions for top level identifiers, second level kernel and hardware
278280
identifiers, and user level identifiers
@@ -296,20 +298,20 @@ definitions for fourth level UDP identifiers
296298
For example, to retrieve the maximum number of processes allowed
297299
in the system, one would use the following request:
298300
.Pp
299-
.Dl "sysctl kern.maxproc"
301+
.Dl Va "sysctl kern.maxproc"
300302
.Pp
301303
To set the maximum number of processes allowed
302304
per uid to 1000, one would use the following request:
303305
.Pp
304-
.Dl "sysctl kern.maxprocperuid=1000"
306+
.Dl Va "sysctl kern.maxprocperuid=1000"
305307
.Pp
306308
Information about the system clock rate may be obtained with:
307309
.Pp
308-
.Dl "sysctl kern.clockrate"
310+
.Dl Va "sysctl kern.clockrate"
309311
.Pp
310312
Information about the load average history may be obtained with:
311313
.Pp
312-
.Dl "sysctl vm.loadavg"
314+
.Dl Va "sysctl vm.loadavg"
313315
.Pp
314316
More variables than these exist, and the best and likely only place
315317
to search for their deeper meaning is undoubtedly the source where

0 commit comments

Comments
 (0)