http_config.h revision 30c289e6bc6d28d210b21edd800ab2cfc78a8381
d29201dd5328b88140ce050100693c501852657dChristian Maeder/* ====================================================================
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * The Apache Software License, Version 1.1
7165a916d2fa1bf87c4741ec63b253413eebbf69Karl Luc * Copyright (c) 2000 The Apache Software Foundation. All rights
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * Redistribution and use in source and binary forms, with or without
cacbb5e3100fb85d23d1614cace3a8662801f2e6Eugen Kuksa * modification, are permitted provided that the following conditions
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * 1. Redistributions of source code must retain the above copyright
7165a916d2fa1bf87c4741ec63b253413eebbf69Karl Luc * notice, this list of conditions and the following disclaimer.
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * 2. Redistributions in binary form must reproduce the above copyright
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * notice, this list of conditions and the following disclaimer in
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * the documentation and/or other materials provided with the
7165a916d2fa1bf87c4741ec63b253413eebbf69Karl Luc * distribution.
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * 3. The end-user documentation included with the redistribution,
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * if any, must include the following acknowledgment:
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * "This product includes software developed by the
7165a916d2fa1bf87c4741ec63b253413eebbf69Karl Luc * Apache Software Foundation (http://www.apache.org/)."
7165a916d2fa1bf87c4741ec63b253413eebbf69Karl Luc * Alternately, this acknowledgment may appear in the software itself,
59ec6aa4da4c93d0d4ef53ed74fdf866d0654539Eugen Kuksa * if and wherever such third-party acknowledgments normally appear.
de03ed90ff6efbbc4751301bcf6b50d9790c1afbKarl Luc * 4. The names "Apache" and "Apache Software Foundation" must
d75d2d11170f1339ebe37d9d9c06aff148637b13Christian Maeder * not be used to endorse or promote products derived from this
f6eb05386b068f5968180b21cc225ef0d7d836e7Eugen Kuksa * software without prior written permission. For written
66977d201b3ff7ee9c1f992c0f3f701b69eac2c9Karl Luc * permission, please contact apache@apache.org.
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * 5. Products derived from this software may not be called "Apache",
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * nor may "Apache" appear in their name, without prior written
0ac66bed6456d7900a657269e36107ca7bec4756Iulia Ignatov * permission of the Apache Software Foundation.
0ac66bed6456d7900a657269e36107ca7bec4756Iulia Ignatov * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
a35bacbc16daf5c10f9accfdfadc4971e9d6f648Iulia Ignatov * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
3831cf8a3b0ea144a80d13fe0314cc2752e32107Christian Maeder * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
7165a916d2fa1bf87c4741ec63b253413eebbf69Karl Luc * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * SUCH DAMAGE.
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * ====================================================================
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * This software consists of voluntary contributions made by many
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * individuals on behalf of the Apache Software Foundation. For more
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * information on the Apache Software Foundation, please see
1ea7fb6b0f66210bc0d3cb995f1b655277b33884Eugen Kuksa * Portions of this software are based upon public domain software
d6ce032cac688f3698be7133d27f53d3967e6749Christian Maeder * originally written at the National Center for Supercomputing Applications,
7165a916d2fa1bf87c4741ec63b253413eebbf69Karl Luc * University of Illinois, Urbana-Champaign.
7165a916d2fa1bf87c4741ec63b253413eebbf69Karl Lucextern "C" {
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * The central data structures around here...
037be4e5b0e867dd148db2ea89640d8edf009053Eugen Kuksa/* Command dispatch structures... */
51846950b4b1f31342008cf17f667859a5f21949Christian Maeder/* Note that for all of these except RAW_ARGS, the config routine is
3831cf8a3b0ea144a80d13fe0314cc2752e32107Christian Maeder * passed a freshly allocated string which can be modified or stored
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa * or whatever... it's only necessary to do pstrdup() stuff with
c51d1f5ff88cce030fe543e271ca6b85625b70d8Karl Luc * RAW_ARGS.
2c10bceb28a74fc291959697e023f22a66753655Eugen Kuksa RAW_ARGS, /* cmd_func parses command line itself */
de03ed90ff6efbbc4751301bcf6b50d9790c1afbKarl Luc * (e.g., IndexIgnore)
551f1476dea3f969775527cb15fd512e86279307Karl Luc ITERATE2, /* two arguments, 2nd occurs multiple times
5e6915f767bd46767306abbfbb39ebcbc10a2a33Christian Maeder * (e.g., AddIcon)
0ac66bed6456d7900a657269e36107ca7bec4756Iulia Ignatov NO_ARGS, /* No args at all, e.g. </Directory> */
c51d1f5ff88cce030fe543e271ca6b85625b70d8Karl Luctypedef struct command_struct {
de03ed90ff6efbbc4751301bcf6b50d9790c1afbKarl Luc * implement multiple commands...
de03ed90ff6efbbc4751301bcf6b50d9790c1afbKarl Luc int req_override; /* What overrides need to be allowed to
de03ed90ff6efbbc4751301bcf6b50d9790c1afbKarl Luc * enable this command.
9e5811a3323b00d6ff8d3fe91a185de1ab31150bChristian Maeder enum cmd_how args_how; /* What the command expects as arguments */
9e5811a3323b00d6ff8d3fe91a185de1ab31150bChristian Maeder const char *errmsg; /* 'usage' message, in case of syntax errors */
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc/* The allowed locations for a configuration directive are the union of
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * those indicated by each set bit in the req_override mask.
c96c73387a0c41614ba325f737edad6abbf07e79Eugen Kuksa * (req_override & RSRC_CONF) => *.conf outside <Directory> or <Location>
c96c73387a0c41614ba325f737edad6abbf07e79Eugen Kuksa * (req_override & ACCESS_CONF) => *.conf inside <Directory> or <Location>
9e5811a3323b00d6ff8d3fe91a185de1ab31150bChristian Maeder * (req_override & OR_AUTHCFG) => *.conf inside <Directory> or <Location>
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * and .htaccess when AllowOverride AuthConfig
9e5811a3323b00d6ff8d3fe91a185de1ab31150bChristian Maeder * (req_override & OR_LIMIT) => *.conf inside <Directory> or <Location>
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * and .htaccess when AllowOverride Limit
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * (req_override & OR_OPTIONS) => *.conf anywhere
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * and .htaccess when AllowOverride Options
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * (req_override & OR_FILEINFO) => *.conf anywhere
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * and .htaccess when AllowOverride FileInfo
75067b1beba1380cde707c30e7fc050d86f6927fKarl Luc * (req_override & OR_INDEXES) => *.conf anywhere
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa * and .htaccess when AllowOverride Indexes
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa#define OR_ALL (OR_LIMIT|OR_OPTIONS|OR_FILEINFO|OR_AUTHCFG|OR_INDEXES)
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa/* This can be returned by a function if they don't wish to handle
1ea7fb6b0f66210bc0d3cb995f1b655277b33884Eugen Kuksa * a command. Make it something not likely someone will actually use
1ea7fb6b0f66210bc0d3cb995f1b655277b33884Eugen Kuksa * as an error code.
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa/* Common structure for reading of config files / passwd files etc. */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksatypedef struct {
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa int (*getch) (void *param); /* a getc()-like function */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa void *(*getstr) (void *buf, size_t bufsiz, void *param); /* a fgets()-like function */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa int (*close) (void *param); /* a close hander function */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa void *param; /* the argument passed to getch/getstr/close */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa const char *name; /* the filename / description */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa unsigned line_number; /* current line number, starting at 1 */
037be4e5b0e867dd148db2ea89640d8edf009053Eugen Kuksa * This structure is passed to a command which is being invoked,
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa * to carry a large variety of miscellaneous data which is all of
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa * use to *somebody*...
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksatypedef struct {
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa void *info; /* Argument to command from cmd_table */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa int override; /* Which allow-override bits are set */
037be4e5b0e867dd148db2ea89640d8edf009053Eugen Kuksa configfile_t *config_file; /* Config file structure. */
037be4e5b0e867dd148db2ea89640d8edf009053Eugen Kuksa ap_directive_t *directive; /* the directive specifying this command */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa ap_pool_t *pool; /* Pool to allocate new storage in */
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa ap_pool_t *temp_pool; /* Pool for scratch memory; persists during
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa * configuration, but wiped before the first
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa * request is served...
99a1bfbb82c875580410b4745617fea2297fdc2bEugen Kuksa server_rec *server; /* Server_rec being configured for */
5e6915f767bd46767306abbfbb39ebcbc10a2a33Christian Maeder * pathname of that directory.
} cmd_parms;
} handler_rec;
typedef struct module_struct {
const char *name;
void *dynamic_load_handle;
void (*register_hooks) (void);
} module;
__FILE__, \
NULL, \
NULL, \
__FILE__, \
NULL, \
NULL, \
#define ap_get_module_config(v,m) \
(((void **)(v))[(m)->module_index])
void *param,
int(*getc_func)(void*),
char *orig_directive);
#define NOT_IN_DIR_LOC_FILE (NOT_IN_DIRECTORY|NOT_IN_LOCATION|NOT_IN_FILES) /* <Directory>/<Location>/<Files>*/
#ifdef CORE_PRIVATE
/* For mod_so.c... */
/* For http_main.c... */
void ap_show_directives(void);
void ap_show_modules(void);
/* For http_request.c... */
/* For http_connection.c... */
/* For http_core.c... (<Directory> command and virtual hosts) */
/* Module-method dispatchers, also for http_request.c */
#ifdef __cplusplus