sysctl.8: fix format typo

Signed-off-by: Igor Ostapenko <pm@igoro.pro>

sbin: Remove ancient SCCS tags.

Remove ancient SCCS tags from the tree, automated scripting, with two
minor fixup to keep things compiling. All the common forms in the tree
were removed with a perl script.

Sponsored by: Netflix

sysctl(8): Mention more security.bsd knobs; Refer to security(7)

Reviewed by: mhorne, pauamma_gundo.com, emaste
MFC after: 2 weeks
Sponsored by: Kumacom SAS
Differential Revision: https://reviews.freebsd.org/D41113

Remove $FreeBSD$: one-line nroff pattern

Remove /^\.\\"\s*\$FreeBSD\$$\n/

Add -F option to sysctl(8) to display sysctl format.

Also add a test to ensure that it is working correctly.

Submitted by: ota_j.email.ne.jp
Reviewed by: mckusick
Differential Revision: https://reviews.freebsd.org/D34012

sysctl.8: grammar nit

sysctl.8: Reference sysctl(9)

MFC after: 1 week

sysctl(8): Mention CTLFLAG_SKIP

`sysctl -a` does not print values with this flag.

Reviewed by: debdrup
MFC after: 2 weeks
Differential Revision: https://reviews.freebsd.org/D34615

Update man-pages to describe the user.localbase variable added in r367179.

MFC after: 3 days

sysctl(8): clarify -n flag

-n omits the name of the variable regardless of the type of information that is
requested. Rephrase to clarify this point.

PR: 242191
Submitted by: stilezy@gmail.com
Approved by: emaste@
Differential Revision: https://reviews.freebsd.org/D26149

Remove -R option which was added to sysctl(8) man page per r244106, but it is not implemented.

MFC after: 3 days
Submitted by: Alfonso Siciliano <alfix86@gmail.com>
Reviewed by: 0mp, imp
Differential Revision: https://reviews.freebsd.org/D19012

sysctl(8): Add a standard exit status section.

Reviewed by: bcr
Approved by: re (gjb), krion (mentor)
Differential Revision: https://reviews.freebsd.org/D17147

Permit sysctl(8) to set an array of numeric values for a single node.

Most sysctl nodes only return a single value, but some nodes return an
array of values (e.g. kern.cp_time). sysctl(8) understand how to display
the values of a node that returns multiple values (it prints out each
numeric value separated by spaces). However, until now sysctl(8) has
only been able to set sysctl nodes to a single value. This change
allows sysctl to accept a new value for a numeric sysctl node that contains
multiple values separated by either spaces or commas. sysctl(8) parses
this list into an array of values and passes the array as the "new" value
to sysctl(2).

Reviewed by: rpokala
MFC after: 1 week
Sponsored by: Chelsio Communications
Differential Revision: https://reviews.freebsd.org/D14569

kern.osreldate is an integer, not a string

PR: 217501
Submitted by: Yavuz Tanriverdi <stemix@gmail.com>
MFC after: 1 week

Renumber copyright clause 4

Renumber cluase 4 to 3, per what everybody else did when BSD granted
them permission to remove clause 3. My insistance on keeping the same
numbering for legal reasons is too pedantic, so give up on that point.

Submitted by: Jan Schaumann <jschauma@stevens.edu>
Pull Request: https://github.com/freebsd/freebsd/pull/96

Add -t option to display field types.

PR: bin/203918
Submitted by: ota <ota@j.email.ne.jp>
Reviewed by: cem
Approved by: bapt (mentor)
Differential Revision: https://reviews.freebsd.org/D4451

add support for specifying an initial buffer size when fetching a
sysctl... This is useful for kern.arandom which (without -B) will
happily return 0 bytes, which isn't too useful or random...

fix spelling (thanks igor!) of settable while I'm here...

Fix a typo: s/wriable/writable/

Teach sysctl(8) about parsing a file (while I'm there also give it
capability of parsing both = and : formats).

Submitted by: hrs (initial version, bugs are mine)
MFC after: 3 months

Allow sysctl to filter boot and runtime tunables.

Add the following flags to sysctl:
-W - show only writable sysctls
-T - show only tuneable sysctls

This can be used to create a /var/run/sysctl.boot to
compare set tunables versus booted tunables.

Sponsored by: iXsystems

mdoc: terminate quoted strings.

Reviewed by: brueffer

Fix typo and bump date.

The kernel is not exporting any "T,dev_t" sysctl nodes anymore, so
remove the capability and mention from sysctl(8).

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.

Merge r203310,203547,203717 from head:

Implement the "-i" option to sysctl(8), to ignore failures while
retrieving individual OIDs. This allows the same list of OIDs to be
passed to sysctl(8) across different systems where particular OIDs may
not exist, and still get as much information as possible from them.

PR: bin/123644
Submitted by: dhw

Add the -i option to the synopsis.

Submitted by: dhw
MFC after: 1 week (with r203310)

Implement the "-i" option to sysctl(8), to ignore failures while
retrieving individual OIDs. This allows the same list of OIDs to be
passed to sysctl(8) across different systems where particular OIDs may not
exist, and still get as much information as possible from them.

PR: bin/123644
Submitted by: dhw
Approved by: ed (mentor)
MFC after: 2 weeks

- Import the HEAD csup code which is the basis for the cvsmode work.

Remove mentionings of kern.dumpdev which is no longer available.

PR: docs/113570
Submitted by: lawrance
MFC After: 3 days (where applicable)

Backout sensors framework.

Requested by: phk
Discussed on: cvs-all

Import OpenBSD's sysctl hardware sensors framework.

This commit includes the following core components:

* sample configuration file for sensorsd
* rc(8) script and glue code for sensorsd(8)
* sysctl(3) doc fixes for CTL_HW tree
* sysctl(3) documentation for hardware sensors
* sysctl(8) documentation for hardware sensors
* support for the sensor structure for sysctl(8)
* rc.conf(5) documentation for starting sensorsd(8)
* sensor_attach(9) et al documentation
* /sys/kern/kern_sensors.c
o sensor_attach(9) API for drivers to register ksensors
o sensor_task_register(9) API for the update task
o sysctl(3) glue code
o hw.sensors shadow tree for sysctl(8) internal magic
* <sys/sensors.h>
* HW_SENSORS definition for <sys/sysctl.h>
* sensors display for systat(1), including documentation
* sensorsd(8) and all applicable documentation

The userland part of the framework is entirely source-code
compatible with OpenBSD 4.1, 4.2 and -current as of today.

All sensor readings can be viewed with `sysctl hw.sensors`,
monitored in semi-realtime with `systat -sensors` and also
logged with `sensorsd`.

Submitted by: Constantine A. Murenin <cnst@FreeBSD.org>
Sponsored by: Google Summer of Code 2007 (GSoC2007/cnst-sensors)
Mentored by: syrinx
Tested by: many
OKed by: kensmith
Obtained from: OpenBSD (parts)

document hw.realmem

Submitted by: cnst@ (Constantine A. Murenin)
Sponsored by: Google Summer of Code 2007
Approved by: re@ (bmah)
MFC after: 1 week

-mdoc sweep.

Add "-q" argument to sysctl(8), which suppresses a limited set of warnings/
errors generated. In particular, it suppresses "unknown oid" when
attempting to get or set a sysctl not present in the kernel.

MFC after: 1 week

- Remove MLINKS to nonexistant manpages
- Change some section numbers to match reality
- For MLINKS to manpages from ports, mention which port installs them

MFC after: 3 days

Sort sections.

Scheduled mdoc(7) sweep.

Code for automatic name completion in a tcsh(1) environment.

PR: docs/44435
Submitted by: Slaven Rezic slaven dot rezic at berlin dot de

Remove advertising clause from University of California Regent's license,
per letter dated July 22, 1999.

Approved by: core, imp

Alphabetization braino.

Pointed out by: johan

Add a command-line option to format output for human readability.
Currently, the only effect it has is to print some (but not all) numbers
using thousands separators.

mdoc(7): Use the new feature of the .In macro.

.Nm -> .Xr

Clarify setting sysctl variables via loader(8) tunables

* s/can not/cannot/

Submitted by: ru (*)
Approved by: re (rwatson)

Add information about setting sysctl variables via loader(8) and
loader.conf(5)

PR: 38426 (slightly modified)
Submitted by: Phil Pennock <pdp@nl.demon.net>
Approved by: re (bmah)
MFC after: 3 days

The .Nm utility.

mdoc(7) police: tiny fixes.

Document the existence of machdep.guessed_bootdev, as suggested
by Sheldon.
For a detailed description look at the commit log for sysctl.c
rev.1.42 -- i do not think it is appropriate to put the full
description in this manpage, and the "boot" and "loader" manpages
where this description might go are also missing a description of
a number of similar variables, so i think this it is ok to limit
documentation to this now, and update it later when I (or someone
else) have a chance to revise "boot" and "loader".

Document `sysctl variable=/dev/foo' syntax.

PR: 34184
Submitted by: Thomas Quinot <thomas@cuivre.fr.eu.org>

- Attempt to help declutter kern. sysctl by moving security out from
beneath it.

Reviewed by: rwatson

Add code to export and print the description associated to sysctl
variables. Use the -d flag in sysctl(8) to see this information.

Possible extensions to sysctl:
+ report variables that do not have a description
+ given a name, report the oid it maps to.

Note to developers: have a look at your code, there are a number of
variables which do not have a description.

Note to developers: do we want this in 4.5 ? It is a very small change
and very useful for documentation purposes.

Suggested by: Orion Hodson

o Update sysctl.8 to reflect renaming of various security-related
sysctls, and to introduce new ones.

Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs

Replace `=' with more correct ``.Ql =''.

Mdoc-policed by: ru

Implement -e option. It modifies the output produced by sysctl(8) in
such a way that the name and the value of the variable(s) are separated
with `=' instead of the usual `: '. This is useful for producing output
that can be fed back to the sysctl utility (pasted to sysctl.conf, for
example).

Reviewed by: rwatson
Approved by: markm
MFC after: 2 weeks

Document the deprecated `-w' option in the COMPATIBILITY section.

Since the ``-w'' sysctl(8) option has been deprecated,
don't mention it in the manpages.

mdoc(7) police: -xwidth has been fold into -width.

mdoc(7) police: fixed formatting.

Remove xref to blackhole(4). sysctl has nothing to do with
blackhole(4), except that blackhole(4) uses sysctl's. This xref
obviously isn't appropriate unless we want to xref all the other man
pages which mention sysctls, which we obviously don't (we may want to
list those sysctls, but that's another story).

PR: 27937
Submitted by: yar

Update the document date after DES's updates, move the description of
the -b option below -a to maintain alphabetical order, and add a
missing ".It" before "Fl o".

Try to make sysctl options slightly more orthogonal:

- introduce a -o option that displays opaque variables.
- introduce a -x option that displays opaque variables in full.
- deprecate -A in favor of -ao and -X in favor of -ax.
- remove -A and -X from usage() and SYNOPSIS (but not from DESCRIPTION).
- ignore -a if one or more variables were listed on the command line.
- deprecate -w, it is not needed to determine the user's intentions.
- some language and style cleanup in the man page.

This commit should not break any existing scripts.

MFC after: 4 weeks

mdoc(7) police: split punctuation characters + misc fixes.

Document the -N option in the usage message and the man page.

Prepare for mdoc(7)NG.

Add missing coma in SEE ALSO section

Reported by: Rich Morin <rdm@cfcl.com>

mdoc(7) police: use the new features of the Nm macro.

Add reference to sysctl.conf.

Describe the syncer(4)-related sysctls kern.filedelay, kern.dirdelay
and kern.metadelay, thanks to mckusick's feedback.

o Mention kern.suser_permitted

Obtained from: TrustedBSD Project

Use 'following' instead of 'follow' in a couple of places for a slightly
better read.

Belatedly back out rev. 1.20.

$Id$ -> $FreeBSD$

Add reference to blackhole(4)

Clean up option handling a little.
Add an option for showing sysctl descriptions instead of their values.

`kern.maxproc' is not changeable using sysctl(1). Change examples
that show `kern.maxproc' being written.

PR: docs/7978
Submitted by: jlemon@americantv.com

Document the kern.logsigexit sysctl variable (sort of).

Reminded by: bde

Document sef's recent changes in the corefile naming.
Reviewed by: sef (well, i believe his `Looks good' was a review result :)

Use err(3). Change err(-1,... to err(1,...

Added hw.machine_arch.

Import Lite2's src/usr.sbin, except for timed. All changed files
except one unimportant one have already left the vendor branch.

Revert $FreeBSD$ to $Id$

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Removed references to pathconf-related variables that were never handled
by sysctl and never can be in their documented form (kern.name_max would
have to become fs.filesystemname.name_max, etc.).

Added missing references to user.stream_max and user.tzname_max. These
seem to misnamed. <sys/sysconf.h> says that they correspond to POSIX2
names, but the sysconf names don't have POSIX2 or "posix2" like all the
other POSIX2 names.

Use the .Fx macro where appropriate.

Fix a bunch of spelling errors in a bunch of man pages.

The rewamped sysctl program that will find all the variables itself.
Also a couple of handy new options.

Implement maxprocperuid and maxfilesperproc. They are tunable
via sysctl(8). The initial value of maxprocperuid is maxproc-1,
that of maxfilesperproc is maxfiles (untill maxfile will disappear)

Now it is at least possible to prohibit one user opening maxfiles

-Guido

Submitted by:
Obtained from:

Allow the user access to net.inet.igmp, even though there's nothing
sysctl(8) can interpret there. (Someday there might be.)

Remove machdep.color_display

Document new machdep variables, pointed by Rod

Document more MIB variables.

BSD 4.4 Lite usr.sbin Sources