CORE(5) | File Formats Manual | CORE(5)

# 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, an `NT_OPENBSD_FPREGS` note is also included containing the state of the floating-point registers of the thread.

# SEE ALSO

gdb(1), setrlimit(2), sigaction(2), sysctl(2)

# HISTORY

A `core` file format appeared in Version 1 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.

May 1, 2021 | Debian