annotate src/core/ngx_inet.h @ 492:98143f74eb3d NGINX_0_7_58

nginx 0.7.58 *) Feature: a "listen" directive of the mail proxy module supports IPv6. *) Feature: the "image_filter_jpeg_quality" directive. *) Feature: the "client_body_in_single_buffer" directive. *) Feature: the $request_body variable. *) Bugfix: in ngx_http_autoindex_module in file name links having a ":" symbol in the name. *) Bugfix: "make upgrade" procedure did not work; the bug had appeared in 0.7.53. Thanks to Denis F. Latypoff.
author Igor Sysoev <http://sysoev.ru>
date Mon, 18 May 2009 00:00:00 +0400
parents a8424ffa495c
children 1dcf6adad484
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
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
15 #define NGX_INET_ADDRSTRLEN (sizeof("255.255.255.255") - 1)
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
16 #define NGX_INET6_ADDRSTRLEN \
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
17 (sizeof("ffff:ffff:ffff:ffff:ffff:ffff:255.255.255.255") - 1)
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
18
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
19 #define NGX_SOCKADDR_STRLEN (NGX_INET6_ADDRSTRLEN + sizeof(":65535") - 1)
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
20
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
21
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
22 /*
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
23 * TODO: autoconfigure NGX_SOCKADDRLEN as
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
24 * sizeof(struct sockaddr_storage)
452
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 448
diff changeset
25 * sizeof(struct sockaddr_un)
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
26 * sizeof(struct sockaddr_in6)
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
27 * sizeof(struct sockaddr_in)
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
28 */
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
29
452
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 448
diff changeset
30 #if (NGX_HAVE_UNIX_DOMAIN)
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 448
diff changeset
31 #define NGX_SOCKADDRLEN sizeof(struct sockaddr_un)
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
32 #else
452
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 448
diff changeset
33 #define NGX_SOCKADDRLEN 512
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
34 #endif
400
6ebbca3d5ed7 nginx 0.7.12
Igor Sysoev <http://sysoev.ru>
parents: 354
diff changeset
35
6ebbca3d5ed7 nginx 0.7.12
Igor Sysoev <http://sysoev.ru>
parents: 354
diff changeset
36
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
37 typedef struct {
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
38 in_addr_t addr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
39 in_addr_t mask;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
40 } ngx_in_cidr_t;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
41
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
42
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
43 #if (NGX_HAVE_INET6)
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
44
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
45 typedef struct {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
46 struct in6_addr addr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
47 struct in6_addr mask;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
48 } ngx_in6_cidr_t;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
49
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
50 #endif
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
51
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
52
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
53 typedef struct {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
54 ngx_uint_t family;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
55 union {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
56 ngx_in_cidr_t in;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
57 #if (NGX_HAVE_INET6)
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
58 ngx_in6_cidr_t in6;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
59 #endif
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
60 } u;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
61 } ngx_cidr_t;
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
62
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
63
200
d2ae1c9f1fd3 nginx 0.3.47
Igor Sysoev <http://sysoev.ru>
parents: 28
diff changeset
64 typedef struct {
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
65 struct sockaddr *sockaddr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
66 socklen_t socklen;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
67 ngx_str_t name;
260
0effe91f6083 nginx 0.5.0
Igor Sysoev <http://sysoev.ru>
parents: 252
diff changeset
68 } ngx_peer_addr_t;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
69
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
70
260
0effe91f6083 nginx 0.5.0
Igor Sysoev <http://sysoev.ru>
parents: 252
diff changeset
71 typedef struct {
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
72 ngx_str_t url;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
73 ngx_str_t host;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
74 ngx_str_t port_text;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
75 ngx_str_t uri;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
76
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
77 in_port_t port;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
78 in_port_t default_port;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
79 int family;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
80
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
81 unsigned listen:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
82 unsigned uri_part:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
83 unsigned no_resolve:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
84 unsigned one_addr:1;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
85
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
86 unsigned no_port:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
87 unsigned wildcard:1;
260
0effe91f6083 nginx 0.5.0
Igor Sysoev <http://sysoev.ru>
parents: 252
diff changeset
88
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
89 socklen_t socklen;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
90 u_char sockaddr[NGX_SOCKADDRLEN];
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
91
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
92 ngx_peer_addr_t *addrs;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
93 ngx_uint_t naddrs;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
94
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
95 char *err;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
96 } ngx_url_t;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
97
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
98
348
e10168d6e371 nginx 0.6.18
Igor Sysoev <http://sysoev.ru>
parents: 340
diff changeset
99 in_addr_t ngx_inet_addr(u_char *text, size_t len);
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
100 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: 400
diff changeset
101 ngx_uint_t port);
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
102 size_t ngx_inet_ntop(int family, void *addr, u_char *text, size_t len);
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
103 ngx_int_t ngx_ptocidr(ngx_str_t *text, ngx_cidr_t *cidr);
340
10cc350ed8a1 nginx 0.6.14
Igor Sysoev <http://sysoev.ru>
parents: 266
diff changeset
104 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
105 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
106
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
107
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
108
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
109 #endif /* _NGX_INET_H_INCLUDED_ */