nginx: src/http/ngx_http_variables.h annotate

annotate src/http/ngx_http_variables.h @ 8031:d26db4f82d7d

All known output headers can be linked lists now. The h->next pointer properly provided as NULL in all cases where known output headers are added. Note that there are 3rd party modules which might not do this, and it might be risky to rely on this for arbitrary headers.

author	Maxim Dounin <mdounin@mdounin.ru>
date	Mon, 30 May 2022 21:25:45 +0300
parents	08b3ea81ff5f
children

rev	line source
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	1
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	2 /*
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	3 * Copyright (C) Igor Sysoev
4412 d620f497c50f Copyright updated. Maxim Konovalov <maxim@nginx.com> parents: 3929 diff changeset	4 * Copyright (C) Nginx, Inc.
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	5 */
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	6
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	7
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	8 #ifndef _NGX_HTTP_VARIABLES_H_INCLUDED_
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	9 #define _NGX_HTTP_VARIABLES_H_INCLUDED_
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	10
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	11
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	12 #include <ngx_config.h>
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	13 #include <ngx_core.h>
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	14 #include <ngx_http.h>
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	15
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	16
1310 33d6c994a0b2 Sun Studio on sparc uses different bit order Igor Sysoev <igor@sysoev.ru> parents: 1162 diff changeset	17 typedef ngx_variable_value_t ngx_http_variable_value_t;
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	18
2008 66dc85397a90 escape 0x00-0x1f, ", and \ in access log variables Igor Sysoev <igor@sysoev.ru> parents: 1565 diff changeset	19 #define ngx_http_variable(v) { sizeof(v) - 1, 1, 0, 0, 0, (u_char *) v }
573 58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	20
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	21 typedef struct ngx_http_variable_s ngx_http_variable_t;
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	22
637 e60fe4cf1d4e nginx-0.3.40-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 635 diff changeset	23 typedef void (ngx_http_set_variable_pt) (ngx_http_request_t r,
e60fe4cf1d4e nginx-0.3.40-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 635 diff changeset	24 ngx_http_variable_value_t *v, uintptr_t data);
573 58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	25 typedef ngx_int_t (ngx_http_get_variable_pt) (ngx_http_request_t r,
58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	26 ngx_http_variable_value_t *v, uintptr_t data);
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	27
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	28
1565 4c43e25d11ea fix English grammar Igor Sysoev <igor@sysoev.ru> parents: 1310 diff changeset	29 #define NGX_HTTP_VAR_CHANGEABLE 1
4c43e25d11ea fix English grammar Igor Sysoev <igor@sysoev.ru> parents: 1310 diff changeset	30 #define NGX_HTTP_VAR_NOCACHEABLE 2
4c43e25d11ea fix English grammar Igor Sysoev <igor@sysoev.ru> parents: 1310 diff changeset	31 #define NGX_HTTP_VAR_INDEXED 4
4c43e25d11ea fix English grammar Igor Sysoev <igor@sysoev.ru> parents: 1310 diff changeset	32 #define NGX_HTTP_VAR_NOHASH 8
6899 d2b2ff157da5 Variables: generic prefix variables. Dmitry Volyntsev <xeioex@nginx.com> parents: 5127 diff changeset	33 #define NGX_HTTP_VAR_WEAK 16
d2b2ff157da5 Variables: generic prefix variables. Dmitry Volyntsev <xeioex@nginx.com> parents: 5127 diff changeset	34 #define NGX_HTTP_VAR_PREFIX 32
509 9b8c906f6e63 nginx-0.1.29-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 501 diff changeset	35
9b8c906f6e63 nginx-0.1.29-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 501 diff changeset	36
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	37 struct ngx_http_variable_s {
573 58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	38 ngx_str_t name; /* must be first to build the hash */
637 e60fe4cf1d4e nginx-0.3.40-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 635 diff changeset	39 ngx_http_set_variable_pt set_handler;
e60fe4cf1d4e nginx-0.3.40-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 635 diff changeset	40 ngx_http_get_variable_pt get_handler;
573 58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	41 uintptr_t data;
58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	42 ngx_uint_t flags;
58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	43 ngx_uint_t index;
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	44 };
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	45
7077 2a288909abc6 Variables: macros for null variables. Ruslan Ermilov <ru@nginx.com> parents: 6899 diff changeset	46 #define ngx_http_null_variable { ngx_null_string, NULL, NULL, 0, 0, 0 }
2a288909abc6 Variables: macros for null variables. Ruslan Ermilov <ru@nginx.com> parents: 6899 diff changeset	47
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	48
501 d4ea69372b94 nginx-0.1.25-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 499 diff changeset	49 ngx_http_variable_t ngx_http_add_variable(ngx_conf_t cf, ngx_str_t *name,
509 9b8c906f6e63 nginx-0.1.29-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 501 diff changeset	50 ngx_uint_t flags);
9b8c906f6e63 nginx-0.1.29-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 501 diff changeset	51 ngx_int_t ngx_http_get_variable_index(ngx_conf_t cf, ngx_str_t name);
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	52 ngx_http_variable_value_t ngx_http_get_indexed_variable(ngx_http_request_t r,
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	53 ngx_uint_t index);
573 58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	54 ngx_http_variable_value_t ngx_http_get_flushed_variable(ngx_http_request_t r,
58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	55 ngx_uint_t index);
58475592100c nginx-0.3.8-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 533 diff changeset	56
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	57 ngx_http_variable_value_t ngx_http_get_variable(ngx_http_request_t r,
3500 0eb46e3c5c02 change processing variables accessed by SSI and perl module: Igor Sysoev <igor@sysoev.ru> parents: 3356 diff changeset	58 ngx_str_t *name, ngx_uint_t key);
509 9b8c906f6e63 nginx-0.1.29-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 501 diff changeset	59
8023 08b3ea81ff5f Combining unknown headers during variables lookup (ticket #1316). Maxim Dounin <mdounin@mdounin.ru> parents: 7077 diff changeset	60 ngx_int_t ngx_http_variable_unknown_header(ngx_http_request_t *r,
08b3ea81ff5f Combining unknown headers during variables lookup (ticket #1316). Maxim Dounin <mdounin@mdounin.ru> parents: 7077 diff changeset	61 ngx_http_variable_value_t v, ngx_str_t var, ngx_list_part_t *part,
08b3ea81ff5f Combining unknown headers during variables lookup (ticket #1316). Maxim Dounin <mdounin@mdounin.ru> parents: 7077 diff changeset	62 size_t prefix);
1162 f59d15404269 $upstream_http_... variables Igor Sysoev <igor@sysoev.ru> parents: 637 diff changeset	63
f59d15404269 $upstream_http_... variables Igor Sysoev <igor@sysoev.ru> parents: 637 diff changeset	64
3356 fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	65 #if (NGX_PCRE)
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	66
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	67 typedef struct {
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	68 ngx_uint_t capture;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	69 ngx_int_t index;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	70 } ngx_http_regex_variable_t;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	71
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	72
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	73 typedef struct {
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	74 ngx_regex_t *regex;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	75 ngx_uint_t ncaptures;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	76 ngx_http_regex_variable_t *variables;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	77 ngx_uint_t nvariables;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	78 ngx_str_t name;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	79 } ngx_http_regex_t;
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	80
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	81
3872 83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	82 typedef struct {
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	83 ngx_http_regex_t *regex;
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	84 void *value;
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	85 } ngx_http_map_regex_t;
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	86
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	87
3325 42c16d8bddbe regex named captures Igor Sysoev <igor@sysoev.ru> parents: 2333 diff changeset	88 ngx_http_regex_t ngx_http_regex_compile(ngx_conf_t cf,
42c16d8bddbe regex named captures Igor Sysoev <igor@sysoev.ru> parents: 2333 diff changeset	89 ngx_regex_compile_t *rc);
42c16d8bddbe regex named captures Igor Sysoev <igor@sysoev.ru> parents: 2333 diff changeset	90 ngx_int_t ngx_http_regex_exec(ngx_http_request_t r, ngx_http_regex_t re,
42c16d8bddbe regex named captures Igor Sysoev <igor@sysoev.ru> parents: 2333 diff changeset	91 ngx_str_t *s);
42c16d8bddbe regex named captures Igor Sysoev <igor@sysoev.ru> parents: 2333 diff changeset	92
3356 fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	93 #endif
fe08c14530e9 fix building without PCRE, the bug had been introduced in r3326 Igor Sysoev <igor@sysoev.ru> parents: 3325 diff changeset	94
3325 42c16d8bddbe regex named captures Igor Sysoev <igor@sysoev.ru> parents: 2333 diff changeset	95
3872 83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	96 typedef struct {
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	97 ngx_hash_combined_t hash;
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	98 #if (NGX_PCRE)
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	99 ngx_http_map_regex_t *regex;
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	100 ngx_uint_t nregex;
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	101 #endif
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	102 } ngx_http_map_t;
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	103
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	104
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	105 void ngx_http_map_find(ngx_http_request_t r, ngx_http_map_t *map,
3929 fa4612bfb9fa change ngx_http_map_find(): use case sensitive regexes Igor Sysoev <igor@sysoev.ru> parents: 3872 diff changeset	106 ngx_str_t *match);
3872 83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	107
83cd1910329c allow regex as "map" parameter Igor Sysoev <igor@sysoev.ru> parents: 3641 diff changeset	108
509 9b8c906f6e63 nginx-0.1.29-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 501 diff changeset	109 ngx_int_t ngx_http_variables_add_core_vars(ngx_conf_t *cf);
9b8c906f6e63 nginx-0.1.29-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 501 diff changeset	110 ngx_int_t ngx_http_variables_init_vars(ngx_conf_t *cf);
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	111
64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	112
577 4d9ea73a627a nginx-0.3.10-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 573 diff changeset	113 extern ngx_http_variable_value_t ngx_http_variable_null_value;
4d9ea73a627a nginx-0.3.10-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 573 diff changeset	114 extern ngx_http_variable_value_t ngx_http_variable_true_value;
4d9ea73a627a nginx-0.3.10-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 573 diff changeset	115
4d9ea73a627a nginx-0.3.10-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: 573 diff changeset	116
499 64d9afb209da nginx-0.1.24-RELEASE import Igor Sysoev <igor@sysoev.ru> parents: diff changeset	117 #endif /* _NGX_HTTP_VARIABLES_H_INCLUDED_ */

Mercurial > hg > nginx

annotate src/http/ngx_http_variables.h @ 8031:d26db4f82d7d