1SYSTEMD-TIMEDATED.SERVICE(8)systemd-timedated.servicSeYSTEMD-TIMEDATED.SERVICE(8)
2
3
4
6 systemd-timedated.service, systemd-timedated - Time and date bus
7 mechanism
8
10 systemd-timedated.service
11
12 /usr/lib/systemd/systemd-timedated
13
15 systemd-timedated.service is a system service that may be used as a
16 mechanism to change the system clock and timezone, as well as to
17 enable/disable network time synchronization. systemd-timedated is
18 automatically activated on request and terminates itself when it is
19 unused.
20
21 The tool timedatectl(1) is a command line client to this service.
22
23 systemd-timedated currently offers access to the following four
24 settings:
25
26 • The system time
27
28 • The system timezone
29
30 • A boolean controlling whether the system RTC is in local or UTC
31 timezone
32
33 • Whether the time synchronization service is enabled/started or
34 disabled/stopped, see next section.
35
36 See org.freedesktop.timedate1(5) and org.freedesktop.LogControl1(5) for
37 information about the D-Bus API.
38
40 systemd-timesyncd will look for files with a ".list" extension in
41 ntp-units.d/ directories. Each file is parsed as a list of unit names,
42 one per line. Empty lines and lines with comments ("#") are ignored.
43 Files are read from /usr/lib/systemd/ntp-units.d/ and the corresponding
44 directories under /etc/, /run/, /usr/local/lib/. Files in /etc/
45 override files with the same name in /run/, /usr/local/lib/, and
46 /usr/lib/. Files in /run/ override files with the same name under
47 /usr/. Packages should install their configuration files in /usr/lib/
48 (distribution packages) or /usr/local/lib/ (local installs).
49
50 Example 1. ntp-units.d/ entry for systemd-timesyncd
51
52 # /usr/lib/systemd/ntp-units.d/80-systemd-timesync.list
53 systemd-timesyncd.service
54
55 If the environment variable $SYSTEMD_TIMEDATED_NTP_SERVICES is set,
56 systemd-timesyncd will parse the contents of that variable as a
57 colon-separated list of unit names. When set, this variable overrides
58 the file-based list described above.
59
60 Example 2. An override that specifies that chronyd should be used if
61 available
62
63 SYSTEMD_TIMEDATED_NTP_SERVICES=chronyd.service:systemd-timesyncd.service
64
66 systemd(1), timedatectl(1), localtime(5), hwclock(8), systemd-
67 timesyncd(8)
68
69
70
71systemd 248 SYSTEMD-TIMEDATED.SERVICE(8)