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

 * Add a set of default signals

    46

 *      SIGPIPE     signals_ignore

    47

 *      SIGINT      signals_loopexit

    48

 */

    49

struct signals *signals_default (struct event_base *ev_base);

    50

    51

/*

    52

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

    53

 */

    54

void signals_free (struct signals *signals);

    55

    56

#endif /* LIB_SIGNAL_H */