1 #ifndef SIGNALS_H

     2 #define SIGNALS_H

     3 

     4 /**

     5  * @file 

     6  *

     7  * Handle signals in a libevent way

     8  */

     9 #include "error.h"

    10 #include <event2/event.h>

    11 

    12 /**

    13  * How many signals we can define actions for

    14  */

    15 #define MAX_SIGNALS 8

    16 

    17 /**

    18  * State for a set of signals

    19  */

    20 struct signals;

    21 

    22 /**

    23  * Used as a handler for signals that should cause a loopexit.

    24  */

    25 void signals_loopexit (int signal, short event, void *arg);

    26 

    27 /**

    28  * Used to receive signals, but discard them, and continue what we were doing.

    29  */

    30 void signals_ignore (int signal, short event, void *arg);

    31 

    32 /**

    33  * Allocate a signals struct, acting on the given ev_base.

    34  *

    35  * Returns NULL on failure

    36  */

    37 err_t signals_create (struct signals **signals_ptr, struct event_base *ev_base);

    38 

    39 /**

    40  * Add a signal to be handled by the given signals struct with the given handler.

    41  */

    42 err_t signals_add (struct signals *signals, int sigval, void (*sig_handler)(evutil_socket_t, short, void *), void *arg);

    43 

    44 /**

    45  * Ignore the given sigval.

    46  */

    47 err_t signal_ignore (int signum, struct error_info *err);

    48 

    49 /**

    50  * Add a set of default signals

    51  *      SIGPIPE     signals_ignore

    52  *      SIGINT      signals_loopexit

    53  */

    54 struct signals *signals_default (struct event_base *ev_base);

    55 

    56 /**

    57  * Free the resources/handlers associated with the given signal handler set

    58  */

    59 void signals_free (struct signals *signals);

    60 

    61 #endif /* SIGNALS_H */