Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

MFC 255498:
- Document the UQUAD sysctl variants.
- Clarify that exactly one of the "access" flags is required and
list the optional flags in a separate list. Prefer bundling
CTLFLAG_TUN into the access flag by not documenting it as an
optional flag to set.

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

mdoc: make pages render with mandoc

It's a bit more pedantic regarding .Bl list elements. This has an added
benefit of unbreaking the ipfw(8) manpage, where groff was silently
skipping one list element.

Implement the following macros for completeness:

SYSCTL_QUAD()
SYSCTL_ADD_QUAD()
TUNABLE_QUAD()
TUNABLE_QUAD_FETCH()

Now we can use 64bit tunables on 32bit systems.

Add a basic man page for the sysctl(9) macro interfaces. Previously man
pages existed only for the dynamic sysctl interfaces. There's probably
more complete and accurate content, better advice, etc, that could be added
here.

Per scottl's suggest, add a small piece of moralizing text regarding the
fact that sysctl names quickly get embedded in system configuration files,
libraries, third party applications, and even books, so renaming and
removing names after they've been published is a tricky issue.

MFC after: 1 month

Mechanically kill hard sentence breaks and double whitespaces.

Document sysctl_move_oid().

mdoc(7): Properly mark C headers.

Typo: s/CTLTYPE_DYN/CTLFLAG_DYN

PR: misc/45012
Submitted by: Steve Coltrin <spcoltri@omcl.org>

ispell sweep of share/man/man9/*.

Update function definitions and required include files to reflect
the current state of the system.

Approved by: alfred

Fixed missing include in synopsis.

Fixed bitrot in synopsis. Const'ification of string args had not reached
here.

Fixed some style bugs (superfluous quotes).

mdoc(7) police: Use the new .In macro for #include statements.

MFS: in HISTORY section, fix release number of first appearance

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

mdoc(7) police: remove extraneous .Pp before and/or after .Sh.

Correct a typo.

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

Add a missing argument for SYSCTL_ADD_OPAQUE.

Fix the examples at the end which were horribly broken.

mdoc(7) police: use canonical form of .Dd macro.

Fix typo.

PR: 22923
Submitted by: Jimmy Olgeni <olgeni@uli.it>

Use FreeBSD.org, not freebsd.org, as has been the precedent.

Order the cross-references in the SEE ALSO section correctly.

Clean up this new manual page. This delta includes content and
whitespace changes, which should not be a problem because this
is only the second revision of the file and translators are
unlikely to have gotten started yet.

Reviewed by: abial

These patches implement dynamic sysctls. It's possible now to add
and remove sysctl oids at will during runtime - they don't rely on
linker sets. Also, the node oids can be referenced by more than
one kernel user, which means that it's possible to create partially
overlapping trees.

Add sysctl contexts to help programmers manage multiple dynamic
oids in convenient way.

Please see the manpages for detailed discussion, and example module
for typical use.

This work is based on ideas and code snippets coming from many
people, among them: Arun Sharma, Jonathan Lemon, Doug Rabson,
Brian Feldman, Kelly Yancey, Poul-Henning Kamp and others. I'd like
to specially thank Brian Feldman for detailed review and style
fixes.

PR: kern/16928
Reviewed by: dfr, green, phk