]>
Commit | Line | Data |
---|---|---|
53e1b683 | 1 | /* SPDX-License-Identifier: LGPL-2.1+ */ |
fd38203a LP |
2 | #ifndef foosdeventhfoo |
3 | #define foosdeventhfoo | |
4 | ||
5 | /*** | |
fd38203a LP |
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 | ||
fd38203a LP |
20 | #include <inttypes.h> |
21 | #include <signal.h> | |
71d35b6b | 22 | #include <sys/epoll.h> |
97ef5391 | 23 | #include <sys/inotify.h> |
71d35b6b TA |
24 | #include <sys/signalfd.h> |
25 | #include <sys/types.h> | |
2b97a957 | 26 | #include <time.h> |
fd38203a | 27 | |
0095c454 LP |
28 | #include "_sd-common.h" |
29 | ||
fd38203a LP |
30 | /* |
31 | Why is this better than pure epoll? | |
32 | ||
10b17992 JSJ |
33 | - Supports event source prioritization |
34 | - Scales better with a large number of time events because it does not require one timerfd each | |
eaa3cbef | 35 | - Automatically tries to coalesce timer events system-wide |
bde0848d LP |
36 | - Handles signals, child PIDs, inotify events |
37 | - Supports systemd-style automatic watchdog event generation | |
fd38203a LP |
38 | */ |
39 | ||
0095c454 | 40 | _SD_BEGIN_DECLARATIONS; |
6695ed7a | 41 | |
b937d761 NM |
42 | #define SD_EVENT_DEFAULT ((sd_event *) 1) |
43 | ||
fd38203a LP |
44 | typedef struct sd_event sd_event; |
45 | typedef struct sd_event_source sd_event_source; | |
46 | ||
da7e457c | 47 | enum { |
baf76283 LP |
48 | SD_EVENT_OFF = 0, |
49 | SD_EVENT_ON = 1, | |
fd38203a | 50 | SD_EVENT_ONESHOT = -1 |
da7e457c LP |
51 | }; |
52 | ||
53 | enum { | |
2b0c9ef7 TG |
54 | SD_EVENT_INITIAL, |
55 | SD_EVENT_ARMED, | |
c45a5a74 | 56 | SD_EVENT_PENDING, |
da7e457c | 57 | SD_EVENT_RUNNING, |
6203e07a | 58 | SD_EVENT_EXITING, |
0be6c2f6 | 59 | SD_EVENT_FINISHED, |
e0c0b07d | 60 | SD_EVENT_PREPARING |
da7e457c | 61 | }; |
fd38203a | 62 | |
6ee69bab | 63 | enum { |
10b17992 | 64 | /* And everything in-between and outside is good too */ |
718db961 LP |
65 | SD_EVENT_PRIORITY_IMPORTANT = -100, |
66 | SD_EVENT_PRIORITY_NORMAL = 0, | |
67 | SD_EVENT_PRIORITY_IDLE = 100 | |
6ee69bab LP |
68 | }; |
69 | ||
718db961 LP |
70 | typedef int (*sd_event_handler_t)(sd_event_source *s, void *userdata); |
71 | typedef int (*sd_event_io_handler_t)(sd_event_source *s, int fd, uint32_t revents, void *userdata); | |
72 | typedef int (*sd_event_time_handler_t)(sd_event_source *s, uint64_t usec, void *userdata); | |
73 | typedef int (*sd_event_signal_handler_t)(sd_event_source *s, const struct signalfd_siginfo *si, void *userdata); | |
772afb76 | 74 | #if defined _GNU_SOURCE || (defined _POSIX_C_SOURCE && _POSIX_C_SOURCE >= 199309L) |
718db961 | 75 | typedef int (*sd_event_child_handler_t)(sd_event_source *s, const siginfo_t *si, void *userdata); |
b2542bf9 ZJS |
76 | #else |
77 | typedef void* sd_event_child_handler_t; | |
78 | #endif | |
97ef5391 | 79 | typedef int (*sd_event_inotify_handler_t)(sd_event_source *s, const struct inotify_event *event, void *userdata); |
deae09cc | 80 | typedef _sd_destroy_t sd_event_destroy_t; |
fd38203a | 81 | |
afc6adb5 LP |
82 | int sd_event_default(sd_event **e); |
83 | ||
fd38203a LP |
84 | int sd_event_new(sd_event **e); |
85 | sd_event* sd_event_ref(sd_event *e); | |
86 | sd_event* sd_event_unref(sd_event *e); | |
87 | ||
151b9b96 | 88 | int sd_event_add_io(sd_event *e, sd_event_source **s, int fd, uint32_t events, sd_event_io_handler_t callback, void *userdata); |
6a0f1f6d | 89 | int sd_event_add_time(sd_event *e, sd_event_source **s, clockid_t clock, uint64_t usec, uint64_t accuracy, sd_event_time_handler_t callback, void *userdata); |
151b9b96 LP |
90 | int sd_event_add_signal(sd_event *e, sd_event_source **s, int sig, sd_event_signal_handler_t callback, void *userdata); |
91 | int sd_event_add_child(sd_event *e, sd_event_source **s, pid_t pid, int options, sd_event_child_handler_t callback, void *userdata); | |
97ef5391 | 92 | int sd_event_add_inotify(sd_event *e, sd_event_source **s, const char *path, uint32_t mask, sd_event_inotify_handler_t callback, void *userdata); |
151b9b96 | 93 | int sd_event_add_defer(sd_event *e, sd_event_source **s, sd_event_handler_t callback, void *userdata); |
6e9feda3 | 94 | int sd_event_add_post(sd_event *e, sd_event_source **s, sd_event_handler_t callback, void *userdata); |
151b9b96 | 95 | int sd_event_add_exit(sd_event *e, sd_event_source **s, sd_event_handler_t callback, void *userdata); |
fd38203a | 96 | |
c45a5a74 | 97 | int sd_event_prepare(sd_event *e); |
0be6c2f6 | 98 | int sd_event_wait(sd_event *e, uint64_t usec); |
c45a5a74 | 99 | int sd_event_dispatch(sd_event *e); |
0be6c2f6 | 100 | int sd_event_run(sd_event *e, uint64_t usec); |
fd38203a | 101 | int sd_event_loop(sd_event *e); |
6203e07a | 102 | int sd_event_exit(sd_event *e, int code); |
fd38203a | 103 | |
6a0f1f6d LP |
104 | int sd_event_now(sd_event *e, clockid_t clock, uint64_t *usec); |
105 | ||
9b364545 | 106 | int sd_event_get_fd(sd_event *e); |
da7e457c | 107 | int sd_event_get_state(sd_event *e); |
afc6adb5 | 108 | int sd_event_get_tid(sd_event *e, pid_t *tid); |
6203e07a | 109 | int sd_event_get_exit_code(sd_event *e, int *code); |
cde93897 | 110 | int sd_event_set_watchdog(sd_event *e, int b); |
8f726607 | 111 | int sd_event_get_watchdog(sd_event *e); |
60a3b1e1 | 112 | int sd_event_get_iteration(sd_event *e, uint64_t *ret); |
fd38203a LP |
113 | |
114 | sd_event_source* sd_event_source_ref(sd_event_source *s); | |
115 | sd_event_source* sd_event_source_unref(sd_event_source *s); | |
afd15bbb | 116 | sd_event_source* sd_event_source_disable_unref(sd_event_source *s); |
fd38203a | 117 | |
9a78148e LP |
118 | sd_event *sd_event_source_get_event(sd_event_source *s); |
119 | void* sd_event_source_get_userdata(sd_event_source *s); | |
120 | void* sd_event_source_set_userdata(sd_event_source *s, void *userdata); | |
121 | ||
356779df LP |
122 | int sd_event_source_set_description(sd_event_source *s, const char *description); |
123 | int sd_event_source_get_description(sd_event_source *s, const char **description); | |
718db961 | 124 | int sd_event_source_set_prepare(sd_event_source *s, sd_event_handler_t callback); |
fd38203a | 125 | int sd_event_source_get_pending(sd_event_source *s); |
31927c16 LP |
126 | int sd_event_source_get_priority(sd_event_source *s, int64_t *priority); |
127 | int sd_event_source_set_priority(sd_event_source *s, int64_t priority); | |
baf76283 LP |
128 | int sd_event_source_get_enabled(sd_event_source *s, int *enabled); |
129 | int sd_event_source_set_enabled(sd_event_source *s, int enabled); | |
305f78bf | 130 | int sd_event_source_get_io_fd(sd_event_source *s); |
30caf8f3 | 131 | int sd_event_source_set_io_fd(sd_event_source *s, int fd); |
ab93297c NM |
132 | int sd_event_source_get_io_fd_own(sd_event_source *s); |
133 | int sd_event_source_set_io_fd_own(sd_event_source *s, int own); | |
305f78bf LP |
134 | int sd_event_source_get_io_events(sd_event_source *s, uint32_t* events); |
135 | int sd_event_source_set_io_events(sd_event_source *s, uint32_t events); | |
136 | int sd_event_source_get_io_revents(sd_event_source *s, uint32_t* revents); | |
fd38203a LP |
137 | int sd_event_source_get_time(sd_event_source *s, uint64_t *usec); |
138 | int sd_event_source_set_time(sd_event_source *s, uint64_t usec); | |
c2ba3ad6 | 139 | int sd_event_source_get_time_accuracy(sd_event_source *s, uint64_t *usec); |
b408026b | 140 | int sd_event_source_set_time_accuracy(sd_event_source *s, uint64_t usec); |
6a0f1f6d | 141 | int sd_event_source_get_time_clock(sd_event_source *s, clockid_t *clock); |
305f78bf | 142 | int sd_event_source_get_signal(sd_event_source *s); |
4bee8012 | 143 | int sd_event_source_get_child_pid(sd_event_source *s, pid_t *pid); |
97ef5391 | 144 | int sd_event_source_get_inotify_mask(sd_event_source *s, uint32_t *ret); |
15723a1d LP |
145 | int sd_event_source_set_destroy_callback(sd_event_source *s, sd_event_destroy_t callback); |
146 | int sd_event_source_get_destroy_callback(sd_event_source *s, sd_event_destroy_t *ret); | |
2382c936 YW |
147 | int sd_event_source_get_floating(sd_event_source *s); |
148 | int sd_event_source_set_floating(sd_event_source *s, int b); | |
fd38203a | 149 | |
4afd3348 LP |
150 | /* Define helpers so that __attribute__((cleanup(sd_event_unrefp))) and similar may be used. */ |
151 | _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_event, sd_event_unref); | |
152 | _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_event_source, sd_event_source_unref); | |
153 | ||
0095c454 | 154 | _SD_END_DECLARATIONS; |
6695ed7a | 155 | |
fd38203a | 156 | #endif |