src/timedate/timedatectl.c

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2
   3 #include <getopt.h>
   4 #include <locale.h>
   5 #include <math.h>
   6 #include <stdbool.h>
   7 #include <stdlib.h>
   8
   9 #include "sd-bus.h"
  10
  11 #include "bus-error.h"
  12 #include "bus-util.h"
  13 #include "in-addr-util.h"
  14 #include "main-func.h"
  15 #include "pager.h"
  16 #include "parse-util.h"
  17 #include "pretty-print.h"
  18 #include "spawn-polkit-agent.h"
  19 #include "sparse-endian.h"
  20 #include "string-table.h"
  21 #include "strv.h"
  22 #include "terminal-util.h"
  23 #include "util.h"
  24 #include "verbs.h"
  25
  26 static PagerFlags arg_pager_flags = 0;
  27 static bool arg_ask_password = true;
  28 static BusTransport arg_transport = BUS_TRANSPORT_LOCAL;
  29 static char *arg_host = NULL;
  30 static bool arg_adjust_system_clock = false;
  31 static bool arg_monitor = false;
  32 static char **arg_property = NULL;
  33 static bool arg_value = false;
  34 static bool arg_all = false;
  35
  36 typedef struct StatusInfo {
  37         usec_t time;
  38         const char *timezone;
  39
  40         usec_t rtc_time;
  41         bool rtc_local;
  42
  43         bool ntp_capable;
  44         bool ntp_active;
  45         bool ntp_synced;
  46 } StatusInfo;
  47
  48 static void print_status_info(const StatusInfo *i) {
  49         const char *old_tz = NULL, *tz;
  50         bool have_time = false;
  51         char a[LINE_MAX];
  52         struct tm tm;
  53         time_t sec;
  54         size_t n;
  55         int r;
  56
  57         assert(i);
  58
  59         /* Save the old $TZ */
  60         tz = getenv("TZ");
  61         if (tz)
  62                 old_tz = strdupa(tz);
  63
  64         /* Set the new $TZ */
  65         if (setenv("TZ", isempty(i->timezone) ? "UTC" : i->timezone, true) < 0)
  66                 log_warning_errno(errno, "Failed to set TZ environment variable, ignoring: %m");
  67         else
  68                 tzset();
  69
  70         if (i->time != 0) {
  71                 sec = (time_t) (i->time / USEC_PER_SEC);
  72                 have_time = true;
  73         } else if (IN_SET(arg_transport, BUS_TRANSPORT_LOCAL, BUS_TRANSPORT_MACHINE)) {
  74                 sec = time(NULL);
  75                 have_time = true;
  76         } else
  77                 log_warning("Could not get time from timedated and not operating locally, ignoring.");
  78
  79         if (have_time) {
  80                 n = strftime(a, sizeof a, "%a %Y-%m-%d %H:%M:%S %Z", localtime_r(&sec, &tm));
  81                 printf("               Local time: %s\n", n > 0 ? a : "n/a");
  82
  83                 n = strftime(a, sizeof a, "%a %Y-%m-%d %H:%M:%S UTC", gmtime_r(&sec, &tm));
  84                 printf("           Universal time: %s\n", n > 0 ? a : "n/a");
  85         } else {
  86                 printf("               Local time: %s\n", "n/a");
  87                 printf("           Universal time: %s\n", "n/a");
  88         }
  89
  90         if (i->rtc_time > 0) {
  91                 time_t rtc_sec;
  92
  93                 rtc_sec = (time_t) (i->rtc_time / USEC_PER_SEC);
  94                 n = strftime(a, sizeof a, "%a %Y-%m-%d %H:%M:%S", gmtime_r(&rtc_sec, &tm));
  95                 printf("                 RTC time: %s\n", n > 0 ? a : "n/a");
  96         } else
  97                 printf("                 RTC time: %s\n", "n/a");
  98
  99         if (have_time)
 100                 n = strftime(a, sizeof a, "%Z, %z", localtime_r(&sec, &tm));
 101
 102         /* Restore the $TZ */
 103         if (old_tz)
 104                 r = setenv("TZ", old_tz, true);
 105         else
 106                 r = unsetenv("TZ");
 107         if (r < 0)
 108                 log_warning_errno(errno, "Failed to set TZ environment variable, ignoring: %m");
 109         else
 110                 tzset();
 111
 112         printf("                Time zone: %s (%s)\n"
 113                "System clock synchronized: %s\n"
 114                "              NTP service: %s\n"
 115                "          RTC in local TZ: %s\n",
 116                strna(i->timezone), have_time && n > 0 ? a : "n/a",
 117                yes_no(i->ntp_synced),
 118                i->ntp_capable ? (i->ntp_active ? "active" : "inactive") : "n/a",
 119                yes_no(i->rtc_local));
 120
 121         if (i->rtc_local)
 122                 printf("\n%s"
 123                        "Warning: The system is configured to read the RTC time in the local time zone.\n"
 124                        "         This mode cannot be fully supported. It will create various problems\n"
 125                        "         with time zone changes and daylight saving time adjustments. The RTC\n"
 126                        "         time is never updated, it relies on external facilities to maintain it.\n"
 127                        "         If at all possible, use RTC in UTC by calling\n"
 128                        "         'timedatectl set-local-rtc 0'.%s\n", ansi_highlight(), ansi_normal());
 129 }
 130
 131 static int show_status(int argc, char **argv, void *userdata) {
 132         StatusInfo info = {};
 133         static const struct bus_properties_map map[]  = {
 134                 { "Timezone",        "s", NULL, offsetof(StatusInfo, timezone)    },
 135                 { "LocalRTC",        "b", NULL, offsetof(StatusInfo, rtc_local)   },
 136                 { "NTP",             "b", NULL, offsetof(StatusInfo, ntp_active)  },
 137                 { "CanNTP",          "b", NULL, offsetof(StatusInfo, ntp_capable) },
 138                 { "NTPSynchronized", "b", NULL, offsetof(StatusInfo, ntp_synced)  },
 139                 { "TimeUSec",        "t", NULL, offsetof(StatusInfo, time)        },
 140                 { "RTCTimeUSec",     "t", NULL, offsetof(StatusInfo, rtc_time)    },
 141                 {}
 142         };
 143
 144         _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
 145         _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
 146         sd_bus *bus = userdata;
 147         int r;
 148
 149         assert(bus);
 150
 151         r = bus_map_all_properties(bus,
 152                                    "org.freedesktop.timedate1",
 153                                    "/org/freedesktop/timedate1",
 154                                    map,
 155                                    BUS_MAP_BOOLEAN_AS_BOOL,
 156                                    &error,
 157                                    &m,
 158                                    &info);
 159         if (r < 0)
 160                 return log_error_errno(r, "Failed to query server: %s", bus_error_message(&error, r));
 161
 162         print_status_info(&info);
 163
 164         return r;
 165 }
 166
 167 static int show_properties(int argc, char **argv, void *userdata) {
 168         sd_bus *bus = userdata;
 169         int r;
 170
 171         assert(bus);
 172
 173         r = bus_print_all_properties(bus,
 174                                      "org.freedesktop.timedate1",
 175                                      "/org/freedesktop/timedate1",
 176                                      NULL,
 177                                      arg_property,
 178                                      arg_value,
 179                                      arg_all,
 180                                      NULL);
 181         if (r < 0)
 182                 return bus_log_parse_error(r);
 183
 184         return 0;
 185 }
 186
 187 static int set_time(int argc, char **argv, void *userdata) {
 188         _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
 189         bool relative = false, interactive = arg_ask_password;
 190         sd_bus *bus = userdata;
 191         usec_t t;
 192         int r;
 193
 194         polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
 195
 196         r = parse_timestamp(argv[1], &t);
 197         if (r < 0)
 198                 return log_error_errno(r, "Failed to parse time specification '%s': %m", argv[1]);
 199
 200         r = sd_bus_call_method(bus,
 201                                "org.freedesktop.timedate1",
 202                                "/org/freedesktop/timedate1",
 203                                "org.freedesktop.timedate1",
 204                                "SetTime",
 205                                &error,
 206                                NULL,
 207                                "xbb", (int64_t) t, relative, interactive);
 208         if (r < 0)
 209                 return log_error_errno(r, "Failed to set time: %s", bus_error_message(&error, r));
 210
 211         return 0;
 212 }
 213
 214 static int set_timezone(int argc, char **argv, void *userdata) {
 215         _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
 216         sd_bus *bus = userdata;
 217         int r;
 218
 219         polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
 220
 221         r = sd_bus_call_method(bus,
 222                                "org.freedesktop.timedate1",
 223                                "/org/freedesktop/timedate1",
 224                                "org.freedesktop.timedate1",
 225                                "SetTimezone",
 226                                &error,
 227                                NULL,
 228                                "sb", argv[1], arg_ask_password);
 229         if (r < 0)
 230                 return log_error_errno(r, "Failed to set time zone: %s", bus_error_message(&error, r));
 231
 232         return 0;
 233 }
 234
 235 static int set_local_rtc(int argc, char **argv, void *userdata) {
 236         _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
 237         sd_bus *bus = userdata;
 238         int r, b;
 239
 240         polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
 241
 242         b = parse_boolean(argv[1]);
 243         if (b < 0)
 244                 return log_error_errno(b, "Failed to parse local RTC setting '%s': %m", argv[1]);
 245
 246         r = sd_bus_call_method(bus,
 247                                "org.freedesktop.timedate1",
 248                                "/org/freedesktop/timedate1",
 249                                "org.freedesktop.timedate1",
 250                                "SetLocalRTC",
 251                                &error,
 252                                NULL,
 253                                "bbb", b, arg_adjust_system_clock, arg_ask_password);
 254         if (r < 0)
 255                 return log_error_errno(r, "Failed to set local RTC: %s", bus_error_message(&error, r));
 256
 257         return 0;
 258 }
 259
 260 static int set_ntp(int argc, char **argv, void *userdata) {
 261         _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
 262         sd_bus *bus = userdata;
 263         int b, r;
 264
 265         polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
 266
 267         b = parse_boolean(argv[1]);
 268         if (b < 0)
 269                 return log_error_errno(b, "Failed to parse NTP setting '%s': %m", argv[1]);
 270
 271         r = sd_bus_call_method(bus,
 272                                "org.freedesktop.timedate1",
 273                                "/org/freedesktop/timedate1",
 274                                "org.freedesktop.timedate1",
 275                                "SetNTP",
 276                                &error,
 277                                NULL,
 278                                "bb", b, arg_ask_password);
 279         if (r < 0)
 280                 return log_error_errno(r, "Failed to set ntp: %s", bus_error_message(&error, r));
 281
 282         return 0;
 283 }
 284
 285 static int list_timezones(int argc, char **argv, void *userdata) {
 286         _cleanup_strv_free_ char **zones = NULL;
 287         int r;
 288
 289         r = get_timezones(&zones);
 290         if (r < 0)
 291                 return log_error_errno(r, "Failed to read list of time zones: %m");
 292
 293         (void) pager_open(arg_pager_flags);
 294         strv_print(zones);
 295
 296         return 0;
 297 }
 298
 299 typedef struct NTPStatusInfo {
 300         const char *server_name;
 301         char *server_address;
 302         usec_t poll_interval, poll_max, poll_min;
 303         usec_t root_distance_max;
 304
 305         uint32_t leap, version, mode, stratum;
 306         int32_t precision;
 307         usec_t root_delay, root_dispersion;
 308         union {
 309                 char str[5];
 310                 uint32_t val;
 311         } reference;
 312         usec_t origin, recv, trans, dest;
 313
 314         bool spike;
 315         uint64_t packet_count;
 316         usec_t jitter;
 317
 318         int64_t freq;
 319 } NTPStatusInfo;
 320
 321 static void ntp_status_info_clear(NTPStatusInfo *p) {
 322         p->server_address = mfree(p->server_address);
 323 }
 324
 325 static const char * const ntp_leap_table[4] = {
 326         [0] = "normal",
 327         [1] = "last minute of the day has 61 seconds",
 328         [2] = "last minute of the day has 59 seconds",
 329         [3] = "not synchronized",
 330 };
 331
 332 #pragma GCC diagnostic push
 333 #pragma GCC diagnostic ignored "-Wtype-limits"
 334 DEFINE_PRIVATE_STRING_TABLE_LOOKUP_TO_STRING(ntp_leap, uint32_t);
 335 #pragma GCC diagnostic pop
 336
 337 static void print_ntp_status_info(NTPStatusInfo *i) {
 338         char ts[FORMAT_TIMESPAN_MAX], tmin[FORMAT_TIMESPAN_MAX], tmax[FORMAT_TIMESPAN_MAX];
 339         usec_t delay, t14, t23, offset, root_distance;
 340         bool offset_sign;
 341
 342         assert(i);
 343
 344         /*
 345          * "Timestamp Name          ID   When Generated
 346          *  ------------------------------------------------------------
 347          *  Originate Timestamp     T1   time request sent by client
 348          *  Receive Timestamp       T2   time request received by server
 349          *  Transmit Timestamp      T3   time reply sent by server
 350          *  Destination Timestamp   T4   time reply received by client
 351          *
 352          *  The round-trip delay, d, and system clock offset, t, are defined as:
 353          *  d = (T4 - T1) - (T3 - T2)     t = ((T2 - T1) + (T3 - T4)) / 2"
 354          */
 355
 356         printf("       Server: %s (%s)\n",
 357                i->server_address, i->server_name);
 358         printf("Poll interval: %s (min: %s; max %s)\n",
 359                format_timespan(ts, sizeof(ts), i->poll_interval, 0),
 360                format_timespan(tmin, sizeof(tmin), i->poll_min, 0),
 361                format_timespan(tmax, sizeof(tmax), i->poll_max, 0));
 362
 363         if (i->packet_count == 0) {
 364                 printf(" Packet count: 0\n");
 365                 return;
 366         }
 367
 368         if (i->dest < i->origin || i->trans < i->recv || i->dest - i->origin < i->trans - i->recv) {
 369                 log_error("Invalid NTP response");
 370                 return;
 371         }
 372
 373         delay = (i->dest - i->origin) - (i->trans - i->recv);
 374
 375         t14 = i->origin + i->dest;
 376         t23 = i->recv + i->trans;
 377         offset_sign = t14 < t23;
 378         offset = (offset_sign ? t23 - t14 : t14 - t23) / 2;
 379
 380         root_distance = i->root_delay / 2 + i->root_dispersion;
 381
 382         printf("         Leap: %s\n"
 383                "      Version: %" PRIu32 "\n"
 384                "      Stratum: %" PRIu32 "\n",
 385                ntp_leap_to_string(i->leap),
 386                i->version,
 387                i->stratum);
 388         if (i->stratum <= 1)
 389                 printf("    Reference: %s\n", i->reference.str);
 390         else
 391                 printf("    Reference: %" PRIX32 "\n", be32toh(i->reference.val));
 392         printf("    Precision: %s (%" PRIi32 ")\n",
 393                format_timespan(ts, sizeof(ts), DIV_ROUND_UP((nsec_t) (exp2(i->precision) * NSEC_PER_SEC), NSEC_PER_USEC), 0),
 394                i->precision);
 395         printf("Root distance: %s (max: %s)\n",
 396                format_timespan(ts, sizeof(ts), root_distance, 0),
 397                format_timespan(tmax, sizeof(tmax), i->root_distance_max, 0));
 398         printf("       Offset: %s%s\n",
 399                offset_sign ? "+" : "-",
 400                format_timespan(ts, sizeof(ts), offset, 0));
 401         printf("        Delay: %s\n",
 402                format_timespan(ts, sizeof(ts), delay, 0));
 403         printf("       Jitter: %s\n",
 404                format_timespan(ts, sizeof(ts), i->jitter, 0));
 405         printf(" Packet count: %" PRIu64 "\n", i->packet_count);
 406
 407         if (!i->spike)
 408                 printf("    Frequency: %+.3fppm\n",
 409                        (double) i->freq / 0x10000);
 410 }
 411
 412 static int map_server_address(sd_bus *bus, const char *member, sd_bus_message *m, sd_bus_error *error, void *userdata) {
 413         char **p = (char **) userdata;
 414         const void *d;
 415         int family, r;
 416         size_t sz;
 417
 418         assert(p);
 419
 420         r = sd_bus_message_enter_container(m, 'r', "iay");
 421         if (r < 0)
 422                 return r;
 423
 424         r = sd_bus_message_read(m, "i", &family);
 425         if (r < 0)
 426                 return r;
 427
 428         r = sd_bus_message_read_array(m, 'y', &d, &sz);
 429         if (r < 0)
 430                 return r;
 431
 432         r = sd_bus_message_exit_container(m);
 433         if (r < 0)
 434                 return r;
 435
 436         if (sz == 0 && family == AF_UNSPEC) {
 437                 *p = mfree(*p);
 438                 return 0;
 439         }
 440
 441         if (!IN_SET(family, AF_INET, AF_INET6)) {
 442                 log_error("Unknown address family %i", family);
 443                 return -EINVAL;
 444         }
 445
 446         if (sz != FAMILY_ADDRESS_SIZE(family)) {
 447                 log_error("Invalid address size");
 448                 return -EINVAL;
 449         }
 450
 451         r = in_addr_to_string(family, d, p);
 452         if (r < 0)
 453                 return r;
 454
 455         return 0;
 456 }
 457
 458 static int map_ntp_message(sd_bus *bus, const char *member, sd_bus_message *m, sd_bus_error *error, void *userdata) {
 459         NTPStatusInfo *p = userdata;
 460         const void *d;
 461         size_t sz;
 462         int32_t b;
 463         int r;
 464
 465         assert(p);
 466
 467         r = sd_bus_message_enter_container(m, 'r', "uuuuittayttttbtt");
 468         if (r < 0)
 469                 return r;
 470
 471         r = sd_bus_message_read(m, "uuuuitt",
 472                                 &p->leap, &p->version, &p->mode, &p->stratum, &p->precision,
 473                                 &p->root_delay, &p->root_dispersion);
 474         if (r < 0)
 475                 return r;
 476
 477         r = sd_bus_message_read_array(m, 'y', &d, &sz);
 478         if (r < 0)
 479                 return r;
 480
 481         r = sd_bus_message_read(m, "ttttbtt",
 482                                 &p->origin, &p->recv, &p->trans, &p->dest,
 483                                 &b, &p->packet_count, &p->jitter);
 484         if (r < 0)
 485                 return r;
 486
 487         r = sd_bus_message_exit_container(m);
 488         if (r < 0)
 489                 return r;
 490
 491         if (sz != 4)
 492                 return -EINVAL;
 493
 494         memcpy(p->reference.str, d, sz);
 495
 496         p->spike = b;
 497
 498         return 0;
 499 }
 500
 501 static int show_timesync_status_once(sd_bus *bus) {
 502         static const struct bus_properties_map map_timesync[]  = {
 503                 { "ServerName",           "s",                  NULL,               offsetof(NTPStatusInfo, server_name)       },
 504                 { "ServerAddress",        "(iay)",              map_server_address, offsetof(NTPStatusInfo, server_address)    },
 505                 { "PollIntervalUSec",     "t",                  NULL,               offsetof(NTPStatusInfo, poll_interval)     },
 506                 { "PollIntervalMinUSec",  "t",                  NULL,               offsetof(NTPStatusInfo, poll_min)          },
 507                 { "PollIntervalMaxUSec",  "t",                  NULL,               offsetof(NTPStatusInfo, poll_max)          },
 508                 { "RootDistanceMaxUSec",  "t",                  NULL,               offsetof(NTPStatusInfo, root_distance_max) },
 509                 { "NTPMessage",           "(uuuuittayttttbtt)", map_ntp_message,    0                                          },
 510                 { "Frequency",            "x",                  NULL,               offsetof(NTPStatusInfo, freq)              },
 511                 {}
 512         };
 513         _cleanup_(ntp_status_info_clear) NTPStatusInfo info = {};
 514         _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
 515         _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
 516         int r;
 517
 518         assert(bus);
 519
 520         r = bus_map_all_properties(bus,
 521                                    "org.freedesktop.timesync1",
 522                                    "/org/freedesktop/timesync1",
 523                                    map_timesync,
 524                                    BUS_MAP_BOOLEAN_AS_BOOL,
 525                                    &error,
 526                                    &m,
 527                                    &info);
 528         if (r < 0)
 529                 return log_error_errno(r, "Failed to query server: %s", bus_error_message(&error, r));
 530
 531         if (arg_monitor && !terminal_is_dumb())
 532                 fputs(ANSI_HOME_CLEAR, stdout);
 533
 534         print_ntp_status_info(&info);
 535
 536         return 0;
 537 }
 538
 539 static int on_properties_changed(sd_bus_message *m, void *userdata, sd_bus_error *error) {
 540         const char *name;
 541         int r;
 542
 543         assert(m);
 544
 545         r = sd_bus_message_read(m, "s", &name);
 546         if (r < 0)
 547                 return log_error_errno(r, "Failed to read interface name: %m");
 548
 549         if (!streq_ptr(name, "org.freedesktop.timesync1.Manager"))
 550                 return 0;
 551
 552         return show_timesync_status_once(sd_bus_message_get_bus(m));
 553 }
 554
 555 static int show_timesync_status(int argc, char **argv, void *userdata) {
 556         _cleanup_(sd_event_unrefp) sd_event *event = NULL;
 557         sd_bus *bus = userdata;
 558         int r;
 559
 560         assert(bus);
 561
 562         r = show_timesync_status_once(bus);
 563         if (r < 0)
 564                 return r;
 565
 566         if (!arg_monitor)
 567                 return 0;
 568
 569         r = sd_event_default(&event);
 570         if (r < 0)
 571                 return log_error_errno(r, "Failed to get event loop: %m");
 572
 573         r = sd_bus_match_signal(bus,
 574                                 NULL,
 575                                 "org.freedesktop.timesync1",
 576                                 "/org/freedesktop/timesync1",
 577                                 "org.freedesktop.DBus.Properties",
 578                                 "PropertiesChanged",
 579                                 on_properties_changed, NULL);
 580         if (r < 0)
 581                 return log_error_errno(r, "Failed to request match for PropertiesChanged signal: %m");
 582
 583         r = sd_bus_attach_event(bus, event, SD_EVENT_PRIORITY_NORMAL);
 584         if (r < 0)
 585                 return log_error_errno(r, "Failed to attach bus to event loop: %m");
 586
 587         r = sd_event_loop(event);
 588         if (r < 0)
 589                 return log_error_errno(r, "Failed to run event loop: %m");
 590
 591         return 0;
 592 }
 593
 594 static int print_timesync_property(const char *name, const char *expected_value, sd_bus_message *m, bool value, bool all) {
 595         char type;
 596         const char *contents;
 597         int r;
 598
 599         assert(name);
 600         assert(m);
 601
 602         r = sd_bus_message_peek_type(m, &type, &contents);
 603         if (r < 0)
 604                 return r;
 605
 606         switch (type) {
 607
 608         case SD_BUS_TYPE_STRUCT:
 609                 if (streq(name, "NTPMessage")) {
 610                         _cleanup_(ntp_status_info_clear) NTPStatusInfo i = {};
 611                         char ts[FORMAT_TIMESPAN_MAX], stamp[FORMAT_TIMESTAMP_MAX];
 612
 613                         r = map_ntp_message(NULL, NULL, m, NULL, &i);
 614                         if (r < 0)
 615                                 return r;
 616
 617                         if (i.packet_count == 0)
 618                                 return 1;
 619
 620                         if (!value) {
 621                                 fputs(name, stdout);
 622                                 fputc('=', stdout);
 623                         }
 624
 625                         printf("{ Leap=%u, Version=%u, Mode=%u, Stratum=%u, Precision=%i,",
 626                                i.leap, i.version, i.mode, i.stratum, i.precision);
 627                         printf(" RootDelay=%s,",
 628                                format_timespan(ts, sizeof(ts), i.root_delay, 0));
 629                         printf(" RootDispersion=%s,",
 630                                format_timespan(ts, sizeof(ts), i.root_dispersion, 0));
 631
 632                         if (i.stratum == 1)
 633                                 printf(" Reference=%s,", i.reference.str);
 634                         else
 635                                 printf(" Reference=%" PRIX32 ",", be32toh(i.reference.val));
 636
 637                         printf(" OriginateTimestamp=%s,",
 638                                format_timestamp(stamp, sizeof(stamp), i.origin));
 639                         printf(" ReceiveTimestamp=%s,",
 640                                format_timestamp(stamp, sizeof(stamp), i.recv));
 641                         printf(" TransmitTimestamp=%s,",
 642                                format_timestamp(stamp, sizeof(stamp), i.trans));
 643                         printf(" DestinationTimestamp=%s,",
 644                                format_timestamp(stamp, sizeof(stamp), i.dest));
 645                         printf(" Ignored=%s PacketCount=%" PRIu64 ",",
 646                                yes_no(i.spike), i.packet_count);
 647                         printf(" Jitter=%s }\n",
 648                                format_timespan(ts, sizeof(ts), i.jitter, 0));
 649
 650                         return 1;
 651
 652                 } else if (streq(name, "ServerAddress")) {
 653                         _cleanup_free_ char *str = NULL;
 654
 655                         r = map_server_address(NULL, NULL, m, NULL, &str);
 656                         if (r < 0)
 657                                 return r;
 658
 659                         if (arg_all || !isempty(str))
 660                                 bus_print_property_value(name, expected_value, value, "%s", str);
 661
 662                         return 1;
 663                 }
 664                 break;
 665         }
 666
 667         return 0;
 668 }
 669
 670 static int show_timesync(int argc, char **argv, void *userdata) {
 671         sd_bus *bus = userdata;
 672         int r;
 673
 674         assert(bus);
 675
 676         r = bus_print_all_properties(bus,
 677                                      "org.freedesktop.timesync1",
 678                                      "/org/freedesktop/timesync1",
 679                                      print_timesync_property,
 680                                      arg_property,
 681                                      arg_value,
 682                                      arg_all,
 683                                      NULL);
 684         if (r < 0)
 685                 return bus_log_parse_error(r);
 686
 687         return 0;
 688 }
 689
 690 static int help(void) {
 691         _cleanup_free_ char *link = NULL;
 692         int r;
 693
 694         r = terminal_urlify_man("timedatectl", "1", &link);
 695         if (r < 0)
 696                 return log_oom();
 697
 698         printf("%s [OPTIONS...] COMMAND ...\n\n"
 699                "Query or change system time and date settings.\n\n"
 700                "  -h --help                Show this help message\n"
 701                "     --version             Show package version\n"
 702                "     --no-pager            Do not pipe output into a pager\n"
 703                "     --no-ask-password     Do not prompt for password\n"
 704                "  -H --host=[USER@]HOST    Operate on remote host\n"
 705                "  -M --machine=CONTAINER   Operate on local container\n"
 706                "     --adjust-system-clock Adjust system clock when changing local RTC mode\n"
 707                "     --monitor             Monitor status of systemd-timesyncd\n"
 708                "  -p --property=NAME       Show only properties by this name\n"
 709                "  -a --all                 Show all properties, including empty ones\n"
 710                "     --value               When showing properties, only print the value\n"
 711                "\n"
 712                "Commands:\n"
 713                "  status                   Show current time settings\n"
 714                "  show                     Show properties of systemd-timedated\n"
 715                "  set-time TIME            Set system time\n"
 716                "  set-timezone ZONE        Set system time zone\n"
 717                "  list-timezones           Show known time zones\n"
 718                "  set-local-rtc BOOL       Control whether RTC is in local time\n"
 719                "  set-ntp BOOL             Enable or disable network time synchronization\n"
 720                "\n"
 721                "systemd-timesyncd Commands:\n"
 722                "  timesync-status          Show status of systemd-timesyncd\n"
 723                "  show-timesync            Show properties of systemd-timesyncd\n"
 724                "\nSee the %s for details.\n"
 725                , program_invocation_short_name
 726                , link
 727         );
 728
 729         return 0;
 730 }
 731
 732 static int verb_help(int argc, char **argv, void *userdata) {
 733         return help();
 734 }
 735
 736 static int parse_argv(int argc, char *argv[]) {
 737
 738         enum {
 739                 ARG_VERSION = 0x100,
 740                 ARG_NO_PAGER,
 741                 ARG_ADJUST_SYSTEM_CLOCK,
 742                 ARG_NO_ASK_PASSWORD,
 743                 ARG_MONITOR,
 744                 ARG_VALUE,
 745         };
 746
 747         static const struct option options[] = {
 748                 { "help",                no_argument,       NULL, 'h'                     },
 749                 { "version",             no_argument,       NULL, ARG_VERSION             },
 750                 { "no-pager",            no_argument,       NULL, ARG_NO_PAGER            },
 751                 { "host",                required_argument, NULL, 'H'                     },
 752                 { "machine",             required_argument, NULL, 'M'                     },
 753                 { "no-ask-password",     no_argument,       NULL, ARG_NO_ASK_PASSWORD     },
 754                 { "adjust-system-clock", no_argument,       NULL, ARG_ADJUST_SYSTEM_CLOCK },
 755                 { "monitor",             no_argument,       NULL, ARG_MONITOR             },
 756                 { "property",            required_argument, NULL, 'p'                     },
 757                 { "all",                 no_argument,       NULL, 'a'                     },
 758                 { "value",               no_argument,       NULL, ARG_VALUE               },
 759                 {}
 760         };
 761
 762         int c, r;
 763
 764         assert(argc >= 0);
 765         assert(argv);
 766
 767         while ((c = getopt_long(argc, argv, "hH:M:p:a", options, NULL)) >= 0)
 768
 769                 switch (c) {
 770
 771                 case 'h':
 772                         return help();
 773
 774                 case ARG_VERSION:
 775                         return version();
 776
 777                 case 'H':
 778                         arg_transport = BUS_TRANSPORT_REMOTE;
 779                         arg_host = optarg;
 780                         break;
 781
 782                 case 'M':
 783                         arg_transport = BUS_TRANSPORT_MACHINE;
 784                         arg_host = optarg;
 785                         break;
 786
 787                 case ARG_NO_ASK_PASSWORD:
 788                         arg_ask_password = false;
 789                         break;
 790
 791                 case ARG_ADJUST_SYSTEM_CLOCK:
 792                         arg_adjust_system_clock = true;
 793                         break;
 794
 795                 case ARG_NO_PAGER:
 796                         arg_pager_flags |= PAGER_DISABLE;
 797                         break;
 798
 799                 case ARG_MONITOR:
 800                         arg_monitor = true;
 801                         break;
 802
 803                 case 'p': {
 804                         r = strv_extend(&arg_property, optarg);
 805                         if (r < 0)
 806                                 return log_oom();
 807
 808                         /* If the user asked for a particular
 809                          * property, show it to him, even if it is
 810                          * empty. */
 811                         arg_all = true;
 812                         break;
 813                 }
 814
 815                 case 'a':
 816                         arg_all = true;
 817                         break;
 818
 819                 case ARG_VALUE:
 820                         arg_value = true;
 821                         break;
 822
 823                 case '?':
 824                         return -EINVAL;
 825
 826                 default:
 827                         assert_not_reached("Unhandled option");
 828                 }
 829
 830         return 1;
 831 }
 832
 833 static int timedatectl_main(sd_bus *bus, int argc, char *argv[]) {
 834         static const Verb verbs[] = {
 835                 { "status",          VERB_ANY, 1,        VERB_DEFAULT, show_status          },
 836                 { "show",            VERB_ANY, 1,        0,            show_properties      },
 837                 { "set-time",        2,        2,        0,            set_time             },
 838                 { "set-timezone",    2,        2,        0,            set_timezone         },
 839                 { "list-timezones",  VERB_ANY, 1,        0,            list_timezones       },
 840                 { "set-local-rtc",   2,        2,        0,            set_local_rtc        },
 841                 { "set-ntp",         2,        2,        0,            set_ntp              },
 842                 { "timesync-status", VERB_ANY, 1,        0,            show_timesync_status },
 843                 { "show-timesync",   VERB_ANY, 1,        0,            show_timesync        },
 844                 { "help",            VERB_ANY, VERB_ANY, 0,            verb_help            }, /* Not documented, but supported since it is created. */
 845                 {}
 846         };
 847
 848         return dispatch_verb(argc, argv, verbs, bus);
 849 }
 850
 851 static int run(int argc, char *argv[]) {
 852         _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL;
 853         int r;
 854
 855         setlocale(LC_ALL, "");
 856         log_parse_environment();
 857         log_open();
 858
 859         r = parse_argv(argc, argv);
 860         if (r <= 0)
 861                 return r;
 862
 863         r = bus_connect_transport(arg_transport, arg_host, false, &bus);
 864         if (r < 0)
 865                 return log_error_errno(r, "Failed to create bus connection: %m");
 866
 867         return timedatectl_main(bus, argc, argv);
 868 }
 869
 870 DEFINE_MAIN_FUNCTION(run);