Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

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

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

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

mdoc: order prologue macros consistently by Dd/Dt/Os

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by: ru
Approved by: philip, ed (mentors)

The last big commit: let usr.sbin/ use WARNS=6 by default.

ANSIfy some more tools in usr.sbin/.

Most of these tools build with WARNS=6, except for their use of K&R
function declarations.

Make grammar a bit more consistent in this document.

Allow for module-path being a semicolon-separated list of dirs.
This is consistent with kern.module_path sysctl and also compensates
for the unconventional syntax of asf(8) where the last of multiple
arguments is the output file, which prevents us from using the
traditional Unix syntax "foo file ..." to specify multiple module
dirs.

Submitted by: emaste
MFC after: 1 week

Flush my typo fix queue for this directory.

Markup fixes.

Whitespace nit.

There is a plenty of arch's out there where sizeof(size_t) != sizeof(int).
A field width in printf(3) must be int, so cast return value from strlen()
to the type.

Noticed by: Andrzej Tobola <ato iem pw edu pl>; tinderbox
Pointy hat to: yar
X-MFC with: the rest of the new asf code

Give a major overhaul to asf(8).

The improvements are:

- can get the kld info from core files via kvm(3);
- can use kldstat(2) directly, which is a piece of cake;
- can use .symbols or whatever, which allows for use by
non-developers when reporting system crashes -- now asf(8)
can be mentioned in the handbook at last;
- speed (no more double fts(3) per loaded module);
- various bugs fixed.

At the same time, the new asf(8) should stay compatible with
the old one, bar bugs. Perhaps some defaults may be changed
later to match today's state of affairs.

Reviewed by: grog
MFC after: 1 month
Sponsored by: RiNet (Cronyx Plus LLC)

Initialize uninitialized variables.

PR: 71653
Submitted by: Dan Lukes <dan@obluda.cz>

Remove one possible way of shooting yourself in the foot.

Submitted by: Ulrich Sperlein <q@galgenberg.net>

Sort sections.

Assorted markup, grammar, and spelling fixes.

Add a "-f" flag for asf(8) which performs a search to find the each module
no matter where in the directory structure it may be. Use this and the "-k"
flag in the generated gdbinit files so that the "getsyms" function in gdb
requires no user intervention to run and will find every module if they're
in the kernel build's module directory. This is still quite useful for
cases where gdb knows that the path for some modules is /boot/kernel and
others are in the object directory for /usr/src/sys/$ARCH/compile/kernel.

Approved by: grog

Add -s option to strip subdirectory from module path.
e.g. moudle-path/firewire/firewire.ko -> module-path/firewire.ko

Reviewed by: grog

Tidy up the manpage.

Reviewed by: grog

Use implicit SRCS list, remove WARNS=0, the code is WARNS=4 clean now,
which is more than enough.

WARNS cleanup. Constness and shadowing, namely.

Fix format string.

Add licence.

Complained about by: juli

Correct usage() text.

Oops, this is section 8, not 1.

Add man page.

Introducing asf, a helper program for kernel debugging.