One Level Up Top Level

src/core/ngx_resolver.h - nginx-1.7.10

Data types defined

Macros defined

Source code


  2. /*
  3. * Copyright (C) Igor Sysoev
  4. * Copyright (C) Nginx, Inc.
  5. */


  8. #include <ngx_config.h>
  9. #include <ngx_core.h>


  12. #ifndef _NGX_RESOLVER_H_INCLUDED_
  13. ‌#define _NGX_RESOLVER_H_INCLUDED_


  16. ‌#define NGX_RESOLVE_A         1
  17. ‌#define NGX_RESOLVE_CNAME     5
  18. ‌#define NGX_RESOLVE_PTR       12
  19. ‌#define NGX_RESOLVE_MX        15
  20. ‌#define NGX_RESOLVE_TXT       16
  21. #if (NGX_HAVE_INET6)
  22. ‌#define NGX_RESOLVE_AAAA      28
  23. #endif
  24. ‌#define NGX_RESOLVE_DNAME     39

  26. ‌#define NGX_RESOLVE_FORMERR   1
  27. ‌#define NGX_RESOLVE_SERVFAIL  2
  28. ‌#define NGX_RESOLVE_NXDOMAIN  3
  29. ‌#define NGX_RESOLVE_NOTIMP    4
  30. ‌#define NGX_RESOLVE_REFUSED   5
  31. ‌#define NGX_RESOLVE_TIMEDOUT  NGX_ETIMEDOUT


  34. ‌#define NGX_NO_RESOLVER       (void *) -1

  36. ‌#define NGX_RESOLVER_MAX_RECURSION    50


  39. typedef struct {
  40.     ngx_connection_t         *connection;
  41.     struct sockaddr          *sockaddr;
  42.     socklen_t                 socklen;
  43.     ngx_str_t                 server;
  44.     ngx_log_t                 log;
  45. ‌} ngx_udp_connection_t;


  48. ‌typedef struct ngx_resolver_ctx_s  ngx_resolver_ctx_t;

  50. ‌typedef void (*ngx_resolver_handler_pt)(ngx_resolver_ctx_t *ctx);


  53. typedef struct {
  54.     /* PTR: resolved name, A: name to resolve */
  55.     u_char                   *name;

  57.     ngx_queue_t               queue;

  59.     /* event ident must be after 3 pointers as in ngx_connection_t */
  60.     ngx_int_t                 ident;

  62.     ngx_rbtree_node_t         node;

  64. #if (NGX_HAVE_INET6)
  65.     /* PTR: IPv6 address to resolve (IPv4 address is in rbtree node key) */
  66.     struct in6_addr           addr6;
  67. #endif

  69.     u_short                   nlen;
  70.     u_short                   qlen;

  72.     u_char                   *query;
  73. #if (NGX_HAVE_INET6)
  74.     u_char                   *query6;
  75. #endif

  77.     union {
  78.         in_addr_t             addr;
  79.         in_addr_t            *addrs;
  80.         u_char               *cname;
  81.     } u;

  83.     u_char                    code;
  84.     u_short                   naddrs;
  85.     u_short                   cnlen;

  87. #if (NGX_HAVE_INET6)
  88.     union {
  89.         struct in6_addr       addr6;
  90.         struct in6_addr      *addrs6;
  91.     } u6;

  93.     u_short                   naddrs6;
  94. #endif

  96.     time_t                    expire;
  97.     time_t                    valid;
  98.     uint32_t                  ttl;

  100.     ngx_resolver_ctx_t       *waiting;
  101. ‌} ngx_resolver_node_t;


  104. typedef struct {
  105.     /* has to be pointer because of "incomplete type" */
  106.     ngx_event_t              *event;
  107.     void                     *dummy;
  108.     ngx_log_t                *log;

  110.     /* event ident must be after 3 pointers as in ngx_connection_t */
  111.     ngx_int_t                 ident;

  113.     /* simple round robin DNS peers balancer */
  114.     ngx_array_t               udp_connections;
  115.     ngx_uint_t                last_connection;

  117.     ngx_rbtree_t              name_rbtree;
  118.     ngx_rbtree_node_t         name_sentinel;

  120.     ngx_rbtree_t              addr_rbtree;
  121.     ngx_rbtree_node_t         addr_sentinel;

  123.     ngx_queue_t               name_resend_queue;
  124.     ngx_queue_t               addr_resend_queue;

  126.     ngx_queue_t               name_expire_queue;
  127.     ngx_queue_t               addr_expire_queue;

  129. #if (NGX_HAVE_INET6)
  130.     ngx_uint_t                ipv6;                 /* unsigned  ipv6:1; */
  131.     ngx_rbtree_t              addr6_rbtree;
  132.     ngx_rbtree_node_t         addr6_sentinel;
  133.     ngx_queue_t               addr6_resend_queue;
  134.     ngx_queue_t               addr6_expire_queue;
  135. #endif

  137.     time_t                    resend_timeout;
  138.     time_t                    expire;
  139.     time_t                    valid;

  141.     ngx_uint_t                log_level;
  142. ‌} ngx_resolver_t;


  145. ‌struct ngx_resolver_ctx_s {
  146.     ngx_resolver_ctx_t       *next;
  147.     ngx_resolver_t           *resolver;
  148.     ngx_udp_connection_t     *udp_connection;

  150.     ngx_int_t                 state;
  151.     ngx_str_t                 name;

  153.     ngx_uint_t                naddrs;
  154.     ngx_addr_t               *addrs;
  155.     ngx_addr_t                addr;
  156.     struct sockaddr_in        sin;

  158.     ngx_resolver_handler_pt   handler;
  159.     void                     *data;
  160.     ngx_msec_t                timeout;

  162.     ngx_uint_t                quick;  /* unsigned  quick:1; */
  163.     ngx_uint_t                recursion;
  164.     ngx_event_t              *event;
  165. };


  168. ngx_resolver_t *ngx_resolver_create(ngx_conf_t *cf, ngx_str_t *names,
  169.     ngx_uint_t n);
  170. ngx_resolver_ctx_t *ngx_resolve_start(ngx_resolver_t *r,
  171.     ngx_resolver_ctx_t *temp);
  172. ngx_int_t ngx_resolve_name(ngx_resolver_ctx_t *ctx);
  173. void ngx_resolve_name_done(ngx_resolver_ctx_t *ctx);
  174. ngx_int_t ngx_resolve_addr(ngx_resolver_ctx_t *ctx);
  175. void ngx_resolve_addr_done(ngx_resolver_ctx_t *ctx);
  176. char *ngx_resolver_strerror(ngx_int_t err);


  179. #endif /* _NGX_RESOLVER_H_INCLUDED_ */

One Level Up Top Level