Provided by: systemd-coredump_229-4ubuntu21.31_amd64
NAME
coredumpctl - Retrieve coredumps from the journal
SYNOPSIS
coredumpctl [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]
DESCRIPTION
coredumpctl may be used to retrieve coredumps from systemd-journald(8).
OPTIONS
The following options are understood: --no-legend Do not print column headers. -1 Show information of a single coredump only, instead of listing all known coredumps. -F FIELD, --field=FIELD Print all possible data values the specified field takes in matching coredump entries of the journal. -o FILE, --output=FILE Write the core to FILE. -D DIR, --directory=DIR Use the journal files in the specified DIR. -h, --help Print a short help text and exit. --version Print a short version string and exit. --no-pager Do not pipe output into a pager. The following commands are understood: list List coredumps captured in the journal matching specified characteristics. If no command is specified, this is the implied default. info Show detailed information about coredumps captured in the journal. dump Extract the last coredump matching specified characteristics. The coredump will be written on standard output, unless an output file is specified with --output=. gdb Invoke the GNU debugger on the last coredump matching specified characteristics.
MATCHING
A match can be: PID Process ID of the process that dumped core. An integer. COMM Name of the executable (matches COREDUMP_COMM=). Must not contain slashes. EXE Path to the executable (matches COREDUMP_EXE=). Must contain at least one slash. MATCH General journalctl predicates (see journalctl(1)). Must contain an equal sign.
EXIT STATUS
On success, 0 is returned; otherwise, a non-zero failure code is returned. Not finding any matching coredumps is treated as failure.
EXAMPLES
Example 1. List all the coredumps of a program named foo # coredumpctl list foo Example 2. Invoke gdb on the last coredump # coredumpctl gdb Example 3. Show information about a process that dumped core, matching by its PID 6654 # coredumpctl info 6654 Example 4. Extract the last coredump of /usr/bin/bar to a file named bar.coredump # coredumpctl -o bar.coredump dump /usr/bin/bar
SEE ALSO
systemd-coredump(8), coredump.conf(5), systemd-journald.service(8), gdb(1)