1

#ifndef RESOLVE_H

     2

#define RESOLVE_H

     3

     4

/**

     5

 * @file

     6

 *

     7

 * DNS resolver interface

     8

 */

     9

#include "error.h"

    10

#include <netdb.h>

    11

    12

/**

    13

 * Lookup result state

    14

 */

    15

struct resolve_result {

    16

    /** Head of the addrinfo list */

    17

    struct addrinfo *list;

    18

    19

    /** Current addrinfo item */

    20

    struct addrinfo *item;

    21

};

    22

    23

/**

    24

 * Resolve the given node/service tuple as a series of addrinfos for the given socktype.

    25

 *

    26

 * This will never return an empty result.

    27

 *

    28

 * XXX: blocking DNS stuff

    29

 *

    30

 * @param res where to store the result state

    31

 * @param node hostname/address to look up

    32

 * @param service service/port to look up

    33

 * @param socktype a SOCK_* value to return addrinfo's for that socktype

    34

 * @param ai_flags optional bitmask of AI_* flags to use

    35

 * @param err returned error info

    36

 */

    37

err_t resolve_addr (struct resolve_result *res, const char *node, const char *service, int socktype, int ai_flags, error_t *err);

    38

    39

/**

    40

 * Initialize the given result to zero

    41

 */

    42

void resolve_result_init (struct resolve_result *res);

    43

    44

/**

    45

 * Get the next address from a result, if any left

    46

 */

    47

struct addrinfo* resolve_result_next (struct resolve_result *res);

    48

    49

/**

    50

 * Release the addrinfo resources associated with the given result

    51

 */

    52

void resolve_result_deinit (struct resolve_result *res);

    53

    54

/**

    55

 * Returns a pointer to a static buffer containing a string description of the given addrinfo

    56

 */

    57

const char * resolve_addr_text (const struct addrinfo *addr);

    58

    59

#endif /* RESOLVE_H */