]>
Commit | Line | Data |
---|---|---|
5eef597e | 1 | '\" t |
86f210e9 | 2 | .TH "TIMESYNCD\&.CONF" "5" "" "systemd 221" "timesyncd.conf" |
5eef597e MP |
3 | .\" ----------------------------------------------------------------- |
4 | .\" * Define some portability stuff | |
5 | .\" ----------------------------------------------------------------- | |
6 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
7 | .\" http://bugs.debian.org/507673 | |
8 | .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html | |
9 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
10 | .ie \n(.g .ds Aq \(aq | |
11 | .el .ds Aq ' | |
12 | .\" ----------------------------------------------------------------- | |
13 | .\" * set default formatting | |
14 | .\" ----------------------------------------------------------------- | |
15 | .\" disable hyphenation | |
16 | .nh | |
17 | .\" disable justification (adjust text to left margin only) | |
18 | .ad l | |
19 | .\" ----------------------------------------------------------------- | |
20 | .\" * MAIN CONTENT STARTS HERE * | |
21 | .\" ----------------------------------------------------------------- | |
22 | .SH "NAME" | |
f47781d8 | 23 | timesyncd.conf, timesyncd.conf.d \- Network Time Synchronization configuration files |
5eef597e MP |
24 | .SH "SYNOPSIS" |
25 | .PP | |
26 | /etc/systemd/timesyncd\&.conf | |
f47781d8 MP |
27 | .PP |
28 | /etc/systemd/timesyncd\&.conf\&.d/*\&.conf | |
29 | .PP | |
30 | /run/systemd/timesyncd\&.conf\&.d/*\&.conf | |
31 | .PP | |
32 | /usr/lib/systemd/timesyncd\&.conf\&.d/*\&.conf | |
5eef597e MP |
33 | .SH "DESCRIPTION" |
34 | .PP | |
f47781d8 MP |
35 | These configuration files control NTP network time synchronization\&. |
36 | .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" | |
37 | .PP | |
e3bff60a MP |
38 | Default configuration is defined during compilation, so a configuration file is only needed when it is necessary to deviate from those defaults\&. By default the configuration file in |
39 | /etc/systemd/ | |
40 | contains commented out entries showing the defaults as a guide to the administrator\&. This file can be edited to create local overrides\&. | |
f47781d8 | 41 | .PP |
e3bff60a MP |
42 | When packages need to customize the configuration, they can install configuration snippets in |
43 | /usr/lib/systemd/*\&.conf\&.d/\&. Files in | |
f47781d8 | 44 | /etc/ |
e3bff60a MP |
45 | are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. The main configuration file is read before any of the configuration directories, and has the lowest precedence; entries in a file in any configuration directory override entries in the single configuration file\&. Files in the |
46 | *\&.conf\&.d/ | |
47 | configuration subdirectories are sorted by their filename in lexicographic order, regardless of which of the subdirectories they reside in\&. If multiple files specify the same option, the entry in the file with the lexicographically latest name takes precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. | |
f47781d8 | 48 | .PP |
e3bff60a | 49 | To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to |
f47781d8 MP |
50 | /dev/null |
51 | in the configuration directory in | |
52 | /etc/, with the same filename as the vendor configuration file\&. | |
5eef597e MP |
53 | .SH "OPTIONS" |
54 | .PP | |
55 | \fINTP=\fR | |
56 | .RS 4 | |
86f210e9 MP |
57 | A space separated list of NTP server host names or IP addresses\&. During runtime this list is combined with any per\-interface NTP servers acquired from |
58 | \fBsystemd-networkd.service\fR(8)\&. systemd\-timesyncd will contact all configured system or per\-interface servers in turn until one is found that responds\&. This setting defaults to an empty list\&. | |
5eef597e MP |
59 | .RE |
60 | .PP | |
61 | \fIFallbackNTP=\fR | |
62 | .RS 4 | |
63 | A space separated list of NTP server host names or IP addresses to be used as the fallback NTP servers\&. Any per\-interface NTP servers obtained from | |
64 | \fBsystemd-networkd.service\fR(8) | |
65 | take precedence over this setting, as do any servers set via | |
66 | \fINTP=\fR | |
67 | above\&. This setting is hence only used if no other NTP server information is known\&. If this option is not given, a compiled\-in list of NTP servers is used instead\&. | |
68 | .RE | |
69 | .SH "SEE ALSO" | |
70 | .PP | |
71 | \fBsystemd\fR(1), | |
72 | \fBsystemd-timesyncd.service\fR(8), | |
73 | \fBsystemd-networkd.service\fR(8) |