src/core/timer.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 #pragma once
   4
   5 /***
   6   This file is part of systemd.
   7
   8   Copyright 2010 Lennart Poettering
   9
  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.
  14
  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.
  19
  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/>.
  22 ***/
  23
  24 typedef struct Timer Timer;
  25
  26 #include "unit.h"
  27 #include "calendarspec.h"
  28
  29 typedef enum TimerState {
  30         TIMER_DEAD,
  31         TIMER_WAITING,
  32         TIMER_RUNNING,
  33         TIMER_ELAPSED,
  34         TIMER_FAILED,
  35         _TIMER_STATE_MAX,
  36         _TIMER_STATE_INVALID = -1
  37 } TimerState;
  38
  39 typedef enum TimerBase {
  40         TIMER_ACTIVE,
  41         TIMER_BOOT,
  42         TIMER_STARTUP,
  43         TIMER_UNIT_ACTIVE,
  44         TIMER_UNIT_INACTIVE,
  45         TIMER_CALENDAR,
  46         _TIMER_BASE_MAX,
  47         _TIMER_BASE_INVALID = -1
  48 } TimerBase;
  49
  50 typedef struct TimerValue {
  51         TimerBase base;
  52         bool disabled;
  53         clockid_t clock_id;
  54
  55         usec_t value; /* only for monotonic events */
  56         CalendarSpec *calendar_spec; /* only for calendar events */
  57         usec_t next_elapse;
  58
  59         LIST_FIELDS(struct TimerValue, value);
  60 } TimerValue;
  61
  62 typedef enum TimerResult {
  63         TIMER_SUCCESS,
  64         TIMER_FAILURE_RESOURCES,
  65         _TIMER_RESULT_MAX,
  66         _TIMER_RESULT_INVALID = -1
  67 } TimerResult;
  68
  69 struct Timer {
  70         Unit meta;
  71
  72         LIST_HEAD(TimerValue, values);
  73         usec_t next_elapse_monotonic;
  74         usec_t next_elapse_realtime;
  75
  76         TimerState state, deserialized_state;
  77
  78         sd_event_source *monotonic_event_source;
  79         sd_event_source *realtime_event_source;
  80
  81         TimerResult result;
  82
  83         usec_t last_trigger_monotonic;
  84 };
  85
  86 void timer_free_values(Timer *t);
  87
  88 extern const UnitVTable timer_vtable;
  89
  90 const char *timer_state_to_string(TimerState i) _const_;
  91 TimerState timer_state_from_string(const char *s) _pure_;
  92
  93 const char *timer_base_to_string(TimerBase i) _const_;
  94 TimerBase timer_base_from_string(const char *s) _pure_;
  95
  96 const char* timer_result_to_string(TimerResult i) _const_;
  97 TimerResult timer_result_from_string(const char *s) _pure_;