2002-12-28 00:22:50 +08:00
|
|
|
#ifndef _NGX_HTTP_CONF_FILE_H_INCLUDED_
|
|
|
|
#define _NGX_HTTP_CONF_FILE_H_INCLUDED_
|
2002-12-19 15:08:55 +08:00
|
|
|
|
|
|
|
|
|
|
|
#include <ngx_config.h>
|
2003-06-03 23:42:58 +08:00
|
|
|
#include <ngx_core.h>
|
2002-12-19 15:08:55 +08:00
|
|
|
|
2002-12-26 15:24:21 +08:00
|
|
|
|
2003-05-15 01:13:13 +08:00
|
|
|
/*
|
2003-05-15 23:42:53 +08:00
|
|
|
* AAAA number of agruments
|
|
|
|
* FF command flags
|
|
|
|
* TT command type, i.e. HTTP "location" or "server" command
|
2003-05-15 01:13:13 +08:00
|
|
|
*/
|
|
|
|
|
2003-05-16 23:27:48 +08:00
|
|
|
#define NGX_CONF_NOARGS 0x00000001
|
|
|
|
#define NGX_CONF_TAKE1 0x00000002
|
|
|
|
#define NGX_CONF_TAKE2 0x00000004
|
2003-10-23 00:38:26 +08:00
|
|
|
#define NGX_CONF_TAKE3 0x00000008
|
|
|
|
#define NGX_CONF_TAKE4 0x00000010
|
|
|
|
#define NGX_CONF_TAKE5 0x00000020
|
|
|
|
#define NGX_CONF_TAKE6 0x00000040
|
|
|
|
#define NGX_CONF_TAKE7 0x00000080
|
|
|
|
|
2003-11-10 04:03:38 +08:00
|
|
|
#define NGX_CONF_TAKE12 (NGX_CONF_TAKE1|NGX_CONF_TAKE2)
|
|
|
|
#define NGX_CONF_TAKE13 (NGX_CONF_TAKE1|NGX_CONF_TAKE3)
|
|
|
|
|
2003-12-26 04:26:58 +08:00
|
|
|
#define NGX_CONF_TAKE23 (NGX_CONF_TAKE2|NGX_CONF_TAKE3)
|
|
|
|
|
2003-10-23 00:38:26 +08:00
|
|
|
#define NGX_CONF_TAKE1234 (NGX_CONF_TAKE1|NGX_CONF_TAKE2|NGX_CONF_TAKE3 \
|
|
|
|
|NGX_CONF_TAKE4)
|
|
|
|
|
2004-04-13 00:38:09 +08:00
|
|
|
#define NGX_CONF_ARGS_NUMBER 0x000000ff
|
|
|
|
#define NGX_CONF_BLOCK 0x00000100
|
|
|
|
#define NGX_CONF_FLAG 0x00000200
|
|
|
|
#define NGX_CONF_ANY 0x00000400
|
|
|
|
#define NGX_CONF_1MORE 0x00000800
|
|
|
|
#define NGX_CONF_2MORE 0x00001000
|
2002-12-19 15:08:55 +08:00
|
|
|
|
2004-04-13 00:38:09 +08:00
|
|
|
#define NGX_DIRECT_CONF 0x00010000
|
2003-05-16 23:27:48 +08:00
|
|
|
#define NGX_MAIN_CONF 0x01000000
|
2003-05-15 01:13:13 +08:00
|
|
|
|
|
|
|
|
2002-12-19 15:08:55 +08:00
|
|
|
|
2002-12-28 00:22:50 +08:00
|
|
|
#define NGX_CONF_UNSET -1
|
2004-04-14 13:57:36 +08:00
|
|
|
#define NGX_CONF_UNSET_UINT (ngx_uint_t) -1
|
2004-03-16 15:10:12 +08:00
|
|
|
#define NGX_CONF_UNSET_SIZE (size_t) -1
|
|
|
|
#define NGX_CONF_UNSET_MSEC (ngx_msec_t) -1
|
2002-12-19 15:08:55 +08:00
|
|
|
|
|
|
|
|
2003-01-09 13:36:00 +08:00
|
|
|
#define NGX_CONF_OK NULL
|
|
|
|
#define NGX_CONF_ERROR (void *) -1
|
2002-12-28 00:22:50 +08:00
|
|
|
|
2002-12-26 15:24:21 +08:00
|
|
|
#define NGX_CONF_BLOCK_DONE 1
|
|
|
|
#define NGX_CONF_FILE_DONE 2
|
|
|
|
|
2003-05-27 20:18:54 +08:00
|
|
|
#define NGX_MODULE 0, 0
|
2002-12-26 15:24:21 +08:00
|
|
|
|
2003-05-27 20:18:54 +08:00
|
|
|
#define NGX_CORE_MODULE 0x45524F43 /* "CORE" */
|
|
|
|
#define NGX_CONF_MODULE 0x464E4F43 /* "CONF" */
|
|
|
|
|
|
|
|
|
2003-11-26 04:44:56 +08:00
|
|
|
#define NGX_MAX_CONF_ERRSTR 256
|
|
|
|
|
|
|
|
|
2002-12-27 00:26:23 +08:00
|
|
|
struct ngx_command_s {
|
2003-10-24 14:53:41 +08:00
|
|
|
ngx_str_t name;
|
|
|
|
int type;
|
|
|
|
char *(*set)(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
|
|
|
int conf;
|
|
|
|
int offset;
|
|
|
|
void *post;
|
2002-12-27 00:26:23 +08:00
|
|
|
};
|
2002-12-26 15:24:21 +08:00
|
|
|
|
2003-10-23 14:13:16 +08:00
|
|
|
#define ngx_null_command { ngx_null_string, 0, NULL, 0, 0, NULL }
|
2002-12-26 15:24:21 +08:00
|
|
|
|
2003-06-03 23:42:58 +08:00
|
|
|
|
2003-07-02 22:41:17 +08:00
|
|
|
struct ngx_open_file_s {
|
|
|
|
ngx_fd_t fd;
|
|
|
|
ngx_str_t name;
|
2003-07-21 05:15:59 +08:00
|
|
|
#if 0
|
|
|
|
/* e.g. append mode, error_log */
|
|
|
|
int flags;
|
|
|
|
/* e.g. reopen db file */
|
|
|
|
int (*handler)(void *data, ngx_open_file_t *file);
|
|
|
|
void *data;
|
|
|
|
#endif
|
2003-07-02 22:41:17 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
|
2003-06-03 23:42:58 +08:00
|
|
|
struct ngx_module_s {
|
2003-05-27 20:18:54 +08:00
|
|
|
int ctx_index;
|
2003-05-16 23:27:48 +08:00
|
|
|
int index;
|
2003-05-27 20:18:54 +08:00
|
|
|
void *ctx;
|
2002-12-26 15:24:21 +08:00
|
|
|
ngx_command_t *commands;
|
|
|
|
int type;
|
2003-07-04 23:10:33 +08:00
|
|
|
int (*init_module)(ngx_cycle_t *cycle);
|
2004-01-06 04:55:48 +08:00
|
|
|
int (*init_process)(ngx_cycle_t *cycle);
|
|
|
|
#if 0
|
|
|
|
int (*init_thread)(ngx_cycle_t *cycle);
|
|
|
|
#endif
|
2003-06-03 23:42:58 +08:00
|
|
|
};
|
2002-12-23 14:29:22 +08:00
|
|
|
|
|
|
|
|
2004-04-13 00:38:09 +08:00
|
|
|
typedef struct {
|
|
|
|
ngx_str_t name;
|
|
|
|
void *(*create_conf)(ngx_cycle_t *cycle);
|
|
|
|
char *(*init_conf)(ngx_cycle_t *cycle, void *conf);
|
|
|
|
} ngx_core_module_t;
|
|
|
|
|
|
|
|
|
2002-12-19 15:08:55 +08:00
|
|
|
typedef struct {
|
|
|
|
ngx_file_t file;
|
|
|
|
ngx_hunk_t *hunk;
|
|
|
|
int line;
|
|
|
|
} ngx_conf_file_t;
|
|
|
|
|
2002-12-26 15:24:21 +08:00
|
|
|
|
2003-05-15 01:13:13 +08:00
|
|
|
typedef char *(*ngx_conf_handler_pt)(ngx_conf_t *cf,
|
2003-05-30 22:27:59 +08:00
|
|
|
ngx_command_t *dummy, void *conf);
|
2003-05-15 01:13:13 +08:00
|
|
|
|
|
|
|
|
2002-12-19 15:08:55 +08:00
|
|
|
struct ngx_conf_s {
|
2003-05-15 01:13:13 +08:00
|
|
|
char *name;
|
|
|
|
ngx_array_t *args;
|
2002-12-19 15:08:55 +08:00
|
|
|
|
2003-07-01 23:00:03 +08:00
|
|
|
ngx_cycle_t *cycle;
|
2003-05-15 01:13:13 +08:00
|
|
|
ngx_pool_t *pool;
|
|
|
|
ngx_conf_file_t *conf_file;
|
|
|
|
ngx_log_t *log;
|
2002-12-19 15:08:55 +08:00
|
|
|
|
2003-05-15 01:13:13 +08:00
|
|
|
void *ctx;
|
|
|
|
int module_type;
|
|
|
|
int cmd_type;
|
|
|
|
|
|
|
|
ngx_conf_handler_pt handler;
|
|
|
|
char *handler_conf;
|
2002-12-19 15:08:55 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
|
2003-10-24 14:53:41 +08:00
|
|
|
typedef char *(*ngx_conf_post_handler_pt) (ngx_conf_t *cf,
|
|
|
|
void *data, void *conf);
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
ngx_conf_post_handler_pt post_handler;
|
|
|
|
} ngx_conf_post_t;
|
|
|
|
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
ngx_conf_post_handler_pt post_handler;
|
|
|
|
int low;
|
|
|
|
int high;
|
|
|
|
} ngx_conf_num_bounds_t;
|
|
|
|
|
|
|
|
|
2004-04-14 13:57:36 +08:00
|
|
|
typedef struct {
|
|
|
|
ngx_str_t name;
|
|
|
|
ngx_uint_t value;
|
|
|
|
} ngx_conf_enum_t;
|
|
|
|
|
|
|
|
|
2003-11-03 06:56:18 +08:00
|
|
|
#define NGX_CONF_BITMASK_SET 1
|
|
|
|
|
2003-10-30 16:51:06 +08:00
|
|
|
typedef struct {
|
2004-04-14 13:57:36 +08:00
|
|
|
ngx_str_t name;
|
|
|
|
ngx_uint_t mask;
|
2003-10-30 16:51:06 +08:00
|
|
|
} ngx_conf_bitmask_t;
|
|
|
|
|
|
|
|
|
2003-10-24 14:53:41 +08:00
|
|
|
char *ngx_conf_check_num_bounds(ngx_conf_t *cf, void *post, void *data);
|
|
|
|
|
|
|
|
|
2003-07-04 23:10:33 +08:00
|
|
|
#define ngx_get_conf(conf_ctx, module) conf_ctx[module.index]
|
2003-05-20 00:39:14 +08:00
|
|
|
|
|
|
|
|
2003-07-18 22:44:05 +08:00
|
|
|
|
2003-05-20 00:39:14 +08:00
|
|
|
#define ngx_conf_init_value(conf, default) \
|
|
|
|
if (conf == NGX_CONF_UNSET) { \
|
|
|
|
conf = default; \
|
|
|
|
}
|
|
|
|
|
2003-12-09 23:08:11 +08:00
|
|
|
#define ngx_conf_init_ptr_value(conf, default) \
|
|
|
|
if (conf == (void *) NGX_CONF_UNSET) { \
|
|
|
|
conf = default; \
|
|
|
|
}
|
|
|
|
|
2003-06-16 02:32:13 +08:00
|
|
|
#define ngx_conf_init_unsigned_value(conf, default) \
|
|
|
|
if (conf == (unsigned) NGX_CONF_UNSET) { \
|
|
|
|
conf = default; \
|
|
|
|
}
|
|
|
|
|
2003-05-20 00:39:14 +08:00
|
|
|
#define ngx_conf_init_size_value(conf, default) \
|
2004-04-05 04:32:09 +08:00
|
|
|
if (conf == NGX_CONF_UNSET_SIZE) { \
|
2003-05-20 00:39:14 +08:00
|
|
|
conf = default; \
|
|
|
|
}
|
|
|
|
|
|
|
|
#define ngx_conf_init_msec_value(conf, default) \
|
2004-04-05 04:32:09 +08:00
|
|
|
if (conf == NGX_CONF_UNSET_MSEC) { \
|
2003-05-20 00:39:14 +08:00
|
|
|
conf = default; \
|
|
|
|
}
|
|
|
|
|
|
|
|
#define ngx_conf_merge_value(conf, prev, default) \
|
2003-01-09 13:36:00 +08:00
|
|
|
if (conf == NGX_CONF_UNSET) { \
|
|
|
|
conf = (prev == NGX_CONF_UNSET) ? default : prev; \
|
|
|
|
}
|
2002-12-25 01:30:59 +08:00
|
|
|
|
2004-04-14 13:57:36 +08:00
|
|
|
#define ngx_conf_merge_unsigned_value(conf, prev, default) \
|
|
|
|
if (conf == NGX_CONF_UNSET_UINT) { \
|
|
|
|
conf = (prev == NGX_CONF_UNSET_UINT) ? default : prev; \
|
|
|
|
}
|
|
|
|
|
2003-05-20 00:39:14 +08:00
|
|
|
#define ngx_conf_merge_msec_value(conf, prev, default) \
|
2004-03-16 15:10:12 +08:00
|
|
|
if (conf == NGX_CONF_UNSET_MSEC) { \
|
|
|
|
conf = (prev == NGX_CONF_UNSET_MSEC) ? default : prev; \
|
2003-05-15 01:13:13 +08:00
|
|
|
}
|
2002-12-25 01:30:59 +08:00
|
|
|
|
2003-11-04 06:20:44 +08:00
|
|
|
#define ngx_conf_merge_sec_value(conf, prev, default) \
|
|
|
|
if (conf == NGX_CONF_UNSET) { \
|
|
|
|
conf = (prev == NGX_CONF_UNSET) ? default : prev; \
|
|
|
|
}
|
|
|
|
|
2003-05-20 00:39:14 +08:00
|
|
|
#define ngx_conf_merge_size_value(conf, prev, default) \
|
2004-03-16 15:10:12 +08:00
|
|
|
if (conf == NGX_CONF_UNSET_SIZE) { \
|
|
|
|
conf = (prev == NGX_CONF_UNSET_SIZE) ? default : prev; \
|
2003-02-07 01:21:13 +08:00
|
|
|
}
|
|
|
|
|
2003-05-27 20:18:54 +08:00
|
|
|
#define ngx_conf_merge_str_value(conf, prev, default) \
|
|
|
|
if (conf.len == 0) { \
|
|
|
|
if (prev.len) { \
|
|
|
|
conf.len = prev.len; \
|
|
|
|
conf.data = prev.data; \
|
|
|
|
} else { \
|
|
|
|
conf.len = sizeof(default) - 1; \
|
2004-03-17 05:26:01 +08:00
|
|
|
conf.data = (u_char *) default; \
|
2003-05-27 20:18:54 +08:00
|
|
|
} \
|
|
|
|
}
|
|
|
|
|
2003-10-08 23:32:54 +08:00
|
|
|
#define ngx_conf_merge_bufs_value(conf, prev, default_num, default_size) \
|
|
|
|
if (conf.num == 0) { \
|
|
|
|
if (prev.num) { \
|
|
|
|
conf.num = prev.num; \
|
|
|
|
conf.size = prev.size; \
|
|
|
|
} else { \
|
|
|
|
conf.num = default_num; \
|
|
|
|
conf.size = default_size; \
|
|
|
|
} \
|
|
|
|
}
|
|
|
|
|
2003-10-30 16:51:06 +08:00
|
|
|
#define ngx_conf_merge_bitmask_value(conf, prev, default) \
|
|
|
|
if (conf == 0) { \
|
|
|
|
conf = (prev == 0) ? default : prev; \
|
|
|
|
}
|
|
|
|
|
2003-02-07 01:21:13 +08:00
|
|
|
|
2003-03-04 14:33:48 +08:00
|
|
|
#define addressof(addr) ((int) &addr)
|
|
|
|
|
2003-01-09 13:36:00 +08:00
|
|
|
|
|
|
|
char *ngx_conf_parse(ngx_conf_t *cf, ngx_str_t *filename);
|
|
|
|
|
|
|
|
|
2003-07-21 05:15:59 +08:00
|
|
|
ngx_open_file_t *ngx_conf_open_file(ngx_cycle_t *cycle, ngx_str_t *name);
|
2004-02-12 01:08:49 +08:00
|
|
|
void ngx_conf_log_error(ngx_uint_t level, ngx_conf_t *cf, ngx_err_t err,
|
2003-07-18 22:44:05 +08:00
|
|
|
char *fmt, ...);
|
|
|
|
|
|
|
|
|
2003-05-27 20:18:54 +08:00
|
|
|
char *ngx_conf_set_flag_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
|
|
|
char *ngx_conf_set_str_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
|
|
|
char *ngx_conf_set_num_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
|
|
|
char *ngx_conf_set_size_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
|
|
|
char *ngx_conf_set_msec_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
2003-11-04 06:20:44 +08:00
|
|
|
char *ngx_conf_set_sec_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
2003-05-27 20:18:54 +08:00
|
|
|
char *ngx_conf_set_time_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
2003-10-08 23:32:54 +08:00
|
|
|
char *ngx_conf_set_bufs_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
2004-04-14 13:57:36 +08:00
|
|
|
char *ngx_conf_set_enum_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
2003-10-30 16:51:06 +08:00
|
|
|
char *ngx_conf_set_bitmask_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
|
2002-12-27 00:26:23 +08:00
|
|
|
|
2003-07-21 05:15:59 +08:00
|
|
|
|
2004-01-06 04:55:48 +08:00
|
|
|
extern ngx_int_t ngx_max_module;
|
|
|
|
extern ngx_module_t *ngx_modules[];
|
2002-12-19 15:08:55 +08:00
|
|
|
|
2003-07-21 05:15:59 +08:00
|
|
|
|
2003-02-07 01:21:13 +08:00
|
|
|
#endif /* _NGX_HTTP_CONF_FILE_H_INCLUDED_ */
|