diff options
Diffstat (limited to 'man/timedatectl.xml')
| -rw-r--r-- | man/timedatectl.xml | 65 |
1 files changed, 37 insertions, 28 deletions
diff --git a/man/timedatectl.xml b/man/timedatectl.xml index 98ec013ebb..d7bd052eff 100644 --- a/man/timedatectl.xml +++ b/man/timedatectl.xml @@ -1,6 +1,9 @@ <?xml version='1.0'?> <!--*-nxml-*--> <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" - "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ +<!ENTITY % entities SYSTEM "custom-entities.ent" > +%entities; +]> <!-- This file is part of systemd. @@ -103,9 +106,14 @@ <varlistentry> <term><command>status</command></term> - <listitem><para>Show current settings - of the system clock and - RTC.</para></listitem> + <listitem><para>Show current settings of the system clock and + RTC, including whether network time synchronization is + on. Note that whether network time synchronization is on + simply reflects whether the + <filename>systemd-timesyncd.service</filename> unit is + enabled. Even if this command shows the status as off a + different service might still synchronize the clock with the + network.</para></listitem> </varlistentry> <varlistentry> @@ -160,9 +168,13 @@ <varlistentry> <term><command>set-ntp [BOOL]</command></term> - <listitem><para>Takes a boolean argument. Controls whether NTP - based network time synchronization is enabled (if - available).</para></listitem> + <listitem><para>Takes a boolean argument. Controls whether + network time synchronization is enabled (if available). This + enables or disables the + <filename>systemd-timesyncd.service</filename> unit. Note that + even if this command turns time synchronization off a + different system service might still synchronize the clock + with the network.</para></listitem> </varlistentry> </variablelist> @@ -182,25 +194,16 @@ <title>Examples</title> <para>Show current settings: <programlisting>$ timedatectl - Local time: Fri, 2012-11-02 09:26:46 CET - Universal time: Fri, 2012-11-02 08:26:46 UTC - RTC time: Fri, 2012-11-02 08:26:45 - Timezone: Europe/Warsaw - UTC offset: +0100 - NTP enabled: no -NTP synchronized: no - RTC in local TZ: no - DST active: no - Last DST change: CEST → CET, DST became inactive - Sun, 2012-10-28 02:59:59 CEST - Sun, 2012-10-28 02:00:00 CET - Next DST change: CET → CEST, DST will become active - the clock will jump one hour forward - Sun, 2013-03-31 01:59:59 CET - Sun, 2013-03-31 03:00:00 CEST</programlisting> + Local time: Di 2015-04-07 16:26:56 CEST + Universal time: Di 2015-04-07 14:26:56 UTC + RTC time: Di 2015-04-07 14:26:56 + Time zone: Europe/Berlin (CEST, +0200) + Network time on: yes +NTP synchronized: yes + RTC in local TZ: no</programlisting> </para> - <para>Enable an NTP daemon (chronyd): + <para>Enable network time synchronization: <programlisting>$ timedatectl set-ntp true ==== AUTHENTICATING FOR org.freedesktop.timedate1.set-ntp === Authentication is required to control whether network time synchronization shall be enabled. @@ -208,10 +211,15 @@ Authenticating as: user Password: ******** ==== AUTHENTICATION COMPLETE ===</programlisting> - <programlisting>$ systemctl status chronyd.service -chronyd.service - NTP client/server - Loaded: loaded (/usr/lib/systemd/system/chronyd.service; enabled) - Active: active (running) since Fri, 2012-11-02 09:36:25 CET; 5s ago + <programlisting>$ systemctl status systemd-timesyncd.service +● systemd-timesyncd.service - Network Time Synchronization + Loaded: loaded (&rootlibexecdir;/system/systemd-timesyncd.service; enabled) + Active: active (running) since Mo 2015-03-30 14:20:38 CEST; 5s ago + Docs: man:systemd-timesyncd.service(8) + Main PID: 595 (systemd-timesyn) + Status: "Using Time Server 216.239.38.15:123 (time4.google.com)." + CGroup: /system.slice/systemd-timesyncd.service + └─595 &rootlibexecdir;/systemd-timesyncd ...</programlisting> </para> </refsect1> @@ -225,6 +233,7 @@ chronyd.service - NTP client/server <citerefentry><refentrytitle>localtime</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd-timedated.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>, + <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry> </para> </refsect1> |