1 <?xml version='
1.0'
?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
6 This file is part of systemd.
8 Copyright 2012 Lennart Poettering
10 systemd is free software; you can redistribute it and/or modify it
11 under the terms of the GNU Lesser General Public License as published by
12 the Free Software Foundation; either version 2.1 of the License, or
13 (at your option) any later version.
15 systemd is distributed in the hope that it will be useful, but
16 WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 Lesser General Public License for more details.
20 You should have received a copy of the GNU Lesser General Public License
21 along with systemd; If not, see <http://www.gnu.org/licenses/>.
24 <refentry id=
"timedatectl" conditional='ENABLE_TIMEDATED'
25 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
28 <title>timedatectl
</title>
29 <productname>systemd
</productname>
33 <contrib>Developer
</contrib>
34 <firstname>Lennart
</firstname>
35 <surname>Poettering
</surname>
36 <email>lennart@poettering.net
</email>
42 <refentrytitle>timedatectl
</refentrytitle>
43 <manvolnum>1</manvolnum>
47 <refname>timedatectl
</refname>
48 <refpurpose>Control the system time and date
</refpurpose>
53 <command>timedatectl
<arg choice=
"opt" rep=
"repeat">OPTIONS
</arg> <arg choice=
"req">COMMAND
</arg></command>
58 <title>Description
</title>
60 <para><command>timedatectl
</command> may be used to
61 query and change the system clock and its
66 <title>Options
</title>
68 <para>The following options are understood:
</para>
72 <term><option>--no-ask-password
</option></term>
74 <listitem><para>Do not query the user
75 for authentication for privileged
76 operations.
</para></listitem>
80 <term><option>-H
</option></term>
81 <term><option>--host=
</option></term>
83 <listitem><para>Execute the operation
84 remotely. Specify a hostname, or
85 username and hostname separated by
<literal>@
</literal>,
86 to connect to. This will use SSH to
87 talk to the remote machine manager
88 instance.
</para></listitem>
92 <term><option>-M
</option></term>
93 <term><option>--machine=
</option></term>
95 <listitem><para>Execute operation on a
96 local container. Specify a container
97 name to connect to.
</para></listitem>
101 <term><option>--adjust-system-clock
</option></term>
104 <command>set-local-rtc
</command> is
105 invoked and this option is passed, the
106 system clock is synchronized from the
107 RTC again, taking the new setting into
108 account. Otherwise, the RTC is
109 synchronized from the system
110 clock.
</para></listitem>
113 <xi:include href=
"standard-options.xml" xpointer=
"help" />
114 <xi:include href=
"standard-options.xml" xpointer=
"version" />
115 <xi:include href=
"standard-options.xml" xpointer=
"no-pager" />
118 <para>The following commands are understood:
</para>
122 <term><command>status
</command></term>
124 <listitem><para>Show current settings
125 of the system clock and
126 RTC.
</para></listitem>
130 <term><command>set-time [TIME]
</command></term>
132 <listitem><para>Set the system clock
133 to the specified time. This will also
134 update the RTC time accordingly. The time
135 may be specified in the format
137 18:17:16".
</para></listitem>
141 <term><command>set-timezone [TIMEZONE]
</command></term>
143 <listitem><para>Set the system time
144 zone to the specified value. Available
145 timezones can be listed with
146 <command>list-timezones
</command>. If
147 the RTC is configured to be in the
148 local time, this will also update the
149 RTC time. This call will alter the
150 <filename>/etc/localtime
</filename>
152 <citerefentry><refentrytitle>localtime
</refentrytitle><manvolnum>5</manvolnum></citerefentry>
154 information.
</para></listitem>
158 <term><command>list-timezones
</command></term>
160 <listitem><para>List available time
161 zones, one per line. Entries from the
162 list can be set as the system
164 <command>set-timezone
</command>.
</para></listitem>
168 <term><command>set-local-rtc [BOOL]
</command></term>
170 <listitem><para>Takes a boolean
171 argument. If
<literal>0</literal>, the
172 system is configured to maintain the
173 RTC in universal time. If
174 <literal>1</literal>, it will maintain
175 the RTC in local time instead. Note
176 that maintaining the RTC in the local
177 timezone is not fully supported and
178 will create various problems with time
179 zone changes and daylight saving
180 adjustments. If at all possible, keep the
181 RTC in UTC mode. Note that invoking this
182 will also synchronize the RTC from the
184 <option>--adjust-system-clock
</option> is
185 passed (see above). This command will
186 change the
3rd line of
187 <filename>/etc/adjtime
</filename>, as
189 <citerefentry><refentrytitle>hwclock
</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
</para></listitem>
193 <term><command>set-ntp [BOOL]
</command></term>
195 <listitem><para>Takes a boolean
196 argument. Controls whether NTP based
197 network time synchronization is
199 available).
</para></listitem>
207 <title>Exit status
</title>
209 <para>On success,
0 is returned, a non-zero failure
210 code otherwise.
</para>
213 <xi:include href=
"less-variables.xml" />
216 <title>Examples
</title>
217 <para>Show current settings:
218 <programlisting>$ timedatectl
219 Local time: Fri,
2012-
11-
02 09:
26:
46 CET
220 Universal time: Fri,
2012-
11-
02 08:
26:
46 UTC
221 RTC time: Fri,
2012-
11-
02 08:
26:
45
222 Timezone: Europe/Warsaw
228 Last DST change: CEST → CET, DST became inactive
229 Sun,
2012-
10-
28 02:
59:
59 CEST
230 Sun,
2012-
10-
28 02:
00:
00 CET
231 Next DST change: CET → CEST, DST will become active
232 the clock will jump one hour forward
233 Sun,
2013-
03-
31 01:
59:
59 CET
234 Sun,
2013-
03-
31 03:
00:
00 CEST
</programlisting>
237 <para>Enable an NTP daemon (chronyd):
238 <programlisting>$ timedatectl set-ntp true
239 ==== AUTHENTICATING FOR org.freedesktop.timedate1.set-ntp ===
240 Authentication is required to control whether network time synchronization shall be enabled.
241 Authenticating as: user
243 ==== AUTHENTICATION COMPLETE ===
</programlisting>
245 <programlisting>$ systemctl status chronyd.service
246 chronyd.service - NTP client/server
247 Loaded: loaded (/usr/lib/systemd/system/chronyd.service; enabled)
248 Active: active (running) since Fri,
2012-
11-
02 09:
36:
25 CET;
5s ago
254 <title>See Also
</title>
256 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
257 <citerefentry><refentrytitle>hwclock
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
258 <citerefentry><refentrytitle>date
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
259 <citerefentry><refentrytitle>localtime
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
260 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
261 <citerefentry><refentrytitle>systemd-timedated.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>