coredumpctl.1 3.13 KB
Newer Older
1
'\" t
2
.TH "COREDUMPCTL" "1" "" "systemd 215" "coredumpctl"
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
.\" -----------------------------------------------------------------
.\" * 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"
23
coredumpctl \- Retrieve coredumps from the journal
24
.SH "SYNOPSIS"
25 26
.HP \w'\fBcoredumpctl\fR\ 'u
\fBcoredumpctl\fR [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]
27 28
.SH "DESCRIPTION"
.PP
29
\fBcoredumpctl\fR
30 31 32 33 34 35
may be used to retrieve coredumps from
\fBsystemd-journald\fR(8)\&.
.SH "OPTIONS"
.PP
The following options are understood:
.PP
36 37 38 39 40 41 42 43 44 45
\fB\-\-no\-legend\fR
.RS 4
Do not print the column headers\&.
.RE
.PP
\fB\-1\fR
.RS 4
Show information of a single coredump only, instead of listing all known coredumps\&.
.RE
.PP
46
\fB\-F\fR, \fB\-\-field=\fR
47
.RS 4
48
Print all possible data values the specified field takes in matching coredump entries of the journal\&.
49 50
.RE
.PP
51
\fB\-o\fR, \fB\-\-output=FILE\fR
52
.RS 4
53 54
Write the core to
\fBFILE\fR\&.
55 56
.RE
.PP
57
\fB\-h\fR, \fB\-\-help\fR
58
.RS 4
59
Print a short help text and exit\&.
60 61
.RE
.PP
62
\fB\-\-version\fR
63
.RS 4
64
Print a short version string and exit\&.
65 66
.RE
.PP
67
\fB\-\-no\-pager\fR
68
.RS 4
69
Do not pipe output into a pager\&.
70 71 72 73 74 75
.RE
.PP
The following commands are understood:
.PP
\fBlist\fR
.RS 4
76 77 78 79 80 81
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\&.
82 83 84 85
.RE
.PP
\fBdump\fR
.RS 4
86
Extract the last coredump matching specified characteristics\&. The coredump will be written on standard output, unless an output file is specified with
87 88 89 90 91 92 93 94 95
\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
96
A match can be:
97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117
.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
118
\fBjournalctl\fR(1))\&. Must contain an equal sign\&.
119 120 121
.RE
.SH "EXIT STATUS"
.PP
122
On success, 0 is returned; otherwise, a non\-zero failure code is returned\&. Not finding any matching coredumps is treated as failure\&.
123 124 125 126
.SH "SEE ALSO"
.PP
\fBsystemd-journald.service\fR(8),
\fBgdb\fR(1)