src/core/timer.c

   1 /***
   2   This file is part of systemd.
   3
   4   Copyright 2010 Lennart Poettering
   5
   6   systemd is free software; you can redistribute it and/or modify it
   7   under the terms of the GNU Lesser General Public License as published by
   8   the Free Software Foundation; either version 2.1 of the License, or
   9   (at your option) any later version.
  10
  11   systemd is distributed in the hope that it will be useful, but
  12   WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  14   Lesser General Public License for more details.
  15
  16   You should have received a copy of the GNU Lesser General Public License
  17   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  18 ***/
  19
  20 #include <errno.h>
  21
  22 #include "alloc-util.h"
  23 #include "bus-error.h"
  24 #include "bus-util.h"
  25 #include "dbus-timer.h"
  26 #include "fs-util.h"
  27 #include "parse-util.h"
  28 #include "random-util.h"
  29 #include "special.h"
  30 #include "string-table.h"
  31 #include "string-util.h"
  32 #include "timer.h"
  33 #include "unit-name.h"
  34 #include "unit.h"
  35 #include "user-util.h"
  36 #include "virt.h"
  37
  38 static const UnitActiveState state_translation_table[_TIMER_STATE_MAX] = {
  39         [TIMER_DEAD] = UNIT_INACTIVE,
  40         [TIMER_WAITING] = UNIT_ACTIVE,
  41         [TIMER_RUNNING] = UNIT_ACTIVE,
  42         [TIMER_ELAPSED] = UNIT_ACTIVE,
  43         [TIMER_FAILED] = UNIT_FAILED
  44 };
  45
  46 static int timer_dispatch(sd_event_source *s, uint64_t usec, void *userdata);
  47
  48 static void timer_init(Unit *u) {
  49         Timer *t = TIMER(u);
  50
  51         assert(u);
  52         assert(u->load_state == UNIT_STUB);
  53
  54         t->next_elapse_monotonic_or_boottime = USEC_INFINITY;
  55         t->next_elapse_realtime = USEC_INFINITY;
  56         t->accuracy_usec = u->manager->default_timer_accuracy_usec;
  57         t->remain_after_elapse = true;
  58 }
  59
  60 void timer_free_values(Timer *t) {
  61         TimerValue *v;
  62
  63         assert(t);
  64
  65         while ((v = t->values)) {
  66                 LIST_REMOVE(value, t->values, v);
  67                 calendar_spec_free(v->calendar_spec);
  68                 free(v);
  69         }
  70 }
  71
  72 static void timer_done(Unit *u) {
  73         Timer *t = TIMER(u);
  74
  75         assert(t);
  76
  77         timer_free_values(t);
  78
  79         t->monotonic_event_source = sd_event_source_unref(t->monotonic_event_source);
  80         t->realtime_event_source = sd_event_source_unref(t->realtime_event_source);
  81
  82         free(t->stamp_path);
  83 }
  84
  85 static int timer_verify(Timer *t) {
  86         assert(t);
  87
  88         if (UNIT(t)->load_state != UNIT_LOADED)
  89                 return 0;
  90
  91         if (!t->values) {
  92                 log_unit_error(UNIT(t), "Timer unit lacks value setting. Refusing.");
  93                 return -EINVAL;
  94         }
  95
  96         return 0;
  97 }
  98
  99 static int timer_add_default_dependencies(Timer *t) {
 100         int r;
 101         TimerValue *v;
 102
 103         assert(t);
 104
 105         if (!UNIT(t)->default_dependencies)
 106                 return 0;
 107
 108         r = unit_add_dependency_by_name(UNIT(t), UNIT_BEFORE, SPECIAL_TIMERS_TARGET, NULL, true);
 109         if (r < 0)
 110                 return r;
 111
 112         if (MANAGER_IS_SYSTEM(UNIT(t)->manager)) {
 113                 r = unit_add_two_dependencies_by_name(UNIT(t), UNIT_AFTER, UNIT_REQUIRES, SPECIAL_SYSINIT_TARGET, NULL, true);
 114                 if (r < 0)
 115                         return r;
 116
 117                 LIST_FOREACH(value, v, t->values) {
 118                         if (v->base == TIMER_CALENDAR) {
 119                                 r = unit_add_dependency_by_name(UNIT(t), UNIT_AFTER, SPECIAL_TIME_SYNC_TARGET, NULL, true);
 120                                 if (r < 0)
 121                                         return r;
 122                                 break;
 123                         }
 124                 }
 125         }
 126
 127         return unit_add_two_dependencies_by_name(UNIT(t), UNIT_BEFORE, UNIT_CONFLICTS, SPECIAL_SHUTDOWN_TARGET, NULL, true);
 128 }
 129
 130 static int timer_setup_persistent(Timer *t) {
 131         int r;
 132
 133         assert(t);
 134
 135         if (!t->persistent)
 136                 return 0;
 137
 138         if (MANAGER_IS_SYSTEM(UNIT(t)->manager)) {
 139
 140                 r = unit_require_mounts_for(UNIT(t), "/var/lib/systemd/timers");
 141                 if (r < 0)
 142                         return r;
 143
 144                 t->stamp_path = strappend("/var/lib/systemd/timers/stamp-", UNIT(t)->id);
 145         } else {
 146                 const char *e;
 147
 148                 e = getenv("XDG_DATA_HOME");
 149                 if (e)
 150                         t->stamp_path = strjoin(e, "/systemd/timers/stamp-", UNIT(t)->id);
 151                 else {
 152
 153                         _cleanup_free_ char *h = NULL;
 154
 155                         r = get_home_dir(&h);
 156                         if (r < 0)
 157                                 return log_unit_error_errno(UNIT(t), r, "Failed to determine home directory: %m");
 158
 159                         t->stamp_path = strjoin(h, "/.local/share/systemd/timers/stamp-", UNIT(t)->id);
 160                 }
 161         }
 162
 163         if (!t->stamp_path)
 164                 return log_oom();
 165
 166         return 0;
 167 }
 168
 169 static int timer_load(Unit *u) {
 170         Timer *t = TIMER(u);
 171         int r;
 172
 173         assert(u);
 174         assert(u->load_state == UNIT_STUB);
 175
 176         r = unit_load_fragment_and_dropin(u);
 177         if (r < 0)
 178                 return r;
 179
 180         if (u->load_state == UNIT_LOADED) {
 181
 182                 if (set_isempty(u->dependencies[UNIT_TRIGGERS])) {
 183                         Unit *x;
 184
 185                         r = unit_load_related_unit(u, ".service", &x);
 186                         if (r < 0)
 187                                 return r;
 188
 189                         r = unit_add_two_dependencies(u, UNIT_BEFORE, UNIT_TRIGGERS, x, true);
 190                         if (r < 0)
 191                                 return r;
 192                 }
 193
 194                 r = timer_setup_persistent(t);
 195                 if (r < 0)
 196                         return r;
 197
 198                 r = timer_add_default_dependencies(t);
 199                 if (r < 0)
 200                         return r;
 201         }
 202
 203         return timer_verify(t);
 204 }
 205
 206 static void timer_dump(Unit *u, FILE *f, const char *prefix) {
 207         char buf[FORMAT_TIMESPAN_MAX];
 208         Timer *t = TIMER(u);
 209         Unit *trigger;
 210         TimerValue *v;
 211
 212         trigger = UNIT_TRIGGER(u);
 213
 214         fprintf(f,
 215                 "%sTimer State: %s\n"
 216                 "%sResult: %s\n"
 217                 "%sUnit: %s\n"
 218                 "%sPersistent: %s\n"
 219                 "%sWakeSystem: %s\n"
 220                 "%sAccuracy: %s\n"
 221                 "%sRemainAfterElapse: %s\n",
 222                 prefix, timer_state_to_string(t->state),
 223                 prefix, timer_result_to_string(t->result),
 224                 prefix, trigger ? trigger->id : "n/a",
 225                 prefix, yes_no(t->persistent),
 226                 prefix, yes_no(t->wake_system),
 227                 prefix, format_timespan(buf, sizeof(buf), t->accuracy_usec, 1),
 228                 prefix, yes_no(t->remain_after_elapse));
 229
 230         LIST_FOREACH(value, v, t->values) {
 231
 232                 if (v->base == TIMER_CALENDAR) {
 233                         _cleanup_free_ char *p = NULL;
 234
 235                         calendar_spec_to_string(v->calendar_spec, &p);
 236
 237                         fprintf(f,
 238                                 "%s%s: %s\n",
 239                                 prefix,
 240                                 timer_base_to_string(v->base),
 241                                 strna(p));
 242                 } else  {
 243                         char timespan1[FORMAT_TIMESPAN_MAX];
 244
 245                         fprintf(f,
 246                                 "%s%s: %s\n",
 247                                 prefix,
 248                                 timer_base_to_string(v->base),
 249                                 format_timespan(timespan1, sizeof(timespan1), v->value, 0));
 250                 }
 251         }
 252 }
 253
 254 static void timer_set_state(Timer *t, TimerState state) {
 255         TimerState old_state;
 256         assert(t);
 257
 258         old_state = t->state;
 259         t->state = state;
 260
 261         if (state != TIMER_WAITING) {
 262                 t->monotonic_event_source = sd_event_source_unref(t->monotonic_event_source);
 263                 t->realtime_event_source = sd_event_source_unref(t->realtime_event_source);
 264                 t->next_elapse_monotonic_or_boottime = USEC_INFINITY;
 265                 t->next_elapse_realtime = USEC_INFINITY;
 266         }
 267
 268         if (state != old_state)
 269                 log_unit_debug(UNIT(t), "Changed %s -> %s", timer_state_to_string(old_state), timer_state_to_string(state));
 270
 271         unit_notify(UNIT(t), state_translation_table[old_state], state_translation_table[state], true);
 272 }
 273
 274 static void timer_enter_waiting(Timer *t, bool initial);
 275
 276 static int timer_coldplug(Unit *u) {
 277         Timer *t = TIMER(u);
 278
 279         assert(t);
 280         assert(t->state == TIMER_DEAD);
 281
 282         if (t->deserialized_state == t->state)
 283                 return 0;
 284
 285         if (t->deserialized_state == TIMER_WAITING)
 286                 timer_enter_waiting(t, false);
 287         else
 288                 timer_set_state(t, t->deserialized_state);
 289
 290         return 0;
 291 }
 292
 293 static void timer_enter_dead(Timer *t, TimerResult f) {
 294         assert(t);
 295
 296         if (t->result == TIMER_SUCCESS)
 297                 t->result = f;
 298
 299         timer_set_state(t, t->result != TIMER_SUCCESS ? TIMER_FAILED : TIMER_DEAD);
 300 }
 301
 302 static void timer_enter_elapsed(Timer *t, bool leave_around) {
 303         assert(t);
 304
 305         /* If a unit is marked with RemainAfterElapse=yes we leave it
 306          * around even after it elapsed once, so that starting it
 307          * later again does not necessarily mean immediate
 308          * retriggering. We unconditionally leave units with
 309          * TIMER_UNIT_ACTIVE or TIMER_UNIT_INACTIVE triggers around,
 310          * since they might be restarted automatically at any time
 311          * later on. */
 312
 313         if (t->remain_after_elapse || leave_around)
 314                 timer_set_state(t, TIMER_ELAPSED);
 315         else
 316                 timer_enter_dead(t, TIMER_SUCCESS);
 317 }
 318
 319 static usec_t monotonic_to_boottime(usec_t t) {
 320         usec_t a, b;
 321
 322         if (t <= 0)
 323                 return 0;
 324
 325         a = now(clock_boottime_or_monotonic());
 326         b = now(CLOCK_MONOTONIC);
 327
 328         if (t + a > b)
 329                 return t + a - b;
 330         else
 331                 return 0;
 332 }
 333
 334 static void add_random(Timer *t, usec_t *v) {
 335         char s[FORMAT_TIMESPAN_MAX];
 336         usec_t add;
 337
 338         assert(t);
 339         assert(v);
 340
 341         if (t->random_usec == 0)
 342                 return;
 343         if (*v == USEC_INFINITY)
 344                 return;
 345
 346         add = random_u64() % t->random_usec;
 347
 348         if (*v + add < *v) /* overflow */
 349                 *v = (usec_t) -2; /* Highest possible value, that is not USEC_INFINITY */
 350         else
 351                 *v += add;
 352
 353         log_unit_info(UNIT(t), "Adding %s random time.", format_timespan(s, sizeof(s), add, 0));
 354 }
 355
 356 static void timer_enter_waiting(Timer *t, bool initial) {
 357         bool found_monotonic = false, found_realtime = false;
 358         usec_t ts_realtime, ts_monotonic;
 359         usec_t base = 0;
 360         bool leave_around = false;
 361         TimerValue *v;
 362         Unit *trigger;
 363         int r;
 364
 365         assert(t);
 366
 367         trigger = UNIT_TRIGGER(UNIT(t));
 368         if (!trigger) {
 369                 log_unit_error(UNIT(t), "Unit to trigger vanished.");
 370                 timer_enter_dead(t, TIMER_FAILURE_RESOURCES);
 371                 return;
 372         }
 373
 374         /* If we shall wake the system we use the boottime clock
 375          * rather than the monotonic clock. */
 376
 377         ts_realtime = now(CLOCK_REALTIME);
 378         ts_monotonic = now(t->wake_system ? clock_boottime_or_monotonic() : CLOCK_MONOTONIC);
 379         t->next_elapse_monotonic_or_boottime = t->next_elapse_realtime = 0;
 380
 381         LIST_FOREACH(value, v, t->values) {
 382
 383                 if (v->disabled)
 384                         continue;
 385
 386                 if (v->base == TIMER_CALENDAR) {
 387                         usec_t b;
 388
 389                         /* If we know the last time this was
 390                          * triggered, schedule the job based relative
 391                          * to that. If we don't just start from
 392                          * now. */
 393
 394                         b = t->last_trigger.realtime > 0 ? t->last_trigger.realtime : ts_realtime;
 395
 396                         r = calendar_spec_next_usec(v->calendar_spec, b, &v->next_elapse);
 397                         if (r < 0)
 398                                 continue;
 399
 400                         if (!found_realtime)
 401                                 t->next_elapse_realtime = v->next_elapse;
 402                         else
 403                                 t->next_elapse_realtime = MIN(t->next_elapse_realtime, v->next_elapse);
 404
 405                         found_realtime = true;
 406
 407                 } else  {
 408                         switch (v->base) {
 409
 410                         case TIMER_ACTIVE:
 411                                 if (state_translation_table[t->state] == UNIT_ACTIVE)
 412                                         base = UNIT(t)->inactive_exit_timestamp.monotonic;
 413                                 else
 414                                         base = ts_monotonic;
 415                                 break;
 416
 417                         case TIMER_BOOT:
 418                                 if (detect_container() <= 0) {
 419                                         /* CLOCK_MONOTONIC equals the uptime on Linux */
 420                                         base = 0;
 421                                         break;
 422                                 }
 423                                 /* In a container we don't want to include the time the host
 424                                  * was already up when the container started, so count from
 425                                  * our own startup. Fall through. */
 426                         case TIMER_STARTUP:
 427                                 base = UNIT(t)->manager->userspace_timestamp.monotonic;
 428                                 break;
 429
 430                         case TIMER_UNIT_ACTIVE:
 431                                 leave_around = true;
 432                                 base = trigger->inactive_exit_timestamp.monotonic;
 433
 434                                 if (base <= 0)
 435                                         base = t->last_trigger.monotonic;
 436
 437                                 if (base <= 0)
 438                                         continue;
 439
 440                                 break;
 441
 442                         case TIMER_UNIT_INACTIVE:
 443                                 leave_around = true;
 444                                 base = trigger->inactive_enter_timestamp.monotonic;
 445
 446                                 if (base <= 0)
 447                                         base = t->last_trigger.monotonic;
 448
 449                                 if (base <= 0)
 450                                         continue;
 451
 452                                 break;
 453
 454                         default:
 455                                 assert_not_reached("Unknown timer base");
 456                         }
 457
 458                         if (t->wake_system)
 459                                 base = monotonic_to_boottime(base);
 460
 461                         v->next_elapse = base + v->value;
 462
 463                         if (!initial && v->next_elapse < ts_monotonic && IN_SET(v->base, TIMER_ACTIVE, TIMER_BOOT, TIMER_STARTUP)) {
 464                                 /* This is a one time trigger, disable it now */
 465                                 v->disabled = true;
 466                                 continue;
 467                         }
 468
 469                         if (!found_monotonic)
 470                                 t->next_elapse_monotonic_or_boottime = v->next_elapse;
 471                         else
 472                                 t->next_elapse_monotonic_or_boottime = MIN(t->next_elapse_monotonic_or_boottime, v->next_elapse);
 473
 474                         found_monotonic = true;
 475                 }
 476         }
 477
 478         if (!found_monotonic && !found_realtime) {
 479                 log_unit_debug(UNIT(t), "Timer is elapsed.");
 480                 timer_enter_elapsed(t, leave_around);
 481                 return;
 482         }
 483
 484         if (found_monotonic) {
 485                 char buf[FORMAT_TIMESPAN_MAX];
 486                 usec_t left;
 487
 488                 add_random(t, &t->next_elapse_monotonic_or_boottime);
 489
 490                 left = t->next_elapse_monotonic_or_boottime > ts_monotonic ? t->next_elapse_monotonic_or_boottime - ts_monotonic : 0;
 491                 log_unit_debug(UNIT(t), "Monotonic timer elapses in %s.", format_timespan(buf, sizeof(buf), left, 0));
 492
 493                 if (t->monotonic_event_source) {
 494                         r = sd_event_source_set_time(t->monotonic_event_source, t->next_elapse_monotonic_or_boottime);
 495                         if (r < 0)
 496                                 goto fail;
 497
 498                         r = sd_event_source_set_enabled(t->monotonic_event_source, SD_EVENT_ONESHOT);
 499                         if (r < 0)
 500                                 goto fail;
 501                 } else {
 502
 503                         r = sd_event_add_time(
 504                                         UNIT(t)->manager->event,
 505                                         &t->monotonic_event_source,
 506                                         t->wake_system ? CLOCK_BOOTTIME_ALARM : CLOCK_MONOTONIC,
 507                                         t->next_elapse_monotonic_or_boottime, t->accuracy_usec,
 508                                         timer_dispatch, t);
 509                         if (r < 0)
 510                                 goto fail;
 511
 512                         (void) sd_event_source_set_description(t->monotonic_event_source, "timer-monotonic");
 513                 }
 514
 515         } else if (t->monotonic_event_source) {
 516
 517                 r = sd_event_source_set_enabled(t->monotonic_event_source, SD_EVENT_OFF);
 518                 if (r < 0)
 519                         goto fail;
 520         }
 521
 522         if (found_realtime) {
 523                 char buf[FORMAT_TIMESTAMP_MAX];
 524
 525                 add_random(t, &t->next_elapse_realtime);
 526
 527                 log_unit_debug(UNIT(t), "Realtime timer elapses at %s.", format_timestamp(buf, sizeof(buf), t->next_elapse_realtime));
 528
 529                 if (t->realtime_event_source) {
 530                         r = sd_event_source_set_time(t->realtime_event_source, t->next_elapse_realtime);
 531                         if (r < 0)
 532                                 goto fail;
 533
 534                         r = sd_event_source_set_enabled(t->realtime_event_source, SD_EVENT_ONESHOT);
 535                         if (r < 0)
 536                                 goto fail;
 537                 } else {
 538                         r = sd_event_add_time(
 539                                         UNIT(t)->manager->event,
 540                                         &t->realtime_event_source,
 541                                         t->wake_system ? CLOCK_REALTIME_ALARM : CLOCK_REALTIME,
 542                                         t->next_elapse_realtime, t->accuracy_usec,
 543                                         timer_dispatch, t);
 544                         if (r < 0)
 545                                 goto fail;
 546
 547                         (void) sd_event_source_set_description(t->realtime_event_source, "timer-realtime");
 548                 }
 549
 550         } else if (t->realtime_event_source) {
 551
 552                 r = sd_event_source_set_enabled(t->realtime_event_source, SD_EVENT_OFF);
 553                 if (r < 0)
 554                         goto fail;
 555         }
 556
 557         timer_set_state(t, TIMER_WAITING);
 558         return;
 559
 560 fail:
 561         log_unit_warning_errno(UNIT(t), r, "Failed to enter waiting state: %m");
 562         timer_enter_dead(t, TIMER_FAILURE_RESOURCES);
 563 }
 564
 565 static void timer_enter_running(Timer *t) {
 566         _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
 567         Unit *trigger;
 568         int r;
 569
 570         assert(t);
 571
 572         /* Don't start job if we are supposed to go down */
 573         if (unit_stop_pending(UNIT(t)))
 574                 return;
 575
 576         trigger = UNIT_TRIGGER(UNIT(t));
 577         if (!trigger) {
 578                 log_unit_error(UNIT(t), "Unit to trigger vanished.");
 579                 timer_enter_dead(t, TIMER_FAILURE_RESOURCES);
 580                 return;
 581         }
 582
 583         r = manager_add_job(UNIT(t)->manager, JOB_START, trigger, JOB_REPLACE, &error, NULL);
 584         if (r < 0)
 585                 goto fail;
 586
 587         dual_timestamp_get(&t->last_trigger);
 588
 589         if (t->stamp_path)
 590                 touch_file(t->stamp_path, true, t->last_trigger.realtime, UID_INVALID, GID_INVALID, MODE_INVALID);
 591
 592         timer_set_state(t, TIMER_RUNNING);
 593         return;
 594
 595 fail:
 596         log_unit_warning(UNIT(t), "Failed to queue unit startup job: %s", bus_error_message(&error, r));
 597         timer_enter_dead(t, TIMER_FAILURE_RESOURCES);
 598 }
 599
 600 static int timer_start(Unit *u) {
 601         Timer *t = TIMER(u);
 602         TimerValue *v;
 603         Unit *trigger;
 604         int r;
 605
 606         assert(t);
 607         assert(t->state == TIMER_DEAD || t->state == TIMER_FAILED);
 608
 609         trigger = UNIT_TRIGGER(u);
 610         if (!trigger || trigger->load_state != UNIT_LOADED) {
 611                 log_unit_error(u, "Refusing to start, unit to trigger not loaded.");
 612                 return -ENOENT;
 613         }
 614
 615         r = unit_start_limit_test(u);
 616         if (r < 0) {
 617                 timer_enter_dead(t, TIMER_FAILURE_START_LIMIT_HIT);
 618                 return r;
 619         }
 620
 621         r = unit_acquire_invocation_id(u);
 622         if (r < 0)
 623                 return r;
 624
 625         t->last_trigger = DUAL_TIMESTAMP_NULL;
 626
 627         /* Reenable all timers that depend on unit activation time */
 628         LIST_FOREACH(value, v, t->values)
 629                 if (v->base == TIMER_ACTIVE)
 630                         v->disabled = false;
 631
 632         if (t->stamp_path) {
 633                 struct stat st;
 634
 635                 if (stat(t->stamp_path, &st) >= 0)
 636                         t->last_trigger.realtime = timespec_load(&st.st_atim);
 637                 else if (errno == ENOENT)
 638                         /* The timer has never run before,
 639                          * make sure a stamp file exists.
 640                          */
 641                         (void) touch_file(t->stamp_path, true, USEC_INFINITY, UID_INVALID, GID_INVALID, MODE_INVALID);
 642         }
 643
 644         t->result = TIMER_SUCCESS;
 645         timer_enter_waiting(t, true);
 646         return 1;
 647 }
 648
 649 static int timer_stop(Unit *u) {
 650         Timer *t = TIMER(u);
 651
 652         assert(t);
 653         assert(t->state == TIMER_WAITING || t->state == TIMER_RUNNING || t->state == TIMER_ELAPSED);
 654
 655         timer_enter_dead(t, TIMER_SUCCESS);
 656         return 1;
 657 }
 658
 659 static int timer_serialize(Unit *u, FILE *f, FDSet *fds) {
 660         Timer *t = TIMER(u);
 661
 662         assert(u);
 663         assert(f);
 664         assert(fds);
 665
 666         unit_serialize_item(u, f, "state", timer_state_to_string(t->state));
 667         unit_serialize_item(u, f, "result", timer_result_to_string(t->result));
 668
 669         if (t->last_trigger.realtime > 0)
 670                 unit_serialize_item_format(u, f, "last-trigger-realtime", "%" PRIu64, t->last_trigger.realtime);
 671
 672         if (t->last_trigger.monotonic > 0)
 673                 unit_serialize_item_format(u, f, "last-trigger-monotonic", "%" PRIu64, t->last_trigger.monotonic);
 674
 675         return 0;
 676 }
 677
 678 static int timer_deserialize_item(Unit *u, const char *key, const char *value, FDSet *fds) {
 679         Timer *t = TIMER(u);
 680         int r;
 681
 682         assert(u);
 683         assert(key);
 684         assert(value);
 685         assert(fds);
 686
 687         if (streq(key, "state")) {
 688                 TimerState state;
 689
 690                 state = timer_state_from_string(value);
 691                 if (state < 0)
 692                         log_unit_debug(u, "Failed to parse state value: %s", value);
 693                 else
 694                         t->deserialized_state = state;
 695         } else if (streq(key, "result")) {
 696                 TimerResult f;
 697
 698                 f = timer_result_from_string(value);
 699                 if (f < 0)
 700                         log_unit_debug(u, "Failed to parse result value: %s", value);
 701                 else if (f != TIMER_SUCCESS)
 702                         t->result = f;
 703         } else if (streq(key, "last-trigger-realtime")) {
 704
 705                 r = safe_atou64(value, &t->last_trigger.realtime);
 706                 if (r < 0)
 707                         log_unit_debug(u, "Failed to parse last-trigger-realtime value: %s", value);
 708
 709         } else if (streq(key, "last-trigger-monotonic")) {
 710
 711                 r = safe_atou64(value, &t->last_trigger.monotonic);
 712                 if (r < 0)
 713                         log_unit_debug(u, "Failed to parse last-trigger-monotonic value: %s", value);
 714
 715         } else
 716                 log_unit_debug(u, "Unknown serialization key: %s", key);
 717
 718         return 0;
 719 }
 720
 721 _pure_ static UnitActiveState timer_active_state(Unit *u) {
 722         assert(u);
 723
 724         return state_translation_table[TIMER(u)->state];
 725 }
 726
 727 _pure_ static const char *timer_sub_state_to_string(Unit *u) {
 728         assert(u);
 729
 730         return timer_state_to_string(TIMER(u)->state);
 731 }
 732
 733 static int timer_dispatch(sd_event_source *s, uint64_t usec, void *userdata) {
 734         Timer *t = TIMER(userdata);
 735
 736         assert(t);
 737
 738         if (t->state != TIMER_WAITING)
 739                 return 0;
 740
 741         log_unit_debug(UNIT(t), "Timer elapsed.");
 742         timer_enter_running(t);
 743         return 0;
 744 }
 745
 746 static void timer_trigger_notify(Unit *u, Unit *other) {
 747         Timer *t = TIMER(u);
 748         TimerValue *v;
 749
 750         assert(u);
 751         assert(other);
 752
 753         if (other->load_state != UNIT_LOADED)
 754                 return;
 755
 756         /* Reenable all timers that depend on unit state */
 757         LIST_FOREACH(value, v, t->values)
 758                 if (v->base == TIMER_UNIT_ACTIVE ||
 759                     v->base == TIMER_UNIT_INACTIVE)
 760                         v->disabled = false;
 761
 762         switch (t->state) {
 763
 764         case TIMER_WAITING:
 765         case TIMER_ELAPSED:
 766
 767                 /* Recalculate sleep time */
 768                 timer_enter_waiting(t, false);
 769                 break;
 770
 771         case TIMER_RUNNING:
 772
 773                 if (UNIT_IS_INACTIVE_OR_FAILED(unit_active_state(other))) {
 774                         log_unit_debug(UNIT(t), "Got notified about unit deactivation.");
 775                         timer_enter_waiting(t, false);
 776                 }
 777                 break;
 778
 779         case TIMER_DEAD:
 780         case TIMER_FAILED:
 781                 break;
 782
 783         default:
 784                 assert_not_reached("Unknown timer state");
 785         }
 786 }
 787
 788 static void timer_reset_failed(Unit *u) {
 789         Timer *t = TIMER(u);
 790
 791         assert(t);
 792
 793         if (t->state == TIMER_FAILED)
 794                 timer_set_state(t, TIMER_DEAD);
 795
 796         t->result = TIMER_SUCCESS;
 797 }
 798
 799 static void timer_time_change(Unit *u) {
 800         Timer *t = TIMER(u);
 801
 802         assert(u);
 803
 804         if (t->state != TIMER_WAITING)
 805                 return;
 806
 807         log_unit_debug(u, "Time change, recalculating next elapse.");
 808         timer_enter_waiting(t, false);
 809 }
 810
 811 static const char* const timer_base_table[_TIMER_BASE_MAX] = {
 812         [TIMER_ACTIVE] = "OnActiveSec",
 813         [TIMER_BOOT] = "OnBootSec",
 814         [TIMER_STARTUP] = "OnStartupSec",
 815         [TIMER_UNIT_ACTIVE] = "OnUnitActiveSec",
 816         [TIMER_UNIT_INACTIVE] = "OnUnitInactiveSec",
 817         [TIMER_CALENDAR] = "OnCalendar"
 818 };
 819
 820 DEFINE_STRING_TABLE_LOOKUP(timer_base, TimerBase);
 821
 822 static const char* const timer_result_table[_TIMER_RESULT_MAX] = {
 823         [TIMER_SUCCESS] = "success",
 824         [TIMER_FAILURE_RESOURCES] = "resources",
 825         [TIMER_FAILURE_START_LIMIT_HIT] = "start-limit-hit",
 826 };
 827
 828 DEFINE_STRING_TABLE_LOOKUP(timer_result, TimerResult);
 829
 830 const UnitVTable timer_vtable = {
 831         .object_size = sizeof(Timer),
 832
 833         .sections =
 834                 "Unit\0"
 835                 "Timer\0"
 836                 "Install\0",
 837         .private_section = "Timer",
 838
 839         .init = timer_init,
 840         .done = timer_done,
 841         .load = timer_load,
 842
 843         .coldplug = timer_coldplug,
 844
 845         .dump = timer_dump,
 846
 847         .start = timer_start,
 848         .stop = timer_stop,
 849
 850         .serialize = timer_serialize,
 851         .deserialize_item = timer_deserialize_item,
 852
 853         .active_state = timer_active_state,
 854         .sub_state_to_string = timer_sub_state_to_string,
 855
 856         .trigger_notify = timer_trigger_notify,
 857
 858         .reset_failed = timer_reset_failed,
 859         .time_change = timer_time_change,
 860
 861         .bus_vtable = bus_timer_vtable,
 862         .bus_set_property = bus_timer_set_property,
 863
 864         .can_transient = true,
 865 };