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

<?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">

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