multicast: removed replay cancellation as responses are limited
[oweals/gnunet.git] / src / include / gnunet_signal_lib.h
index e386ccc0ed261d001c96cea44bba61259633ea86..9cb032b3b7efa8086f9b0d7476f258576c7ae79f 100644 (file)
@@ -1,10 +1,10 @@
 /*
      This file is part of GNUnet.
-     (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009 Christian Grothoff (and other contributing authors)
+     Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009 Christian Grothoff (and other contributing authors)
 
      GNUnet is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published
-     by the Free Software Foundation; either version 2, or (at your
+     by the Free Software Foundation; either version 3, or (at your
      option) any later version.
 
      GNUnet is distributed in the hope that it will be useful, but
@@ -14,8 +14,8 @@
 
      You should have received a copy of the GNU General Public License
      along with GNUnet; see the file COPYING.  If not, write to the
-     Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-     Boston, MA 02111-1307, USA.
+     Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+     Boston, MA 02110-1301, USA.
 */
 
 /**
@@ -41,6 +41,7 @@ extern "C"
  */
 struct GNUNET_SIGNAL_Context;
 
+
 /**
  * A signal handler.  Since different OSes have different signatures
  * for their handlers, the API only gives the most restrictive
@@ -49,7 +50,9 @@ struct GNUNET_SIGNAL_Context;
  * the implementation must guarantee that this handler is not called
  * for signals other than the one that it has been registered for.
  */
-typedef void (*GNUNET_SIGNAL_Handler) (void);
+typedef void
+(*GNUNET_SIGNAL_Handler) (void);
+
 
 /**
  * Install a signal handler that will be run if the
@@ -59,9 +62,10 @@ typedef void (*GNUNET_SIGNAL_Handler) (void);
  * @param handler the function to call
  * @return context that can be used to restore, NULL on error
  */
-struct GNUNET_SIGNAL_Context *GNUNET_SIGNAL_handler_install (int signal,
-                                                             GNUNET_SIGNAL_Handler
-                                                             handler);
+struct GNUNET_SIGNAL_Context *
+GNUNET_SIGNAL_handler_install (int signal,
+                               GNUNET_SIGNAL_Handler handler);
+
 
 /**
  * Uninstall a previously installed signal hander.
@@ -69,7 +73,19 @@ struct GNUNET_SIGNAL_Context *GNUNET_SIGNAL_handler_install (int signal,
  * @param ctx context that was returned when the
  *            signal handler was installed
  */
-void GNUNET_SIGNAL_handler_uninstall (struct GNUNET_SIGNAL_Context *ctx);
+void
+GNUNET_SIGNAL_handler_uninstall (struct GNUNET_SIGNAL_Context *ctx);
+
+
+/**
+ * Raise the given signal by calling the installed signal handlers.  This will
+ * not use the @em raise() system call but only calls the handlers registered
+ * through GNUNET_SIGNAL_handler_install().
+ *
+ * @param sig the signal to raise
+ */
+void
+GNUNET_SIGNAL_raise (const int sig);
 
 
 #if 0                           /* keep Emacsens' auto-indent happy */