NAME
core
—
memory image file format
SYNOPSIS
#include
<sys/types.h>
#include <sys/exec_elf.h>
DESCRIPTION
A small number of signals which cause abnormal termination of a process also cause a record of the process's in-core state to be written to disk for later examination by one of the available debuggers (see sigaction(2)).
By default, this memory image is written to a file named
programname.core in the working directory, provided
the terminated process had write permission in the directory, and the
terminated process either had an effective user ID of zero or had never
changed user or group ID. See the description of
KERN_NOSUIDCOREDUMP
in
sysctl(2) for other options.
The maximum size of a programname.core file is limited by setrlimit(2). Files which would be larger than the limit are not created.
The programname.core file is in the ELF
binary file format with an e_type of
ET_CORE
. It has no section header table and a
segment header that contains PT_LOAD
and
PT_NOTE
segments that describe the state of the
process when terminated.
The PT_LOAD
segments hold images of the
process memory when it was terminated. Device mappings are excluded, as are
read-only mappings that do not have private mapping changes. Each segment's
p_vaddr, p_memsz, and
p_flags specify the address, size, and access
protection of the memory segment it describes.
The PT_NOTE
segment contains notes
describing the kernel state and CPU registers of each thread in the process.
Notes describing the process as a whole have the name
“OpenBSD”. An NT_OPENBSD_PROCINFO
note
is included containing an elfcore_procinfo structure
with information about the kernel state of the process. An
NT_OPENBSD_AUXV
note is included containing a copy
of the original process environment strings. On sparc64, an
NT_OPENBSD_WCOOKIE
note is included containing the
process's ‘window cookie’.
Notes describing the individual threads in the process have names
in the format “OpenBSD@%d” where the suffix is the thread ID.
For each thread, an NT_OPENBSD_REGS
note is included
containing the state of the regular registers of the thread and, on
architectures other than luna88k and sgi, an
NT_OPENBSD_FPREGS
note is also included containing
the state of the floating-point registers of the thread.
SEE ALSO
HISTORY
A core
file format appeared in
Version 3 AT&T UNIX.
OpenBSD 2.0 started using the ELF format for some
architectures. All architectures used ELF starting in
OpenBSD 5.4.
CAVEATS
Programs which are started with either the set-user-ID or
set-group-ID bits set, or which change their UID or GID after starting, will
normally not dump core. This is to prevent sensitive information from
inadvertently ending up on disk. This behaviour can be changed (for
debugging purposes) by changing the
kern.nosuidcoredump
sysctl(2) variable to the right settings.