1 <html><head><meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8"><title>systemd-coredumpctl
</title><meta name=
"generator" content=
"DocBook XSL Stylesheets V1.78.1"></head><body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF"><style>
11 background-color: #c60f0f;
15 h1:hover
> a.headerlink, h2:hover
> a.headerlink, h3:hover
> a.headerlink, dt:hover
> a.headerlink {
18 </style><a href=
"index.html">Index
</a>·
19 <a href=
"systemd.directives.html">Directives
</a>·
20 <a href=
"../python-systemd/index.html">Python
</a>·
21 <a href=
"../libudev/index.html">libudev
</a>·
22 <a href=
"../libudev/index.html">gudev
</a><span style=
"float:right">systemd
214</span><hr><div class=
"refentry"><a name=
"systemd-coredumpctl"></a><div class=
"titlepage"></div><div class=
"refnamediv"><h2>Name
</h2><p>systemd-coredumpctl — Retrieve coredumps from the journal
</p></div><div class=
"refsynopsisdiv"><h2>Synopsis
</h2><div class=
"cmdsynopsis"><p><code class=
"command">systemd-coredumpctl
</code> [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]
</p></div></div><div class=
"refsect1"><a name=
"idm214170585728"></a><h2 id=
"Description">Description
<a class=
"headerlink" title=
"Permalink to this headline" href=
"#Description">¶
</a></h2><p><span class=
"command"><strong>systemd-coredumpctl
</strong></span> may be used to
23 retrieve coredumps from
24 <a href=
"systemd-journald.html"><span class=
"citerefentry"><span class=
"refentrytitle">systemd-journald
</span>(
8)
</span></a>.
</p></div><div class=
"refsect1"><a name=
"idm214170583184"></a><h2 id=
"Options">Options
<a class=
"headerlink" title=
"Permalink to this headline" href=
"#Options">¶
</a></h2><p>The following options are understood:
</p><div class=
"variablelist"><dl class=
"variablelist"><dt id=
"-F"><span class=
"term"><code class=
"option">-F
</code>,
</span><span class=
"term"><code class=
"option">--field=
</code></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#-F">¶
</a></dt><dd><p>Print all possible
25 data values the specified field
26 takes in matching coredump entries of the
27 journal.
</p></dd><dt id=
"-o"><span class=
"term"><code class=
"option">-o
</code>,
</span><span class=
"term"><code class=
"option">--output=FILE
</code></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#-o">¶
</a></dt><dd><p>Write the core to
28 <code class=
"option">FILE
</code>.
</p></dd><dt id=
"--no-legend"><span class=
"term"><code class=
"option">--no-legend
</code></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#--no-legend">¶
</a></dt><dd><p>Do not print the column headers.
29 </p></dd><dt id=
"-h"><span class=
"term"><code class=
"option">-h
</code>,
</span><span class=
"term"><code class=
"option">--help
</code></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#-h">¶
</a></dt><dd><p><a name=
"help-text"></a>Print a short help text and exit.
30 </p></dd><dt id=
"--version"><span class=
"term"><code class=
"option">--version
</code></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#--version">¶
</a></dt><dd><p><a name=
"version-text"></a>Print a short version string and exit.
</p></dd><dt id=
"--no-pager"><span class=
"term"><code class=
"option">--no-pager
</code></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#--no-pager">¶
</a></dt><dd><p>Do not pipe output into a pager.
</p></dd></dl></div><p>The following commands are understood:
</p><div class=
"variablelist"><dl class=
"variablelist"><dt id=
"list"><span class=
"term"><span class=
"command"><strong>list
</strong></span></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#list">¶
</a></dt><dd><p>List coredumps captured in the journal
31 matching specified characteristics.
</p></dd><dt id=
"dump"><span class=
"term"><span class=
"command"><strong>dump
</strong></span></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#dump">¶
</a></dt><dd><p>Extract the last coredump
32 matching specified characteristics.
33 The coredump will be written on standard output,
34 unless an output file is specified with
35 <code class=
"option">-o/--output
</code>.
36 </p></dd><dt id=
"gdb"><span class=
"term"><span class=
"command"><strong>gdb
</strong></span></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#gdb">¶
</a></dt><dd><p>Invoke the GNU
37 debugger on the last coredump matching
38 specified characteristics.
39 </p></dd></dl></div></div><div class=
"refsect1"><a name=
"idm214170684464"></a><h2 id=
"Matching">Matching
<a class=
"headerlink" title=
"Permalink to this headline" href=
"#Matching">¶
</a></h2><p>Match can be:
</p><div class=
"variablelist"><dl class=
"variablelist"><dt id=
"PID"><span class=
"term"><em class=
"replaceable"><code>PID
</code></em></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#PID">¶
</a></dt><dd><p>Process ID of the
41 core. An integer.
</p></dd><dt id=
"COMM"><span class=
"term"><em class=
"replaceable"><code>COMM
</code></em></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#COMM">¶
</a></dt><dd><p>Name of the executable
42 (matches
<code class=
"option">COREDUMP_COMM=
</code>).
43 Must not contain slashes.
44 </p></dd><dt id=
"EXE"><span class=
"term"><em class=
"replaceable"><code>EXE
</code></em></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#EXE">¶
</a></dt><dd><p>Path to the executable
45 (matches
<code class=
"option">COREDUMP_EXE=
</code>).
46 Must contain at least one slash.
47 </p></dd><dt id=
"MATCH"><span class=
"term"><em class=
"replaceable"><code>MATCH
</code></em></span><a class=
"headerlink" title=
"Permalink to this term" href=
"#MATCH">¶
</a></dt><dd><p>General journalctl predicates
48 (see
<a href=
"journalctl.html"><span class=
"citerefentry"><span class=
"refentrytitle">journalctl
</span>(
1)
</span></a>).
49 Must contain an equals sign.
50 </p></dd></dl></div></div><div class=
"refsect1"><a name=
"idm214170675024"></a><h2 id=
"Exit status">Exit status
<a class=
"headerlink" title=
"Permalink to this headline" href=
"#Exit%20status">¶
</a></h2><p>On success,
0 is returned; otherwise, a non-zero failure
51 code is returned. Not finding any matching coredumps is treated
53 </p></div><div class=
"refsect1"><a name=
"idm214170673648"></a><h2 id=
"See Also">See Also
<a class=
"headerlink" title=
"Permalink to this headline" href=
"#See%20Also">¶
</a></h2><p>
54 <a href=
"systemd-journald.service.html"><span class=
"citerefentry"><span class=
"refentrytitle">systemd-journald.service
</span>(
8)
</span></a>,
55 <a href=
"gdb.html"><span class=
"citerefentry"><span class=
"refentrytitle">gdb
</span>(
1)
</span></a>
56 </p></div></div></body></html>