3

     4

/**

     5

 * @file

     6

 *

     7

 * Defines a simple interface for creating services, which listen for connections and create transport_t's.

     8

 */

     9

#include "transport.h"

    10

    11

/**

    12

 * Opaque state struct.

    13

 */

    14

typedef struct service service_t;

    15

    16

/**

    17

 * User callbacks for services.

    18

 */

    19

struct service_callbacks {

    20

    /**

    21

     * The service broke.

    22

     *

    23

     * This is only called for errors which occur when called directly from the event loop, and never for errors that

    24

     * occur inside of calls to service_*.

    25

     */

    26

    void (*on_error) (service_t *service, const error_t *err, void *arg);

    27

};

    28

    29

/**

    30

 * User info required to build a service

    31

 */

    32

struct service_info {

    33

    /** Callback table */

    34

    const struct service_callbacks *cb_tbl;

    35

    36

    /** Callback context arg */

    37

    void *cb_arg;

    38

    39

    /** Settings for the service's client transports */

    40

    struct transport_info trans_info;

    41

};

    42

    43

/**

    44

 * Destroy a service to stop accepting any connections and release all resources.

    45

 *

    46

 * Any connected client transports should stay intact (?)

    47

 */

    48

void service_destroy (service_t *service);

    49