Mon Mar 27 07:45:37 2017 UTC ()
More markup.


(wiz)
diff -r1.29 -r1.30 src/share/man/man5/core.5
cvs diff -r1.29 -r1.30 src/share/man/man5/core.5 (expand / switch to unified diff)

--- src/share/man/man5/core.5 2017/03/26 23:49:28 1.29
+++ src/share/man/man5/core.5 2017/03/27 07:45:37 1.30
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: core.5,v 1.29 2017/03/26 23:49:28 kamil Exp $ 1.\" $NetBSD: core.5,v 1.30 2017/03/27 07:45:37 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2002 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jason R. Thorpe. 7.\" by Jason R. Thorpe.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -129,27 +129,28 @@ Files which would be larger than the lim @@ -129,27 +129,28 @@ Files which would be larger than the lim
129.Ss ELF CORE FORMAT 129.Ss ELF CORE FORMAT
130ELF-format core files are described by a standard ELF exec header and 130ELF-format core files are described by a standard ELF exec header and
131a series of ELF program headers. 131a series of ELF program headers.
132Each program header describes a range 132Each program header describes a range
133of the virtual address space of the process. 133of the virtual address space of the process.
134.Pp 134.Pp
135In addition, 135In addition,
136.Nx 136.Nx
137ELF core files include an ELF note section which provides additional 137ELF core files include an ELF note section which provides additional
138information about the process. 138information about the process.
139The first note in the note section has a note name of 139The first note in the note section has a note name of
140.Dq NetBSD-CORE 140.Dq NetBSD-CORE
141and a note type of 141and a note type of
142ELF_NOTE_NETBSD_CORE_PROCINFO (1), and contains the following 142.Dv ELF_NOTE_NETBSD_CORE_PROCINFO ( 1 ) ,
 143and contains the following
143structure: 144structure:
144.Bd -literal 145.Bd -literal
145struct netbsd_elfcore_procinfo { 146struct netbsd_elfcore_procinfo {
146 /* Version 1 fields start here. */ 147 /* Version 1 fields start here. */
147 uint32_t cpi_version; /* netbsd_elfcore_procinfo version */ 148 uint32_t cpi_version; /* netbsd_elfcore_procinfo version */
148 uint32_t cpi_cpisize; /* sizeof(netbsd_elfcore_procinfo) */ 149 uint32_t cpi_cpisize; /* sizeof(netbsd_elfcore_procinfo) */
149 uint32_t cpi_signo; /* killing signal */ 150 uint32_t cpi_signo; /* killing signal */
150 uint32_t cpi_sigcode; /* signal code */ 151 uint32_t cpi_sigcode; /* signal code */
151 uint32_t cpi_sigpend[4]; /* pending signals */ 152 uint32_t cpi_sigpend[4]; /* pending signals */
152 uint32_t cpi_sigmask[4]; /* blocked signals */ 153 uint32_t cpi_sigmask[4]; /* blocked signals */
153 uint32_t cpi_sigignore[4]; /* blocked signals */ 154 uint32_t cpi_sigignore[4]; /* blocked signals */
154 uint32_t cpi_sigcatch[4]; /* blocked signals */ 155 uint32_t cpi_sigcatch[4]; /* blocked signals */
155 int32_t cpi_pid; /* process ID */ 156 int32_t cpi_pid; /* process ID */
@@ -223,27 +224,27 @@ Effective group ID of the process. @@ -223,27 +224,27 @@ Effective group ID of the process.
223Saved group ID of the process. 224Saved group ID of the process.
224.It cpi_nlwps 225.It cpi_nlwps
225Number of kernel-visible execution contexts (LWPs) of the process. 226Number of kernel-visible execution contexts (LWPs) of the process.
226.It cpi_name 227.It cpi_name
227Process name, copied from the p_comm field of 228Process name, copied from the p_comm field of
228.Fa struct proc . 229.Fa struct proc .
229.It cpi_siglwp 230.It cpi_siglwp
230LWP target of killing signal. 231LWP target of killing signal.
231.El 232.El
232.Pp 233.Pp
233The second note with name 234The second note with name
234.Dq NetBSD-CORE 235.Dq NetBSD-CORE
235is a note type of 236is a note type of
236ELF_NOTE_NETBSD_CORE_AUXV (2), 237.Dv ELF_NOTE_NETBSD_CORE_AUXV ( 2 ) ,
237and contains an array of AuxInfo structures. 238and contains an array of AuxInfo structures.
238.Pp 239.Pp
239The note section also contains additional notes for each 240The note section also contains additional notes for each
240kernel-visible execution context of the process (LWP). 241kernel-visible execution context of the process (LWP).
241These notes have names of the form 242These notes have names of the form
242.Dq NetBSD-CORE@nn 243.Dq NetBSD-CORE@nn
243where 244where
244.Dq nn 245.Dq nn
245is the LWP ID of the execution context, for example: 246is the LWP ID of the execution context, for example:
246.Dq NetBSD-CORE@1 . 247.Dq NetBSD-CORE@1 .
247These notes contain register and other per-execution context 248These notes contain register and other per-execution context
248data in the same format as is used by the 249data in the same format as is used by the
249.Xr ptrace 2 250.Xr ptrace 2