2 Unix SMB/CIFS implementation.
4 common events code for signal events
6 Copyright (C) Andrew Tridgell 2007
8 ** NOTE! The following LGPL license applies to the tevent
9 ** library. This does NOT imply that all of Samba is released
12 This library is free software; you can redistribute it and/or
13 modify it under the terms of the GNU Lesser General Public
14 License as published by the Free Software Foundation; either
15 version 3 of the License, or (at your option) any later version.
17 This library is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 Lesser General Public License for more details.
22 You should have received a copy of the GNU Lesser General Public
23 License along with this library; if not, see <http://www.gnu.org/licenses/>.
27 #include "system/filesys.h"
28 #include "system/wait.h"
30 #include "tevent_internal.h"
31 #include "tevent_util.h"
33 #define NUM_SIGNALS 64
35 /* maximum number of SA_SIGINFO signals to hold in the queue */
36 #define SA_INFO_QUEUE_COUNT 100
43 #define SIG_INCREMENT(s) (s).count++
44 #define SIG_SEEN(s, n) (s).seen += (n)
45 #define SIG_PENDING(s) ((s).seen != (s).count)
47 struct tevent_common_signal_list {
48 struct tevent_common_signal_list *prev, *next;
49 struct tevent_signal *se;
53 the poor design of signals means that this table must be static global
55 static struct sig_state {
56 struct tevent_common_signal_list *sig_handlers[NUM_SIGNALS+1];
57 struct sigaction *oldact[NUM_SIGNALS+1];
58 struct sigcounter signal_count[NUM_SIGNALS+1];
59 struct sigcounter got_signal;
61 /* with SA_SIGINFO we get quite a lot of info per signal */
62 siginfo_t *sig_info[NUM_SIGNALS+1];
63 struct sigcounter sig_blocked[NUM_SIGNALS+1];
68 return number of sigcounter events not processed yet
70 static uint32_t sig_count(struct sigcounter s)
72 return s.count - s.seen;
76 signal handler - redirects to registered signals
78 static void tevent_common_signal_handler(int signum)
82 struct tevent_common_signal_list *sl;
83 struct tevent_context *ev = NULL;
85 SIG_INCREMENT(sig_state->signal_count[signum]);
86 SIG_INCREMENT(sig_state->got_signal);
88 /* Write to each unique event context. */
89 for (sl = sig_state->sig_handlers[signum]; sl; sl = sl->next) {
90 if (sl->se->event_ctx != ev) {
91 /* doesn't matter if this pipe overflows */
92 res = write(ev->pipe_fds[1], &c, 1);
93 ev = sl->se->event_ctx;
100 signal handler with SA_SIGINFO - redirects to registered signals
102 static void tevent_common_signal_handler_info(int signum, siginfo_t *info,
105 uint32_t count = sig_count(sig_state->signal_count[signum]);
106 /* sig_state->signal_count[signum].seen % SA_INFO_QUEUE_COUNT
107 * is the base of the unprocessed signals in the ringbuffer. */
108 uint32_t ofs = (sig_state->signal_count[signum].seen + count) %
110 sig_state->sig_info[signum][ofs] = *info;
112 tevent_common_signal_handler(signum);
114 /* handle SA_SIGINFO */
115 if (count+1 == SA_INFO_QUEUE_COUNT) {
116 /* we've filled the info array - block this signal until
117 these ones are delivered */
120 sigaddset(&set, signum);
121 sigprocmask(SIG_BLOCK, &set, NULL);
122 SIG_INCREMENT(sig_state->sig_blocked[signum]);
127 static int tevent_common_signal_list_destructor(struct tevent_common_signal_list *sl)
129 DLIST_REMOVE(sig_state->sig_handlers[sl->se->signum], sl);
134 destroy a signal event
136 static int tevent_signal_destructor(struct tevent_signal *se)
138 struct tevent_common_signal_list *sl;
139 sl = talloc_get_type(se->additional_data,
140 struct tevent_common_signal_list);
143 DLIST_REMOVE(se->event_ctx->signal_events, se);
148 if (sig_state->sig_handlers[se->signum] == NULL) {
149 /* restore old handler, if any */
150 sigaction(se->signum, sig_state->oldact[se->signum], NULL);
151 sig_state->oldact[se->signum] = NULL;
153 if (se->sa_flags & SA_SIGINFO) {
154 talloc_free(sig_state->sig_info[se->signum]);
155 sig_state->sig_info[se->signum] = NULL;
164 this is part of the pipe hack needed to avoid the signal race condition
166 static void signal_pipe_handler(struct tevent_context *ev, struct tevent_fd *fde,
167 uint16_t flags, void *_private)
171 /* its non-blocking, doesn't matter if we read too much */
172 res = read(fde->fd, c, sizeof(c));
177 return NULL on failure (memory allocation error)
179 struct tevent_signal *tevent_common_add_signal(struct tevent_context *ev,
183 tevent_signal_handler_t handler,
185 const char *handler_name,
186 const char *location)
188 struct tevent_signal *se;
189 struct tevent_common_signal_list *sl;
190 sigset_t set, oldset;
192 if (signum >= NUM_SIGNALS) {
197 /* the sig_state needs to be on a global context as it can last across
198 multiple event contexts */
199 if (sig_state == NULL) {
200 sig_state = talloc_zero(talloc_autofree_context(), struct sig_state);
201 if (sig_state == NULL) {
206 se = talloc(mem_ctx?mem_ctx:ev, struct tevent_signal);
207 if (se == NULL) return NULL;
211 se->sa_flags = sa_flags;
212 se->handler = handler;
213 se->private_data = private_data;
214 se->handler_name = handler_name;
215 se->location = location;
216 se->additional_data = NULL;
218 sl = talloc(se, struct tevent_common_signal_list);
224 se->additional_data = sl;
226 /* Ensure, no matter the destruction order, that we always have a handle on the global sig_state */
227 if (!talloc_reference(se, sig_state)) {
232 /* we need to setup the pipe hack handler if not already
234 if (ev->pipe_fde == NULL) {
235 if (pipe(ev->pipe_fds) == -1) {
239 ev_set_blocking(ev->pipe_fds[0], false);
240 ev_set_blocking(ev->pipe_fds[1], false);
241 ev->pipe_fde = tevent_add_fd(ev, ev, ev->pipe_fds[0],
243 signal_pipe_handler, NULL);
245 close(ev->pipe_fds[0]);
246 close(ev->pipe_fds[1]);
252 /* only install a signal handler if not already installed */
253 if (sig_state->sig_handlers[signum] == NULL) {
254 struct sigaction act;
256 act.sa_handler = tevent_common_signal_handler;
257 act.sa_flags = sa_flags;
259 if (sa_flags & SA_SIGINFO) {
260 act.sa_handler = NULL;
261 act.sa_sigaction = tevent_common_signal_handler_info;
262 if (sig_state->sig_info[signum] == NULL) {
263 sig_state->sig_info[signum] = talloc_zero_array(sig_state, siginfo_t, SA_INFO_QUEUE_COUNT);
264 if (sig_state->sig_info[signum] == NULL) {
271 sig_state->oldact[signum] = talloc(sig_state, struct sigaction);
272 if (sig_state->oldact[signum] == NULL) {
276 if (sigaction(signum, &act, sig_state->oldact[signum]) == -1) {
282 DLIST_ADD(se->event_ctx->signal_events, se);
284 /* Make sure the signal doesn't come in while we're mangling list. */
286 sigaddset(&set, signum);
287 sigprocmask(SIG_BLOCK, &set, &oldset);
288 DLIST_ADD(sig_state->sig_handlers[signum], sl);
289 sigprocmask(SIG_SETMASK, &oldset, NULL);
291 talloc_set_destructor(se, tevent_signal_destructor);
292 talloc_set_destructor(sl, tevent_common_signal_list_destructor);
299 check if a signal is pending
300 return != 0 if a signal was pending
302 int tevent_common_check_signal(struct tevent_context *ev)
306 if (!sig_state || !SIG_PENDING(sig_state->got_signal)) {
310 for (i=0;i<NUM_SIGNALS+1;i++) {
311 struct tevent_common_signal_list *sl, *next;
312 struct sigcounter counter = sig_state->signal_count[i];
313 uint32_t count = sig_count(counter);
315 /* Ensure we null out any stored siginfo_t entries
316 * after processing for debugging purposes. */
317 bool clear_processed_siginfo = false;
323 for (sl=sig_state->sig_handlers[i];sl;sl=next) {
324 struct tevent_signal *se = sl->se;
327 if (se->sa_flags & SA_SIGINFO) {
330 clear_processed_siginfo = true;
332 for (j=0;j<count;j++) {
333 /* sig_state->signal_count[i].seen
334 * % SA_INFO_QUEUE_COUNT is
335 * the base position of the unprocessed
336 * signals in the ringbuffer. */
337 uint32_t ofs = (counter.seen + j)
338 % SA_INFO_QUEUE_COUNT;
339 se->handler(ev, se, i, 1,
340 (void*)&sig_state->sig_info[i][ofs],
343 if (se->sa_flags & SA_RESETHAND) {
349 se->handler(ev, se, i, count, NULL, se->private_data);
350 if (se->sa_flags & SA_RESETHAND) {
356 if (clear_processed_siginfo) {
358 for (j=0;j<count;j++) {
359 uint32_t ofs = (counter.seen + j)
360 % SA_INFO_QUEUE_COUNT;
361 memset((void*)&sig_state->sig_info[i][ofs],
368 SIG_SEEN(sig_state->signal_count[i], count);
369 SIG_SEEN(sig_state->got_signal, count);
372 if (SIG_PENDING(sig_state->sig_blocked[i])) {
373 /* We'd filled the queue, unblock the
374 signal now the queue is empty again.
375 Note we MUST do this after the
376 SIG_SEEN(sig_state->signal_count[i], count)
377 call to prevent a new signal running
378 out of room in the sig_state->sig_info[i][]
383 SIG_SEEN(sig_state->sig_blocked[i],
384 sig_count(sig_state->sig_blocked[i]));
385 sigprocmask(SIG_UNBLOCK, &set, NULL);