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_adjust_system_clock = false;
42 static bool arg_no_pager = false;
43 static BusTransport arg_transport = BUS_TRANSPORT_LOCAL;
44 static bool arg_ask_password = true;
45 static char *arg_host = NULL;
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)
64 typedef struct StatusInfo {
76 static const char *jump_str(int delta_minutes, char *s, size_t size) {
77 if (delta_minutes == 60)
78 return "one hour forward";
79 if (delta_minutes == -60)
80 return "one hour backwards";
81 if (delta_minutes < 0) {
82 snprintf(s, size, "%i minutes backwards", -delta_minutes);
85 if (delta_minutes > 0) {
86 snprintf(s, size, "%i minutes forward", delta_minutes);
92 static void print_status_info(StatusInfo *i) {
93 char a[FORMAT_TIMESTAMP_MAX];
94 char b[FORMAT_TIMESTAMP_MAX];
101 bool is_dstc, is_dstn;
106 /* Enforce the values of /etc/localtime */
108 fprintf(stderr, "Warning: ignoring the TZ variable, reading the system's timezone setting only.\n\n");
112 sec = (time_t) (i->time / USEC_PER_SEC);
115 assert_se(strftime(a, sizeof(a), "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&sec, &tm)) > 0);
117 printf(" Local time: %s\n", a);
120 assert_se(strftime(a, sizeof(a), "%a %Y-%m-%d %H:%M:%S UTC", gmtime_r(&sec, &tm)) > 0);
122 printf(" Universal time: %s\n", a);
124 if (i->rtc_time > 0) {
127 rtc_sec = (time_t)(i->rtc_time / USEC_PER_SEC);
129 assert_se(strftime(a, sizeof(a), "%a %Y-%m-%d %H:%M:%S", gmtime_r(&rtc_sec, &tm)) > 0);
131 printf(" RTC time: %s\n", a);
133 printf(" RTC time: n/a\n");
136 assert_se(strftime(a, sizeof(a), "%Z, %z", localtime_r(&sec, &tm)) > 0);
138 printf(" Timezone: %s (%s)\n"
140 "NTP synchronized: %s\n"
141 " RTC in local TZ: %s\n",
142 strna(i->timezone), a,
143 i->ntp_capable ? yes_no(i->ntp_enabled) : "n/a",
144 yes_no(i->ntp_synced),
145 yes_no(i->rtc_local));
147 r = time_get_dst(sec, "/etc/localtime",
149 &tn, &dn, &zn, &is_dstn);
151 printf(" DST active: n/a\n");
153 printf(" DST active: %s\n", yes_no(is_dstc));
157 assert_se(strftime(a, sizeof(a), "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&t, &tm)) > 0);
161 assert_se(strftime(b, sizeof(b), "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&tc, &tm)) > 0);
163 printf(" Last DST change: DST %s at\n"
166 is_dstc ? "began" : "ended", a, b);
170 assert_se(strftime(a, sizeof(a), "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&t, &tm)) > 0);
174 assert_se(strftime(b, sizeof(b), "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&tn, &tm)) > 0);
176 printf(" Next DST change: DST %s (the clock jumps %s) at\n"
179 is_dstn ? "begins" : "ends", jump_str(dn, s, sizeof(s)), a, b);
186 fputs("\n" ANSI_HIGHLIGHT_ON
187 "Warning: The RTC is configured to maintain time in the local timezone. This\n"
188 " mode is not fully supported and will create various problems with time\n"
189 " zone changes and daylight saving adjustments. If at all possible use\n"
190 " RTC in UTC, by calling 'timedatectl set-local-rtc 0'" ANSI_HIGHLIGHT_OFF ".\n", stdout);
193 static int get_timedate_property_bool(sd_bus *bus, const char *name, bool *target) {
194 _cleanup_bus_message_unref_ sd_bus_message *reply = NULL;
195 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
200 r = sd_bus_get_property_trivial(
202 "org.freedesktop.timedate1",
203 "/org/freedesktop/timedate1",
204 "org.freedesktop.timedate1",
209 log_error("Failed to get property: %s %s", name, bus_error_message(&error, -r));
217 static int get_timedate_property_usec(sd_bus *bus, const char *name, usec_t *target) {
218 _cleanup_bus_message_unref_ sd_bus_message *reply = NULL;
219 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
224 r = sd_bus_get_property_trivial(
226 "org.freedesktop.timedate1",
227 "/org/freedesktop/timedate1",
228 "org.freedesktop.timedate1",
233 log_error("Failed to get property: %s %s", name, bus_error_message(&error, -r));
240 static int show_status(sd_bus *bus, char **args, unsigned n) {
241 _cleanup_bus_message_unref_ sd_bus_message *reply = NULL;
242 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
244 StatusInfo info = {};
248 r = sd_bus_get_property(
250 "org.freedesktop.timedate1",
251 "/org/freedesktop/timedate1",
252 "org.freedesktop.timedate1",
258 log_error("Failed to get property: Timezone %s", bus_error_message(&error, -r));
262 r = sd_bus_message_read(reply, "s", &info.timezone);
266 r = get_timedate_property_bool(bus, "LocalRTC", &info.rtc_local);
270 r = get_timedate_property_bool(bus, "NTP", &info.ntp_enabled);
274 r = get_timedate_property_bool(bus, "CanNTP", &info.ntp_capable);
278 r = get_timedate_property_bool(bus, "NTPSynchronized", &info.ntp_synced);
282 r = get_timedate_property_usec(bus, "TimeUSec", &info.time);
286 r = get_timedate_property_usec(bus, "RTCTimeUSec", &info.rtc_time);
290 print_status_info(&info);
294 static int set_time(sd_bus *bus, char **args, unsigned n) {
295 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
296 bool relative = false, interactive = arg_ask_password;
303 polkit_agent_open_if_enabled();
305 r = parse_timestamp(args[1], &t);
307 log_error("Failed to parse time specification: %s", args[1]);
311 r = sd_bus_call_method(bus,
312 "org.freedesktop.timedate1",
313 "/org/freedesktop/timedate1",
314 "org.freedesktop.timedate1",
318 "xbb", (int64_t)t, relative, interactive);
320 log_error("Failed to set time: %s", bus_error_message(&error, -r));
325 static int set_timezone(sd_bus *bus, char **args, unsigned n) {
326 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
332 polkit_agent_open_if_enabled();
334 r = sd_bus_call_method(bus,
335 "org.freedesktop.timedate1",
336 "/org/freedesktop/timedate1",
337 "org.freedesktop.timedate1",
341 "sb", args[1], arg_ask_password);
343 log_error("Failed to set timezone: %s", bus_error_message(&error, -r));
348 static int set_local_rtc(sd_bus *bus, char **args, unsigned n) {
349 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
355 polkit_agent_open_if_enabled();
357 b = parse_boolean(args[1]);
359 log_error("Failed to parse local RTC setting: %s", args[1]);
363 r = sd_bus_call_method(bus,
364 "org.freedesktop.timedate1",
365 "/org/freedesktop/timedate1",
366 "org.freedesktop.timedate1",
370 "bbb", b, arg_adjust_system_clock, arg_ask_password);
372 log_error("Failed to set local RTC: %s", bus_error_message(&error, -r));
377 static int set_ntp(sd_bus *bus, char **args, unsigned n) {
378 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
384 polkit_agent_open_if_enabled();
386 b = parse_boolean(args[1]);
388 log_error("Failed to parse NTP setting: %s", args[1]);
392 r = sd_bus_call_method(bus,
393 "org.freedesktop.timedate1",
394 "/org/freedesktop/timedate1",
395 "org.freedesktop.timedate1",
399 "bb", b, arg_ask_password);
401 log_error("Failed to set ntp: %s", bus_error_message(&error, -r));
406 static int list_timezones(sd_bus *bus, char **args, unsigned n) {
407 _cleanup_fclose_ FILE *f = NULL;
408 _cleanup_strv_free_ char **zones = NULL;
414 f = fopen("/usr/share/zoneinfo/zone.tab", "re");
416 log_error("Failed to open timezone database: %m");
421 char l[LINE_MAX], *p, **z, *w;
424 if (!fgets(l, sizeof(l), f)) {
428 log_error("Failed to read timezone database: %m");
434 if (isempty(p) || *p == '#')
438 /* Skip over country code */
439 p += strcspn(p, WHITESPACE);
440 p += strspn(p, WHITESPACE);
442 /* Skip over coordinates */
443 p += strcspn(p, WHITESPACE);
444 p += strspn(p, WHITESPACE);
446 /* Found timezone name */
447 k = strcspn(p, WHITESPACE);
455 z = realloc(zones, sizeof(char*) * (n_zones + 2));
462 zones[n_zones++] = w;
466 zones[n_zones] = NULL;
468 pager_open_if_enabled();
476 static int help(void) {
478 printf("%s [OPTIONS...] COMMAND ...\n\n"
479 "Query or change system time and date settings.\n\n"
480 " -h --help Show this help\n"
481 " --version Show package version\n"
482 " --adjust-system-clock\n"
483 " Adjust system clock when changing local RTC mode\n"
484 " --no-pager Do not pipe output into a pager\n"
485 " --no-ask-password Do not prompt for password\n"
486 " -H --host=[USER@]HOST Operate on remote host\n"
487 " -M --machine=CONTAINER Operate on local container\n\n"
489 " status Show current time settings\n"
490 " set-time TIME Set system time\n"
491 " set-timezone ZONE Set system timezone\n"
492 " list-timezones Show known timezones\n"
493 " set-local-rtc BOOL Control whether RTC is in local time\n"
494 " set-ntp BOOL Control whether NTP is enabled\n",
495 program_invocation_short_name);
500 static int parse_argv(int argc, char *argv[]) {
505 ARG_ADJUST_SYSTEM_CLOCK,
509 static const struct option options[] = {
510 { "help", no_argument, NULL, 'h' },
511 { "version", no_argument, NULL, ARG_VERSION },
512 { "no-pager", no_argument, NULL, ARG_NO_PAGER },
513 { "host", required_argument, NULL, 'H' },
514 { "machine", required_argument, NULL, 'M' },
515 { "no-ask-password", no_argument, NULL, ARG_NO_ASK_PASSWORD },
516 { "adjust-system-clock", no_argument, NULL, ARG_ADJUST_SYSTEM_CLOCK },
525 while ((c = getopt_long(argc, argv, "hH:M:", options, NULL)) >= 0) {
534 puts(PACKAGE_STRING);
535 puts(SYSTEMD_FEATURES);
539 arg_transport = BUS_TRANSPORT_REMOTE;
544 arg_transport = BUS_TRANSPORT_CONTAINER;
548 case ARG_NO_ASK_PASSWORD:
549 arg_ask_password = false;
552 case ARG_ADJUST_SYSTEM_CLOCK:
553 arg_adjust_system_clock = true;
564 log_error("Unknown option code %c", c);
572 static int timedatectl_main(sd_bus *bus, int argc, char *argv[]) {
574 static const struct {
582 int (* const dispatch)(sd_bus *bus, char **args, unsigned n);
584 { "status", LESS, 1, show_status },
585 { "set-time", EQUAL, 2, set_time },
586 { "set-timezone", EQUAL, 2, set_timezone },
587 { "list-timezones", EQUAL, 1, list_timezones },
588 { "set-local-rtc", EQUAL, 2, set_local_rtc },
589 { "set-ntp", EQUAL, 2, set_ntp, },
598 left = argc - optind;
601 /* Special rule: no arguments means "status" */
604 if (streq(argv[optind], "help")) {
609 for (i = 0; i < ELEMENTSOF(verbs); i++)
610 if (streq(argv[optind], verbs[i].verb))
613 if (i >= ELEMENTSOF(verbs)) {
614 log_error("Unknown operation %s", argv[optind]);
619 switch (verbs[i].argc_cmp) {
622 if (left != verbs[i].argc) {
623 log_error("Invalid number of arguments.");
630 if (left < verbs[i].argc) {
631 log_error("Too few arguments.");
638 if (left > verbs[i].argc) {
639 log_error("Too many arguments.");
646 assert_not_reached("Unknown comparison operator.");
649 return verbs[i].dispatch(bus, argv + optind, left);
652 int main(int argc, char *argv[]) {
653 int r, ret = EXIT_FAILURE;
654 _cleanup_bus_unref_ sd_bus *bus = NULL;
656 setlocale(LC_ALL, "");
657 log_parse_environment();
660 r = parse_argv(argc, argv);
668 r = bus_open_transport(arg_transport, arg_host, false, &bus);
670 log_error("Failed to create bus connection: %s", strerror(-r));
675 r = timedatectl_main(bus, argc, argv);
676 ret = r < 0 ? EXIT_FAILURE : r;