[thirdparty/systemd.git] / man / timedatectl.xml

<?xml version='1.0'?> <!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!-- SPDX-License-Identifier: LGPL-2.1+ -->

<refentry id="timedatectl" conditional='ENABLE_TIMEDATECTL'
  xmlns:xi="http://www.w3.org/2001/XInclude">

  <refentryinfo>
    <title>timedatectl</title>
    <productname>systemd</productname>
  </refentryinfo>

  <refmeta>
    <refentrytitle>timedatectl</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>timedatectl</refname>
    <refpurpose>Control the system time and date</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>timedatectl <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para><command>timedatectl</command> may be used to query and
    change the system clock and its settings.</para>

    <para>Use
    <citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
    to initialize the system time zone for mounted (but not booted)
    system images.</para>

    <para><command>timedatectl</command> may be used to show the current status of
    <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
    </para>

  </refsect1>

  <refsect1>
    <title>Options</title>

    <para>The following options are understood:</para>

    <variablelist>
      <varlistentry>
        <term><option>--no-ask-password</option></term>

        <listitem><para>Do not query the user for authentication for
        privileged operations.</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--adjust-system-clock</option></term>

        <listitem><para>If <command>set-local-rtc</command> is invoked
        and this option is passed, the system clock is synchronized
        from the RTC again, taking the new setting into account.
        Otherwise, the RTC is synchronized from the system
        clock.</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--monitor</option></term>

        <listitem><para>If <command>timesync-status</command> is invoked and this option is passed, then
        <command>timedatectl</command> monitors the status of
        <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
        and updates the outputs. Use <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> to terminate the
        monitoring.</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-a</option></term>
        <term><option>--all</option></term>

        <listitem><para>When showing properties of
        <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
        show all properties regardless of whether they are set or not.</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-p</option></term>
        <term><option>--property=</option></term>

        <listitem><para>When showing properties of
        <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
        limit display to certain properties as specified as argument. If not specified, all set properties are shown.
        The argument should be a property name, such as <literal>ServerName</literal>. If specified more than once,
        all properties with the specified names are shown.</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--value</option></term>

        <listitem>
          <para>When printing properties with <command>show-timesync</command>, only print the value, and skip the
          property name and <literal>=</literal>.</para></listitem>
      </varlistentry>

      <xi:include href="user-system-options.xml" xpointer="host" />
      <xi:include href="user-system-options.xml" xpointer="machine" />

      <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>
  </refsect1>

  <refsect1>
    <title>Commands</title>

    <para>The following commands are understood:</para>

    <variablelist>
      <varlistentry>
        <term><command>status</command></term>

        <listitem><para>Show current settings of the system clock and RTC,
        including whether network time synchronization through
        <filename>systemd-timesyncd.service</filename> is active. Even if it is
        inactive, a different service might still synchronize the clock.
        If no command is specified, this is the implied default.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>show</command></term>

        <listitem><para>Show the same information as <option>status</option>, but in machine readable form.
        This command is intended to be used whenever computer-parsable output is required.
        Use <option>status</option> if you are looking for formatted human-readable output.</para>
        <para>By default, empty properties are suppressed. Use <option>--all</option> to show those too.
        To select specific properties to show, use <option>--property=</option>.</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>set-time [TIME]</command></term>

        <listitem><para>Set the system clock to the specified time.
        This will also update the RTC time accordingly. The time may
        be specified in the format "2012-10-30
        18:17:16".</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>set-timezone [TIMEZONE]</command></term>

        <listitem><para>Set the system time zone to the specified
        value. Available timezones can be listed with
        <command>list-timezones</command>. If the RTC is configured to
        be in the local time, this will also update the RTC time. This
        call will alter the <filename>/etc/localtime</filename>
        symlink. See
        <citerefentry><refentrytitle>localtime</refentrytitle><manvolnum>5</manvolnum></citerefentry>
        for more information.</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>list-timezones</command></term>

        <listitem><para>List available time zones, one per line.
        Entries from the list can be set as the system timezone with
        <command>set-timezone</command>.</para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>set-local-rtc [BOOL]</command></term>

        <listitem><para>Takes a boolean argument. If
        <literal>0</literal>, the system is configured to maintain the
        RTC in universal time. If <literal>1</literal>, it will
        maintain the RTC in local time instead. Note that maintaining
        the RTC in the local timezone is not fully supported and will
        create various problems with time zone changes and daylight
        saving adjustments. If at all possible, keep the RTC in UTC
        mode. Note that invoking this will also synchronize the RTC
        from the system clock, unless
        <option>--adjust-system-clock</option> is passed (see above).
        This command will change the 3rd line of
        <filename>/etc/adjtime</filename>, as documented in
        <citerefentry project='man-pages'><refentrytitle>hwclock</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>set-ntp [BOOL]</command></term>

        <listitem><para>Takes a boolean argument. Controls whether network time synchronization is active
        and enabled (if available). If the argument is true, this enables and starts the first existed
        service listed in the environment variable <varname>$SYSTEMD_TIMEDATED_NTP_SERVICES</varname>
        of <filename>systemd-timedated.service</filename>. If the argument is false, then this disables and
        stops the all services listed in <varname>$SYSTEMD_TIMEDATED_NTP_SERVICES</varname>.</para></listitem>
      </varlistentry>

    </variablelist>

    <refsect2>
      <title>systemd-timesyncd Commands</title>

      <para>The following commands are specific to
      <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
      </para>

      <variablelist>
        <varlistentry>
          <term><command>timesync-status</command></term>

          <listitem><para>Show current status of
          <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
          If <option>--monitor</option> is specified, then this will monitor the status updates.</para></listitem>
        </varlistentry>

        <varlistentry>
          <term><command>show-timesync</command></term>

          <listitem><para>Show the same information as <option>timesync-status</option>, but in machine readable form.
          This command is intended to be used whenever computer-parsable output is required.
          Use <option>timesync-status</option> if you are looking for formatted human-readable output.</para>
          <para>By default, empty properties are suppressed. Use <option>--all</option> to show those too.
          To select specific properties to show, use <option>--property=</option>.</para></listitem>
        </varlistentry>

        <varlistentry>
          <term><command>ntp-servers <replaceable>INTERFACE</replaceable> <replaceable>SERVER</replaceable>…</command></term>

          <listitem><para>Set the interface specific NTP servers. This command can be used only when the
          interface is managed by <command>systemd-networkd</command>.</para></listitem>
        </varlistentry>

        <varlistentry>
          <term><command>revert <replaceable>INTERFACE</replaceable></command></term>

          <listitem><para>Revert the interface specific NTP servers. This command can be used only when
          the interface is managed by <command>systemd-networkd</command>.</para></listitem>
        </varlistentry>
      </variablelist>

    </refsect2>

  </refsect1>

  <refsect1>
    <title>Exit status</title>

    <para>On success, 0 is returned, a non-zero failure
    code otherwise.</para>
  </refsect1>

  <xi:include href="less-variables.xml" />

  <refsect1>
    <title>Examples</title>
    <para>Show current settings:
    <programlisting>$ timedatectl
               Local time: Thu 2017-09-21 16:08:56 CEST
           Universal time: Thu 2017-09-21 14:08:56 UTC
                 RTC time: Thu 2017-09-21 14:08:56
                Time zone: Europe/Warsaw (CEST, +0200)
System clock synchronized: yes
              NTP service: active
          RTC in local TZ: no</programlisting>
    </para>

    <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.
Authenticating as: user
Password: ********
==== AUTHENTICATION COMPLETE ===</programlisting>

    <programlisting>$ systemctl status systemd-timesyncd.service
● systemd-timesyncd.service - Network Time Synchronization
   Loaded: loaded (/usr/lib/systemd/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 /usr/lib/systemd/systemd-timesyncd
…</programlisting>
    </para>

    <para>Show current status of
    <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>:
    <programlisting>$ timedatectl timesync-status
       Server: 216.239.38.15 (time4.google.com)
Poll interval: 1min 4s (min: 32s; max 34min 8s)
         Leap: normal
      Version: 4
      Stratum: 1
    Reference: GPS
    Precision: 1us (-20)
Root distance: 335us (max: 5s)
       Offset: +316us
        Delay: 349us
       Jitter: 0
 Packet count: 1
    Frequency: -8.802ppm</programlisting>
    </para>

  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
      <citerefentry project='man-pages'><refentrytitle>hwclock</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
      <citerefentry project='man-pages'><refentrytitle>date</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
      <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>

</refentry>
Commit	Line	Data
6d0274f1	1	<?xml version='1.0'?> <!---nxml--->
3a54a157	2	<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
12b42c76	3	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
0307f791	4	<!-- SPDX-License-Identifier: LGPL-2.1+ -->
6d0274f1	5
1e4acc77	6	<refentry id="timedatectl" conditional='ENABLE_TIMEDATECTL'
798d3a52 ZJS	7	xmlns:xi="http://www.w3.org/2001/XInclude">
	8
	9	<refentryinfo>
	10	<title>timedatectl</title>
	11	<productname>systemd</productname>
798d3a52 ZJS	12	</refentryinfo>
	13
	14	<refmeta>
	15	<refentrytitle>timedatectl</refentrytitle>
	16	<manvolnum>1</manvolnum>
	17	</refmeta>
	18
	19	<refnamediv>
	20	<refname>timedatectl</refname>
	21	<refpurpose>Control the system time and date</refpurpose>
	22	</refnamediv>
	23
	24	<refsynopsisdiv>
	25	<cmdsynopsis>
	26	<command>timedatectl <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command>
	27	</cmdsynopsis>
	28	</refsynopsisdiv>
	29
	30	<refsect1>
	31	<title>Description</title>
	32
	33	<para><command>timedatectl</command> may be used to query and
	34	change the system clock and its settings.</para>
	35
	36	<para>Use
	37	<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
	38	to initialize the system time zone for mounted (but not booted)
	39	system images.</para>
1e4acc77 YW	40
	41	<para><command>timedatectl</command> may be used to show the current status of
	42	<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
	43	</para>
	44
798d3a52 ZJS	45	</refsect1>
	46
	47	<refsect1>
	48	<title>Options</title>
	49
	50	<para>The following options are understood:</para>
	51
	52	<variablelist>
	53	<varlistentry>
	54	<term><option>--no-ask-password</option></term>
	55
	56	<listitem><para>Do not query the user for authentication for
	57	privileged operations.</para></listitem>
	58	</varlistentry>
	59
	60	<varlistentry>
	61	<term><option>--adjust-system-clock</option></term>
	62
	63	<listitem><para>If <command>set-local-rtc</command> is invoked
	64	and this option is passed, the system clock is synchronized
	65	from the RTC again, taking the new setting into account.
	66	Otherwise, the RTC is synchronized from the system
	67	clock.</para></listitem>
	68	</varlistentry>
	69
1e4acc77 YW	70	<varlistentry>
	71	<term><option>--monitor</option></term>
	72
84afbbcf ZJS	73	<listitem><para>If <command>timesync-status</command> is invoked and this option is passed, then
84afbbcf ZJS	74	<command>timedatectl</command> monitors the status of
1e4acc77	75	<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
84afbbcf ZJS	76	and updates the outputs. Use <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> to terminate the
84afbbcf ZJS	77	monitoring.</para></listitem>
1e4acc77 YW	78	</varlistentry>
	79
	80	<varlistentry>
	81	<term><option>-a</option></term>
ab14760e	82	<term><option>--all</option></term>
1e4acc77 YW	83
	84	<listitem><para>When showing properties of
	85	<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
	86	show all properties regardless of whether they are set or not.</para></listitem>
	87	</varlistentry>
	88
	89	<varlistentry>
	90	<term><option>-p</option></term>
	91	<term><option>--property=</option></term>
	92
	93	<listitem><para>When showing properties of
	94	<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
	95	limit display to certain properties as specified as argument. If not specified, all set properties are shown.
	96	The argument should be a property name, such as <literal>ServerName</literal>. If specified more than once,
	97	all properties with the specified names are shown.</para></listitem>
	98	</varlistentry>
	99
	100	<varlistentry>
	101	<term><option>--value</option></term>
	102
	103	<listitem>
	104	<para>When printing properties with <command>show-timesync</command>, only print the value, and skip the
	105	property name and <literal>=</literal>.</para></listitem>
	106	</varlistentry>
	107
798d3a52 ZJS	108	<xi:include href="user-system-options.xml" xpointer="host" />
	109	<xi:include href="user-system-options.xml" xpointer="machine" />
	110
	111	<xi:include href="standard-options.xml" xpointer="help" />
	112	<xi:include href="standard-options.xml" xpointer="version" />
	113	<xi:include href="standard-options.xml" xpointer="no-pager" />
	114	</variablelist>
24fcd009 YW	115	</refsect1>
	116
	117	<refsect1>
	118	<title>Commands</title>
798d3a52 ZJS	119
	120	<para>The following commands are understood:</para>
	121
	122	<variablelist>
	123	<varlistentry>
	124	<term><command>status</command></term>
	125
1b7ac91f ZJS	126	<listitem><para>Show current settings of the system clock and RTC,
	127	including whether network time synchronization through
	128	<filename>systemd-timesyncd.service</filename> is active. Even if it is
	129	inactive, a different service might still synchronize the clock.
24fcd009	130	If no command is specified, this is the implied default.
1b7ac91f	131	</para></listitem>
798d3a52 ZJS	132	</varlistentry>
798d3a52 ZJS	133
ead0adb1 YW	134	<varlistentry>
	135	<term><command>show</command></term>
	136
	137	<listitem><para>Show the same information as <option>status</option>, but in machine readable form.
	138	This command is intended to be used whenever computer-parsable output is required.
	139	Use <option>status</option> if you are looking for formatted human-readable output.</para>
	140	<para>By default, empty properties are suppressed. Use <option>--all</option> to show those too.
	141	To select specific properties to show, use <option>--property=</option>.</para></listitem>
	142	</varlistentry>
	143
798d3a52 ZJS	144	<varlistentry>
	145	<term><command>set-time [TIME]</command></term>
	146
	147	<listitem><para>Set the system clock to the specified time.
	148	This will also update the RTC time accordingly. The time may
	149	be specified in the format "2012-10-30
	150	18:17:16".</para></listitem>
	151	</varlistentry>
	152
	153	<varlistentry>
	154	<term><command>set-timezone [TIMEZONE]</command></term>
	155
	156	<listitem><para>Set the system time zone to the specified
	157	value. Available timezones can be listed with
	158	<command>list-timezones</command>. If the RTC is configured to
	159	be in the local time, this will also update the RTC time. This
	160	call will alter the <filename>/etc/localtime</filename>
	161	symlink. See
	162	<citerefentry><refentrytitle>localtime</refentrytitle><manvolnum>5</manvolnum></citerefentry>
	163	for more information.</para></listitem>
	164	</varlistentry>
	165
	166	<varlistentry>
	167	<term><command>list-timezones</command></term>
	168
	169	<listitem><para>List available time zones, one per line.
	170	Entries from the list can be set as the system timezone with
	171	<command>set-timezone</command>.</para></listitem>
	172	</varlistentry>
	173
	174	<varlistentry>
	175	<term><command>set-local-rtc [BOOL]</command></term>
	176
	177	<listitem><para>Takes a boolean argument. If
	178	<literal>0</literal>, the system is configured to maintain the
	179	RTC in universal time. If <literal>1</literal>, it will
	180	maintain the RTC in local time instead. Note that maintaining
	181	the RTC in the local timezone is not fully supported and will
	182	create various problems with time zone changes and daylight
	183	saving adjustments. If at all possible, keep the RTC in UTC
	184	mode. Note that invoking this will also synchronize the RTC
	185	from the system clock, unless
	186	<option>--adjust-system-clock</option> is passed (see above).
	187	This command will change the 3rd line of
	188	<filename>/etc/adjtime</filename>, as documented in
	189	<citerefentry project='man-pages'><refentrytitle>hwclock</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
	190	</para></listitem>
	191	</varlistentry>
	192
	193	<varlistentry>
	194	<term><command>set-ntp [BOOL]</command></term>
	195
326208e0 YW	196	<listitem><para>Takes a boolean argument. Controls whether network time synchronization is active
	197	and enabled (if available). If the argument is true, this enables and starts the first existed
	198	service listed in the environment variable <varname>$SYSTEMD_TIMEDATED_NTP_SERVICES</varname>
	199	of <filename>systemd-timedated.service</filename>. If the argument is false, then this disables and
	200	stops the all services listed in <varname>$SYSTEMD_TIMEDATED_NTP_SERVICES</varname>.</para></listitem>
798d3a52 ZJS	201	</varlistentry>
	202
	203	</variablelist>
	204
ead0adb1 YW	205	<refsect2>
ead0adb1 YW	206	<title>systemd-timesyncd Commands</title>
1e4acc77	207
ead0adb1 YW	208	<para>The following commands are specific to
	209	<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
	210	</para>
1e4acc77 YW	211
	212	<variablelist>
	213	<varlistentry>
	214	<term><command>timesync-status</command></term>
	215
	216	<listitem><para>Show current status of
	217	<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
	218	If <option>--monitor</option> is specified, then this will monitor the status updates.</para></listitem>
	219	</varlistentry>
	220
	221	<varlistentry>
	222	<term><command>show-timesync</command></term>
	223
ead0adb1 YW	224	<listitem><para>Show the same information as <option>timesync-status</option>, but in machine readable form.
	225	This command is intended to be used whenever computer-parsable output is required.
	226	Use <option>timesync-status</option> if you are looking for formatted human-readable output.</para>
	227	<para>By default, empty properties are suppressed. Use <option>--all</option> to show those too.
	228	To select specific properties to show, use <option>--property=</option>.</para></listitem>
1e4acc77	229	</varlistentry>
159a855b YW	230
	231	<varlistentry>
	232	<term><command>ntp-servers <replaceable>INTERFACE</replaceable> <replaceable>SERVER</replaceable>…</command></term>
	233
	234	<listitem><para>Set the interface specific NTP servers. This command can be used only when the
	235	interface is managed by <command>systemd-networkd</command>.</para></listitem>
	236	</varlistentry>
	237
	238	<varlistentry>
	239	<term><command>revert <replaceable>INTERFACE</replaceable></command></term>
	240
	241	<listitem><para>Revert the interface specific NTP servers. This command can be used only when
	242	the interface is managed by <command>systemd-networkd</command>.</para></listitem>
	243	</varlistentry>
1e4acc77 YW	244	</variablelist>
	245
	246	</refsect2>
	247
798d3a52 ZJS	248	</refsect1>
	249
	250	<refsect1>
	251	<title>Exit status</title>
	252
	253	<para>On success, 0 is returned, a non-zero failure
	254	code otherwise.</para>
	255	</refsect1>
	256
	257	<xi:include href="less-variables.xml" />
	258
	259	<refsect1>
	260	<title>Examples</title>
	261	<para>Show current settings:
	262	<programlisting>$ timedatectl
326208e0 YW	263	Local time: Thu 2017-09-21 16:08:56 CEST
	264	Universal time: Thu 2017-09-21 14:08:56 UTC
	265	RTC time: Thu 2017-09-21 14:08:56
	266	Time zone: Europe/Warsaw (CEST, +0200)
	267	System clock synchronized: yes
	268	NTP service: active
	269	RTC in local TZ: no</programlisting>
798d3a52	270	</para>
be1015dd	271
b90930c7	272	<para>Enable network time synchronization:
798d3a52	273	<programlisting>$ timedatectl set-ntp true
be1015dd ZJS	274	==== AUTHENTICATING FOR org.freedesktop.timedate1.set-ntp ===
	275	Authentication is required to control whether network time synchronization shall be enabled.
	276	Authenticating as: user
	277	Password: ********
9fccdb0f	278	==== AUTHENTICATION COMPLETE ===</programlisting>
be1015dd	279
57506e7d LP	280	<programlisting>$ systemctl status systemd-timesyncd.service
57506e7d LP	281	● systemd-timesyncd.service - Network Time Synchronization
12b42c76	282	Loaded: loaded (/usr/lib/systemd/system/systemd-timesyncd.service; enabled)
57506e7d LP	283	Active: active (running) since Mo 2015-03-30 14:20:38 CEST; 5s ago
	284	Docs: man:systemd-timesyncd.service(8)
	285	Main PID: 595 (systemd-timesyn)
	286	Status: "Using Time Server 216.239.38.15:123 (time4.google.com)."
	287	CGroup: /system.slice/systemd-timesyncd.service
12b42c76	288	└─595 /usr/lib/systemd/systemd-timesyncd
1eecafb8	289	…</programlisting>
798d3a52	290	</para>
1e4acc77 YW	291
	292	<para>Show current status of
	293	<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>:
	294	<programlisting>$ timedatectl timesync-status
	295	Server: 216.239.38.15 (time4.google.com)
	296	Poll interval: 1min 4s (min: 32s; max 34min 8s)
	297	Leap: normal
	298	Version: 4
	299	Stratum: 1
	300	Reference: GPS
	301	Precision: 1us (-20)
	302	Root distance: 335us (max: 5s)
	303	Offset: +316us
	304	Delay: 349us
	305	Jitter: 0
	306	Packet count: 1
	307	Frequency: -8.802ppm</programlisting>
	308	</para>
	309
798d3a52 ZJS	310	</refsect1>
	311
	312	<refsect1>
	313	<title>See Also</title>
	314	<para>
	315	<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
	316	<citerefentry project='man-pages'><refentrytitle>hwclock</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
	317	<citerefentry project='man-pages'><refentrytitle>date</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
	318	<citerefentry><refentrytitle>localtime</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
	319	<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
	320	<citerefentry><refentrytitle>systemd-timedated.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
ff5921ba	321	<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
798d3a52 ZJS	322	<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
	323	</para>
	324	</refsect1>
6d0274f1 LP	325
6d0274f1 LP	326	</refentry>