'\" t .TH "SYSTEMD\-TIMEDATED\&.SERVICE" "8" "" "systemd 256.7" "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)