summaryrefslogtreecommitdiffstats
path: root/man/systemctl.xml
diff options
context:
space:
mode:
authorLuca Boccassi <luca.boccassi@microsoft.com>2020-06-19 12:26:22 +0200
committerLuca Boccassi <luca.boccassi@microsoft.com>2020-08-19 16:30:13 +0200
commit46ad9c5378864ff3380dc119a949beeed08782cd (patch)
tree5f009edbd4313db9140100801be47da27508e489 /man/systemctl.xml
parentbasic/time-util: add function to format timestamps with different styles (diff)
downloadsystemd-46ad9c5378864ff3380dc119a949beeed08782cd.tar.xz
systemd-46ad9c5378864ff3380dc119a949beeed08782cd.zip
systemctl: add --timestamp to change timestamp print format
Timestamps for unit start/stop are recorded with microsecond granularity, but status and show truncate to second granularity by default. Add a --timestamp=pretty|us|utc option to allow including the microseconds or to use the UTC TZ to all timestamps printed by systemctl.
Diffstat (limited to 'man/systemctl.xml')
-rw-r--r--man/systemctl.xml14
1 files changed, 14 insertions, 0 deletions
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 506f9ca68f..bb3a296645 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -2134,6 +2134,20 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><option>--timestamp=</option></term>
+
+ <listitem>
+ <para>Takes one of <literal>pretty</literal> (the default),
+ <literal>us</literal>, <literal>µs</literal>, <literal>utc</literal>.
+ Changes the format of printed timestamps.
+ <literal>pretty</literal>: <literal>Day YYYY-MM-DD HH:MM:SS TZ</literal>
+ <literal>us</literal> or <literal>µs</literal>: <literal>Day YYYY-MM-DD HH:MM:SS.UUUUUU TZ</literal>
+ <literal>utc</literal>: <literal>Day YYYY-MM-DD HH:MM:SS UTC</literal></para>
+ <literal>us+utc</literal> or <literal>µs+utc</literal>: <literal>Day YYYY-MM-DD HH:MM:SS.UUUUUU UTC</literal>
+ </listitem>
+ </varlistentry>
+
<xi:include href="user-system-options.xml" xpointer="host" />
<xi:include href="user-system-options.xml" xpointer="machine" />