mirror of
https://git.proxmox.com/git/systemd
synced 2025-06-03 07:51:32 +00:00
178 lines
3.8 KiB
Groff
178 lines
3.8 KiB
Groff
'\" 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)
|