annotate src/core/ngx_inet.h @ 552:c04fa65fe604 NGINX_0_8_22

nginx 0.8.22 *) Feature: the "proxy_bind", "fastcgi_bind", and "memcached_bind" directives. *) Feature: the "access" and the "deny" directives support IPv6. *) Feature: the "set_real_ip_from" directive supports IPv6 addresses in request headers. *) Feature: the "unix:" parameter of the "set_real_ip_from" directive. *) Bugfix: nginx did not delete unix domain socket after configuration testing. *) Bugfix: nginx deleted unix domain socket while online upgrade. *) Bugfix: the "!-x" operator did not work. Thanks to Maxim Dounin. *) Bugfix: a segmentation fault might occur in a worker process, if limit_rate was used in HTTPS server. Thanks to Maxim Dounin. *) Bugfix: a segmentation fault might occur in a worker process while $limit_rate logging. Thanks to Maxim Dounin. *) Bugfix: a segmentation fault might occur in a worker process, if there was no "listen" directive in "server" block; the bug had appeared in 0.8.21.
author Igor Sysoev <http://sysoev.ru>
date Tue, 03 Nov 2009 00:00:00 +0300
parents 1dcf6adad484
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
1
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
2 /*
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
3 * Copyright (C) Igor Sysoev
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
4 */
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
5
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
6
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
7 #ifndef _NGX_INET_H_INCLUDED_
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
8 #define _NGX_INET_H_INCLUDED_
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
9
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
10
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
11 #include <ngx_config.h>
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
12 #include <ngx_core.h>
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
13
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
14
457
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
15 /*
550
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
16 * TODO: autoconfigure NGX_SOCKADDRLEN and NGX_SOCKADDR_STRLEN as
457
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
17 * sizeof(struct sockaddr_storage)
461
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 457
diff changeset
18 * sizeof(struct sockaddr_un)
457
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
19 * sizeof(struct sockaddr_in6)
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
20 * sizeof(struct sockaddr_in)
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
21 */
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
22
550
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
23 #define NGX_INET_ADDRSTRLEN (sizeof("255.255.255.255") - 1)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
24 #define NGX_INET6_ADDRSTRLEN \
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
25 (sizeof("ffff:ffff:ffff:ffff:ffff:ffff:255.255.255.255") - 1)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
26 #define NGX_UNIX_ADDRSTRLEN \
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
27 (sizeof(struct sockaddr_un) - offsetof(struct sockaddr_un, sun_path))
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
28
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
29 #if (NGX_HAVE_UNIX_DOMAIN)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
30 #define NGX_SOCKADDR_STRLEN (sizeof("unix:") - 1 + NGX_UNIX_ADDRSTRLEN)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
31 #else
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
32 #define NGX_SOCKADDR_STRLEN (NGX_INET6_ADDRSTRLEN + sizeof(":65535") - 1)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
33 #endif
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 501
diff changeset
34
461
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 457
diff changeset
35 #if (NGX_HAVE_UNIX_DOMAIN)
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 457
diff changeset
36 #define NGX_SOCKADDRLEN sizeof(struct sockaddr_un)
457
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
37 #else
461
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 457
diff changeset
38 #define NGX_SOCKADDRLEN 512
457
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
39 #endif
406
6ebbca3d5ed7 nginx 0.7.12
Igor Sysoev <http://sysoev.ru>
parents: 354
diff changeset
40
6ebbca3d5ed7 nginx 0.7.12
Igor Sysoev <http://sysoev.ru>
parents: 354
diff changeset
41
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
42 typedef struct {
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
43 in_addr_t addr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
44 in_addr_t mask;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
45 } ngx_in_cidr_t;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
46
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
47
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
48 #if (NGX_HAVE_INET6)
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
49
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
50 typedef struct {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
51 struct in6_addr addr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
52 struct in6_addr mask;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
53 } ngx_in6_cidr_t;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
54
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
55 #endif
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
56
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
57
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
58 typedef struct {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
59 ngx_uint_t family;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
60 union {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
61 ngx_in_cidr_t in;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
62 #if (NGX_HAVE_INET6)
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
63 ngx_in6_cidr_t in6;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
64 #endif
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
65 } u;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
66 } ngx_cidr_t;
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
67
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
68
200
d2ae1c9f1fd3 nginx 0.3.47
Igor Sysoev <http://sysoev.ru>
parents: 28
diff changeset
69 typedef struct {
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
70 struct sockaddr *sockaddr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
71 socklen_t socklen;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
72 ngx_str_t name;
552
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 550
diff changeset
73 } ngx_addr_t;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
74
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
75
260
0effe91f6083 nginx 0.5.0
Igor Sysoev <http://sysoev.ru>
parents: 252
diff changeset
76 typedef struct {
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
77 ngx_str_t url;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
78 ngx_str_t host;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
79 ngx_str_t port_text;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
80 ngx_str_t uri;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
81
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
82 in_port_t port;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
83 in_port_t default_port;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
84 int family;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
85
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
86 unsigned listen:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
87 unsigned uri_part:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
88 unsigned no_resolve:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
89 unsigned one_addr:1;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
90
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
91 unsigned no_port:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
92 unsigned wildcard:1;
260
0effe91f6083 nginx 0.5.0
Igor Sysoev <http://sysoev.ru>
parents: 252
diff changeset
93
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
94 socklen_t socklen;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
95 u_char sockaddr[NGX_SOCKADDRLEN];
457
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
96
552
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 550
diff changeset
97 ngx_addr_t *addrs;
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
98 ngx_uint_t naddrs;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
99
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
100 char *err;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
101 } ngx_url_t;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
102
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
103
348
e10168d6e371 nginx 0.6.18
Igor Sysoev <http://sysoev.ru>
parents: 340
diff changeset
104 in_addr_t ngx_inet_addr(u_char *text, size_t len);
552
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 550
diff changeset
105 #if (NGX_HAVE_INET6)
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 550
diff changeset
106 ngx_int_t ngx_inet6_addr(u_char *p, size_t len, u_char *addr);
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 550
diff changeset
107 size_t ngx_inet6_ntop(u_char *p, u_char *text, size_t len);
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 550
diff changeset
108 #endif
457
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
109 size_t ngx_sock_ntop(struct sockaddr *sa, u_char *text, size_t len,
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 406
diff changeset
110 ngx_uint_t port);
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
111 size_t ngx_inet_ntop(int family, void *addr, u_char *text, size_t len);
463
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 461
diff changeset
112 ngx_int_t ngx_ptocidr(ngx_str_t *text, ngx_cidr_t *cidr);
552
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 550
diff changeset
113 ngx_int_t ngx_parse_addr(ngx_pool_t *pool, ngx_addr_t *addr, u_char *text,
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 550
diff changeset
114 size_t len);
340
10cc350ed8a1 nginx 0.6.14
Igor Sysoev <http://sysoev.ru>
parents: 266
diff changeset
115 ngx_int_t ngx_parse_url(ngx_pool_t *pool, ngx_url_t *u);
10cc350ed8a1 nginx 0.6.14
Igor Sysoev <http://sysoev.ru>
parents: 266
diff changeset
116 ngx_int_t ngx_inet_resolve_host(ngx_pool_t *pool, ngx_url_t *u);
260
0effe91f6083 nginx 0.5.0
Igor Sysoev <http://sysoev.ru>
parents: 252
diff changeset
117
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
118
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
119 #endif /* _NGX_INET_H_INCLUDED_ */