timesyncd.conf.xml revision 6c033c34967b6dffb6a4b295c43bd151105e4f1f
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering This file is part of systemd.
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering Copyright 2014 Lennart Poettering
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering systemd is free software; you can redistribute it and/or modify it
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering under the terms of the GNU Lesser General Public License as published by
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering the Free Software Foundation; either version 2.1 of the License, or
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering (at your option) any later version.
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering systemd is distributed in the hope that it will be useful, but
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering Lesser General Public License for more details.
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering You should have received a copy of the GNU Lesser General Public License
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
dd1eb43ba771d4d56b20b4c93ba3acc59475f642Lennart Poettering<refentry id="timesyncd.conf" conditional='ENABLE_TIMESYNCD'
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek xmlns:xi="http://www.w3.org/2001/XInclude">
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <email>lennart@poettering.net</email>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>timesyncd.conf</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>timesyncd.conf</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>timesyncd.conf.d</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Network Time Synchronization configuration files</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>/etc/systemd/timesyncd.conf</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>/etc/systemd/timesyncd.conf.d/*.conf</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>/run/systemd/timesyncd.conf.d/*.conf</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>/usr/lib/systemd/timesyncd.conf.d/*.conf</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>These configuration files control NTP network time
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek synchronization.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <xi:include href="standard-conf.xml" xpointer="main-conf" />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The following settings are configured in the <literal>[Time]</literal> section:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>NTP=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>A space-separated list of NTP server host
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek names or IP addresses. During runtime this list is combined
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering with any per-interface NTP servers acquired from
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering systemd-timesyncd will contact all configured system or
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering per-interface servers in turn until one is found that
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering responds. This setting defaults to an empty
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering </varlistentry>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <varlistentry>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <term><varname>FallbackNTP=</varname></term>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <listitem><para>A space-separated list of NTP server host
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering names or IP addresses to be used as the fallback NTP servers.
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering Any per-interface NTP servers obtained from
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering take precedence over this setting, as do any servers set via
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <varname>NTP=</varname> above. This setting is hence only used
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering if no other NTP server information is known. If this option is
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering not given, a compiled-in list of NTP servers is used
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering </varlistentry>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>