<para>The following options are understood:</para>
<variablelist>
+ <varlistentry>
+ <term><option>--no-legend</option></term>
+
+ <listitem><para>Do not print column headers.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-1</option></term>
+
+ <listitem><para>Show information of a
+ single coredump only, instead of
+ listing all known coredumps.
+ </para></listitem>
+ </varlistentry>
+
<varlistentry>
<term><option>-F</option></term>
<term><option>--field=</option></term>
<option>FILE</option>.</para></listitem>
</varlistentry>
- <varlistentry>
- <term><option>--no-legend</option></term>
-
- <listitem><para>Do not print the column headers.
- </para></listitem>
- </varlistentry>
-
<xi:include href="standard-options.xml" xpointer="help" />
<xi:include href="standard-options.xml" xpointer="version" />
<xi:include href="standard-options.xml" xpointer="no-pager" />
+
</variablelist>
<para>The following commands are understood:</para>
<varlistentry>
<term><command>list</command></term>
- <listitem><para>List coredumps captured in the journal
- matching specified characteristics.</para></listitem>
+ <listitem><para>List coredumps
+ captured in the journal matching
+ specified characteristics. If no
+ command is specified, this is the
+ implied default.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><command>info</command></term>
+
+ <listitem><para>Show detailed
+ information about coredumps captured
+ in the journal.</para></listitem>
</varlistentry>
<varlistentry>
</para></listitem>
</varlistentry>
-
<varlistentry>
<term><command>gdb</command></term>
<refsect1>
<title>Matching</title>
- <para>Match can be:</para>
+ <para>A match can be:</para>
<variablelist>
<varlistentry>
<listitem><para>General journalctl predicates
(see <citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>).
- Must contain an equals sign.
+ Must contain an equal sign.
</para></listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
+ <refsect1>
+ <title>Examples</title>
+
+ <example>
+ <title>List all the coredumps of a program named foo</title>
+
+ <programlisting># coredumpctl list foo</programlisting>
+ </example>
+
+ <example>
+ <title>Invoke gdb on the last coredump</title>
+
+ <programlisting># coredumpctl gdb</programlisting>
+ </example>
+
+ <example>
+ <title>Show information about a process that dumped core, matching by its PID 6654</title>
+
+ <programlisting># coredumpctl info 6654</programlisting>
+ </example>
+
+ <example>
+ <title>Extract the last coredump of /usr/bin/bar to a file named bar.coredump</title>
+
+ <programlisting># coredumpctl -o bar.coredump dump /usr/bin/bar</programlisting>
+ </example>
+ </refsect1>
+
<refsect1>
<title>See Also</title>
<para>
+ <citerefentry><refentrytitle>systemd-coredump</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>coredump.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
- <citerefentry><refentrytitle>gdb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+ <citerefentry project='man-pages'><refentrytitle>gdb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
</para>
</refsect1>