MFH: r292263

Assorted grammar, spelling and punctuation fixes.

PR: 203336, 203339
Submitted by: espeyb@rpi.edu, themesta@gmail.com

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

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

A number of places in the source tree still reference cuad.* after
sio(4) was deprecated by uart(4).

s/cuad/cuau/g/

PR: docs/171533
Reviewed by: imp
Approved by: cperciva (implicit)
MFC after: 3 weeks

Spelling fixes for tools/

Add some $FreeBSD$ tags so svn will allow the commit.

Fix a couple of typos.

PR: docs/148891
Submitted by: olgeni
MFC after: 1 week

o Correct comments: remove a reference to non-existent gdbinit.9 man page;
correct a path to the kernel build directory; gdb lost -k key.

Reviewed by: grog
MFC after: 1 week

I forgot to commit this fix that is now kgdb aware...

Remove the uarea column from the DDB 'ps' display, and from grog's gdb
scripts.

Reviewed by: arch@

Catch up with PHK's sio(4) cuaa->cuad rework [sys/dev/sio/sio.c rev. 1.456].

Remove vinum bits.

add a set of scripts that I posted to -current last year. This makes
debugging kernels and kernel modules much easier. It will automaticly
locate kernel source, extract kernel module information, and rerun gdb
to load kernel module symbol information (if available by compiling module
w/ debuging symbols).

I have not run these recently, so may need to be updated to work with
gdb6. Feel free to fix as appropriate for -current.

Rename "msgbuf" to "dmesg", a more easily remembered name.
"Fix" documentation by removing periods and commas.

Remove calls to 'y' macro.

Remove current implementation of kldstat macro.

Add new kldstat, kldstat-v and kernel macros. The kldstat macro is
functionally equivalent to the previous implementation, but it looks
prettier and it matches the kldstat-v macro better. kldstat-v gives
output similar to userland kldstat -v (note lacking space), and kernel
loads a new kernel and dump.

Submitted by: des

Add documentation for previously undocumented macros, and correct
existing documentation. This is not made any easier by the
brain-damaged format required for the documentation: one line, no full
stops or commas.

Add documentation for previously undocumented macros. This is not
made any easier by the brain-damaged format required for the
documentation: one line, no full stops or commas.

Remove macro xy. I can't see any use for it any more.

Add comments to deter people from using this file directly. That's
not the intention.

Rearrange "you may want to change these values" values to the top, and
reduce their number as much as possible.

tr macro: Require a parameter (because gdb is too stupid to understand
optional parameters), and create macros tr0, tr1 and trf which call it
to connect to /dev/cuaa0, /dev/cuaa1 and firewire connections
respectively.

Split kld symbol load into two separate macros: revision 1.5
simplified things for the /dev/mem case, but broke it for anything
else. Now the simple /dev/mem version is called kldsyms, and the
version for serial debugging and processor dumps is called getsyms,
and still requires this irritating cut and paste.

Change comments on startup to make life easier for the poor
(de)bugger.

Explain what all this is about.

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

Replace hard-coded module path with a keyword which gets changed when
the kernel is built.

Make defproc work.

Make btpp and fr work. There's still more to be done.

Terminate echoed lines. Unlike echo(1), gdb echo doesen't
automatically terminate them.

Get the manual section number for kldstat(8) right. Comment change only.

Pointed out by: yar

Modify startup mode: don't specify the file name for the debug kernel,
so it needs to be (and can be) specified on the command line. Don't
try to automatically connect to a remote machine, so that the same
.gdbinit file can be used for analysing processor dumps.

Add macros for kernel debugging. These have been around for a
while, and they will need some more tuning before they're really
useful, but at the moment they're better than nothing.

Indirectly reminded by: dwhite