Debian Codegraph @

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

raw
1 '\" t
2 .TH "SYSTEMD\-TIMEDATED\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-timedated.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-timedated.service, systemd-timedated \- Time and date bus mechanism
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-timedated\&.service
27 .PP
28 /usr/lib/systemd/systemd\-timedated
29 .SH "DESCRIPTION"
30 .PP
31 systemd\-timedated\&.service
32 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\&.
33 systemd\-timedated
34 is automatically activated on request and terminates itself when it is unused\&.
35 .PP
36 The tool
37 \fBtimedatectl\fR(1)
38 is a command line client to this service\&.
39 .PP
40 systemd\-timedated
41 currently offers access to the following four settings:
42 .sp
43 .RS 4
44 .ie n \{\
45 \h'-04'\(bu\h'+03'\c
46 .\}
47 .el \{\
48 .sp -1
49 .IP \(bu 2.3
50 .\}
51 The system time
52 .RE
53 .sp
54 .RS 4
55 .ie n \{\
56 \h'-04'\(bu\h'+03'\c
57 .\}
58 .el \{\
59 .sp -1
60 .IP \(bu 2.3
61 .\}
62 The system timezone
63 .RE
64 .sp
65 .RS 4
66 .ie n \{\
67 \h'-04'\(bu\h'+03'\c
68 .\}
69 .el \{\
70 .sp -1
71 .IP \(bu 2.3
72 .\}
73 A boolean controlling whether the system RTC is in local or UTC timezone
74 .RE
75 .sp
76 .RS 4
77 .ie n \{\
78 \h'-04'\(bu\h'+03'\c
79 .\}
80 .el \{\
81 .sp -1
82 .IP \(bu 2.3
83 .\}
84 Whether the time synchronization service is enabled/started or disabled/stopped, see next section\&.
85 .RE
86 .PP
87 See
88 \fBorg.freedesktop.timedate1\fR(5)
89 and
90 \fBorg.freedesktop.LogControl1\fR(5)
91 for information about the D\-Bus API\&.
92 .SH "LIST OF NETWORK TIME SYNCHRONIZATION SERVICES"
93 .PP
94 \fBsystemd\-timedated\fR
95 will look for files with a
96 "\&.list"
97 extension in
98 ntp\-units\&.d/
99 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
100 /usr/lib/systemd/ntp\-units\&.d/
101 and the corresponding directories under
102 /etc/,
103 /run/,
104 /usr/local/lib/\&. Files in
105 /etc/
106 override files with the same name in
107 /run/,
108 /usr/local/lib/, and
109 /usr/lib/\&. Files in
110 /run/
111 override files with the same name under
112 /usr/\&. Packages should install their configuration files in
113 /usr/lib/
114 (distribution packages) or
115 /usr/local/lib/
116 (local installs)\&.
117 .PP
118 \fBExample\ \&1.\ \&ntp\-units\&.d/ entry for systemd\-timesyncd\fR
119 .sp
120 .if n \{\
121 .RS 4
122 .\}
123 .nf
124 # /usr/lib/systemd/ntp\-units\&.d/80\-systemd\-timesync\&.list
125 systemd\-timesyncd\&.service
126 .fi
127 .if n \{\
128 .RE
129 .\}
130 .PP
131 If the environment variable
132 \fI$SYSTEMD_TIMEDATED_NTP_SERVICES\fR
133 is set,
134 \fBsystemd\-timedated\fR
135 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\&.
136 .PP
137 \fBExample\ \&2.\ \&An override that specifies that chronyd should be used if available\fR
138 .sp
139 .if n \{\
140 .RS 4
141 .\}
142 .nf
143 SYSTEMD_TIMEDATED_NTP_SERVICES=chronyd\&.service:systemd\-timesyncd\&.service
144 .fi
145 .if n \{\
146 .RE
147 .\}
148 .SH "SEE ALSO"
149 .PP
150 \fBsystemd\fR(1), \fBtimedatectl\fR(1), \fBlocaltime\fR(5), \fBhwclock\fR(8), \fBsystemd-timesyncd\fR(8), \fBorg.freedesktop.timedate1\fR(5)