nginx/src/core/ngx_conf_file.h

282 lines
9.2 KiB
C
Raw Normal View History

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
#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_ */