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 r246485:
Document the detail of interaction between vfork and PT_TRACEME.

MFC r233648:
Remove trailing whitespace per mdoc lint warning

Approved by: cperciva (implicit)

MFC r231902:
Document PL_FLAG_CHILD.

MFC r225974:
Remove no longer valid statement about ARM.

MFC r226066:
Remove no longer needed BUGS section.

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

Approved by: re (implicit)

Document PT_FLAG_FORKED, PT_FOLLOW_FORK, pl_tdname and pl_child_pid.

MFC after: 2 weeks

Fix typos and spelling mistakes.

Document pl_siginfo and PT_FLAG_SI for PT_LWPINFO.

MFC after: 1 month

Improve the documentation for PT_LWPINFO. Note that some features are
not implemented on MIPS and ARM.

MFC after: 1 month

o Add support for COMPAT_IA32.
o Incorporate review comments:
- Properly reference and lock the map
- Take into account that the VM map can change inbetween requests
- Add the fileid and fsid attributes

Credits: kib@
Reviewed by: kib@

Add PT_VM_TIMESTAMP and PT_VM_ENTRY so that the tracing process can
obtain the memory map of the traced process. PT_VM_TIMESTAMP can be
used to check if the memory map changed since the last time to avoid
iterating over all the VM entries unnecesarily.

MFC after: 1 month

Document missing requests.

Belatedly bump Dd for my recent changes.

Document PT_GETNUMLWPS.

Describe PT_GETLWPLIST's arguments.

Add an entry for PT_GETLWPLIST.

Nudged by: jhb
Reviewed by: davidxu

Expand *n't contractions.

Document the new PT_LWPINFO request. In fact, the request is so new
it hasn't even been implemented yet. I just wanted to be the first
to try a new approach to development ;-)

Markup, grammar, and spelling fixes.

Clarify the behavior of ptrace(2) a little bit: the tracing process
must first attach to the traced process. If the tracing process
exits without detaching, the traced process will be killed rather
than continued. For the duration of the tracing session, the traced
process is reparented to the tracing process (with resulting expected
behaviors). It is permissible to trace more than one other process
at a time. When using waitpid() to monitor the behavior of the traced
process, signals are intercepted: they may optionally then be
forwarded using ptrace(). Signals are generated normally by and for
the process, but also by the tracing facility (SIGTRAP).

Product of: Suffering
Sponsored by: DARPA, AFRL

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

Make the documentation of PT_STEP match its implementation: the
`data' parameter is not ignored; if non-zero, it specifies a signal
number to be delivered to the traced process.

MFC after: 1 day

mdoc(7) police: "The .Fa argument.".

mdoc(7) police: Tidy up the syscall language.

Stop calling system calls "function calls".

Use "The .Fn system call" a-la "The .Nm utility".

When referring to a non-BSD implementation in
the HISTORY section, call syscall a function,
to be safe.

mdoc(7) police: Fixed the spammage of this file with trailing whitespaces
in revisions 1.26-1.28. Fixed two bugs in punctuation cleanup in rev. 1.27.
Removed hard sentence break not killed by rev. 1.26.

Document PT_IO, and move the comment about machine-dependent requests
below PT_[GS]ET_{,DB,FP}REGS.

Further cleanup (punctuation, genitive)

Insert newlines between sentences and rewrap paragraphs. No changes to
the actual text or markup.

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

PT_STEP in ptrace(2) man page is described as 'addr and data fields
are not used'. This is incorrect, as addr must be passed (caddr_t)1
to do anything useful. The source for gdb and a short test program
will confirm that this man page was in error.

PR: docs/27758
Submitted by: Jiangyi Liu <jyliu@163.net>

Update ptrace(2) re: PT_READ_U and PT_WRITE_U

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

Remove whitespace at EOL.

mdoc(7) police: removed HISTORY info from the .Os call.

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

Prepare for mdoc(7)NG.

mdoc(7) police: removed history info from the .Os FreeBSD call.

Use Fx macro wherever possible.

Document the ptrace() PT_STEP request.

Add references to the newly added hardware debug register
support functions i386_clr_watch(3) and i386_set_watch(3).

Reviewed by: Sean Eric Fagan <sef@kithrup.com>
and no other response to the review request.

Use `Er' variable to define first column width in ERRORS section. It was
initially suggested by mdoc(7) style, but was broken over the years

Introduce ".Lb" macro to libc manpages.

More libraries manpages updates following.

Document the support in the kernel for hardware debug registers on the
ix86 platform which allows for hardware watchpoints, etc...

Submitted by: Brian Dean <brdean@unx.sas.com>

$Id$ -> $FreeBSD$

Use the .Tn macro for generic FreeBSD references. Other minor cleanup.

Revert $FreeBSD$ to $Id$

Sort cross references.

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.

Add missing RETURN VALUES/ERRORS sections.

add missing comma(s) in .Xr macros

function appeared in Version 7 AT&T UNIX
Obtained from: ftp://netlib.att.com/netlib/att/cs/v7man/man2

Bring in the man page additions for PT_ATTACH/DETACH|GET/SET_REGS that
were deleted out after the initial import now that Peter's code has
implemented them in -current.

- FreeBSD'ized the ptrace manpage by removing non-FreeBSD specific portions.
- install ptrace.2

This commit was generated by cvs2svn to compensate for changes in r13519,
which included commits to RCS files with non-trunk default branches.

ptrace(2) manpage