summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMark Stosberg <mark@rideamigos.com>2017-02-26 20:03:30 -0500
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2017-02-26 20:03:30 -0500
commitccdda9556ee67a6b1c12e2a33cc309ad8fb06996 (patch)
tree979fe27ffc5dbde2146166ea081eb9f50913ac1b
parentacdf6ac97d2fd114f0edde899db53d9fd235a2b2 (diff)
man: systemctl list-timers: Provide sample output and document it. (#5463)
As with `systemctl list-sockets` and `systemctl status`, we provide a sample output for `systemctl list-timers` and document what the columns mean.
-rw-r--r--man/systemctl.xml15
1 files changed, 15 insertions, 0 deletions
diff --git a/man/systemctl.xml b/man/systemctl.xml
index d0b39d771b..22ff9494d6 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -712,8 +712,23 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
<listitem>
<para>List timer units currently in memory, ordered by the time they elapse next. If one or more
<replaceable>PATTERN</replaceable>s are specified, only units matching one of them are shown.
+ Produces output similiar to
+ <programlisting>
+NEXT LEFT LAST PASSED UNIT ACTIVATES
+n/a n/a Thu 2017-02-23 13:40:29 EST 3 days ago ureadahead-stop.timer ureadahead-stop.service
+Sun 2017-02-26 18:55:42 EST 1min 14s left Thu 2017-02-23 13:54:44 EST 3 days ago systemd-tmpfiles-clean.timer systemd-tmpfiles-clean.service
+Sun 2017-02-26 20:37:16 EST 1h 42min left Sun 2017-02-26 11:56:36 EST 6h ago apt-daily.timer apt-daily.service
+Sun 2017-02-26 20:57:49 EST 2h 3min left Sun 2017-02-26 11:56:36 EST 6h ago snapd.refresh.timer snapd.refresh.service
+ </programlisting>
</para>
+ <para><emphasis>NEXT</emphasis> shows the next time the timer will run.</para>
+ <para><emphasis>LEFT</emphasis> shows how long till the next time the timer runs.</para>
+ <para><emphasis>LAST</emphasis> shows the last time the timer ran.</para>
+ <para><emphasis>PASSED</emphasis> shows has long as passed since the timer laset ran.</para>
+ <para><emphasis>UNIT</emphasis> shows the name of the timer</para>
+ <para><emphasis>ACTIVATES</emphasis> shows the the name the service the timer activates when it runs.</para>
+
<para>Also see <option>--all</option> and <option>--state=</option>.</para>
</listitem>
</varlistentry>