event: add apis to query the timestamp of the event currently processed

[elogind.git] / man / journalctl.xml

diff --git a/man/journalctl.xml b/man/journalctl.xml
index 65a59ea4e73b8b62bb7bb453e0dde5374165f3af..2ce81a0563adb22bd418b454ff1eec00527d4b33 100644 (file)
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -104,7 +104,7 @@
 
                 <para>All users are granted access to their private
                 per-user journals. However, by default, only root and
 
                 <para>All users are granted access to their private
                 per-user journals. However, by default, only root and

-                users who are members of the <literal>adm</literal>
+                users who are members of the <literal>systemd-journal</literal>

                 group get access to the system journal and the
                 journals of other users.</para>
 
                 group get access to the system journal and the
                 journals of other users.</para>
 


@@ -152,11 +152,20 @@
                         </varlistentry>
 
                         <varlistentry>
                         </varlistentry>
 
                         <varlistentry>

-                                <term><option>-l</option></term>
+                                <term><option>--no-full</option></term>

                                 <term><option>--full</option></term>
                                 <term><option>--full</option></term>

+                                <term><option>-l</option></term>
+
+                                <listitem><para>Ellipsize fields when
+                                they don't fit in available columns.
+                                The default is to show full fields,
+                                allowing them to wrap or be truncated
+                                by the pager if one is used.</para>

 
 

-                                <listitem><para>Show all (printable) fields in
-                                full.</para></listitem>
+                                <para>Old options
+                                <option>-l</option>/<option>--full</option>
+                                not useful anymore, except to undo
+                                <option>--no-full</option>.</para></listitem>

                         </varlistentry>
 
                         <varlistentry>
                         </varlistentry>
 
                         <varlistentry>


@@ -251,12 +260,37 @@
                                                 </listitem>
                                         </varlistentry>
 
                                                 </listitem>
                                         </varlistentry>
 

+                                        <varlistentry>
+                                                <term>
+                                                        <option>short-iso</option>
+                                                </term>
+                                                <listitem>
+                                                        <para>is very similar,
+                                                        but shows ISO 8601
+                                                        wallclock timestamps.
+                                                        </para>
+                                                </listitem>
+                                        </varlistentry>
+
+                                        <varlistentry>
+                                                <term>
+                                                        <option>short-precise</option>
+                                                </term>
+                                                <listitem>
+                                                        <para>is very similar,
+                                                        but shows timestamps
+                                                        with full microsecond
+                                                        precision.
+                                                        </para>
+                                                </listitem>
+                                        </varlistentry>
+

                                         <varlistentry>
                                                 <term>
                                                         <option>short-monotonic</option>
                                                 </term>
                                                 <listitem>
                                         <varlistentry>
                                                 <term>
                                                         <option>short-monotonic</option>
                                                 </term>
                                                 <listitem>

-                                                        <para>is very similar
+                                                        <para>is very similar,

                                                         but shows monotonic
                                                         timestamps instead of
                                                         wallclock timestamps.
                                                         but shows monotonic
                                                         timestamps instead of
                                                         wallclock timestamps.


@@ -367,7 +401,7 @@
                                 context of an error or log event,
                                 possible solutions, as well as
                                 pointers to support forums, developer
                                 context of an error or log event,
                                 possible solutions, as well as
                                 pointers to support forums, developer

-                                documentation and any other relevant
+                                documentation, and any other relevant

                                 manuals. Note that help texts are not
                                 available for all messages, but only
                                 for selected ones. For more
                                 manuals. Note that help texts are not
                                 available for all messages, but only
                                 for selected ones. For more


@@ -375,7 +409,14 @@
                                 please refer to the <ulink
                                 url="http://www.freedesktop.org/wiki/Software/systemd/catalog">Message
                                 Catalog Developer
                                 please refer to the <ulink
                                 url="http://www.freedesktop.org/wiki/Software/systemd/catalog">Message
                                 Catalog Developer

-                                Documentation</ulink>.</para></listitem>
+                                Documentation</ulink>.</para>
+
+                                <para>Note: when attaching
+                                <command>journalctl</command> output
+                                to bug reports, please do
+                                <emphasis>not</emphasis> use
+                                <option>-x</option>.</para>
+                                </listitem>

                         </varlistentry>
 
                         <varlistentry>
                         </varlistentry>
 
                         <varlistentry>


@@ -839,9 +880,9 @@
 
                 <programlisting>journalctl /dev/sda</programlisting>
 
 
                 <programlisting>journalctl /dev/sda</programlisting>
 

-                <para>Show all kernel logs from last boot:</para>
+                <para>Show all kernel logs from previous boot:</para>

 
 

-                <programlisting>journalctl -k -b :</programlisting>
+                <programlisting>journalctl -k -b -1</programlisting>

 
         </refsect1>
 
 
         </refsect1>