nginx/src/http/ngx_http_config.h


/*
 * Copyright (C) Igor Sysoev
 */


#ifndef _NGX_HTTP_CONFIG_H_INCLUDED_
#define _NGX_HTTP_CONFIG_H_INCLUDED_


#include <ngx_config.h>
#include <ngx_core.h>
#include <ngx_http.h>


typedef struct {
    void        **main_conf;
    void        **srv_conf;
    void        **loc_conf;
} ngx_http_conf_ctx_t;


typedef struct {
    ngx_int_t   (*preconfiguration)(ngx_conf_t *cf);
    ngx_int_t   (*postconfiguration)(ngx_conf_t *cf);

    void       *(*create_main_conf)(ngx_conf_t *cf);
    char       *(*init_main_conf)(ngx_conf_t *cf, void *conf);

    void       *(*create_srv_conf)(ngx_conf_t *cf);
    char       *(*merge_srv_conf)(ngx_conf_t *cf, void *prev, void *conf);

    void       *(*create_loc_conf)(ngx_conf_t *cf);
    char       *(*merge_loc_conf)(ngx_conf_t *cf, void *prev, void *conf);
} ngx_http_module_t;


#define NGX_HTTP_MODULE           0x50545448   /* "HTTP" */

#define NGX_HTTP_MAIN_CONF        0x02000000
#define NGX_HTTP_SRV_CONF         0x04000000
#define NGX_HTTP_LOC_CONF         0x08000000
#define NGX_HTTP_UPS_CONF         0x10000000
#define NGX_HTTP_SIF_CONF         0x20000000
#define NGX_HTTP_LIF_CONF         0x40000000
#define NGX_HTTP_LMT_CONF         0x80000000


#define NGX_HTTP_MAIN_CONF_OFFSET  offsetof(ngx_http_conf_ctx_t, main_conf)
#define NGX_HTTP_SRV_CONF_OFFSET   offsetof(ngx_http_conf_ctx_t, srv_conf)
#define NGX_HTTP_LOC_CONF_OFFSET   offsetof(ngx_http_conf_ctx_t, loc_conf)


#define ngx_http_get_module_main_conf(r, module)                             \
    (r)->main_conf[module.ctx_index]
#define ngx_http_get_module_srv_conf(r, module)  (r)->srv_conf[module.ctx_index]
#define ngx_http_get_module_loc_conf(r, module)  (r)->loc_conf[module.ctx_index]

/*
 * ngx_http_conf_get_module_srv_conf() and ngx_http_conf_get_module_loc_conf()
 * must not be used at the merge phase because cf->ctx points to http{}'s ctx
 */

#define ngx_http_conf_get_module_main_conf(cf, module)                        \
    ((ngx_http_conf_ctx_t *) cf->ctx)->main_conf[module.ctx_index]
#define ngx_http_conf_get_module_srv_conf(cf, module)                         \
    ((ngx_http_conf_ctx_t *) cf->ctx)->srv_conf[module.ctx_index]
#define ngx_http_conf_get_module_loc_conf(cf, module)                         \
    ((ngx_http_conf_ctx_t *) cf->ctx)->loc_conf[module.ctx_index]

#define ngx_http_cycle_get_module_main_conf(cycle, module)                    \
    (cycle->conf_ctx[ngx_http_module.index] ?                                 \
        ((ngx_http_conf_ctx_t *) cycle->conf_ctx[ngx_http_module.index])      \
            ->main_conf[module.ctx_index]:                                    \
        NULL)


#endif /* _NGX_HTTP_CONFIG_H_INCLUDED_ */
nginx-0.1.0-2004-09-28-12:34:51 import; set copyright and remove unused files 2004-09-28 16:34:51 +08:00
			`/*`
nginx-0.1.0-2004-09-29-20:00:49 import; remove years from copyright 2004-09-30 00:00:49 +08:00			`* Copyright (C) Igor Sysoev`
nginx-0.1.0-2004-09-28-12:34:51 import; set copyright and remove unused files 2004-09-28 16:34:51 +08:00			`*/`


nginx-0.0.1-2002-09-11-19:18:33 import 2002-09-11 23:18:33 +08:00			`#ifndef _NGX_HTTP_CONFIG_H_INCLUDED_`
			`#define _NGX_HTTP_CONFIG_H_INCLUDED_`


nginx-0.1.35-RELEASE import ) Feature: the "working_directory" directive. ) Feature: the "port_in_redirect" directive. ) Bugfix: the segmentation fault was occurred if the backend response header was in several packets; the bug had appeared in 0.1.29. ) Bugfix: if more than 10 servers were configured or some server did not use the "listen" directive, then the segmentation fault was occurred on the start. ) Bugfix: the segmentation fault might occur if the response was bigger than the temporary file. ) Bugfix: nginx returned the 400 response on requests like "GET http://www.domain.com/uri HTTP/1.0"; the bug had appeared in 0.1.28. 2005-06-07 23:56:31 +08:00			`#include <ngx_config.h>`
			`#include <ngx_core.h>`
nginx-0.0.1-2002-09-11-19:18:33 import 2002-09-11 23:18:33 +08:00			`#include <ngx_http.h>`


nginx-0.0.1-2002-12-26-19:26:23 import 2002-12-27 00:26:23 +08:00			`typedef struct {`
nginx-0.3.17-RELEASE import ) Change: now on Linux configure checks the presence of epoll and sendfile64() in kernel. ) Feature: the "map" directive supports domain names in the ".domain.tld" form. ) Bugfix: the timeouts were not used in SSL handshake; the bug had appeared in 0.2.4. ) Bugfix: in the HTTPS protocol in the "proxy_pass" directive. *) Bugfix: when the HTTPS protocol was used in the "proxy_pass" directive the port 80 was used by default. 2005-12-19 00:02:44 +08:00			`void **main_conf;`
			`void **srv_conf;`
			`void **loc_conf;`
nginx-0.0.1-2002-12-26-19:26:23 import 2002-12-27 00:26:23 +08:00			`} ngx_http_conf_ctx_t;`


nginx-0.0.1-2003-03-20-19:09:44 import 2003-03-21 00:09:44 +08:00			`typedef struct {`
nginx-0.1.29-RELEASE import ) Feature: the ngx_http_ssi_module supports "include virtual" command. ) Feature: the ngx_http_ssi_module supports the condition command like 'if expr="$NAME"' and "else" and "endif" commands. Only one nested level is supported. ) Feature: the ngx_http_ssi_module supports the DATE_LOCAL and DATE_GMT variables and "config timefmt" command. ) Feature: the "ssi_ignore_recycled_buffers" directive. ) Bugfix: the "echo" command did not show the default value for the empty QUERY_STRING variable. ) Change: the ngx_http_proxy_module was rewritten. ) Feature: the "proxy_redirect", "proxy_pass_request_headers", "proxy_pass_request_body", and "proxy_method" directives. ) Feature: the "proxy_set_header" directive. The "proxy_x_var" was canceled and must be replaced with the proxy_set_header directive. ) Change: the "proxy_preserve_host" is canceled and must be replaced with the "proxy_set_header Host $host" and the "proxy_redirect off" directives, the "proxy_set_header Host $host:$proxy_port" directive and the appropriate proxy_redirect directives. ) Change: the "proxy_set_x_real_ip" is canceled and must be replaced with the "proxy_set_header X-Real-IP $remote_addr" directive. ) Change: the "proxy_add_x_forwarded_for" is canceled and must be replaced with the "proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for" directive. ) Change: the "proxy_set_x_url" is canceled and must be replaced with the "proxy_set_header X-URL http://$host:$server_port$request_uri" directive. ) Feature: the "fastcgi_param" directive. ) Change: the "fastcgi_root", "fastcgi_set_var" and "fastcgi_params" directive are canceled and must be replaced with the fastcgi_param directives. ) Feature: the "index" directive can use the variables. ) Feature: the "index" directive can be used at http and server levels. ) Change: the last index only in the "index" directive can be absolute. ) Feature: the "rewrite" directive can use the variables. ) Feature: the "internal" directive. ) Feature: the CONTENT_LENGTH, CONTENT_TYPE, REMOTE_PORT, SERVER_ADDR, SERVER_PORT, SERVER_PROTOCOL, DOCUMENT_ROOT, SERVER_NAME, REQUEST_METHOD, REQUEST_URI, and REMOTE_USER variables. ) Change: nginx now passes the invalid lines in a client request headers or a backend response header. ) Bugfix: if the backend did not transfer response for a long time and the "send_timeout" was less than "proxy_read_timeout", then nginx returned the 408 response. ) Bugfix: the segmentation fault was occurred if the backend sent an invalid line in response header; the bug had appeared in 0.1.26. ) Bugfix: the segmentation fault may occurred in FastCGI fault tolerance configuration. ) Bugfix: the "expires" directive did not remove the previous "Expires" and "Cache-Control" headers. ) Bugfix: nginx did not take into account trailing dot in "Host" header line. ) Bugfix: the ngx_http_auth_module did not work under Linux. ) Bugfix: the rewrite directive worked incorrectly, if the arguments were in a request. *) Bugfix: nginx could not be built on MacOS X. 2005-05-12 22:58:06 +08:00			`ngx_int_t (preconfiguration)(ngx_conf_t cf);`
			`ngx_int_t (postconfiguration)(ngx_conf_t cf);`
nginx-0.0.1-2003-03-20-19:09:44 import 2003-03-21 00:09:44 +08:00
nginx-0.0.7-2004-06-16-19:32:11 import 2004-06-16 23:32:11 +08:00			`void (create_main_conf)(ngx_conf_t *cf);`
			`char (init_main_conf)(ngx_conf_t cf, void conf);`
nginx-0.0.1-2003-03-20-19:09:44 import 2003-03-21 00:09:44 +08:00
nginx-0.0.7-2004-06-16-19:32:11 import 2004-06-16 23:32:11 +08:00			`void (create_srv_conf)(ngx_conf_t *cf);`
			`char (merge_srv_conf)(ngx_conf_t cf, void prev, void *conf);`
nginx-0.0.1-2003-05-19-20:39:14 import 2003-05-20 00:39:14 +08:00
nginx-0.0.7-2004-06-16-19:32:11 import 2004-06-16 23:32:11 +08:00			`void (create_loc_conf)(ngx_conf_t *cf);`
			`char (merge_loc_conf)(ngx_conf_t cf, void prev, void *conf);`
nginx-0.0.1-2003-03-20-19:09:44 import 2003-03-21 00:09:44 +08:00			`} ngx_http_module_t;`


nginx-0.0.1-2003-05-27-16:18:54 import 2003-05-27 20:18:54 +08:00			`#define NGX_HTTP_MODULE 0x50545448 /* "HTTP" */`
nginx-0.0.1-2003-03-20-19:09:44 import 2003-03-21 00:09:44 +08:00
nginx-0.0.3-2004-04-12-20:38:09 import 2004-04-13 00:38:09 +08:00			`#define NGX_HTTP_MAIN_CONF 0x02000000`
			`#define NGX_HTTP_SRV_CONF 0x04000000`
			`#define NGX_HTTP_LOC_CONF 0x08000000`
nginx-0.1.17-RELEASE import ) Change: the ngx_http_rewrite_module was rewritten from the scratch. Now it is possible to redirect, to return the error codes, to check the variables and referrers. The directives can be used inside locations. The redirect directive was canceled. ) Feature: the ngx_http_geo_module. ) Feature: the proxy_set_x_var and fastcgi_set_var directives. ) Bugfix: the location configuration with "=" modifier may be used in another location. ) Bugfix: the correct content type was set only for requests that use small caps letters in extension. ) Bugfix: if the proxy_pass or fastcgi_pass directives were set in the location, and access was denied, and the error was redirected to a static page, then the segmentation fault occurred. ) Bugfix: if in a proxied "Location" header was a relative URL, then a host name and a slash were added to them; the bug had appeared in 0.1.14. ) Bugfix: the system error message was not logged on Linux. 2005-02-04 03:33:37 +08:00			`#define NGX_HTTP_UPS_CONF 0x10000000`
			`#define NGX_HTTP_SIF_CONF 0x20000000`
nginx-0.3.37-RELEASE import ) Feature: the "limit_except" directive. ) Feature: the "if" directive supports the "!~", "!~", "-f", and "!-f" operators. ) Feature: the ngx_http_perl_module supports the $r->request_body method. *) Bugfix: in the ngx_http_addition_filter_module. 2006-04-07 22:08:04 +08:00			`#define NGX_HTTP_LIF_CONF 0x40000000`
			`#define NGX_HTTP_LMT_CONF 0x80000000`
nginx-0.0.1-2003-01-09-08:36:00 import 2003-01-09 13:36:00 +08:00
nginx-0.0.1-2003-03-20-19:09:44 import 2003-03-21 00:09:44 +08:00
nginx-0.0.1-2003-05-16-19:27:48 import 2003-05-16 23:27:48 +08:00			`#define NGX_HTTP_MAIN_CONF_OFFSET offsetof(ngx_http_conf_ctx_t, main_conf)`
			`#define NGX_HTTP_SRV_CONF_OFFSET offsetof(ngx_http_conf_ctx_t, srv_conf)`
			`#define NGX_HTTP_LOC_CONF_OFFSET offsetof(ngx_http_conf_ctx_t, loc_conf)`
nginx-0.0.1-2002-12-26-19:26:23 import 2002-12-27 00:26:23 +08:00

nginx-0.1.24-RELEASE import ) Feature: the ngx_http_ssi_filter_module supports the QUERY_STRING and DOCUMENT_URI variables. ) Bugfix: the ngx_http_autoindex_module may some times return the 404 response for existent directory, if this directory was used in "alias" directive. ) Bugfix: the ngx_http_ssi_filter_module ran incorrectly for large responses. ) Bugfix: the lack of the "Referer" header line was always accounted as valid referrer. 2005-03-04 22:06:57 +08:00			`#define ngx_http_get_module_main_conf(r, module) \`
			`(r)->main_conf[module.ctx_index]`
			`#define ngx_http_get_module_srv_conf(r, module) (r)->srv_conf[module.ctx_index]`
			`#define ngx_http_get_module_loc_conf(r, module) (r)->loc_conf[module.ctx_index]`
nginx-0.0.1-2003-03-20-19:09:44 import 2003-03-21 00:09:44 +08:00
nginx-0.0.7-2004-07-16-21:11:43 import 2004-07-17 01:11:43 +08:00			`/*`
			`* ngx_http_conf_get_module_srv_conf() and ngx_http_conf_get_module_loc_conf()`
nginx-0.0.10-2004-09-14-09:45:22 import 2004-09-14 13:45:22 +08:00			`* must not be used at the merge phase because cf->ctx points to http{}'s ctx`
nginx-0.0.7-2004-07-16-21:11:43 import 2004-07-17 01:11:43 +08:00			`*/`
nginx-0.0.7-2004-07-15-20:35:51 import 2004-07-16 00:35:51 +08:00
nginx-0.0.7-2004-07-18-23:11:20 import 2004-07-19 03:11:20 +08:00			`#define ngx_http_conf_get_module_main_conf(cf, module) \`
nginx-0.1.25-RELEASE import ) Bugfix: nginx did run on Linux parisc. ) Feature: nginx now does not start under FreeBSD if the sysctl kern.ipc.somaxconn value is too big. ) Bugfix: if a request was internally redirected by the ngx_http_index_module module to the ngx_http_proxy_module or ngx_http_fastcgi_module modules, then the index file was not closed after request completion. ) Feature: the "proxy_pass" can be used in location with regular expression. ) Feature: the ngx_http_rewrite_filter_module module supports the condition like "if ($HTTP_USER_AGENT ~ MSIE)". ) Bugfix: nginx started too slow if the large number of addresses and text values were used in the "geo" directive. ) Change: a variable name must be declared as "$name" in the "geo" directive. The previous variant without "$" is still supported, but will be removed soon. ) Feature: the "%{VARIABLE}v" logging parameter. ) Feature: the "set $name value" directive. ) Bugfix: gcc 4.0 compatibility. *) Feature: the --with-openssl-opt=OPTIONS autoconfiguration directive. 2005-03-19 20:38:37 +08:00			`((ngx_http_conf_ctx_t *) cf->ctx)->main_conf[module.ctx_index]`
nginx-0.0.7-2004-07-18-23:11:20 import 2004-07-19 03:11:20 +08:00			`#define ngx_http_conf_get_module_srv_conf(cf, module) \`
nginx-0.1.25-RELEASE import ) Bugfix: nginx did run on Linux parisc. ) Feature: nginx now does not start under FreeBSD if the sysctl kern.ipc.somaxconn value is too big. ) Bugfix: if a request was internally redirected by the ngx_http_index_module module to the ngx_http_proxy_module or ngx_http_fastcgi_module modules, then the index file was not closed after request completion. ) Feature: the "proxy_pass" can be used in location with regular expression. ) Feature: the ngx_http_rewrite_filter_module module supports the condition like "if ($HTTP_USER_AGENT ~ MSIE)". ) Bugfix: nginx started too slow if the large number of addresses and text values were used in the "geo" directive. ) Change: a variable name must be declared as "$name" in the "geo" directive. The previous variant without "$" is still supported, but will be removed soon. ) Feature: the "%{VARIABLE}v" logging parameter. ) Feature: the "set $name value" directive. ) Bugfix: gcc 4.0 compatibility. *) Feature: the --with-openssl-opt=OPTIONS autoconfiguration directive. 2005-03-19 20:38:37 +08:00			`((ngx_http_conf_ctx_t *) cf->ctx)->srv_conf[module.ctx_index]`
nginx-0.0.7-2004-07-18-23:11:20 import 2004-07-19 03:11:20 +08:00			`#define ngx_http_conf_get_module_loc_conf(cf, module) \`
nginx-0.1.25-RELEASE import ) Bugfix: nginx did run on Linux parisc. ) Feature: nginx now does not start under FreeBSD if the sysctl kern.ipc.somaxconn value is too big. ) Bugfix: if a request was internally redirected by the ngx_http_index_module module to the ngx_http_proxy_module or ngx_http_fastcgi_module modules, then the index file was not closed after request completion. ) Feature: the "proxy_pass" can be used in location with regular expression. ) Feature: the ngx_http_rewrite_filter_module module supports the condition like "if ($HTTP_USER_AGENT ~ MSIE)". ) Bugfix: nginx started too slow if the large number of addresses and text values were used in the "geo" directive. ) Change: a variable name must be declared as "$name" in the "geo" directive. The previous variant without "$" is still supported, but will be removed soon. ) Feature: the "%{VARIABLE}v" logging parameter. ) Feature: the "set $name value" directive. ) Bugfix: gcc 4.0 compatibility. *) Feature: the --with-openssl-opt=OPTIONS autoconfiguration directive. 2005-03-19 20:38:37 +08:00			`((ngx_http_conf_ctx_t *) cf->ctx)->loc_conf[module.ctx_index]`
nginx-0.0.7-2004-07-18-23:11:20 import 2004-07-19 03:11:20 +08:00
nginx-0.0.7-2004-07-15-20:35:51 import 2004-07-16 00:35:51 +08:00			`#define ngx_http_cycle_get_module_main_conf(cycle, module) \`
fix segfault if no http section is defined in confguraiton, the bug has been introduced in r1259 2009-04-16 04:26:33 +08:00			`(cycle->conf_ctx[ngx_http_module.index] ? \`
			`((ngx_http_conf_ctx_t *) cycle->conf_ctx[ngx_http_module.index]) \`
			`->main_conf[module.ctx_index]: \`
			`NULL)`
nginx-0.0.1-2002-12-26-19:26:23 import 2002-12-27 00:26:23 +08:00

nginx-0.0.1-2003-02-06-20:21:13 import 2003-02-07 01:21:13 +08:00			`#endif /* _NGX_HTTP_CONFIG_H_INCLUDED_ */`