1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
4 This file is part of systemd.
6 Copyright 2012 Lennart Poettering
7 Copyright 2013 Kay Sievers
9 systemd is free software; you can redistribute it and/or modify it
10 under the terms of the GNU Lesser General Public License as published by
11 the Free Software Foundation; either version 2.1 of the License, or
12 (at your option) any later version.
14 systemd is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 Lesser General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public License
20 along with systemd; If not, see <http://www.gnu.org/licenses/>.
29 #include <sys/timex.h>
33 #include "bus-error.h"
35 #include "spawn-polkit-agent.h"
41 static bool arg_no_pager = false;
42 static bool arg_ask_password = true;
43 static BusTransport arg_transport = BUS_TRANSPORT_LOCAL;
44 static char *arg_host = NULL;
45 static bool arg_adjust_system_clock = false;
47 static void pager_open_if_enabled(void) {
55 static void polkit_agent_open_if_enabled(void) {
57 /* Open the polkit agent as a child process if necessary */
58 if (!arg_ask_password)
61 if (arg_transport != BUS_TRANSPORT_LOCAL)
67 typedef struct StatusInfo {
79 static const char *jump_str(int delta_minutes, char *s, size_t size) {
80 if (delta_minutes == 60)
81 return "one hour forward";
82 if (delta_minutes == -60)
83 return "one hour backwards";
84 if (delta_minutes < 0) {
85 snprintf(s, size, "%i minutes backwards", -delta_minutes);
88 if (delta_minutes > 0) {
89 snprintf(s, size, "%i minutes forward", delta_minutes);
95 static void print_status_info(const StatusInfo *i) {
96 char a[FORMAT_TIMESTAMP_MAX];
97 char b[FORMAT_TIMESTAMP_MAX];
101 bool have_time = false;
102 _cleanup_free_ char *zc = NULL, *zn = NULL;
105 bool is_dstc = false, is_dstn = false;
110 /* Enforce the values of /etc/localtime */
112 fprintf(stderr, "Warning: Ignoring the TZ variable. Reading the system's time zone setting only.\n\n");
117 sec = (time_t) (i->time / USEC_PER_SEC);
119 } else if (arg_transport == BUS_TRANSPORT_LOCAL) {
123 fprintf(stderr, "Warning: Could not get time from timedated and not operating locally.\n\n");
126 xstrftime(a, "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&sec, &tm));
127 printf(" Local time: %.*s\n", (int) sizeof(a), a);
129 xstrftime(a, "%a %Y-%m-%d %H:%M:%S UTC", gmtime_r(&sec, &tm));
130 printf(" Universal time: %.*s\n", (int) sizeof(a), a);
132 printf(" Local time: %s\n", "n/a");
133 printf(" Universal time: %s\n", "n/a");
136 if (i->rtc_time > 0) {
139 rtc_sec = (time_t)(i->rtc_time / USEC_PER_SEC);
140 xstrftime(a, "%a %Y-%m-%d %H:%M:%S", gmtime_r(&rtc_sec, &tm));
141 printf(" RTC time: %.*s\n", (int) sizeof(a), a);
143 printf(" RTC time: %s\n", "n/a");
146 xstrftime(a, "%Z, %z", localtime_r(&sec, &tm));
148 printf(" Time zone: %s (%.*s)\n"
150 "NTP synchronized: %s\n"
151 " RTC in local TZ: %s\n",
152 strna(i->timezone), (int) sizeof(a), have_time ? a : "n/a",
153 i->ntp_capable ? yes_no(i->ntp_enabled) : "n/a",
154 yes_no(i->ntp_synced),
155 yes_no(i->rtc_local));
158 r = time_get_dst(sec, "/etc/localtime",
160 &tn, &dn, &zn, &is_dstn);
162 printf(" DST active: %s\n", "n/a");
164 printf(" DST active: %s\n", yes_no(is_dstc));
167 xstrftime(a, "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&t, &tm));
169 xstrftime(b, "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&tc, &tm));
170 printf(" Last DST change: DST %s at\n"
173 is_dstc ? "began" : "ended",
178 xstrftime(a, "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&t, &tm));
179 xstrftime(b, "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&tn, &tm));
180 printf(" Next DST change: DST %s (the clock jumps %s) at\n"
183 is_dstn ? "begins" : "ends",
184 jump_str(dn, s, sizeof(s)),
189 printf(" DST active: %s\n", yes_no(is_dstc));
192 fputs("\n" ANSI_HIGHLIGHT_ON
193 "Warning: The system is configured to read the RTC time in the local time zone. This\n"
194 " mode can not be fully supported. It will create various problems with time\n"
195 " zone changes and daylight saving time adjustments. The RTC time is never updated,\n"
196 " it relies on external facilities to maintain it. If at all possible, use\n"
197 " RTC in UTC by calling 'timedatectl set-local-rtc 0'" ANSI_HIGHLIGHT_OFF ".\n", stdout);
200 static int show_status(sd_bus *bus, char **args, unsigned n) {
201 StatusInfo info = {};
202 static const struct bus_properties_map map[] = {
203 { "Timezone", "s", NULL, offsetof(StatusInfo, timezone) },
204 { "LocalRTC", "b", NULL, offsetof(StatusInfo, rtc_local) },
205 { "NTP", "b", NULL, offsetof(StatusInfo, ntp_enabled) },
206 { "CanNTP", "b", NULL, offsetof(StatusInfo, ntp_capable) },
207 { "NTPSynchronized", "b", NULL, offsetof(StatusInfo, ntp_synced) },
208 { "TimeUSec", "t", NULL, offsetof(StatusInfo, time) },
209 { "RTCTimeUSec", "t", NULL, offsetof(StatusInfo, rtc_time) },
216 r = bus_map_all_properties(bus,
217 "org.freedesktop.timedate1",
218 "/org/freedesktop/timedate1",
222 log_error_errno(r, "Failed to query server: %m");
226 print_status_info(&info);
233 static int set_time(sd_bus *bus, char **args, unsigned n) {
234 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
235 bool relative = false, interactive = arg_ask_password;
242 polkit_agent_open_if_enabled();
244 r = parse_timestamp(args[1], &t);
246 log_error("Failed to parse time specification: %s", args[1]);
250 r = sd_bus_call_method(bus,
251 "org.freedesktop.timedate1",
252 "/org/freedesktop/timedate1",
253 "org.freedesktop.timedate1",
257 "xbb", (int64_t)t, relative, interactive);
259 log_error("Failed to set time: %s", bus_error_message(&error, -r));
264 static int set_timezone(sd_bus *bus, char **args, unsigned n) {
265 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
271 polkit_agent_open_if_enabled();
273 r = sd_bus_call_method(bus,
274 "org.freedesktop.timedate1",
275 "/org/freedesktop/timedate1",
276 "org.freedesktop.timedate1",
280 "sb", args[1], arg_ask_password);
282 log_error("Failed to set time zone: %s", bus_error_message(&error, -r));
287 static int set_local_rtc(sd_bus *bus, char **args, unsigned n) {
288 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
294 polkit_agent_open_if_enabled();
296 b = parse_boolean(args[1]);
298 log_error("Failed to parse local RTC setting: %s", args[1]);
302 r = sd_bus_call_method(bus,
303 "org.freedesktop.timedate1",
304 "/org/freedesktop/timedate1",
305 "org.freedesktop.timedate1",
309 "bbb", b, arg_adjust_system_clock, arg_ask_password);
311 log_error("Failed to set local RTC: %s", bus_error_message(&error, -r));
316 static int set_ntp(sd_bus *bus, char **args, unsigned n) {
317 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
323 polkit_agent_open_if_enabled();
325 b = parse_boolean(args[1]);
327 log_error("Failed to parse NTP setting: %s", args[1]);
331 r = sd_bus_call_method(bus,
332 "org.freedesktop.timedate1",
333 "/org/freedesktop/timedate1",
334 "org.freedesktop.timedate1",
338 "bb", b, arg_ask_password);
340 log_error("Failed to set ntp: %s", bus_error_message(&error, -r));
345 static int list_timezones(sd_bus *bus, char **args, unsigned n) {
346 _cleanup_strv_free_ char **zones = NULL;
352 r = get_timezones(&zones);
354 return log_error_errno(r, "Failed to read list of time zones: %m");
356 pager_open_if_enabled();
362 static void help(void) {
363 printf("%s [OPTIONS...] COMMAND ...\n\n"
364 "Query or change system time and date settings.\n\n"
365 " -h --help Show this help message\n"
366 " --version Show package version\n"
367 " --no-pager Do not pipe output into a pager\n"
368 " --no-ask-password Do not prompt for password\n"
369 " -H --host=[USER@]HOST Operate on remote host\n"
370 " -M --machine=CONTAINER Operate on local container\n"
371 " --adjust-system-clock Adjust system clock when changing local RTC mode\n\n"
373 " status Show current time settings\n"
374 " set-time TIME Set system time\n"
375 " set-timezone ZONE Set system time zone\n"
376 " list-timezones Show known time zones\n"
377 " set-local-rtc BOOL Control whether RTC is in local time\n"
378 " set-ntp BOOL Control whether NTP is enabled\n",
379 program_invocation_short_name);
382 static int parse_argv(int argc, char *argv[]) {
387 ARG_ADJUST_SYSTEM_CLOCK,
391 static const struct option options[] = {
392 { "help", no_argument, NULL, 'h' },
393 { "version", no_argument, NULL, ARG_VERSION },
394 { "no-pager", no_argument, NULL, ARG_NO_PAGER },
395 { "host", required_argument, NULL, 'H' },
396 { "machine", required_argument, NULL, 'M' },
397 { "no-ask-password", no_argument, NULL, ARG_NO_ASK_PASSWORD },
398 { "adjust-system-clock", no_argument, NULL, ARG_ADJUST_SYSTEM_CLOCK },
407 while ((c = getopt_long(argc, argv, "hH:M:", options, NULL)) >= 0)
416 puts(PACKAGE_STRING);
417 puts(SYSTEMD_FEATURES);
421 arg_transport = BUS_TRANSPORT_REMOTE;
426 arg_transport = BUS_TRANSPORT_MACHINE;
430 case ARG_NO_ASK_PASSWORD:
431 arg_ask_password = false;
434 case ARG_ADJUST_SYSTEM_CLOCK:
435 arg_adjust_system_clock = true;
446 assert_not_reached("Unhandled option");
452 static int timedatectl_main(sd_bus *bus, int argc, char *argv[]) {
454 static const struct {
462 int (* const dispatch)(sd_bus *bus, char **args, unsigned n);
464 { "status", LESS, 1, show_status },
465 { "set-time", EQUAL, 2, set_time },
466 { "set-timezone", EQUAL, 2, set_timezone },
467 { "list-timezones", EQUAL, 1, list_timezones },
468 { "set-local-rtc", EQUAL, 2, set_local_rtc },
469 { "set-ntp", EQUAL, 2, set_ntp, },
478 left = argc - optind;
481 /* Special rule: no arguments means "status" */
484 if (streq(argv[optind], "help")) {
489 for (i = 0; i < ELEMENTSOF(verbs); i++)
490 if (streq(argv[optind], verbs[i].verb))
493 if (i >= ELEMENTSOF(verbs)) {
494 log_error("Unknown operation %s", argv[optind]);
499 switch (verbs[i].argc_cmp) {
502 if (left != verbs[i].argc) {
503 log_error("Invalid number of arguments.");
510 if (left < verbs[i].argc) {
511 log_error("Too few arguments.");
518 if (left > verbs[i].argc) {
519 log_error("Too many arguments.");
526 assert_not_reached("Unknown comparison operator.");
529 return verbs[i].dispatch(bus, argv + optind, left);
532 int main(int argc, char *argv[]) {
533 _cleanup_bus_close_unref_ sd_bus *bus = NULL;
536 setlocale(LC_ALL, "");
537 log_parse_environment();
540 r = parse_argv(argc, argv);
544 r = bus_open_transport(arg_transport, arg_host, false, &bus);
546 log_error_errno(r, "Failed to create bus connection: %m");
550 r = timedatectl_main(bus, argc, argv);
555 return r < 0 ? EXIT_FAILURE : EXIT_SUCCESS;