[src/trunk]: src/share/man/man5 Update core(5) with current reality

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

details:   https://anonhg.NetBSD.org/src/rev/bb38212d9f4e
branches:  trunk
changeset: 822595:bb38212d9f4e
user:      kamil <kamil%NetBSD.org@localhost>
date:      Sun Mar 26 23:49:28 2017 +0000

description:
Update core(5) with current reality

Note cpi_siglwp addition in NetBSD-2.0 and retaining the procinfo ver. 1.

Note ELF_NOTE_NETBSD_CORE_AUXV (2) addition in NetBSD-8.0.

Update the HISTORY section.

diffstat:

 share/man/man5/core.5 |  27 +++++++++++++++++++++++++--
 1 files changed, 25 insertions(+), 2 deletions(-)

diffs (64 lines):

diff -r b9bf441336dc -r bb38212d9f4e share/man/man5/core.5
--- a/share/man/man5/core.5     Sun Mar 26 22:00:04 2017 +0000
+++ b/share/man/man5/core.5     Sun Mar 26 23:49:28 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: core.5,v 1.28 2014/10/27 16:21:59 wiz Exp $
+.\"    $NetBSD: core.5,v 1.29 2017/03/26 23:49:28 kamil Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -56,7 +56,7 @@
 .\"
 .\"     @(#)core.5     8.3 (Berkeley) 12/11/93
 .\"
-.Dd July 8, 2002
+.Dd March 27, 2017
 .Dt CORE 5
 .Os
 .Sh NAME
@@ -165,6 +165,7 @@
     uint32_t cpi_nlwps;        /* number of LWPs */
     int8_t   cpi_name[32];     /* copy of p->p_comm */
     /* Add version 2 fields below here. */
+    int32_t         cpi_siglwp;     /* LWP target of killing signal */
 };
 .Ed
 .Pp
@@ -225,8 +226,16 @@
 .It cpi_name
 Process name, copied from the p_comm field of
 .Fa struct proc .
+.It cpi_siglwp
+LWP target of killing signal.
 .El
 .Pp
+The second note with name
+.Dq NetBSD-CORE
+is a note type of
+ELF_NOTE_NETBSD_CORE_AUXV (2),
+and contains an array of AuxInfo structures.
+.Pp
 The note section also contains additional notes for each
 kernel-visible execution context of the process (LWP).
 These notes have names of the form
@@ -387,6 +396,20 @@
 In releases previous to
 .Nx 1.6 ,
 ELF program images produced a.out-format core files.
+.Pp
+The
+.Dv cpi_siglwp
+member of the
+.Dv netbsd_elfcore_procinfo
+structure first appeared in
+.Nx 2.0 .
+However it retained the procinfo version 1,
+stored in
+.Dv cpi_version .
+.Pp
+.Dv ELF_NOTE_NETBSD_CORE_AUXV
+was added in
+.Nx 8.0 .
 .Sh BUGS
 There is no standard location or name for the
 CPU-dependent data structure stored in the