Debian Codegraph @

upstream/debian-unstable/man8/systemd-timesyncd.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-TIMESYNCD\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-timesyncd.service"
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"
23 systemd-timesyncd.service, systemd-timesyncd \- Network Time Synchronization
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-timesyncd\&.service
27 .PP
28 /usr/lib/systemd/systemd\-timesyncd
29 .SH "DESCRIPTION"
30 .PP
31 systemd\-timesyncd\&.service
32 is a system service that may be used to synchronize the local system clock with a remote Network Time Protocol (NTP) server\&. It also saves the local time to disk every time the clock has been synchronized and uses this to possibly advance the system realtime clock on subsequent reboots to ensure it (roughly) monotonically advances even if the system lacks a battery\-buffered RTC chip\&.
33 .PP
34 The
35 systemd\-timesyncd\&.service
36 service implements SNTP only\&. This minimalistic service will step the system clock for large offsets or slowly adjust it for smaller deltas\&. Complex use cases that require full NTP support (and where SNTP is not sufficient) are not covered by
37 systemd\-timesyncd\&.service\&.
38 .PP
39 The NTP servers contacted are determined from the global settings in
40 \fBtimesyncd.conf\fR(5), the per\-link static settings in
41 \&.network
42 files, and the per\-link dynamic settings received over DHCP\&. See
43 \fBsystemd.network\fR(5)
44 for further details\&.
45 .PP
46 \fBtimedatectl\fR(1)\*(Aqs
47 \fBset\-ntp\fR
48 command may be used to enable and start, or disable and stop this service\&.
49 .PP
50 \fBtimedatectl\fR(1)\*(Aqs
51 \fBtimesync\-status\fR
52 or
53 \fBshow\-timesync\fR
54 command can be used to show the current status of this service\&.
55 .PP
56 Initialization of
57 systemd\-timesyncd\&.service
58 delays the start of units that are ordered after
59 time\-set\&.target
60 (see
61 \fBsystemd.special\fR(7)
62 for details) until the local time has been updated from
63 /var/lib/systemd/timesync/clock
64 (see below) in order to make it roughly monotonic\&. It does not delay other units until synchronization with an accurate reference time sources has been reached\&. Use
65 \fBsystemd-time-wait-sync.service\fR(8)
66 to achieve that, which will delay start of units that are ordered after
67 time\-sync\&.target
68 until synchronization to an accurate reference clock is reached\&.
69 .PP
70 \fBsystemd\fR
71 and
72 \fBsystemd\-timesyncd\fR
73 advance the system clock to the "epoch" (the lowest date above which the system clock time is assumed to be set correctly)\&. See "System clock epoch" section in
74 \fBsystemd\fR(1)
75 for details\&.
76 \fBsystemd\fR
77 will set the clock when initializing, but
78 /var/lib/systemd/timesync/clock
79 might not yet be available at that point\&.
80 \fBsystemd\-timesyncd\fR
81 will advance the clock when it is started and notices that the system clock is before the modification time of
82 /var/lib/systemd/timesync/clock\&.
83 .SH "FILES"
84 .PP
85 /var/lib/systemd/timesync/clock
86 .RS 4
87 The modification time ("mtime") of this file is updated on each successful NTP synchronization or after each
88 \fISaveIntervalSec=\fR
89 time interval, as specified in
90 \fBtimesyncd.conf\fR(5)\&.
91 .sp
92 If present, the modification time of this file is used for the epoch by
93 \fBsystemd\fR(1)
94 and
95 systemd\-timesyncd\&.service\&.
96 .sp
97 Added in version 219\&.
98 .RE
99 .PP
100 /run/systemd/timesync/synchronized
101 .RS 4
102 A file that is touched on each successful synchronization to assist
103 \fBsystemd-time-wait-sync.service\fR(8)
104 service and other applications in detecting synchronization to an accurate reference clock\&.
105 .sp
106 Added in version 239\&.
107 .RE
108 .SH "SEE ALSO"
109 .PP
110 \fBsystemd\fR(1), \fBtimesyncd.conf\fR(5), \fBsystemd.network\fR(5), \fBsystemd-networkd.service\fR(8), \fBsystemd-time-wait-sync.service\fR(8), \fBsystemd.special\fR(7), \fBtimedatectl\fR(1), \fBlocaltime\fR(5), \fBhwclock\fR(8)