2012-06-26 00:56:45 +04:00
<?xml version='1.0'?> <!-- * - nxml - * -->
2019-03-14 16:40:58 +03:00
< !DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
2015-06-18 20:47:44 +03:00
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
2019-03-14 16:29:37 +03:00
<!-- SPDX - License - Identifier: LGPL - 2.1+ -->
2012-06-26 00:56:45 +04:00
2013-02-03 07:47:47 +04:00
<refentry id= "systemd-timedated.service" conditional= 'ENABLE_TIMEDATED' >
2012-06-26 00:56:45 +04:00
2015-02-04 05:14:13 +03:00
<refentryinfo >
<title > systemd-timedated.service</title>
<productname > systemd</productname>
</refentryinfo>
<refmeta >
<refentrytitle > systemd-timedated.service</refentrytitle>
<manvolnum > 8</manvolnum>
</refmeta>
<refnamediv >
<refname > systemd-timedated.service</refname>
<refname > systemd-timedated</refname>
<refpurpose > Time and date bus mechanism</refpurpose>
</refnamediv>
<refsynopsisdiv >
<para > <filename > systemd-timedated.service</filename> </para>
2015-06-18 20:47:44 +03:00
<para > <filename > /usr/lib/systemd/systemd-timedated</filename> </para>
2015-02-04 05:14:13 +03:00
</refsynopsisdiv>
<refsect1 >
<title > Description</title>
2020-04-09 18:17:16 +03:00
<para > <filename > systemd-timedated.service</filename> is a system service
2015-02-04 05:14:13 +03:00
that may be used as a mechanism to change the system clock and
2019-07-21 16:06:35 +03:00
timezone, as well as to enable/disable network time synchronization.
2015-02-04 05:14:13 +03:00
<filename > systemd-timedated</filename> is automatically activated
on request and terminates itself when it is unused.</para>
<para > The tool
<citerefentry > <refentrytitle > timedatectl</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry>
is a command line client to this service.</para>
2020-04-09 18:17:16 +03:00
<para > <filename > systemd-timedated</filename> currently offers access to
the following four settings:
<itemizedlist >
<listitem > <para > The system time</para> </listitem>
<listitem > <para > The system timezone</para> </listitem>
<listitem > <para > A boolean controlling whether the system RTC is in local or UTC
timezone</para> </listitem>
<listitem > <para > Whether the time synchronization service is enabled/started or
disabled/stopped, see next section.</para> </listitem>
</itemizedlist> </para>
<para > See
<citerefentry > <refentrytitle > org.freedesktop.timedate1</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry>
for information about the D-Bus API.</para>
2015-02-04 05:14:13 +03:00
</refsect1>
2018-04-17 07:57:27 +03:00
<refsect1 >
2019-07-21 16:06:35 +03:00
<title > List of network time synchronization services</title>
<para > <command > systemd-timesyncd</command> will look for files with a <literal > .list</literal> extension
in <filename > ntp-units.d/</filename> directories. Each file is parsed as a list of unit names, one per
line. Empty lines and lines with comments (<literal > #</literal> ) are ignored. Files are read from
<filename > /usr/lib/systemd/ntp-units.d/</filename> and the corresponding directories under
<filename > /etc/</filename> , <filename > /run/</filename> , <filename > /usr/local/lib/</filename> . Files in
<filename > /etc/</filename> override files with the same name in <filename > /run/</filename> ,
<filename > /usr/local/lib/</filename> , and <filename > /usr/lib/</filename> . Files in
<filename > /run/</filename> override files with the same name under <filename > /usr/</filename> . Packages
should install their configuration files in <filename > /usr/lib/</filename> (distribution packages) or
<filename > /usr/local/lib/</filename> (local installs).</para>
<example >
<title > <filename > ntp-units.d/</filename> entry for <command > systemd-timesyncd</command> </title>
<programlisting > # /usr/lib/systemd/ntp-units.d/80-systemd-timesync.list
systemd-timesyncd.service
</programlisting>
</example>
<para > If the environment variable <varname > $SYSTEMD_TIMEDATED_NTP_SERVICES</varname> is set,
<command > systemd-timesyncd</command> will parse the contents of that variable as a colon-separated list
of unit names. When set, this variable overrides the file-based list described above.</para>
<example >
<title > An override that specifies that <command > chronyd</command> should be used if available</title>
<programlisting > SYSTEMD_TIMEDATED_NTP_SERVICES=chronyd.service:systemd-timesyncd.service</programlisting>
</example>
2018-04-17 07:57:27 +03:00
</refsect1>
2019-07-21 16:06:35 +03:00
2015-02-04 05:14:13 +03:00
<refsect1 >
<title > See Also</title>
<para >
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > timedatectl</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > localtime</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> ,
2018-04-17 07:57:27 +03:00
<citerefentry project= 'man-pages' > <refentrytitle > hwclock</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > systemd-timesyncd</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry>
2015-02-04 05:14:13 +03:00
</para>
</refsect1>
2012-06-26 00:56:45 +04:00
</refentry>