tizen 2.4 release
[external/systemd.git] / man / coredumpctl.xml
similarity index 79%
rename from man/systemd-coredumpctl.xml
rename to man/coredumpctl.xml
index 092ec56..a7b8793 100644 (file)
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="systemd-coredumpctl" conditional='ENABLE_COREDUMP'
+<refentry id="coredumpctl" conditional='ENABLE_COREDUMP'
           xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
-                <title>systemd-coredumpctl</title>
+                <title>coredumpctl</title>
                 <productname>systemd</productname>
 
                 <authorgroup>
         </refentryinfo>
 
         <refmeta>
-                <refentrytitle>systemd-coredumpctl</refentrytitle>
+                <refentrytitle>coredumpctl</refentrytitle>
                 <manvolnum>1</manvolnum>
         </refmeta>
 
         <refnamediv>
-                <refname>systemd-coredumpctl</refname>
+                <refname>coredumpctl</refname>
                 <refpurpose>Retrieve coredumps from the journal</refpurpose>
         </refnamediv>
 
         <refsynopsisdiv>
                 <cmdsynopsis>
-                        <command>systemd-coredumpctl</command>
+                        <command>coredumpctl</command>
                         <arg choice="opt" rep="repeat">OPTIONS</arg>
                         <arg choice="req">COMMAND</arg>
                         <arg choice="opt" rep="repeat">PID|COMM|EXE|MATCH</arg>
@@ -60,7 +60,7 @@
         <refsect1>
                 <title>Description</title>
 
-                <para><command>systemd-coredumpctl</command> may be used to
+                <para><command>coredumpctl</command> may be used to
                 retrieve coredumps from
                 <citerefentry><refentrytitle>systemd-journald</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
         </refsect1>
 
                 <variablelist>
                         <varlistentry>
+                                <term><option>--no-legend</option></term>
+
+                                <listitem><para>Do not print the 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>
         <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>