1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
4 This file is part of systemd.
6 Copyright 2013 Lennart Poettering
8 systemd is free software; you can redistribute it and/or modify it
9 under the terms of the GNU Lesser General Public License as published by
10 the Free Software Foundation; either version 2.1 of the License, or
11 (at your option) any later version.
13 systemd is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 Lesser General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with systemd; If not, see <http://www.gnu.org/licenses/>.
22 #include <sys/epoll.h>
23 #include <sys/timerfd.h>
28 #include "sd-daemon.h"
33 #include "time-util.h"
40 #define EPOLL_QUEUE_MAX 512U
41 #define DEFAULT_ACCURACY_USEC (250 * USEC_PER_MSEC)
43 typedef enum EventSourceType {
47 SOURCE_TIME_MONOTONIC,
48 SOURCE_TIME_REALTIME_ALARM,
49 SOURCE_TIME_BOOTTIME_ALARM,
56 _SOURCE_EVENT_SOURCE_TYPE_MAX,
57 _SOURCE_EVENT_SOURCE_TYPE_INVALID = -1
60 #define EVENT_SOURCE_IS_TIME(t) IN_SET((t), SOURCE_TIME_REALTIME, SOURCE_TIME_BOOTTIME, SOURCE_TIME_MONOTONIC, SOURCE_TIME_REALTIME_ALARM, SOURCE_TIME_BOOTTIME_ALARM)
62 struct sd_event_source {
67 sd_event_handler_t prepare;
71 EventSourceType type:5;
78 unsigned pending_index;
79 unsigned prepare_index;
80 unsigned pending_iteration;
81 unsigned prepare_iteration;
83 LIST_FIELDS(sd_event_source, sources);
87 sd_event_io_handler_t callback;
94 sd_event_time_handler_t callback;
95 usec_t next, accuracy;
96 unsigned earliest_index;
97 unsigned latest_index;
100 sd_event_signal_handler_t callback;
101 struct signalfd_siginfo siginfo;
105 sd_event_child_handler_t callback;
111 sd_event_handler_t callback;
114 sd_event_handler_t callback;
117 sd_event_handler_t callback;
118 unsigned prioq_index;
126 /* For all clocks we maintain two priority queues each, one
127 * ordered for the earliest times the events may be
128 * dispatched, and one ordered by the latest times they must
129 * have been dispatched. The range between the top entries in
130 * the two prioqs is the time window we can freely schedule
150 /* timerfd_create() only supports these five clocks so far. We
151 * can add support for more clocks when the kernel learns to
152 * deal with them, too. */
153 struct clock_data realtime;
154 struct clock_data boottime;
155 struct clock_data monotonic;
156 struct clock_data realtime_alarm;
157 struct clock_data boottime_alarm;
162 sd_event_source **signal_sources;
164 Hashmap *child_sources;
165 unsigned n_enabled_child_sources;
174 dual_timestamp timestamp;
175 usec_t timestamp_boottime;
178 bool exit_requested:1;
179 bool need_process_child:1;
185 sd_event **default_event_ptr;
187 usec_t watchdog_last, watchdog_period;
191 LIST_HEAD(sd_event_source, sources);
194 static void source_disconnect(sd_event_source *s);
196 static int pending_prioq_compare(const void *a, const void *b) {
197 const sd_event_source *x = a, *y = b;
202 /* Enabled ones first */
203 if (x->enabled != SD_EVENT_OFF && y->enabled == SD_EVENT_OFF)
205 if (x->enabled == SD_EVENT_OFF && y->enabled != SD_EVENT_OFF)
208 /* Lower priority values first */
209 if (x->priority < y->priority)
211 if (x->priority > y->priority)
214 /* Older entries first */
215 if (x->pending_iteration < y->pending_iteration)
217 if (x->pending_iteration > y->pending_iteration)
220 /* Stability for the rest */
229 static int prepare_prioq_compare(const void *a, const void *b) {
230 const sd_event_source *x = a, *y = b;
235 /* Move most recently prepared ones last, so that we can stop
236 * preparing as soon as we hit one that has already been
237 * prepared in the current iteration */
238 if (x->prepare_iteration < y->prepare_iteration)
240 if (x->prepare_iteration > y->prepare_iteration)
243 /* Enabled ones first */
244 if (x->enabled != SD_EVENT_OFF && y->enabled == SD_EVENT_OFF)
246 if (x->enabled == SD_EVENT_OFF && y->enabled != SD_EVENT_OFF)
249 /* Lower priority values first */
250 if (x->priority < y->priority)
252 if (x->priority > y->priority)
255 /* Stability for the rest */
264 static int earliest_time_prioq_compare(const void *a, const void *b) {
265 const sd_event_source *x = a, *y = b;
267 assert(EVENT_SOURCE_IS_TIME(x->type));
268 assert(x->type == y->type);
270 /* Enabled ones first */
271 if (x->enabled != SD_EVENT_OFF && y->enabled == SD_EVENT_OFF)
273 if (x->enabled == SD_EVENT_OFF && y->enabled != SD_EVENT_OFF)
276 /* Move the pending ones to the end */
277 if (!x->pending && y->pending)
279 if (x->pending && !y->pending)
283 if (x->time.next < y->time.next)
285 if (x->time.next > y->time.next)
288 /* Stability for the rest */
297 static int latest_time_prioq_compare(const void *a, const void *b) {
298 const sd_event_source *x = a, *y = b;
300 assert(EVENT_SOURCE_IS_TIME(x->type));
301 assert(x->type == y->type);
303 /* Enabled ones first */
304 if (x->enabled != SD_EVENT_OFF && y->enabled == SD_EVENT_OFF)
306 if (x->enabled == SD_EVENT_OFF && y->enabled != SD_EVENT_OFF)
309 /* Move the pending ones to the end */
310 if (!x->pending && y->pending)
312 if (x->pending && !y->pending)
316 if (x->time.next + x->time.accuracy < y->time.next + y->time.accuracy)
318 if (x->time.next + x->time.accuracy > y->time.next + y->time.accuracy)
321 /* Stability for the rest */
330 static int exit_prioq_compare(const void *a, const void *b) {
331 const sd_event_source *x = a, *y = b;
333 assert(x->type == SOURCE_EXIT);
334 assert(y->type == SOURCE_EXIT);
336 /* Enabled ones first */
337 if (x->enabled != SD_EVENT_OFF && y->enabled == SD_EVENT_OFF)
339 if (x->enabled == SD_EVENT_OFF && y->enabled != SD_EVENT_OFF)
342 /* Lower priority values first */
343 if (x->priority < y->priority)
345 if (x->priority > y->priority)
348 /* Stability for the rest */
357 static void free_clock_data(struct clock_data *d) {
361 prioq_free(d->earliest);
362 prioq_free(d->latest);
365 static void event_free(sd_event *e) {
370 while ((s = e->sources)) {
372 source_disconnect(s);
373 sd_event_source_unref(s);
376 assert(e->n_sources == 0);
378 if (e->default_event_ptr)
379 *(e->default_event_ptr) = NULL;
381 safe_close(e->epoll_fd);
382 safe_close(e->signal_fd);
383 safe_close(e->watchdog_fd);
385 free_clock_data(&e->realtime);
386 free_clock_data(&e->boottime);
387 free_clock_data(&e->monotonic);
388 free_clock_data(&e->realtime_alarm);
389 free_clock_data(&e->boottime_alarm);
391 prioq_free(e->pending);
392 prioq_free(e->prepare);
395 free(e->signal_sources);
397 hashmap_free(e->child_sources);
398 set_free(e->post_sources);
402 _public_ int sd_event_new(sd_event** ret) {
406 assert_return(ret, -EINVAL);
408 e = new0(sd_event, 1);
413 e->signal_fd = e->watchdog_fd = e->epoll_fd = e->realtime.fd = e->boottime.fd = e->monotonic.fd = e->realtime_alarm.fd = e->boottime_alarm.fd = -1;
414 e->realtime.next = e->boottime.next = e->monotonic.next = e->realtime_alarm.next = e->boottime_alarm.next = USEC_INFINITY;
415 e->original_pid = getpid();
416 e->perturb = USEC_INFINITY;
418 assert_se(sigemptyset(&e->sigset) == 0);
420 e->pending = prioq_new(pending_prioq_compare);
426 e->epoll_fd = epoll_create1(EPOLL_CLOEXEC);
427 if (e->epoll_fd < 0) {
440 _public_ sd_event* sd_event_ref(sd_event *e) {
441 assert_return(e, NULL);
443 assert(e->n_ref >= 1);
449 _public_ sd_event* sd_event_unref(sd_event *e) {
454 assert(e->n_ref >= 1);
463 static bool event_pid_changed(sd_event *e) {
466 /* We don't support people creating am event loop and keeping
467 * it around over a fork(). Let's complain. */
469 return e->original_pid != getpid();
472 static int source_io_unregister(sd_event_source *s) {
476 assert(s->type == SOURCE_IO);
478 if (!s->io.registered)
481 r = epoll_ctl(s->event->epoll_fd, EPOLL_CTL_DEL, s->io.fd, NULL);
485 s->io.registered = false;
489 static int source_io_register(
494 struct epoll_event ev = {};
498 assert(s->type == SOURCE_IO);
499 assert(enabled != SD_EVENT_OFF);
504 if (enabled == SD_EVENT_ONESHOT)
505 ev.events |= EPOLLONESHOT;
507 if (s->io.registered)
508 r = epoll_ctl(s->event->epoll_fd, EPOLL_CTL_MOD, s->io.fd, &ev);
510 r = epoll_ctl(s->event->epoll_fd, EPOLL_CTL_ADD, s->io.fd, &ev);
515 s->io.registered = true;
520 static clockid_t event_source_type_to_clock(EventSourceType t) {
524 case SOURCE_TIME_REALTIME:
525 return CLOCK_REALTIME;
527 case SOURCE_TIME_BOOTTIME:
528 return CLOCK_BOOTTIME;
530 case SOURCE_TIME_MONOTONIC:
531 return CLOCK_MONOTONIC;
533 case SOURCE_TIME_REALTIME_ALARM:
534 return CLOCK_REALTIME_ALARM;
536 case SOURCE_TIME_BOOTTIME_ALARM:
537 return CLOCK_BOOTTIME_ALARM;
540 return (clockid_t) -1;
544 static EventSourceType clock_to_event_source_type(clockid_t clock) {
549 return SOURCE_TIME_REALTIME;
552 return SOURCE_TIME_BOOTTIME;
554 case CLOCK_MONOTONIC:
555 return SOURCE_TIME_MONOTONIC;
557 case CLOCK_REALTIME_ALARM:
558 return SOURCE_TIME_REALTIME_ALARM;
560 case CLOCK_BOOTTIME_ALARM:
561 return SOURCE_TIME_BOOTTIME_ALARM;
564 return _SOURCE_EVENT_SOURCE_TYPE_INVALID;
568 static struct clock_data* event_get_clock_data(sd_event *e, EventSourceType t) {
573 case SOURCE_TIME_REALTIME:
576 case SOURCE_TIME_BOOTTIME:
579 case SOURCE_TIME_MONOTONIC:
580 return &e->monotonic;
582 case SOURCE_TIME_REALTIME_ALARM:
583 return &e->realtime_alarm;
585 case SOURCE_TIME_BOOTTIME_ALARM:
586 return &e->boottime_alarm;
593 static bool need_signal(sd_event *e, int signal) {
594 return (e->signal_sources && e->signal_sources[signal] &&
595 e->signal_sources[signal]->enabled != SD_EVENT_OFF)
597 (signal == SIGCHLD &&
598 e->n_enabled_child_sources > 0);
601 static int event_update_signal_fd(sd_event *e) {
602 struct epoll_event ev = {};
608 add_to_epoll = e->signal_fd < 0;
610 r = signalfd(e->signal_fd, &e->sigset, SFD_NONBLOCK|SFD_CLOEXEC);
620 ev.data.ptr = INT_TO_PTR(SOURCE_SIGNAL);
622 r = epoll_ctl(e->epoll_fd, EPOLL_CTL_ADD, e->signal_fd, &ev);
624 e->signal_fd = safe_close(e->signal_fd);
631 static void source_disconnect(sd_event_source *s) {
639 assert(s->event->n_sources > 0);
645 source_io_unregister(s);
649 case SOURCE_TIME_REALTIME:
650 case SOURCE_TIME_BOOTTIME:
651 case SOURCE_TIME_MONOTONIC:
652 case SOURCE_TIME_REALTIME_ALARM:
653 case SOURCE_TIME_BOOTTIME_ALARM: {
654 struct clock_data *d;
656 d = event_get_clock_data(s->event, s->type);
659 prioq_remove(d->earliest, s, &s->time.earliest_index);
660 prioq_remove(d->latest, s, &s->time.latest_index);
661 d->needs_rearm = true;
666 if (s->signal.sig > 0) {
667 if (s->event->signal_sources)
668 s->event->signal_sources[s->signal.sig] = NULL;
670 /* If the signal was on and now it is off... */
671 if (s->enabled != SD_EVENT_OFF && !need_signal(s->event, s->signal.sig)) {
672 assert_se(sigdelset(&s->event->sigset, s->signal.sig) == 0);
674 (void) event_update_signal_fd(s->event);
675 /* If disabling failed, we might get a spurious event,
676 * but otherwise nothing bad should happen. */
683 if (s->child.pid > 0) {
684 if (s->enabled != SD_EVENT_OFF) {
685 assert(s->event->n_enabled_child_sources > 0);
686 s->event->n_enabled_child_sources--;
688 /* We know the signal was on, if it is off now... */
689 if (!need_signal(s->event, SIGCHLD)) {
690 assert_se(sigdelset(&s->event->sigset, SIGCHLD) == 0);
692 (void) event_update_signal_fd(s->event);
693 /* If disabling failed, we might get a spurious event,
694 * but otherwise nothing bad should happen. */
698 hashmap_remove(s->event->child_sources, INT_TO_PTR(s->child.pid));
708 set_remove(s->event->post_sources, s);
712 prioq_remove(s->event->exit, s, &s->exit.prioq_index);
716 assert_not_reached("Wut? I shouldn't exist.");
720 prioq_remove(s->event->pending, s, &s->pending_index);
723 prioq_remove(s->event->prepare, s, &s->prepare_index);
727 s->type = _SOURCE_EVENT_SOURCE_TYPE_INVALID;
729 LIST_REMOVE(sources, event->sources, s);
733 sd_event_unref(event);
736 static void source_free(sd_event_source *s) {
739 source_disconnect(s);
740 free(s->description);
744 static int source_set_pending(sd_event_source *s, bool b) {
748 assert(s->type != SOURCE_EXIT);
756 s->pending_iteration = s->event->iteration;
758 r = prioq_put(s->event->pending, s, &s->pending_index);
764 assert_se(prioq_remove(s->event->pending, s, &s->pending_index));
766 if (EVENT_SOURCE_IS_TIME(s->type)) {
767 struct clock_data *d;
769 d = event_get_clock_data(s->event, s->type);
772 prioq_reshuffle(d->earliest, s, &s->time.earliest_index);
773 prioq_reshuffle(d->latest, s, &s->time.latest_index);
774 d->needs_rearm = true;
780 static sd_event_source *source_new(sd_event *e, bool floating, EventSourceType type) {
785 s = new0(sd_event_source, 1);
791 s->floating = floating;
793 s->pending_index = s->prepare_index = PRIOQ_IDX_NULL;
798 LIST_PREPEND(sources, e->sources, s);
804 _public_ int sd_event_add_io(
806 sd_event_source **ret,
809 sd_event_io_handler_t callback,
815 assert_return(e, -EINVAL);
816 assert_return(fd >= 0, -EINVAL);
817 assert_return(!(events & ~(EPOLLIN|EPOLLOUT|EPOLLRDHUP|EPOLLPRI|EPOLLERR|EPOLLHUP|EPOLLET)), -EINVAL);
818 assert_return(callback, -EINVAL);
819 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
820 assert_return(!event_pid_changed(e), -ECHILD);
822 s = source_new(e, !ret, SOURCE_IO);
827 s->io.events = events;
828 s->io.callback = callback;
829 s->userdata = userdata;
830 s->enabled = SD_EVENT_ON;
832 r = source_io_register(s, s->enabled, events);
844 static void initialize_perturb(sd_event *e) {
845 sd_id128_t bootid = {};
847 /* When we sleep for longer, we try to realign the wakeup to
848 the same time wihtin each minute/second/250ms, so that
849 events all across the system can be coalesced into a single
850 CPU wakeup. However, let's take some system-specific
851 randomness for this value, so that in a network of systems
852 with synced clocks timer events are distributed a
853 bit. Here, we calculate a perturbation usec offset from the
856 if (_likely_(e->perturb != USEC_INFINITY))
859 if (sd_id128_get_boot(&bootid) >= 0)
860 e->perturb = (bootid.qwords[0] ^ bootid.qwords[1]) % USEC_PER_MINUTE;
863 static int event_setup_timer_fd(
865 struct clock_data *d,
868 struct epoll_event ev = {};
874 if (_likely_(d->fd >= 0))
877 fd = timerfd_create(clock, TFD_NONBLOCK|TFD_CLOEXEC);
882 ev.data.ptr = INT_TO_PTR(clock_to_event_source_type(clock));
884 r = epoll_ctl(e->epoll_fd, EPOLL_CTL_ADD, fd, &ev);
894 _public_ int sd_event_add_time(
896 sd_event_source **ret,
900 sd_event_time_handler_t callback,
903 EventSourceType type;
905 struct clock_data *d;
908 assert_return(e, -EINVAL);
909 assert_return(usec != (uint64_t) -1, -EINVAL);
910 assert_return(accuracy != (uint64_t) -1, -EINVAL);
911 assert_return(callback, -EINVAL);
912 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
913 assert_return(!event_pid_changed(e), -ECHILD);
915 type = clock_to_event_source_type(clock);
916 assert_return(type >= 0, -ENOTSUP);
918 d = event_get_clock_data(e, type);
922 d->earliest = prioq_new(earliest_time_prioq_compare);
928 d->latest = prioq_new(latest_time_prioq_compare);
934 r = event_setup_timer_fd(e, d, clock);
939 s = source_new(e, !ret, type);
944 s->time.accuracy = accuracy == 0 ? DEFAULT_ACCURACY_USEC : accuracy;
945 s->time.callback = callback;
946 s->time.earliest_index = s->time.latest_index = PRIOQ_IDX_NULL;
947 s->userdata = userdata;
948 s->enabled = SD_EVENT_ONESHOT;
950 d->needs_rearm = true;
952 r = prioq_put(d->earliest, s, &s->time.earliest_index);
956 r = prioq_put(d->latest, s, &s->time.latest_index);
970 static int signal_exit_callback(sd_event_source *s, const struct signalfd_siginfo *si, void *userdata) {
973 return sd_event_exit(sd_event_source_get_event(s), PTR_TO_INT(userdata));
976 _public_ int sd_event_add_signal(
978 sd_event_source **ret,
980 sd_event_signal_handler_t callback,
988 assert_return(e, -EINVAL);
989 assert_return(sig > 0, -EINVAL);
990 assert_return(sig < _NSIG, -EINVAL);
991 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
992 assert_return(!event_pid_changed(e), -ECHILD);
995 callback = signal_exit_callback;
997 r = pthread_sigmask(SIG_SETMASK, NULL, &ss);
1001 if (!sigismember(&ss, sig))
1004 if (!e->signal_sources) {
1005 e->signal_sources = new0(sd_event_source*, _NSIG);
1006 if (!e->signal_sources)
1008 } else if (e->signal_sources[sig])
1011 previous = need_signal(e, sig);
1013 s = source_new(e, !ret, SOURCE_SIGNAL);
1017 s->signal.sig = sig;
1018 s->signal.callback = callback;
1019 s->userdata = userdata;
1020 s->enabled = SD_EVENT_ON;
1022 e->signal_sources[sig] = s;
1025 assert_se(sigaddset(&e->sigset, sig) == 0);
1027 r = event_update_signal_fd(e);
1040 _public_ int sd_event_add_child(
1042 sd_event_source **ret,
1045 sd_event_child_handler_t callback,
1052 assert_return(e, -EINVAL);
1053 assert_return(pid > 1, -EINVAL);
1054 assert_return(!(options & ~(WEXITED|WSTOPPED|WCONTINUED)), -EINVAL);
1055 assert_return(options != 0, -EINVAL);
1056 assert_return(callback, -EINVAL);
1057 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
1058 assert_return(!event_pid_changed(e), -ECHILD);
1060 r = hashmap_ensure_allocated(&e->child_sources, NULL);
1064 if (hashmap_contains(e->child_sources, INT_TO_PTR(pid)))
1067 previous = need_signal(e, SIGCHLD);
1069 s = source_new(e, !ret, SOURCE_CHILD);
1074 s->child.options = options;
1075 s->child.callback = callback;
1076 s->userdata = userdata;
1077 s->enabled = SD_EVENT_ONESHOT;
1079 r = hashmap_put(e->child_sources, INT_TO_PTR(pid), s);
1085 e->n_enabled_child_sources ++;
1088 assert_se(sigaddset(&e->sigset, SIGCHLD) == 0);
1090 r = event_update_signal_fd(e);
1097 e->need_process_child = true;
1105 _public_ int sd_event_add_defer(
1107 sd_event_source **ret,
1108 sd_event_handler_t callback,
1114 assert_return(e, -EINVAL);
1115 assert_return(callback, -EINVAL);
1116 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
1117 assert_return(!event_pid_changed(e), -ECHILD);
1119 s = source_new(e, !ret, SOURCE_DEFER);
1123 s->defer.callback = callback;
1124 s->userdata = userdata;
1125 s->enabled = SD_EVENT_ONESHOT;
1127 r = source_set_pending(s, true);
1139 _public_ int sd_event_add_post(
1141 sd_event_source **ret,
1142 sd_event_handler_t callback,
1148 assert_return(e, -EINVAL);
1149 assert_return(callback, -EINVAL);
1150 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
1151 assert_return(!event_pid_changed(e), -ECHILD);
1153 r = set_ensure_allocated(&e->post_sources, NULL);
1157 s = source_new(e, !ret, SOURCE_POST);
1161 s->post.callback = callback;
1162 s->userdata = userdata;
1163 s->enabled = SD_EVENT_ON;
1165 r = set_put(e->post_sources, s);
1177 _public_ int sd_event_add_exit(
1179 sd_event_source **ret,
1180 sd_event_handler_t callback,
1186 assert_return(e, -EINVAL);
1187 assert_return(callback, -EINVAL);
1188 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
1189 assert_return(!event_pid_changed(e), -ECHILD);
1192 e->exit = prioq_new(exit_prioq_compare);
1197 s = source_new(e, !ret, SOURCE_EXIT);
1201 s->exit.callback = callback;
1202 s->userdata = userdata;
1203 s->exit.prioq_index = PRIOQ_IDX_NULL;
1204 s->enabled = SD_EVENT_ONESHOT;
1206 r = prioq_put(s->event->exit, s, &s->exit.prioq_index);
1218 _public_ sd_event_source* sd_event_source_ref(sd_event_source *s) {
1219 assert_return(s, NULL);
1221 assert(s->n_ref >= 1);
1227 _public_ sd_event_source* sd_event_source_unref(sd_event_source *s) {
1232 assert(s->n_ref >= 1);
1235 if (s->n_ref <= 0) {
1236 /* Here's a special hack: when we are called from a
1237 * dispatch handler we won't free the event source
1238 * immediately, but we will detach the fd from the
1239 * epoll. This way it is safe for the caller to unref
1240 * the event source and immediately close the fd, but
1241 * we still retain a valid event source object after
1244 if (s->dispatching) {
1245 if (s->type == SOURCE_IO)
1246 source_io_unregister(s);
1248 source_disconnect(s);
1256 _public_ int sd_event_source_set_description(sd_event_source *s, const char *description) {
1257 assert_return(s, -EINVAL);
1259 return free_and_strdup(&s->description, description);
1262 _public_ int sd_event_source_get_description(sd_event_source *s, const char **description) {
1263 assert_return(s, -EINVAL);
1264 assert_return(description, -EINVAL);
1266 *description = s->description;
1270 _public_ sd_event *sd_event_source_get_event(sd_event_source *s) {
1271 assert_return(s, NULL);
1276 _public_ int sd_event_source_get_pending(sd_event_source *s) {
1277 assert_return(s, -EINVAL);
1278 assert_return(s->type != SOURCE_EXIT, -EDOM);
1279 assert_return(s->event->state != SD_EVENT_FINISHED, -ESTALE);
1280 assert_return(!event_pid_changed(s->event), -ECHILD);
1285 _public_ int sd_event_source_get_io_fd(sd_event_source *s) {
1286 assert_return(s, -EINVAL);
1287 assert_return(s->type == SOURCE_IO, -EDOM);
1288 assert_return(!event_pid_changed(s->event), -ECHILD);
1293 _public_ int sd_event_source_set_io_fd(sd_event_source *s, int fd) {
1296 assert_return(s, -EINVAL);
1297 assert_return(fd >= 0, -EINVAL);
1298 assert_return(s->type == SOURCE_IO, -EDOM);
1299 assert_return(!event_pid_changed(s->event), -ECHILD);
1304 if (s->enabled == SD_EVENT_OFF) {
1306 s->io.registered = false;
1310 saved_fd = s->io.fd;
1311 assert(s->io.registered);
1314 s->io.registered = false;
1316 r = source_io_register(s, s->enabled, s->io.events);
1318 s->io.fd = saved_fd;
1319 s->io.registered = true;
1323 epoll_ctl(s->event->epoll_fd, EPOLL_CTL_DEL, saved_fd, NULL);
1329 _public_ int sd_event_source_get_io_events(sd_event_source *s, uint32_t* events) {
1330 assert_return(s, -EINVAL);
1331 assert_return(events, -EINVAL);
1332 assert_return(s->type == SOURCE_IO, -EDOM);
1333 assert_return(!event_pid_changed(s->event), -ECHILD);
1335 *events = s->io.events;
1339 _public_ int sd_event_source_set_io_events(sd_event_source *s, uint32_t events) {
1342 assert_return(s, -EINVAL);
1343 assert_return(s->type == SOURCE_IO, -EDOM);
1344 assert_return(!(events & ~(EPOLLIN|EPOLLOUT|EPOLLRDHUP|EPOLLPRI|EPOLLERR|EPOLLHUP|EPOLLET)), -EINVAL);
1345 assert_return(s->event->state != SD_EVENT_FINISHED, -ESTALE);
1346 assert_return(!event_pid_changed(s->event), -ECHILD);
1348 /* edge-triggered updates are never skipped, so we can reset edges */
1349 if (s->io.events == events && !(events & EPOLLET))
1352 if (s->enabled != SD_EVENT_OFF) {
1353 r = source_io_register(s, s->enabled, events);
1358 s->io.events = events;
1359 source_set_pending(s, false);
1364 _public_ int sd_event_source_get_io_revents(sd_event_source *s, uint32_t* revents) {
1365 assert_return(s, -EINVAL);
1366 assert_return(revents, -EINVAL);
1367 assert_return(s->type == SOURCE_IO, -EDOM);
1368 assert_return(s->pending, -ENODATA);
1369 assert_return(!event_pid_changed(s->event), -ECHILD);
1371 *revents = s->io.revents;
1375 _public_ int sd_event_source_get_signal(sd_event_source *s) {
1376 assert_return(s, -EINVAL);
1377 assert_return(s->type == SOURCE_SIGNAL, -EDOM);
1378 assert_return(!event_pid_changed(s->event), -ECHILD);
1380 return s->signal.sig;
1383 _public_ int sd_event_source_get_priority(sd_event_source *s, int64_t *priority) {
1384 assert_return(s, -EINVAL);
1385 assert_return(!event_pid_changed(s->event), -ECHILD);
1390 _public_ int sd_event_source_set_priority(sd_event_source *s, int64_t priority) {
1391 assert_return(s, -EINVAL);
1392 assert_return(s->event->state != SD_EVENT_FINISHED, -ESTALE);
1393 assert_return(!event_pid_changed(s->event), -ECHILD);
1395 if (s->priority == priority)
1398 s->priority = priority;
1401 prioq_reshuffle(s->event->pending, s, &s->pending_index);
1404 prioq_reshuffle(s->event->prepare, s, &s->prepare_index);
1406 if (s->type == SOURCE_EXIT)
1407 prioq_reshuffle(s->event->exit, s, &s->exit.prioq_index);
1412 _public_ int sd_event_source_get_enabled(sd_event_source *s, int *m) {
1413 assert_return(s, -EINVAL);
1414 assert_return(m, -EINVAL);
1415 assert_return(!event_pid_changed(s->event), -ECHILD);
1421 _public_ int sd_event_source_set_enabled(sd_event_source *s, int m) {
1424 assert_return(s, -EINVAL);
1425 assert_return(m == SD_EVENT_OFF || m == SD_EVENT_ON || m == SD_EVENT_ONESHOT, -EINVAL);
1426 assert_return(!event_pid_changed(s->event), -ECHILD);
1428 /* If we are dead anyway, we are fine with turning off
1429 * sources, but everything else needs to fail. */
1430 if (s->event->state == SD_EVENT_FINISHED)
1431 return m == SD_EVENT_OFF ? 0 : -ESTALE;
1433 if (s->enabled == m)
1436 if (m == SD_EVENT_OFF) {
1441 r = source_io_unregister(s);
1448 case SOURCE_TIME_REALTIME:
1449 case SOURCE_TIME_BOOTTIME:
1450 case SOURCE_TIME_MONOTONIC:
1451 case SOURCE_TIME_REALTIME_ALARM:
1452 case SOURCE_TIME_BOOTTIME_ALARM: {
1453 struct clock_data *d;
1456 d = event_get_clock_data(s->event, s->type);
1459 prioq_reshuffle(d->earliest, s, &s->time.earliest_index);
1460 prioq_reshuffle(d->latest, s, &s->time.latest_index);
1461 d->needs_rearm = true;
1466 assert(need_signal(s->event, s->signal.sig));
1470 if (!need_signal(s->event, s->signal.sig)) {
1471 assert_se(sigdelset(&s->event->sigset, s->signal.sig) == 0);
1473 (void) event_update_signal_fd(s->event);
1474 /* If disabling failed, we might get a spurious event,
1475 * but otherwise nothing bad should happen. */
1481 assert(need_signal(s->event, SIGCHLD));
1485 assert(s->event->n_enabled_child_sources > 0);
1486 s->event->n_enabled_child_sources--;
1488 if (!need_signal(s->event, SIGCHLD)) {
1489 assert_se(sigdelset(&s->event->sigset, SIGCHLD) == 0);
1491 (void) event_update_signal_fd(s->event);
1498 prioq_reshuffle(s->event->exit, s, &s->exit.prioq_index);
1507 assert_not_reached("Wut? I shouldn't exist.");
1514 r = source_io_register(s, m, s->io.events);
1521 case SOURCE_TIME_REALTIME:
1522 case SOURCE_TIME_BOOTTIME:
1523 case SOURCE_TIME_MONOTONIC:
1524 case SOURCE_TIME_REALTIME_ALARM:
1525 case SOURCE_TIME_BOOTTIME_ALARM: {
1526 struct clock_data *d;
1529 d = event_get_clock_data(s->event, s->type);
1532 prioq_reshuffle(d->earliest, s, &s->time.earliest_index);
1533 prioq_reshuffle(d->latest, s, &s->time.latest_index);
1534 d->needs_rearm = true;
1539 /* Check status before enabling. */
1540 if (!need_signal(s->event, s->signal.sig)) {
1541 assert_se(sigaddset(&s->event->sigset, s->signal.sig) == 0);
1543 r = event_update_signal_fd(s->event);
1545 s->enabled = SD_EVENT_OFF;
1554 /* Check status before enabling. */
1555 if (s->enabled == SD_EVENT_OFF) {
1556 if (!need_signal(s->event, SIGCHLD)) {
1557 assert_se(sigaddset(&s->event->sigset, s->signal.sig) == 0);
1559 r = event_update_signal_fd(s->event);
1561 s->enabled = SD_EVENT_OFF;
1566 s->event->n_enabled_child_sources++;
1574 prioq_reshuffle(s->event->exit, s, &s->exit.prioq_index);
1583 assert_not_reached("Wut? I shouldn't exist.");
1588 prioq_reshuffle(s->event->pending, s, &s->pending_index);
1591 prioq_reshuffle(s->event->prepare, s, &s->prepare_index);
1596 _public_ int sd_event_source_get_time(sd_event_source *s, uint64_t *usec) {
1597 assert_return(s, -EINVAL);
1598 assert_return(usec, -EINVAL);
1599 assert_return(EVENT_SOURCE_IS_TIME(s->type), -EDOM);
1600 assert_return(!event_pid_changed(s->event), -ECHILD);
1602 *usec = s->time.next;
1606 _public_ int sd_event_source_set_time(sd_event_source *s, uint64_t usec) {
1607 struct clock_data *d;
1609 assert_return(s, -EINVAL);
1610 assert_return(usec != (uint64_t) -1, -EINVAL);
1611 assert_return(EVENT_SOURCE_IS_TIME(s->type), -EDOM);
1612 assert_return(s->event->state != SD_EVENT_FINISHED, -ESTALE);
1613 assert_return(!event_pid_changed(s->event), -ECHILD);
1615 s->time.next = usec;
1617 source_set_pending(s, false);
1619 d = event_get_clock_data(s->event, s->type);
1622 prioq_reshuffle(d->earliest, s, &s->time.earliest_index);
1623 prioq_reshuffle(d->latest, s, &s->time.latest_index);
1624 d->needs_rearm = true;
1629 _public_ int sd_event_source_get_time_accuracy(sd_event_source *s, uint64_t *usec) {
1630 assert_return(s, -EINVAL);
1631 assert_return(usec, -EINVAL);
1632 assert_return(EVENT_SOURCE_IS_TIME(s->type), -EDOM);
1633 assert_return(!event_pid_changed(s->event), -ECHILD);
1635 *usec = s->time.accuracy;
1639 _public_ int sd_event_source_set_time_accuracy(sd_event_source *s, uint64_t usec) {
1640 struct clock_data *d;
1642 assert_return(s, -EINVAL);
1643 assert_return(usec != (uint64_t) -1, -EINVAL);
1644 assert_return(EVENT_SOURCE_IS_TIME(s->type), -EDOM);
1645 assert_return(s->event->state != SD_EVENT_FINISHED, -ESTALE);
1646 assert_return(!event_pid_changed(s->event), -ECHILD);
1649 usec = DEFAULT_ACCURACY_USEC;
1651 s->time.accuracy = usec;
1653 source_set_pending(s, false);
1655 d = event_get_clock_data(s->event, s->type);
1658 prioq_reshuffle(d->latest, s, &s->time.latest_index);
1659 d->needs_rearm = true;
1664 _public_ int sd_event_source_get_time_clock(sd_event_source *s, clockid_t *clock) {
1665 assert_return(s, -EINVAL);
1666 assert_return(clock, -EINVAL);
1667 assert_return(EVENT_SOURCE_IS_TIME(s->type), -EDOM);
1668 assert_return(!event_pid_changed(s->event), -ECHILD);
1670 *clock = event_source_type_to_clock(s->type);
1674 _public_ int sd_event_source_get_child_pid(sd_event_source *s, pid_t *pid) {
1675 assert_return(s, -EINVAL);
1676 assert_return(pid, -EINVAL);
1677 assert_return(s->type == SOURCE_CHILD, -EDOM);
1678 assert_return(!event_pid_changed(s->event), -ECHILD);
1680 *pid = s->child.pid;
1684 _public_ int sd_event_source_set_prepare(sd_event_source *s, sd_event_handler_t callback) {
1687 assert_return(s, -EINVAL);
1688 assert_return(s->type != SOURCE_EXIT, -EDOM);
1689 assert_return(s->event->state != SD_EVENT_FINISHED, -ESTALE);
1690 assert_return(!event_pid_changed(s->event), -ECHILD);
1692 if (s->prepare == callback)
1695 if (callback && s->prepare) {
1696 s->prepare = callback;
1700 r = prioq_ensure_allocated(&s->event->prepare, prepare_prioq_compare);
1704 s->prepare = callback;
1707 r = prioq_put(s->event->prepare, s, &s->prepare_index);
1711 prioq_remove(s->event->prepare, s, &s->prepare_index);
1716 _public_ void* sd_event_source_get_userdata(sd_event_source *s) {
1717 assert_return(s, NULL);
1722 _public_ void *sd_event_source_set_userdata(sd_event_source *s, void *userdata) {
1725 assert_return(s, NULL);
1728 s->userdata = userdata;
1733 static usec_t sleep_between(sd_event *e, usec_t a, usec_t b) {
1744 initialize_perturb(e);
1747 Find a good time to wake up again between times a and b. We
1748 have two goals here:
1750 a) We want to wake up as seldom as possible, hence prefer
1751 later times over earlier times.
1753 b) But if we have to wake up, then let's make sure to
1754 dispatch as much as possible on the entire system.
1756 We implement this by waking up everywhere at the same time
1757 within any given minute if we can, synchronised via the
1758 perturbation value determined from the boot ID. If we can't,
1759 then we try to find the same spot in every 10s, then 1s and
1760 then 250ms step. Otherwise, we pick the last possible time
1764 c = (b / USEC_PER_MINUTE) * USEC_PER_MINUTE + e->perturb;
1766 if (_unlikely_(c < USEC_PER_MINUTE))
1769 c -= USEC_PER_MINUTE;
1775 c = (b / (USEC_PER_SEC*10)) * (USEC_PER_SEC*10) + (e->perturb % (USEC_PER_SEC*10));
1777 if (_unlikely_(c < USEC_PER_SEC*10))
1780 c -= USEC_PER_SEC*10;
1786 c = (b / USEC_PER_SEC) * USEC_PER_SEC + (e->perturb % USEC_PER_SEC);
1788 if (_unlikely_(c < USEC_PER_SEC))
1797 c = (b / (USEC_PER_MSEC*250)) * (USEC_PER_MSEC*250) + (e->perturb % (USEC_PER_MSEC*250));
1799 if (_unlikely_(c < USEC_PER_MSEC*250))
1802 c -= USEC_PER_MSEC*250;
1811 static int event_arm_timer(
1813 struct clock_data *d) {
1815 struct itimerspec its = {};
1816 sd_event_source *a, *b;
1823 if (!d->needs_rearm)
1826 d->needs_rearm = false;
1828 a = prioq_peek(d->earliest);
1829 if (!a || a->enabled == SD_EVENT_OFF) {
1834 if (d->next == USEC_INFINITY)
1838 r = timerfd_settime(d->fd, TFD_TIMER_ABSTIME, &its, NULL);
1842 d->next = USEC_INFINITY;
1846 b = prioq_peek(d->latest);
1847 assert_se(b && b->enabled != SD_EVENT_OFF);
1849 t = sleep_between(e, a->time.next, b->time.next + b->time.accuracy);
1853 assert_se(d->fd >= 0);
1856 /* We don' want to disarm here, just mean some time looooong ago. */
1857 its.it_value.tv_sec = 0;
1858 its.it_value.tv_nsec = 1;
1860 timespec_store(&its.it_value, t);
1862 r = timerfd_settime(d->fd, TFD_TIMER_ABSTIME, &its, NULL);
1870 static int process_io(sd_event *e, sd_event_source *s, uint32_t revents) {
1873 assert(s->type == SOURCE_IO);
1875 /* If the event source was already pending, we just OR in the
1876 * new revents, otherwise we reset the value. The ORing is
1877 * necessary to handle EPOLLONESHOT events properly where
1878 * readability might happen independently of writability, and
1879 * we need to keep track of both */
1882 s->io.revents |= revents;
1884 s->io.revents = revents;
1886 return source_set_pending(s, true);
1889 static int flush_timer(sd_event *e, int fd, uint32_t events, usec_t *next) {
1896 assert_return(events == EPOLLIN, -EIO);
1898 ss = read(fd, &x, sizeof(x));
1900 if (errno == EAGAIN || errno == EINTR)
1906 if (_unlikely_(ss != sizeof(x)))
1910 *next = USEC_INFINITY;
1915 static int process_timer(
1918 struct clock_data *d) {
1927 s = prioq_peek(d->earliest);
1930 s->enabled == SD_EVENT_OFF ||
1934 r = source_set_pending(s, true);
1938 prioq_reshuffle(d->earliest, s, &s->time.earliest_index);
1939 prioq_reshuffle(d->latest, s, &s->time.latest_index);
1940 d->needs_rearm = true;
1946 static int process_child(sd_event *e) {
1953 e->need_process_child = false;
1956 So, this is ugly. We iteratively invoke waitid() with P_PID
1957 + WNOHANG for each PID we wait for, instead of using
1958 P_ALL. This is because we only want to get child
1959 information of very specific child processes, and not all
1960 of them. We might not have processed the SIGCHLD even of a
1961 previous invocation and we don't want to maintain a
1962 unbounded *per-child* event queue, hence we really don't
1963 want anything flushed out of the kernel's queue that we
1964 don't care about. Since this is O(n) this means that if you
1965 have a lot of processes you probably want to handle SIGCHLD
1968 We do not reap the children here (by using WNOWAIT), this
1969 is only done after the event source is dispatched so that
1970 the callback still sees the process as a zombie.
1973 HASHMAP_FOREACH(s, e->child_sources, i) {
1974 assert(s->type == SOURCE_CHILD);
1979 if (s->enabled == SD_EVENT_OFF)
1982 zero(s->child.siginfo);
1983 r = waitid(P_PID, s->child.pid, &s->child.siginfo,
1984 WNOHANG | (s->child.options & WEXITED ? WNOWAIT : 0) | s->child.options);
1988 if (s->child.siginfo.si_pid != 0) {
1990 s->child.siginfo.si_code == CLD_EXITED ||
1991 s->child.siginfo.si_code == CLD_KILLED ||
1992 s->child.siginfo.si_code == CLD_DUMPED;
1994 if (!zombie && (s->child.options & WEXITED)) {
1995 /* If the child isn't dead then let's
1996 * immediately remove the state change
1997 * from the queue, since there's no
1998 * benefit in leaving it queued */
2000 assert(s->child.options & (WSTOPPED|WCONTINUED));
2001 waitid(P_PID, s->child.pid, &s->child.siginfo, WNOHANG|(s->child.options & (WSTOPPED|WCONTINUED)));
2004 r = source_set_pending(s, true);
2013 static int process_signal(sd_event *e, uint32_t events) {
2014 bool read_one = false;
2019 assert_return(events == EPOLLIN, -EIO);
2022 struct signalfd_siginfo si;
2024 sd_event_source *s = NULL;
2026 n = read(e->signal_fd, &si, sizeof(si));
2028 if (errno == EAGAIN || errno == EINTR)
2034 if (_unlikely_(n != sizeof(si)))
2037 assert(si.ssi_signo < _NSIG);
2041 if (si.ssi_signo == SIGCHLD) {
2042 r = process_child(e);
2049 if (e->signal_sources)
2050 s = e->signal_sources[si.ssi_signo];
2055 s->signal.siginfo = si;
2056 r = source_set_pending(s, true);
2062 static int source_dispatch(sd_event_source *s) {
2066 assert(s->pending || s->type == SOURCE_EXIT);
2068 if (s->type != SOURCE_DEFER && s->type != SOURCE_EXIT) {
2069 r = source_set_pending(s, false);
2074 if (s->type != SOURCE_POST) {
2078 /* If we execute a non-post source, let's mark all
2079 * post sources as pending */
2081 SET_FOREACH(z, s->event->post_sources, i) {
2082 if (z->enabled == SD_EVENT_OFF)
2085 r = source_set_pending(z, true);
2091 if (s->enabled == SD_EVENT_ONESHOT) {
2092 r = sd_event_source_set_enabled(s, SD_EVENT_OFF);
2097 s->dispatching = true;
2102 r = s->io.callback(s, s->io.fd, s->io.revents, s->userdata);
2105 case SOURCE_TIME_REALTIME:
2106 case SOURCE_TIME_BOOTTIME:
2107 case SOURCE_TIME_MONOTONIC:
2108 case SOURCE_TIME_REALTIME_ALARM:
2109 case SOURCE_TIME_BOOTTIME_ALARM:
2110 r = s->time.callback(s, s->time.next, s->userdata);
2114 r = s->signal.callback(s, &s->signal.siginfo, s->userdata);
2117 case SOURCE_CHILD: {
2120 zombie = s->child.siginfo.si_code == CLD_EXITED ||
2121 s->child.siginfo.si_code == CLD_KILLED ||
2122 s->child.siginfo.si_code == CLD_DUMPED;
2124 r = s->child.callback(s, &s->child.siginfo, s->userdata);
2126 /* Now, reap the PID for good. */
2128 waitid(P_PID, s->child.pid, &s->child.siginfo, WNOHANG|WEXITED);
2134 r = s->defer.callback(s, s->userdata);
2138 r = s->post.callback(s, s->userdata);
2142 r = s->exit.callback(s, s->userdata);
2145 case SOURCE_WATCHDOG:
2146 case _SOURCE_EVENT_SOURCE_TYPE_MAX:
2147 case _SOURCE_EVENT_SOURCE_TYPE_INVALID:
2148 assert_not_reached("Wut? I shouldn't exist.");
2151 s->dispatching = false;
2155 log_debug("Event source '%s' returned error, disabling: %s", s->description, strerror(-r));
2157 log_debug("Event source %p returned error, disabling: %s", s, strerror(-r));
2163 sd_event_source_set_enabled(s, SD_EVENT_OFF);
2168 static int event_prepare(sd_event *e) {
2176 s = prioq_peek(e->prepare);
2177 if (!s || s->prepare_iteration == e->iteration || s->enabled == SD_EVENT_OFF)
2180 s->prepare_iteration = e->iteration;
2181 r = prioq_reshuffle(e->prepare, s, &s->prepare_index);
2187 s->dispatching = true;
2188 r = s->prepare(s, s->userdata);
2189 s->dispatching = false;
2193 log_debug("Prepare callback of event source '%s' returned error, disabling: %s", s->description, strerror(-r));
2195 log_debug("Prepare callback of event source %p returned error, disabling: %s", s, strerror(-r));
2201 sd_event_source_set_enabled(s, SD_EVENT_OFF);
2207 static int dispatch_exit(sd_event *e) {
2213 p = prioq_peek(e->exit);
2214 if (!p || p->enabled == SD_EVENT_OFF) {
2215 e->state = SD_EVENT_FINISHED;
2221 e->state = SD_EVENT_EXITING;
2223 r = source_dispatch(p);
2225 e->state = SD_EVENT_PASSIVE;
2231 static sd_event_source* event_next_pending(sd_event *e) {
2236 p = prioq_peek(e->pending);
2240 if (p->enabled == SD_EVENT_OFF)
2246 static int arm_watchdog(sd_event *e) {
2247 struct itimerspec its = {};
2252 assert(e->watchdog_fd >= 0);
2254 t = sleep_between(e,
2255 e->watchdog_last + (e->watchdog_period / 2),
2256 e->watchdog_last + (e->watchdog_period * 3 / 4));
2258 timespec_store(&its.it_value, t);
2260 /* Make sure we never set the watchdog to 0, which tells the
2261 * kernel to disable it. */
2262 if (its.it_value.tv_sec == 0 && its.it_value.tv_nsec == 0)
2263 its.it_value.tv_nsec = 1;
2265 r = timerfd_settime(e->watchdog_fd, TFD_TIMER_ABSTIME, &its, NULL);
2272 static int process_watchdog(sd_event *e) {
2278 /* Don't notify watchdog too often */
2279 if (e->watchdog_last + e->watchdog_period / 4 > e->timestamp.monotonic)
2282 sd_notify(false, "WATCHDOG=1");
2283 e->watchdog_last = e->timestamp.monotonic;
2285 return arm_watchdog(e);
2288 _public_ int sd_event_prepare(sd_event *e) {
2291 assert_return(e, -EINVAL);
2292 assert_return(!event_pid_changed(e), -ECHILD);
2293 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
2294 assert_return(e->state == SD_EVENT_PASSIVE, -EBUSY);
2296 if (e->exit_requested)
2301 r = event_prepare(e);
2305 r = event_arm_timer(e, &e->realtime);
2309 r = event_arm_timer(e, &e->boottime);
2313 r = event_arm_timer(e, &e->monotonic);
2317 r = event_arm_timer(e, &e->realtime_alarm);
2321 r = event_arm_timer(e, &e->boottime_alarm);
2325 if (event_next_pending(e) || e->need_process_child)
2328 e->state = SD_EVENT_PREPARED;
2333 e->state = SD_EVENT_PREPARED;
2334 r = sd_event_wait(e, 0);
2336 e->state = SD_EVENT_PREPARED;
2341 _public_ int sd_event_wait(sd_event *e, uint64_t timeout) {
2342 struct epoll_event *ev_queue;
2343 unsigned ev_queue_max;
2346 assert_return(e, -EINVAL);
2347 assert_return(!event_pid_changed(e), -ECHILD);
2348 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
2349 assert_return(e->state == SD_EVENT_PREPARED, -EBUSY);
2351 if (e->exit_requested) {
2352 e->state = SD_EVENT_PENDING;
2356 ev_queue_max = CLAMP(e->n_sources, 1U, EPOLL_QUEUE_MAX);
2357 ev_queue = newa(struct epoll_event, ev_queue_max);
2359 m = epoll_wait(e->epoll_fd, ev_queue, ev_queue_max,
2360 timeout == (uint64_t) -1 ? -1 : (int) ((timeout + USEC_PER_MSEC - 1) / USEC_PER_MSEC));
2362 if (errno == EINTR) {
2363 e->state = SD_EVENT_PENDING;
2372 dual_timestamp_get(&e->timestamp);
2373 e->timestamp_boottime = now(CLOCK_BOOTTIME);
2375 for (i = 0; i < m; i++) {
2377 if (ev_queue[i].data.ptr == INT_TO_PTR(SOURCE_TIME_REALTIME))
2378 r = flush_timer(e, e->realtime.fd, ev_queue[i].events, &e->realtime.next);
2379 else if (ev_queue[i].data.ptr == INT_TO_PTR(SOURCE_TIME_BOOTTIME))
2380 r = flush_timer(e, e->boottime.fd, ev_queue[i].events, &e->boottime.next);
2381 else if (ev_queue[i].data.ptr == INT_TO_PTR(SOURCE_TIME_MONOTONIC))
2382 r = flush_timer(e, e->monotonic.fd, ev_queue[i].events, &e->monotonic.next);
2383 else if (ev_queue[i].data.ptr == INT_TO_PTR(SOURCE_TIME_REALTIME_ALARM))
2384 r = flush_timer(e, e->realtime_alarm.fd, ev_queue[i].events, &e->realtime_alarm.next);
2385 else if (ev_queue[i].data.ptr == INT_TO_PTR(SOURCE_TIME_BOOTTIME_ALARM))
2386 r = flush_timer(e, e->boottime_alarm.fd, ev_queue[i].events, &e->boottime_alarm.next);
2387 else if (ev_queue[i].data.ptr == INT_TO_PTR(SOURCE_SIGNAL))
2388 r = process_signal(e, ev_queue[i].events);
2389 else if (ev_queue[i].data.ptr == INT_TO_PTR(SOURCE_WATCHDOG))
2390 r = flush_timer(e, e->watchdog_fd, ev_queue[i].events, NULL);
2392 r = process_io(e, ev_queue[i].data.ptr, ev_queue[i].events);
2398 r = process_watchdog(e);
2402 r = process_timer(e, e->timestamp.realtime, &e->realtime);
2406 r = process_timer(e, e->timestamp_boottime, &e->boottime);
2410 r = process_timer(e, e->timestamp.monotonic, &e->monotonic);
2414 r = process_timer(e, e->timestamp.realtime, &e->realtime_alarm);
2418 r = process_timer(e, e->timestamp_boottime, &e->boottime_alarm);
2422 if (e->need_process_child) {
2423 r = process_child(e);
2428 if (event_next_pending(e)) {
2429 e->state = SD_EVENT_PENDING;
2437 e->state = SD_EVENT_PASSIVE;
2442 _public_ int sd_event_dispatch(sd_event *e) {
2446 assert_return(e, -EINVAL);
2447 assert_return(!event_pid_changed(e), -ECHILD);
2448 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
2449 assert_return(e->state == SD_EVENT_PENDING, -EBUSY);
2451 if (e->exit_requested)
2452 return dispatch_exit(e);
2454 p = event_next_pending(e);
2458 e->state = SD_EVENT_RUNNING;
2459 r = source_dispatch(p);
2460 e->state = SD_EVENT_PASSIVE;
2467 e->state = SD_EVENT_PASSIVE;
2472 _public_ int sd_event_run(sd_event *e, uint64_t timeout) {
2475 assert_return(e, -EINVAL);
2476 assert_return(!event_pid_changed(e), -ECHILD);
2477 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
2478 assert_return(e->state == SD_EVENT_PASSIVE, -EBUSY);
2480 r = sd_event_prepare(e);
2482 return sd_event_dispatch(e);
2486 r = sd_event_wait(e, timeout);
2488 return sd_event_dispatch(e);
2493 _public_ int sd_event_loop(sd_event *e) {
2496 assert_return(e, -EINVAL);
2497 assert_return(!event_pid_changed(e), -ECHILD);
2498 assert_return(e->state == SD_EVENT_PASSIVE, -EBUSY);
2502 while (e->state != SD_EVENT_FINISHED) {
2503 r = sd_event_run(e, (uint64_t) -1);
2515 _public_ int sd_event_get_fd(sd_event *e) {
2517 assert_return(e, -EINVAL);
2518 assert_return(!event_pid_changed(e), -ECHILD);
2523 _public_ int sd_event_get_state(sd_event *e) {
2524 assert_return(e, -EINVAL);
2525 assert_return(!event_pid_changed(e), -ECHILD);
2530 _public_ int sd_event_get_exit_code(sd_event *e, int *code) {
2531 assert_return(e, -EINVAL);
2532 assert_return(code, -EINVAL);
2533 assert_return(!event_pid_changed(e), -ECHILD);
2535 if (!e->exit_requested)
2538 *code = e->exit_code;
2542 _public_ int sd_event_exit(sd_event *e, int code) {
2543 assert_return(e, -EINVAL);
2544 assert_return(e->state != SD_EVENT_FINISHED, -ESTALE);
2545 assert_return(!event_pid_changed(e), -ECHILD);
2547 e->exit_requested = true;
2548 e->exit_code = code;
2553 _public_ int sd_event_now(sd_event *e, clockid_t clock, uint64_t *usec) {
2554 assert_return(e, -EINVAL);
2555 assert_return(usec, -EINVAL);
2556 assert_return(!event_pid_changed(e), -ECHILD);
2558 /* If we haven't run yet, just get the actual time */
2559 if (!dual_timestamp_is_set(&e->timestamp))
2564 case CLOCK_REALTIME:
2565 case CLOCK_REALTIME_ALARM:
2566 *usec = e->timestamp.realtime;
2569 case CLOCK_MONOTONIC:
2570 *usec = e->timestamp.monotonic;
2573 case CLOCK_BOOTTIME:
2574 case CLOCK_BOOTTIME_ALARM:
2575 *usec = e->timestamp_boottime;
2582 _public_ int sd_event_default(sd_event **ret) {
2584 static thread_local sd_event *default_event = NULL;
2589 return !!default_event;
2591 if (default_event) {
2592 *ret = sd_event_ref(default_event);
2596 r = sd_event_new(&e);
2600 e->default_event_ptr = &default_event;
2608 _public_ int sd_event_get_tid(sd_event *e, pid_t *tid) {
2609 assert_return(e, -EINVAL);
2610 assert_return(tid, -EINVAL);
2611 assert_return(!event_pid_changed(e), -ECHILD);
2621 _public_ int sd_event_set_watchdog(sd_event *e, int b) {
2624 assert_return(e, -EINVAL);
2625 assert_return(!event_pid_changed(e), -ECHILD);
2627 if (e->watchdog == !!b)
2631 struct epoll_event ev = {};
2633 r = sd_watchdog_enabled(false, &e->watchdog_period);
2637 /* Issue first ping immediately */
2638 sd_notify(false, "WATCHDOG=1");
2639 e->watchdog_last = now(CLOCK_MONOTONIC);
2641 e->watchdog_fd = timerfd_create(CLOCK_MONOTONIC, TFD_NONBLOCK|TFD_CLOEXEC);
2642 if (e->watchdog_fd < 0)
2645 r = arm_watchdog(e);
2649 ev.events = EPOLLIN;
2650 ev.data.ptr = INT_TO_PTR(SOURCE_WATCHDOG);
2652 r = epoll_ctl(e->epoll_fd, EPOLL_CTL_ADD, e->watchdog_fd, &ev);
2659 if (e->watchdog_fd >= 0) {
2660 epoll_ctl(e->epoll_fd, EPOLL_CTL_DEL, e->watchdog_fd, NULL);
2661 e->watchdog_fd = safe_close(e->watchdog_fd);
2669 e->watchdog_fd = safe_close(e->watchdog_fd);
2673 _public_ int sd_event_get_watchdog(sd_event *e) {
2674 assert_return(e, -EINVAL);
2675 assert_return(!event_pid_changed(e), -ECHILD);