[src/trunk]: src/share/man/man2 Document TRAP_CHLD in siginfo(2)

[kamil <kamil%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/3a92e67b1482
branches:  trunk
changeset: 350292:3a92e67b1482
user:      kamil <kamil%NetBSD.org@localhost>
date:      Tue Jan 10 00:51:56 2017 +0000

description:
Document TRAP_CHLD in siginfo(2)

The SIGTRAP signal is thrown from the kernel if EVENT_MASK (ptrace_event)
enables PTRACE_FORK. This new si_code helps debuggers to distinguish the
exact source of signal delivered for a debugger.

Another purpose of TRAP_CHLD is to retain the same behavior inside the
NetBSD kernel for process child traps and have an interface to monitor it.

Retrieving exact event and extended properties of process child trap is
available with PT_GET_PROCESS_STATE.

There is no behavior change for existing software.

This si_code value is NetBSD extension.

Sponsored by <The NetBSD Foundation>

diffstat:

 share/man/man2/siginfo.2 |  8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)

diffs (36 lines):

diff -r 3f7829adfdb5 -r 3a92e67b1482 share/man/man2/siginfo.2
--- a/share/man/man2/siginfo.2  Tue Jan 10 00:50:57 2017 +0000
+++ b/share/man/man2/siginfo.2  Tue Jan 10 00:51:56 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: siginfo.2,v 1.19 2017/01/08 13:53:28 wiz Exp $
+.\"    $NetBSD: siginfo.2,v 1.20 2017/01/10 00:51:56 kamil Exp $
 .\"
 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 7, 2017
+.Dd January 10, 2017
 .Dt SIGINFO 2
 .Os
 .Sh NAME
@@ -229,6 +229,8 @@
 .Bl -tag -width TRAP_BRKPT
 .It TRAP_BRKPT
 Process breakpoint
+.It TRAP_CHLD
+Process child trap
 .It TRAP_EXEC
 Process exec trap
 .It TRAP_TRACE
@@ -378,6 +380,8 @@
 functionality first appeared in
 .At V.4 .
 .Pp
+.Dv TRAP_CHLD
+and
 .Dv TRAP_EXEC
 first appeared
 in