'\" t
.TH "COREDUMPCTL" "1" "" "systemd 219" "coredumpctl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
coredumpctl \- Retrieve coredumps from the journal
.SH "SYNOPSIS"
.HP \w'\fBcoredumpctl\fR\ 'u
\fBcoredumpctl\fR [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]
.SH "DESCRIPTION"
.PP
\fBcoredumpctl\fR
may be used to retrieve coredumps from
\fBsystemd-journald\fR(8)\&.
.SH "OPTIONS"
.PP
The following options are understood:
.PP
\fB\-\-no\-legend\fR
.RS 4
Do not print column headers\&.
.RE
.PP
\fB\-1\fR
.RS 4
Show information of a single coredump only, instead of listing all known coredumps\&.
.RE
.PP
\fB\-F\fR, \fB\-\-field=\fR
.RS 4
Print all possible data values the specified field takes in matching coredump entries of the journal\&.
.RE
.PP
\fB\-o\fR, \fB\-\-output=FILE\fR
.RS 4
Write the core to
\fBFILE\fR\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print a short help text and exit\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print a short version string and exit\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
Do not pipe output into a pager\&.
.RE
.PP
The following commands are understood:
.PP
\fBlist\fR
.RS 4
List coredumps captured in the journal matching specified characteristics\&. If no command is specified, this is the implied default\&.
.RE
.PP
\fBinfo\fR
.RS 4
Show detailed information about coredumps captured in the journal\&.
.RE
.PP
\fBdump\fR
.RS 4
Extract the last coredump matching specified characteristics\&. The coredump will be written on standard output, unless an output file is specified with
\fB\-o/\-\-output\fR\&.
.RE
.PP
\fBgdb\fR
.RS 4
Invoke the GNU debugger on the last coredump matching specified characteristics\&.
.RE
.SH "MATCHING"
.PP
A match can be:
.PP
\fIPID\fR
.RS 4
Process ID of the process that dumped core\&. An integer\&.
.RE
.PP
\fICOMM\fR
.RS 4
Name of the executable (matches
\fBCOREDUMP_COMM=\fR)\&. Must not contain slashes\&.
.RE
.PP
\fIEXE\fR
.RS 4
Path to the executable (matches
\fBCOREDUMP_EXE=\fR)\&. Must contain at least one slash\&.
.RE
.PP
\fIMATCH\fR
.RS 4
General journalctl predicates (see
\fBjournalctl\fR(1))\&. Must contain an equal sign\&.
.RE
.SH "EXIT STATUS"
.PP
On success, 0 is returned; otherwise, a non\-zero failure code is returned\&. Not finding any matching coredumps is treated as failure\&.
.SH "EXAMPLES"
.PP
\fBExample\ \&1.\ \&List all the coredumps of a program named foo\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# coredumpctl list foo
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&2.\ \&Invoke gdb on the last coredump\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# coredumpctl gdb
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&3.\ \&Show information about a process that dumped core, matching by its PID 6654\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# coredumpctl info 6654
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&4.\ \&Extract the last coredump of /usr/bin/bar to a file named bar\&.coredump\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# coredumpctl \-o bar\&.coredump dump /usr/bin/bar
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
\fBsystemd-coredump\fR(8),
\fBcoredump.conf\fR(5),
\fBsystemd-journald.service\fR(8),
\fBgdb\fR(1)