annotate src/core/ngx_resolver.h @ 350:5a1bb0129dff NGINX_0_6_19

nginx 0.6.19 *) Bugfix: the 0.6.18 version could not be built.
author Igor Sysoev <http://sysoev.ru>
date Tue, 27 Nov 2007 00:00:00 +0300
parents
children 583decdb82a4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
350
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
1
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
2 /*
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
3 * Copyright (C) Igor Sysoev
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
4 */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
5
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
6
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
7 #include <ngx_config.h>
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
8 #include <ngx_core.h>
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
9
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
10
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
11 #ifndef _NGX_RESOLVER_H_INCLUDED_
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
12 #define _NGX_RESOLVER_H_INCLUDED_
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
13
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
14
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
15 #define NGX_RESOLVE_A 1
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
16 #define NGX_RESOLVE_CNAME 5
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
17 #define NGX_RESOLVE_PTR 12
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
18 #define NGX_RESOLVE_MX 15
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
19 #define NGX_RESOLVE_TXT 16
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
20
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
21 #define NGX_RESOLVE_FORMERR 1
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
22 #define NGX_RESOLVE_SERVFAIL 2
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
23 #define NGX_RESOLVE_NXDOMAIN 3
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
24 #define NGX_RESOLVE_NOTIMP 4
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
25 #define NGX_RESOLVE_REFUSED 5
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
26 #define NGX_RESOLVE_TIMEDOUT NGX_ETIMEDOUT
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
27
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
28
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
29 typedef struct {
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
30 ngx_connection_t *connection;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
31 struct sockaddr *sockaddr;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
32 socklen_t socklen;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
33 ngx_str_t server;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
34 ngx_log_t *log;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
35 } ngx_udp_connection_t;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
36
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
37
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
38 typedef struct ngx_resolver_ctx_s ngx_resolver_ctx_t;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
39
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
40 typedef void (*ngx_resolver_handler_pt)(ngx_resolver_ctx_t *ctx);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
41
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
42
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
43 typedef struct {
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
44 ngx_rbtree_node_t node;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
45 ngx_queue_t queue;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
46
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
47 /* PTR: resolved name, A: name to resolve */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
48 u_char *name;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
49
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
50 u_short nlen;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
51 u_short qlen;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
52
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
53 u_char *query;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
54
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
55 union {
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
56 in_addr_t addr;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
57 in_addr_t *addrs;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
58 u_char *cname;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
59 } u;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
60
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
61 u_short naddrs;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
62 u_short cnlen;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
63
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
64 time_t expire;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
65 time_t valid;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
66
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
67 ngx_resolver_ctx_t *waiting;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
68 } ngx_resolver_node_t;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
69
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
70
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
71 typedef struct {
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
72 /* has to be pointer because of "incomplete type" */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
73 ngx_event_t *event;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
74
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
75 /* TODO: DNS peers balancer */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
76 /* STUB */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
77 ngx_udp_connection_t *udp_connection;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
78
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
79 ngx_log_t *log;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
80
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
81 /* ident must be after 3 pointers */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
82 ngx_int_t ident;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
83
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
84 ngx_rbtree_t name_rbtree;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
85 ngx_rbtree_node_t name_sentinel;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
86
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
87 ngx_rbtree_t addr_rbtree;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
88 ngx_rbtree_node_t addr_sentinel;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
89
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
90 ngx_queue_t name_resend_queue;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
91 ngx_queue_t addr_resend_queue;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
92
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
93 ngx_queue_t name_expire_queue;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
94 ngx_queue_t addr_expire_queue;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
95
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
96 time_t resend_timeout;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
97 time_t expire;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
98 time_t valid;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
99
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
100 ngx_uint_t log_level;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
101 } ngx_resolver_t;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
102
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
103
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
104 struct ngx_resolver_ctx_s {
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
105 ngx_resolver_ctx_t *next;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
106 ngx_resolver_t *resolver;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
107 ngx_udp_connection_t *udp_connection;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
108
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
109 /* ident must be after 3 pointers */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
110 ngx_int_t ident;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
111
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
112 ngx_int_t state;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
113 ngx_int_t type;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
114 ngx_str_t name;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
115
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
116 ngx_uint_t naddrs;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
117 in_addr_t *addrs;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
118 in_addr_t addr;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
119
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
120 /* TODO: DNS peers balancer ctx */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
121
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
122 ngx_resolver_handler_pt handler;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
123 void *data;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
124 ngx_msec_t timeout;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
125
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
126 ngx_uint_t quick; /* unsigned quick:1; */
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
127 ngx_event_t *event;
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
128 };
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
129
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
130
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
131 ngx_resolver_t *ngx_resolver_create(ngx_peer_addr_t *addr, ngx_log_t *log);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
132 ngx_resolver_ctx_t *ngx_resolve_start(ngx_resolver_t *r,
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
133 ngx_resolver_ctx_t *temp);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
134 ngx_int_t ngx_resolve_name(ngx_resolver_ctx_t *ctx);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
135 void ngx_resolve_name_done(ngx_resolver_ctx_t *ctx);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
136 ngx_int_t ngx_resolve_addr(ngx_resolver_ctx_t *ctx);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
137 void ngx_resolve_addr_done(ngx_resolver_ctx_t *ctx);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
138 void *ngx_resolver_calloc(ngx_resolver_t *r, size_t size);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
139 char *ngx_resolver_strerror(ngx_int_t err);
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
140
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
141
5a1bb0129dff nginx 0.6.19
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
142 #endif /* _NGX_RESOLVER_H_INCLUDED_ */