Merge branch 'refs/heads/t/wma'
[paraslash.git] / signal.h
1 /*
2 * Copyright (C) 2007 Andre Noll <maan@tuebingen.mpg.de>
3 *
4 * Licensed under the GPL v2. For licencing details see COPYING.
5 */
6
7 /** \file signal.h exported symbols from signal.c */
8
9 /**
10 * Task for signal handling.
11 */
12 struct signal_task {
13 /** The signal pipe. */
14 int fd;
15 /** The associated task structure. */
16 struct task *task;
17 };
18
19 /**
20 * A generic pre-select method for signal tasks.
21 *
22 * \param s Passed to para_fd_set().
23 * \param context Signal task pointer.
24 *
25 * This convenience helper is called from several programs which need to handle
26 * signals, including para_server and para_audiod. These programs define a
27 * signal task structure and set its ->pre_select method to this function which
28 * adds the file descriptor of the signal task to the set of descriptors to be
29 * watched in the next select() call.
30 *
31 * Although the second parameter must be in fact a pointer to a signal_task
32 * structure, the parameter is specified as void * here to match the
33 * ->pre_select method of struct task.
34 */
35 _static_inline_ void signal_pre_select(struct sched *s, void *context)
36 {
37 struct signal_task *st = context;
38 para_fd_set(st->fd, &s->rfds, &s->max_fileno);
39 }
40
41 struct signal_task *signal_init_or_die(void);
42 void para_sigaction(int sig, void (*handler)(int));
43 void para_install_sighandler(int);
44 int para_reap_child(pid_t *pid);
45 int para_next_signal(fd_set *rfds);
46 void signal_shutdown(struct signal_task *st);
47 void para_block_signal(int sig);
48 void para_unblock_signal(int sig);