1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
'\" t
.TH "SYSTEMD\-TIMEDATED\&.SERVICE" "8" "" "systemd 255" "systemd-timedated.service"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
systemd-timedated.service, systemd-timedated \- Time and date bus mechanism
.SH "SYNOPSIS"
.PP
systemd\-timedated\&.service
.PP
/usr/lib/systemd/systemd\-timedated
.SH "DESCRIPTION"
.PP
systemd\-timedated\&.service
is a system service that may be used as a mechanism to change the system clock and timezone, as well as to enable/disable network time synchronization\&.
systemd\-timedated
is automatically activated on request and terminates itself when it is unused\&.
.PP
The tool
\fBtimedatectl\fR(1)
is a command line client to this service\&.
.PP
systemd\-timedated
currently offers access to the following four settings:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The system time
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The system timezone
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
A boolean controlling whether the system RTC is in local or UTC timezone
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Whether the time synchronization service is enabled/started or disabled/stopped, see next section\&.
.RE
.PP
See
\fBorg.freedesktop.timedate1\fR(5)
and
\fBorg.freedesktop.LogControl1\fR(5)
for information about the D\-Bus API\&.
.SH "LIST OF NETWORK TIME SYNCHRONIZATION SERVICES"
.PP
\fBsystemd\-timedated\fR
will look for files with a
"\&.list"
extension in
ntp\-units\&.d/
directories\&. Each file is parsed as a list of unit names, one per line\&. Empty lines and lines with comments ("#") are ignored\&. Files are read from
/usr/lib/systemd/ntp\-units\&.d/
and the corresponding directories under
/etc/,
/run/,
/usr/local/lib/\&. Files in
/etc/
override files with the same name in
/run/,
/usr/local/lib/, and
/usr/lib/\&. Files in
/run/
override files with the same name under
/usr/\&. Packages should install their configuration files in
/usr/lib/
(distribution packages) or
/usr/local/lib/
(local installs)\&.
.PP
\fBExample\ \&1.\ \&ntp\-units\&.d/ entry for systemd\-timesyncd\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# /usr/lib/systemd/ntp\-units\&.d/80\-systemd\-timesync\&.list
systemd\-timesyncd\&.service
.fi
.if n \{\
.RE
.\}
.PP
If the environment variable
\fI$SYSTEMD_TIMEDATED_NTP_SERVICES\fR
is set,
\fBsystemd\-timedated\fR
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\&.
.PP
\fBExample\ \&2.\ \&An override that specifies that chronyd should be used if available\fR
.sp
.if n \{\
.RS 4
.\}
.nf
SYSTEMD_TIMEDATED_NTP_SERVICES=chronyd\&.service:systemd\-timesyncd\&.service
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
\fBsystemd\fR(1),
\fBtimedatectl\fR(1),
\fBlocaltime\fR(5),
\fBhwclock\fR(8),
\fBsystemd-timesyncd\fR(8)
|
