X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=signal.h;h=e5532ded5a9378619f7951708b49c5b38bf52d18;hb=HEAD;hp=50c5f636a84168f637ae26db9a41086d5177580f;hpb=471684761a2039bbc89aa1e3c33c62de6bef86cf;p=paraslash.git diff --git a/signal.h b/signal.h index 50c5f636..d9e98e78 100644 --- a/signal.h +++ b/signal.h @@ -1,13 +1,43 @@ -/* - * Copyright (C) 2007 Andre Noll - * - * Licensed under the GPL v2. For licencing details see COPYING. - */ +/* Copyright (C) 2007 Andre Noll , see file COPYING. */ /** \file signal.h exported symbols from signal.c */ -int para_signal_init(void); -int para_install_sighandler(int); -void para_reap_children(void); -pid_t para_reap_child(void); +/** + * Task for signal handling. + */ +struct signal_task { + /** The signal pipe. */ + int fd; + /** The associated task structure. */ + struct task *task; +}; + +/** + * Monitor the signal fd for reading. + * + * \param s The scheduler instance. + * \param context Signal task pointer. + * + * This convenience helper is called from several programs which need to handle + * signals, including para_server and para_audiod. These programs set up a + * signal pipe and a signal task structure, and use this function to tell the + * scheduler to monitor the read end of the pipe. + * + * Although the second parameter must be in fact a pointer to a signal_task + * structure, the parameter is specified as void * here to match the signature + * declared in struct \ref task_info. + */ +_static_inline_ void signal_pre_monitor(struct sched *s, void *context) +{ + struct signal_task *st = context; + sched_monitor_readfd(st->fd, s); +} + +struct signal_task *signal_init_or_die(void); +void para_sigaction(int sig, void (*handler)(int)); +void para_install_sighandler(int); +int para_reap_child(pid_t *pid); int para_next_signal(void); +void signal_shutdown(struct signal_task *st); +void para_block_signal(int sig); +void para_unblock_signal(int sig);