X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=signal.h;h=d9e98e78a635930577038d6090c9d5260772ddec;hb=ac9cc8f21ddeb821134e657f509bb83cec8c1da4;hp=1e562af76ffb4487d206be001a909ca0a6a9311d;hpb=f167629b3191c57a6b691cd2a6af04a45a74ccb0;p=paraslash.git

diff --git a/signal.h b/signal.h
index 1e562af7..d9e98e78 100644
--- a/signal.h
+++ b/signal.h
@@ -1,8 +1,4 @@
-/*
- * Copyright (C) 2007 Andre Noll <maan@tuebingen.mpg.de>
- *
- * Licensed under the GPL v2. For licencing details see COPYING.
- */
+/* Copyright (C) 2007 Andre Noll <maan@tuebingen.mpg.de>, see file COPYING. */
 
 /** \file signal.h exported symbols from signal.c */
 
@@ -16,11 +12,32 @@ struct signal_task {
 	struct task *task;
 };
 
-int para_signal_init(void);
+/**
+ * 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(fd_set *rfds);
-void para_signal_shutdown(void);
+int para_next_signal(void);
+void signal_shutdown(struct signal_task *st);
 void para_block_signal(int sig);
 void para_unblock_signal(int sig);