man/timesyncd.conf.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
   3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   4         "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   5
   6 <!--
   7   This file is part of systemd.
   8
   9   Copyright 2014 Lennart Poettering
  10
  11   systemd is free software; you can redistribute it and/or modify it
  12   under the terms of the GNU Lesser General Public License as published by
  13   the Free Software Foundation; either version 2.1 of the License, or
  14   (at your option) any later version.
  15
  16   systemd is distributed in the hope that it will be useful, but
  17   WITHOUT ANY WARRANTY; without even the implied warranty of
  18   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  19   Lesser General Public License for more details.
  20
  21   You should have received a copy of the GNU Lesser General Public License
  22   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  23 -->
  24
  25 <refentry id="timesyncd.conf" conditional='ENABLE_TIMESYNCD'
  26           xmlns:xi="http://www.w3.org/2001/XInclude">
  27         <refentryinfo>
  28                 <title>timesyncd.conf</title>
  29                 <productname>systemd</productname>
  30
  31                 <authorgroup>
  32                         <author>
  33                                 <contrib>Developer</contrib>
  34                                 <firstname>Lennart</firstname>
  35                                 <surname>Poettering</surname>
  36                                 <email>lennart@poettering.net</email>
  37                         </author>
  38                 </authorgroup>
  39         </refentryinfo>
  40
  41         <refmeta>
  42                 <refentrytitle>timesyncd.conf</refentrytitle>
  43                 <manvolnum>5</manvolnum>
  44         </refmeta>
  45
  46         <refnamediv>
  47                 <refname>timesyncd.conf</refname>
  48                 <refname>timesyncd.conf.d</refname>
  49                 <refpurpose>Network Time Synchronization configuration files</refpurpose>
  50         </refnamediv>
  51
  52         <refsynopsisdiv>
  53                 <para><filename>/etc/systemd/timesyncd.conf</filename></para>
  54                 <para><filename>/etc/systemd/timesyncd.conf.d/*.conf</filename></para>
  55                 <para><filename>/run/systemd/timesyncd.conf.d/*.conf</filename></para>
  56                 <para><filename>/usr/lib/systemd/timesyncd.conf.d/*.conf</filename></para>
  57         </refsynopsisdiv>
  58
  59         <refsect1>
  60                 <title>Description</title>
  61
  62                 <para>These configuration files control NTP network time
  63                 synchronization.</para>
  64
  65         </refsect1>
  66
  67         <xi:include href="standard-conf.xml" xpointer="confd" />
  68         <xi:include href="standard-conf.xml" xpointer="conf" />
  69
  70         <refsect1>
  71                 <title>Options</title>
  72
  73                 <variablelist class='network-directives'>
  74
  75                         <varlistentry>
  76                                 <term><varname>NTP=</varname></term>
  77                                 <listitem><para>A space separated list
  78                                 of NTP servers host names or IP
  79                                 addresses. During runtime this list is
  80                                 combined with any per-interface NTP
  81                                 servers acquired from
  82                                 <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>. systemd-timesyncd
  83                                 will contact all configured system or
  84                                 per-interface servers in turn until
  85                                 one is found that responds. This
  86                                 setting defaults to the empty
  87                                 list.</para></listitem>
  88                         </varlistentry>
  89
  90                         <varlistentry>
  91                                 <term><varname>FallbackNTP=</varname></term>
  92                                 <listitem><para>A space separated list
  93                                 of NTP server host names or IP
  94                                 addresses to be used as the fallback
  95                                 NTP servers. Any per-interface NTP
  96                                 servers obtained from
  97                                 <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  98                                 take precedence over this setting, as
  99                                 do any servers set via
 100                                 <varname>NTP=</varname> above. This
 101                                 setting is hence only used if no other
 102                                 NTP server information is known. If
 103                                 this option is not given, a
 104                                 compiled-in list of NTP servers is
 105                                 used instead.</para></listitem>
 106                         </varlistentry>
 107
 108                 </variablelist>
 109         </refsect1>
 110
 111         <refsect1>
 112                   <title>See Also</title>
 113                   <para>
 114                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 115                         <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 116                         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 117                   </para>
 118         </refsect1>
 119
 120 </refentry>