Module Name: src
Committed By: kamil
Date: Sun Mar 26 23:49:28 UTC 2017
Modified Files:
src/share/man/man5: core.5
Log Message:
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.
To generate a diff of this commit:
cvs rdiff -u -r1.28 -r1.29 src/share/man/man5/core.5
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man5/core.5
diff -u src/share/man/man5/core.5:1.28 src/share/man/man5/core.5:1.29
--- src/share/man/man5/core.5:1.28 Mon Oct 27 16:21:59 2014
+++ src/share/man/man5/core.5 Sun Mar 26 23:49:28 2017
@@ -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 @@ struct netbsd_elfcore_procinfo {
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 @@ Number of kernel-visible execution conte
.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 @@ ELF core file format was introduced in
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
