dns.h

Go to the documentation of this file.

 
#ifndef DNS_RESOLVER_H
#define DNS_RESOLVER_H
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct dns_resolver dns_resolver_t;
 
typedef struct dns_request dns_request_t;
 
typedef struct {
  char address[46]; 
  int family;       
  int socktype;     
  int protocol;     
} dns_address_t;
 
typedef struct {
  dns_address_t *addresses; 
  size_t count;             
  int error_code;           
  char *hostname;           
} dns_result_t;
 
typedef void (*dns_callback_t)(dns_result_t *result, void *user_data);
 
typedef struct {
  int timeout_ms;     
  int max_concurrent; 
  bool prefer_ipv4;   
  bool prefer_ipv6;   
} dns_config_t;
 
dns_resolver_t *dns_resolver_create(const dns_config_t *config);
 
void dns_resolver_destroy(dns_resolver_t *resolver);
 
dns_request_t *dns_resolve_async(dns_resolver_t *resolver, const char *hostname,
                                 const char *service, dns_callback_t callback,
                                 void *user_data);
 
bool dns_request_cancel(dns_request_t *request);
 
void dns_resolver_process(dns_resolver_t *resolver);
 
void dns_result_free(dns_result_t *result);
 
const char *dns_error_string(int error_code);
 
dns_config_t dns_config_default(void);
 
#ifdef __cplusplus
}
#endif
 
#endif /* DNS_RESOLVER_H */