annotate src/core/ngx_inet.h @ 660:d0f7a625f27c NGINX_1_1_14

nginx 1.1.14 *) Feature: multiple "limit_req" limits may be used simultaneously. *) Bugfix: in error handling while connecting to a backend. Thanks to Piotr Sikora. *) Bugfix: in AIO error handling on FreeBSD. *) Bugfix: in the OpenSSL library initialization. *) Bugfix: the "proxy_redirect" directives might not be correctly inherited. *) Bugfix: memory leak during reconfiguration if the "pcre_jit" directive was used.
author Igor Sysoev <http://sysoev.ru>
date Mon, 30 Jan 2012 00:00:00 +0400
parents c04fa65fe604
children 88a1b4797f2e
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
660
d0f7a625f27c nginx 1.1.14
Igor Sysoev <http://sysoev.ru>
parents: 540
diff changeset
4 * Copyright (C) Nginx, Inc.
0
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
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
8 #ifndef _NGX_INET_H_INCLUDED_
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
9 #define _NGX_INET_H_INCLUDED_
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
10
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
11
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
12 #include <ngx_config.h>
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
13 #include <ngx_core.h>
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
14
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
15
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
16 /*
538
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
17 * TODO: autoconfigure NGX_SOCKADDRLEN and NGX_SOCKADDR_STRLEN as
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
18 * sizeof(struct sockaddr_storage)
452
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 448
diff changeset
19 * sizeof(struct sockaddr_un)
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
20 * sizeof(struct sockaddr_in6)
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
21 * sizeof(struct sockaddr_in)
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
538
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
24 #define NGX_INET_ADDRSTRLEN (sizeof("255.255.255.255") - 1)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
25 #define NGX_INET6_ADDRSTRLEN \
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
26 (sizeof("ffff:ffff:ffff:ffff:ffff:ffff:255.255.255.255") - 1)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
27 #define NGX_UNIX_ADDRSTRLEN \
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
28 (sizeof(struct sockaddr_un) - offsetof(struct sockaddr_un, sun_path))
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
29
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
30 #if (NGX_HAVE_UNIX_DOMAIN)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
31 #define NGX_SOCKADDR_STRLEN (sizeof("unix:") - 1 + NGX_UNIX_ADDRSTRLEN)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
32 #else
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
33 #define NGX_SOCKADDR_STRLEN (NGX_INET6_ADDRSTRLEN + sizeof(":65535") - 1)
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
34 #endif
1dcf6adad484 nginx 0.8.21
Igor Sysoev <http://sysoev.ru>
parents: 492
diff changeset
35
452
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 448
diff changeset
36 #if (NGX_HAVE_UNIX_DOMAIN)
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 448
diff changeset
37 #define NGX_SOCKADDRLEN sizeof(struct sockaddr_un)
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
38 #else
452
fc5ebf0e5f98 nginx 0.7.38
Igor Sysoev <http://sysoev.ru>
parents: 448
diff changeset
39 #define NGX_SOCKADDRLEN 512
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
40 #endif
400
6ebbca3d5ed7 nginx 0.7.12
Igor Sysoev <http://sysoev.ru>
parents: 354
diff changeset
41
6ebbca3d5ed7 nginx 0.7.12
Igor Sysoev <http://sysoev.ru>
parents: 354
diff changeset
42
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
43 typedef struct {
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
44 in_addr_t addr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
45 in_addr_t mask;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
46 } ngx_in_cidr_t;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
47
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
48
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
49 #if (NGX_HAVE_INET6)
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
50
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
51 typedef struct {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
52 struct in6_addr addr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
53 struct in6_addr mask;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
54 } ngx_in6_cidr_t;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
55
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
56 #endif
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
57
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
58
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
59 typedef struct {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
60 ngx_uint_t family;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
61 union {
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
62 ngx_in_cidr_t in;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
63 #if (NGX_HAVE_INET6)
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
64 ngx_in6_cidr_t in6;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
65 #endif
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
66 } u;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
67 } ngx_cidr_t;
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
68
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
69
200
d2ae1c9f1fd3 nginx 0.3.47
Igor Sysoev <http://sysoev.ru>
parents: 28
diff changeset
70 typedef struct {
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
71 struct sockaddr *sockaddr;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
72 socklen_t socklen;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
73 ngx_str_t name;
540
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 538
diff changeset
74 } ngx_addr_t;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
75
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
76
260
0effe91f6083 nginx 0.5.0
Igor Sysoev <http://sysoev.ru>
parents: 252
diff changeset
77 typedef struct {
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
78 ngx_str_t url;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
79 ngx_str_t host;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
80 ngx_str_t port_text;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
81 ngx_str_t uri;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
82
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
83 in_port_t port;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
84 in_port_t default_port;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
85 int family;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
86
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
87 unsigned listen:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
88 unsigned uri_part:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
89 unsigned no_resolve:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
90 unsigned one_addr:1;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
91
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
92 unsigned no_port:1;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
93 unsigned wildcard:1;
260
0effe91f6083 nginx 0.5.0
Igor Sysoev <http://sysoev.ru>
parents: 252
diff changeset
94
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
95 socklen_t socklen;
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
96 u_char sockaddr[NGX_SOCKADDRLEN];
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
97
540
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 538
diff changeset
98 ngx_addr_t *addrs;
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
99 ngx_uint_t naddrs;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
100
454
a8424ffa495c nginx 0.7.39
Igor Sysoev <http://sysoev.ru>
parents: 452
diff changeset
101 char *err;
252
644510700914 nginx 0.4.11
Igor Sysoev <http://sysoev.ru>
parents: 212
diff changeset
102 } ngx_url_t;
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
103
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
104
348
e10168d6e371 nginx 0.6.18
Igor Sysoev <http://sysoev.ru>
parents: 340
diff changeset
105 in_addr_t ngx_inet_addr(u_char *text, size_t len);
540
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 538
diff changeset
106 #if (NGX_HAVE_INET6)
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 538
diff changeset
107 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: 538
diff changeset
108 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: 538
diff changeset
109 #endif
448
76a79816b771 nginx 0.7.36
Igor Sysoev <http://sysoev.ru>
parents: 400
diff changeset
110 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
111 ngx_uint_t port);
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
112 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
113 ngx_int_t ngx_ptocidr(ngx_str_t *text, ngx_cidr_t *cidr);
540
c04fa65fe604 nginx 0.8.22
Igor Sysoev <http://sysoev.ru>
parents: 538
diff changeset
114 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: 538
diff changeset
115 size_t len);
340
10cc350ed8a1 nginx 0.6.14
Igor Sysoev <http://sysoev.ru>
parents: 266
diff changeset
116 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
117 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
118
28
7ca9bdc82b3f nginx 0.1.14
Igor Sysoev <http://sysoev.ru>
parents: 0
diff changeset
119
0
f0b350454894 nginx 0.1.0
Igor Sysoev <http://sysoev.ru>
parents:
diff changeset
120 #endif /* _NGX_INET_H_INCLUDED_ */