1 /* Licensed to the Apache Software Foundation (ASF) under one or more
2 * contributor license agreements. See the NOTICE file distributed with
3 * this work for additional information regarding copyright ownership.
4 * The ASF licenses this file to You under the Apache License, Version 2.0
5 * (the "License"); you may not use this file except in compliance with
6 * the License. You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 * @brief CORE HTTP Daemon
21 * @defgroup APACHE_CORE_HTTPD Core HTTP Daemon
22 * @ingroup APACHE_CORE
26 #ifndef APACHE_HTTP_CORE_H
27 #define APACHE_HTTP_CORE_H
31 #include "apr_optional.h"
32 #include "util_filter.h"
34 #include "apr_tables.h"
36 #include "http_config.h"
38 #if APR_HAVE_STRUCT_RLIMIT
40 #include <sys/resource.h>
48 /* ****************************************************************
50 * The most basic server code is encapsulated in a single module
51 * known as the core, which is just *barely* functional enough to
52 * serve documents, though not terribly well.
54 * Largely for NCSA back-compatibility reasons, the core needs to
55 * make pieces of its config structures available to other modules.
56 * The accessors are declared here, along with the interpretation
57 * of one of them (allow_options).
61 * @defgroup APACHE_CORE_HTTPD_ACESSORS Acessors
63 * @brief File/Directory Accessor directives
70 /** Indexes directive */
72 /** SSI is enabled without exec= permission */
73 #define OPT_INCLUDES 2
74 /** FollowSymLinks directive */
75 #define OPT_SYM_LINKS 4
76 /** ExecCGI directive */
78 /** directive unset */
80 /** SSI exec= permission is permitted, iff OPT_INCLUDES is also set */
81 #define OPT_INC_WITH_EXEC 32
82 /** SymLinksIfOwnerMatch directive */
83 #define OPT_SYM_OWNER 64
84 /** MultiViews directive */
87 #define OPT_ALL (OPT_INDEXES|OPT_INCLUDES|OPT_INC_WITH_EXEC|OPT_SYM_LINKS|OPT_EXECCGI)
91 * @defgroup get_remote_host Remote Host Resolution
92 * @ingroup APACHE_CORE_HTTPD
95 /** REMOTE_HOST returns the hostname, or NULL if the hostname
96 * lookup fails. It will force a DNS lookup according to the
97 * HostnameLookups setting.
99 #define REMOTE_HOST (0)
101 /** REMOTE_NAME returns the hostname, or the dotted quad if the
102 * hostname lookup fails. It will force a DNS lookup according
103 * to the HostnameLookups setting.
105 #define REMOTE_NAME (1)
107 /** REMOTE_NOLOOKUP is like REMOTE_NAME except that a DNS lookup is
110 #define REMOTE_NOLOOKUP (2)
112 /** REMOTE_DOUBLE_REV will always force a DNS lookup, and also force
113 * a double reverse lookup, regardless of the HostnameLookups
114 * setting. The result is the (double reverse checked) hostname,
115 * or NULL if any of the lookups fail.
117 #define REMOTE_DOUBLE_REV (3)
119 /** @} // get_remote_host */
121 /** all of the requirements must be met */
122 #define SATISFY_ALL 0
123 /** any of the requirements must be met */
124 #define SATISFY_ANY 1
125 /** There are no applicable satisfy lines */
126 #define SATISFY_NOSPEC 2
128 /** Make sure we don't write less than 8000 bytes at any one time.
130 #define AP_MIN_BYTES_TO_WRITE 8000
132 /** default maximum of internal redirects */
133 # define AP_DEFAULT_MAX_INTERNAL_REDIRECTS 10
135 /** default maximum subrequest nesting level */
136 # define AP_DEFAULT_MAX_SUBREQ_DEPTH 10
139 * Retrieve the value of Options for this request
140 * @param r The current request
141 * @return the Options bitmask
143 AP_DECLARE(int) ap_allow_options(request_rec *r);
146 * Retrieve the value of the AllowOverride for this request
147 * @param r The current request
148 * @return the overrides bitmask
150 AP_DECLARE(int) ap_allow_overrides(request_rec *r);
153 * Retrieve the document root for this server
154 * @param r The current request
155 * @warning Don't use this! If your request went through a Userdir, or
156 * something like that, it'll screw you. But it's back-compatible...
157 * @return The document root
159 AP_DECLARE(const char *) ap_document_root(request_rec *r);
162 * Lookup the remote user agent's DNS name or IP address
163 * @ingroup get_remote_host
164 * @param req The current request
165 * @param type The type of lookup to perform. One of:
167 * REMOTE_HOST returns the hostname, or NULL if the hostname
168 * lookup fails. It will force a DNS lookup according to the
169 * HostnameLookups setting.
170 * REMOTE_NAME returns the hostname, or the dotted quad if the
171 * hostname lookup fails. It will force a DNS lookup according
172 * to the HostnameLookups setting.
173 * REMOTE_NOLOOKUP is like REMOTE_NAME except that a DNS lookup is
175 * REMOTE_DOUBLE_REV will always force a DNS lookup, and also force
176 * a double reverse lookup, regardless of the HostnameLookups
177 * setting. The result is the (double reverse checked)
178 * hostname, or NULL if any of the lookups fail.
180 * @param str_is_ip unless NULL is passed, this will be set to non-zero on
181 * output when an IP address string is returned
182 * @return The remote hostname (based on the request useragent_ip)
184 AP_DECLARE(const char *) ap_get_useragent_host(request_rec *req, int type,
188 * Lookup the remote client's DNS name or IP address
189 * @ingroup get_remote_host
190 * @param conn The current connection
191 * @param dir_config The directory config vector from the request
192 * @param type The type of lookup to perform. One of:
194 * REMOTE_HOST returns the hostname, or NULL if the hostname
195 * lookup fails. It will force a DNS lookup according to the
196 * HostnameLookups setting.
197 * REMOTE_NAME returns the hostname, or the dotted quad if the
198 * hostname lookup fails. It will force a DNS lookup according
199 * to the HostnameLookups setting.
200 * REMOTE_NOLOOKUP is like REMOTE_NAME except that a DNS lookup is
202 * REMOTE_DOUBLE_REV will always force a DNS lookup, and also force
203 * a double reverse lookup, regardless of the HostnameLookups
204 * setting. The result is the (double reverse checked)
205 * hostname, or NULL if any of the lookups fail.
207 * @param str_is_ip unless NULL is passed, this will be set to non-zero on output when an IP address
209 * @return The remote hostname (based on the connection client_ip)
211 AP_DECLARE(const char *) ap_get_remote_host(conn_rec *conn, void *dir_config, int type, int *str_is_ip);
214 * Retrieve the login name of the remote user. Undef if it could not be
216 * @param r The current request
217 * @return The user logged in to the client machine
219 AP_DECLARE(const char *) ap_get_remote_logname(request_rec *r);
221 /* Used for constructing self-referencing URLs, and things like SERVER_PORT,
225 * build a fully qualified URL from the uri and information in the request rec
226 * @param p The pool to allocate the URL from
227 * @param uri The path to the requested file
228 * @param r The current request
229 * @return A fully qualified URL
231 AP_DECLARE(char *) ap_construct_url(apr_pool_t *p, const char *uri, request_rec *r);
234 * Get the current server name from the request
235 * @param r The current request
236 * @return the server name
238 AP_DECLARE(const char *) ap_get_server_name(request_rec *r);
241 * Get the current server name from the request for the purposes
242 * of using in a URL. If the server name is an IPv6 literal
243 * address, it will be returned in URL format (e.g., "[fe80::1]").
244 * @param r The current request
245 * @return the server name
247 AP_DECLARE(const char *) ap_get_server_name_for_url(request_rec *r);
250 * Get the current server port
251 * @param r The current request
252 * @return The server's port
254 AP_DECLARE(apr_port_t) ap_get_server_port(const request_rec *r);
257 * Return the limit on bytes in request msg body
258 * @param r The current request
259 * @return the maximum number of bytes in the request msg body
261 AP_DECLARE(apr_off_t) ap_get_limit_req_body(const request_rec *r);
264 * Return the limit on bytes in XML request msg body
265 * @param r The current request
266 * @return the maximum number of bytes in XML request msg body
268 AP_DECLARE(apr_size_t) ap_get_limit_xml_body(const request_rec *r);
271 * Install a custom response handler for a given status
272 * @param r The current request
273 * @param status The status for which the custom response should be used
274 * @param string The custom response. This can be a static string, a file
277 AP_DECLARE(void) ap_custom_response(request_rec *r, int status, const char *string);
280 * Check if the current request is beyond the configured max. number of redirects or subrequests
281 * @param r The current request
282 * @return true (is exceeded) or false
284 AP_DECLARE(int) ap_is_recursion_limit_exceeded(const request_rec *r);
287 * Check for a definition from the server command line
288 * @param name The define to check for
289 * @return 1 if defined, 0 otherwise
291 AP_DECLARE(int) ap_exists_config_define(const char *name);
292 /* FIXME! See STATUS about how */
293 AP_DECLARE_NONSTD(int) ap_core_translate(request_rec *r);
295 /* Authentication stuff. This is one of the places where compatibility
296 * with the old config files *really* hurts; they don't discriminate at
297 * all between different authentication schemes, meaning that we need
298 * to maintain common state for all of them in the core, and make it
299 * available to the other modules through interfaces.
302 /** @see require_line */
303 typedef struct require_line require_line;
306 * @brief A structure to keep track of authorization requirements
308 struct require_line {
309 /** Where the require line is in the config file. */
310 apr_int64_t method_mask;
311 /** The complete string from the command line */
316 * Return the type of authorization required for this request
317 * @param r The current request
318 * @return The authorization required
320 AP_DECLARE(const char *) ap_auth_type(request_rec *r);
323 * Return the current Authorization realm
324 * @param r The current request
325 * @return The current authorization realm
327 AP_DECLARE(const char *) ap_auth_name(request_rec *r);
330 * How the requires lines must be met.
331 * @param r The current request
332 * @return How the requirements must be met. One of:
334 * SATISFY_ANY -- any of the requirements must be met.
335 * SATISFY_ALL -- all of the requirements must be met.
336 * SATISFY_NOSPEC -- There are no applicable satisfy lines
339 AP_DECLARE(int) ap_satisfies(request_rec *r);
342 * Core is also unlike other modules in being implemented in more than
343 * one file... so, data structures are declared here, even though most of
344 * the code that cares really is in http_core.c. Also, another accessor.
346 AP_DECLARE_DATA extern module core_module;
349 * Accessor for core_module's specific data. Equivalent to
350 * ap_get_module_config(cv, &core_module) but more efficient.
351 * @param cv The vector in which the modules configuration is stored.
352 * usually r->per_dir_config or s->module_config
353 * @return The module-specific data
355 AP_DECLARE(void *) ap_get_core_module_config(const ap_conf_vector_t *cv);
358 * Accessor to set core_module's specific data. Equivalent to
359 * ap_set_module_config(cv, &core_module, val) but more efficient.
360 * @param cv The vector in which the modules configuration is stored.
361 * usually r->per_dir_config or s->module_config
362 * @param val The module-specific data to set
364 AP_DECLARE(void) ap_set_core_module_config(ap_conf_vector_t *cv, void *val);
366 /** Get the socket from the core network filter. This should be used instead of
367 * accessing the core connection config directly.
368 * @param c The connection record
371 AP_DECLARE(apr_socket_t *) ap_get_conn_socket(conn_rec *c);
374 #define AP_CORE_MODULE_INDEX 0
375 #define ap_get_core_module_config(v) \
376 (((void **)(v))[AP_CORE_MODULE_INDEX])
377 #define ap_set_core_module_config(v, val) \
378 ((((void **)(v))[AP_CORE_MODULE_INDEX]) = (val))
380 #define AP_CORE_MODULE_INDEX (AP_DEBUG_ASSERT(core_module.module_index == 0), 0)
384 * @brief Per-request configuration
387 /** bucket brigade used by getline for look-ahead and
388 * ap_get_client_block for holding left-over request body */
389 struct apr_bucket_brigade *bb;
391 /** an array of per-request working data elements, accessed
392 * by ID using ap_get_request_note()
393 * (Use ap_register_request_note() during initialization
398 /** Custom response strings registered via ap_custom_response(),
399 * or NULL; check per-dir config if nothing found here
401 char **response_code_strings; /* from ap_custom_response(), not from
405 /** per-request document root of the server. This allows mass vhosting
406 * modules better compatibility with some scripts. Normally the
407 * context_* info should be used instead */
408 const char *document_root;
411 * more fine-grained context information which is set by modules like
412 * mod_alias and mod_userdir
414 /** the context root directory on disk for the current resource,
415 * without trailing slash
417 const char *context_document_root;
418 /** the URI prefix that corresponds to the context_document_root directory,
419 * without trailing slash
421 const char *context_prefix;
423 /** There is a script processor installed on the output filter chain,
424 * so it needs the default_handler to deliver a (script) file into
425 * the chain so it can process it. Normally, default_handler only
426 * serves files on a GET request (assuming the file is actual content),
427 * since other methods are not content-retrieval. This flag overrides
428 * that behavior, stating that the "content" is actually a script and
429 * won't actually be delivered as the response for the non-GET method.
433 /** Should addition of charset= be suppressed for this request?
435 int suppress_charset;
436 } core_request_config;
438 /* Standard entries that are guaranteed to be accessible via
439 * ap_get_request_note() for each request (additional entries
440 * can be added with ap_register_request_note())
442 #define AP_NOTE_DIRECTORY_WALK 0
443 #define AP_NOTE_LOCATION_WALK 1
444 #define AP_NOTE_FILE_WALK 2
445 #define AP_NOTE_IF_WALK 3
446 #define AP_NUM_STD_NOTES 4
449 * Reserve an element in the core_request_config->notes array
450 * for some application-specific data
451 * @return An integer key that can be passed to ap_get_request_note()
452 * during request processing to access this element for the
455 AP_DECLARE(apr_size_t) ap_register_request_note(void);
458 * Retrieve a pointer to an element in the core_request_config->notes array
459 * @param r The request
460 * @param note_num A key for the element: either a value obtained from
461 * ap_register_request_note() or one of the predefined AP_NOTE_*
463 * @return NULL if the note_num is invalid, otherwise a pointer to the
464 * requested note element.
465 * @remark At the start of a request, each note element is NULL. The
466 * handle provided by ap_get_request_note() is a pointer-to-pointer
467 * so that the caller can point the element to some app-specific
468 * data structure. The caller should guarantee that any such
469 * structure will last as long as the request itself.
471 AP_DECLARE(void **) ap_get_request_note(request_rec *r, apr_size_t note_num);
474 typedef unsigned char allow_options_t;
475 typedef unsigned int overrides_t;
478 * Bits of info that go into making an ETag for a file
479 * document. Why a long? Because char historically
480 * proved too short for Options, and int can be different
481 * sizes on different platforms.
483 typedef unsigned long etag_components_t;
486 #define ETAG_NONE (1 << 0)
487 #define ETAG_MTIME (1 << 1)
488 #define ETAG_INODE (1 << 2)
489 #define ETAG_SIZE (1 << 3)
490 #define ETAG_ALL (ETAG_MTIME | ETAG_INODE | ETAG_SIZE)
491 /* This is the default value used */
492 #define ETAG_BACKWARD (ETAG_MTIME | ETAG_SIZE)
494 /* Generic ON/OFF/UNSET for unsigned int foo :2 */
495 #define AP_CORE_CONFIG_OFF (0)
496 #define AP_CORE_CONFIG_ON (1)
497 #define AP_CORE_CONFIG_UNSET (2)
499 /* Generic merge of flag */
500 #define AP_CORE_MERGE_FLAG(field, to, base, over) to->field = \
501 over->field != AP_CORE_CONFIG_UNSET \
506 * @brief Server Signature Enumeration
513 } server_signature_e;
516 * @brief Per-directory configuration
519 /** path of the directory/regex/etc. see also d_is_fnmatch/absolute below */
521 /** the number of slashes in d */
522 unsigned d_components;
524 /** If (opts & OPT_UNSET) then no absolute assignment to options has
526 * invariant: (opts_add & opts_remove) == 0
527 * Which said another way means that the last relative (options + or -)
528 * assignment made to each bit is recorded in exactly one of opts_add
531 allow_options_t opts;
532 allow_options_t opts_add;
533 allow_options_t opts_remove;
534 overrides_t override;
535 allow_options_t override_opts;
537 /* Used to be the custom response config. No longer used. */
538 char **response_code_strings; /* from ErrorDocument, not from
539 * ap_custom_response() */
541 /* Hostname resolution etc */
542 #define HOSTNAME_LOOKUP_OFF 0
543 #define HOSTNAME_LOOKUP_ON 1
544 #define HOSTNAME_LOOKUP_DOUBLE 2
545 #define HOSTNAME_LOOKUP_UNSET 3
546 unsigned int hostname_lookups : 4;
548 unsigned int content_md5 : 2; /* calculate Content-MD5? */
550 #define USE_CANONICAL_NAME_OFF (0)
551 #define USE_CANONICAL_NAME_ON (1)
552 #define USE_CANONICAL_NAME_DNS (2)
553 #define USE_CANONICAL_NAME_UNSET (3)
554 unsigned use_canonical_name : 2;
556 /* since is_fnmatch(conf->d) was being called so frequently in
557 * directory_walk() and its relatives, this field was created and
558 * is set to the result of that call.
560 unsigned d_is_fnmatch : 1;
562 /* should we force a charset on any outgoing parameterless content-type?
563 * if so, which charset?
565 #define ADD_DEFAULT_CHARSET_OFF (0)
566 #define ADD_DEFAULT_CHARSET_ON (1)
567 #define ADD_DEFAULT_CHARSET_UNSET (2)
568 unsigned add_default_charset : 2;
569 const char *add_default_charset_name;
571 /* System Resource Control */
573 struct rlimit *limit_cpu;
575 #if defined (RLIMIT_DATA) || defined (RLIMIT_VMEM) || defined(RLIMIT_AS)
576 struct rlimit *limit_mem;
579 struct rlimit *limit_nproc;
581 apr_off_t limit_req_body; /* limit on bytes in request msg body */
582 long limit_xml_body; /* limit on bytes in XML request msg body */
584 /* logging options */
586 server_signature_e server_signature;
589 apr_array_header_t *sec_file;
590 apr_array_header_t *sec_if;
593 const char *mime_type; /* forced with ForceType */
594 const char *handler; /* forced by something other than SetHandler */
595 const char *output_filters; /* forced with SetOutputFilters */
596 const char *input_filters; /* forced with SetInputFilters */
597 int accept_path_info; /* forced with AcceptPathInfo */
600 * What attributes/data should be included in ETag generation?
602 etag_components_t etag_bits;
603 etag_components_t etag_add;
604 etag_components_t etag_remove;
607 * Run-time performance tuning
609 #define ENABLE_MMAP_OFF (0)
610 #define ENABLE_MMAP_ON (1)
611 #define ENABLE_MMAP_UNSET (2)
612 unsigned int enable_mmap : 2; /* whether files in this dir can be mmap'ed */
614 #define ENABLE_SENDFILE_OFF (0)
615 #define ENABLE_SENDFILE_ON (1)
616 #define ENABLE_SENDFILE_UNSET (2)
617 unsigned int enable_sendfile : 2; /* files in this dir can be sendfile'ed */
619 #define USE_CANONICAL_PHYS_PORT_OFF (0)
620 #define USE_CANONICAL_PHYS_PORT_ON (1)
621 #define USE_CANONICAL_PHYS_PORT_UNSET (2)
622 unsigned int use_canonical_phys_port : 2;
624 unsigned int allow_encoded_slashes : 1; /* URLs may contain %2f w/o being
625 * pitched indiscriminately */
626 unsigned int decode_encoded_slashes : 1; /* whether to decode encoded slashes in URLs */
628 #define AP_CONDITION_IF 1
629 #define AP_CONDITION_ELSE 2
630 #define AP_CONDITION_ELSEIF (AP_CONDITION_ELSE|AP_CONDITION_IF)
631 unsigned int condition_ifelse : 2; /* is this an <If>, <ElseIf>, or <Else> */
633 ap_expr_info_t *condition; /* Conditionally merge <If> sections */
635 /** per-dir log config */
636 struct ap_logconf *log;
638 /** Table of directives allowed per AllowOverrideList */
639 apr_table_t *override_list;
641 #define AP_MAXRANGES_UNSET -1
642 #define AP_MAXRANGES_DEFAULT -2
643 #define AP_MAXRANGES_UNLIMITED -3
644 #define AP_MAXRANGES_NORANGES 0
645 /** Number of Ranges before returning HTTP_OK. **/
647 /** Max number of Range overlaps (merges) allowed **/
649 /** Max number of Range reversals (eg: 200-300, 100-125) allowed **/
652 unsigned int allow_encoded_slashes_set : 1;
653 unsigned int decode_encoded_slashes_set : 1;
655 /** Named back references */
656 apr_array_header_t *refs;
658 #define AP_CGI_PASS_AUTH_OFF (0)
659 #define AP_CGI_PASS_AUTH_ON (1)
660 #define AP_CGI_PASS_AUTH_UNSET (2)
661 /** CGIPassAuth: Whether HTTP authorization headers will be passed to
662 * scripts as CGI variables; affects all modules calling
663 * ap_add_common_vars(), as well as any others using this field as
666 unsigned int cgi_pass_auth : 2;
668 /** Custom response config with expression support. The hash table
669 * contains compiled expressions keyed against the custom response
672 apr_hash_t *response_code_exprs;
674 unsigned int qualify_redirect_url :2;
675 ap_expr_info_t *expr_handler; /* forced with SetHandler */
677 /** Table of rules for building CGI variables, NULL if none configured */
678 apr_hash_t *cgi_var_rules;
681 /* macro to implement off by default behaviour */
682 #define AP_SENDFILE_ENABLED(x) \
683 ((x) == ENABLE_SENDFILE_ON ? APR_SENDFILE_ENABLED : 0)
685 /* Per-server core configuration */
691 /* Name translations --- we want the core to be able to do *something*
692 * so it's at least a minimally functional web server on its own (and
693 * can be tested that way). But let's keep it to the bare minimum:
695 const char *ap_document_root;
700 apr_array_header_t *sec_dir;
701 apr_array_header_t *sec_url;
703 /* recursion backstopper */
704 int redirect_limit; /* maximum number of internal redirects */
705 int subreq_limit; /* maximum nesting level of subrequests */
707 const char *protocol;
708 apr_table_t *accf_map;
710 /* array of ap_errorlog_format_item for error log format string */
711 apr_array_header_t *error_log_format;
713 * two arrays of arrays of ap_errorlog_format_item for additional information
714 * logged to the error log once per connection/request
716 apr_array_header_t *error_log_conn;
717 apr_array_header_t *error_log_req;
720 #define AP_TRACE_UNSET -1
721 #define AP_TRACE_DISABLE 0
722 #define AP_TRACE_ENABLE 1
723 #define AP_TRACE_EXTENDED 2
725 #define AP_MERGE_TRAILERS_UNSET 0
726 #define AP_MERGE_TRAILERS_ENABLE 1
727 #define AP_MERGE_TRAILERS_DISABLE 2
730 apr_array_header_t *conn_log_level;
732 #define AP_HTTP09_UNSET 0
733 #define AP_HTTP09_ENABLE 1
734 #define AP_HTTP09_DISABLE 2
737 #define AP_HTTP_CONFORMANCE_UNSET 0
738 #define AP_HTTP_CONFORMANCE_UNSAFE 1
739 #define AP_HTTP_CONFORMANCE_STRICT 2
740 char http_conformance;
742 #define AP_HTTP_WHITESPACE_UNSET 0
743 #define AP_HTTP_WHITESPACE_LENIENT 1
744 #define AP_HTTP_WHITESPACE_STRICT 2
745 char http_whitespace;
747 #define AP_HTTP_METHODS_UNSET 0
748 #define AP_HTTP_METHODS_LENIENT 1
749 #define AP_HTTP_METHODS_REGISTERED 2
752 #define AP_HTTP_URI_UNSET 0
753 #define AP_HTTP_URI_UNSAFE 1
754 #define AP_HTTP_URI_STRICT 2
757 #define AP_HTTP_CL_HEAD_ZERO_UNSET 0
758 #define AP_HTTP_CL_HEAD_ZERO_ENABLE 1
759 #define AP_HTTP_CL_HEAD_ZERO_DISABLE 2
760 int http_cl_head_zero;
762 #define AP_HTTP_EXPECT_STRICT_UNSET 0
763 #define AP_HTTP_EXPECT_STRICT_ENABLE 1
764 #define AP_HTTP_EXPECT_STRICT_DISABLE 2
765 int http_expect_strict;
768 apr_array_header_t *protocols;
769 int protocols_honor_order;
771 unsigned int async_filter_set:1;
772 } core_server_config;
774 /* for AddOutputFiltersByType in core.c */
775 void ap_add_output_filters_by_type(request_rec *r);
777 /* for http_config.c */
778 void ap_core_reorder_directories(apr_pool_t *, server_rec *);
781 AP_CORE_DECLARE(void) ap_add_per_dir_conf(server_rec *s, void *dir_config);
782 AP_CORE_DECLARE(void) ap_add_per_url_conf(server_rec *s, void *url_config);
783 AP_CORE_DECLARE(void) ap_add_file_conf(apr_pool_t *p, core_dir_config *conf, void *url_config);
784 AP_CORE_DECLARE(const char *) ap_add_if_conf(apr_pool_t *p, core_dir_config *conf, void *url_config);
785 AP_CORE_DECLARE_NONSTD(const char *) ap_limit_section(cmd_parms *cmd, void *dummy, const char *arg);
787 /* Core filters; not exported. */
788 apr_status_t ap_core_input_filter(ap_filter_t *f, apr_bucket_brigade *b,
789 ap_input_mode_t mode, apr_read_type_e block,
790 apr_off_t readbytes);
791 apr_status_t ap_core_output_filter(ap_filter_t *f, apr_bucket_brigade *b);
794 AP_DECLARE(const char*) ap_get_server_protocol(server_rec* s);
795 AP_DECLARE(void) ap_set_server_protocol(server_rec* s, const char* proto);
797 typedef struct core_output_filter_ctx core_output_filter_ctx_t;
798 typedef struct core_filter_ctx core_ctx_t;
800 typedef struct core_net_rec {
801 /** Connection to the client */
802 apr_socket_t *client_socket;
804 /** connection record */
807 core_output_filter_ctx_t *out_ctx;
812 * Insert the network bucket into the core input filter's input brigade.
813 * This hook is intended for MPMs or protocol modules that need to do special
815 * @param c The connection
816 * @param bb The brigade to insert the bucket into
817 * @param socket The socket to put into a bucket
818 * @return AP_DECLINED if the current function does not handle this connection,
819 * APR_SUCCESS or an error otherwise.
821 AP_DECLARE_HOOK(apr_status_t, insert_network_bucket,
822 (conn_rec *c, apr_bucket_brigade *bb, apr_socket_t *socket))
824 /* ----------------------------------------------------------------------
826 * Runtime status/management
842 const char *description;
844 ap_mgmt_type_e vtype;
848 /* Handles for core filters */
849 AP_DECLARE_DATA extern ap_filter_rec_t *ap_subreq_core_filter_handle;
850 AP_DECLARE_DATA extern ap_filter_rec_t *ap_core_output_filter_handle;
851 AP_DECLARE_DATA extern ap_filter_rec_t *ap_content_length_filter_handle;
852 AP_DECLARE_DATA extern ap_filter_rec_t *ap_core_input_filter_handle;
853 AP_DECLARE_DATA extern ap_filter_rec_t *ap_request_core_filter_handle;
856 * This hook provdes a way for modules to provide metrics/statistics about
857 * their operational status.
859 * @param p A pool to use to create entries in the hash table
860 * @param val The name of the parameter(s) that is wanted. This is
861 * tree-structured would be in the form ('*' is all the tree,
862 * 'module.*' all of the module , 'module.foo.*', or
864 * @param ht The hash table to store the results. Keys are item names, and
865 * the values point to ap_mgmt_item_t structures.
868 AP_DECLARE_HOOK(int, get_mgmt_items,
869 (apr_pool_t *p, const char * val, apr_hash_t *ht))
871 /* ---------------------------------------------------------------------- */
873 /* ----------------------------------------------------------------------
875 * I/O logging with mod_logio
878 APR_DECLARE_OPTIONAL_FN(void, ap_logio_add_bytes_out,
879 (conn_rec *c, apr_off_t bytes));
881 APR_DECLARE_OPTIONAL_FN(void, ap_logio_add_bytes_in,
882 (conn_rec *c, apr_off_t bytes));
884 APR_DECLARE_OPTIONAL_FN(apr_off_t, ap_logio_get_last_bytes, (conn_rec *c));
886 /* ----------------------------------------------------------------------
892 * The info structure passed to callback functions of errorlog handlers.
893 * Not all information is available in all contexts. In particular, all
894 * pointers may be NULL.
896 typedef struct ap_errorlog_info {
897 /** current server_rec.
898 * Should be preferred over c->base_server and r->server
902 /** current conn_rec.
903 * Should be preferred over r->connection
907 /** current request_rec. */
908 const request_rec *r;
909 /** r->main if r is a subrequest, otherwise equal to r */
910 const request_rec *rmain;
912 /** pool passed to ap_log_perror, NULL otherwise */
915 /** name of source file where the log message was produced, NULL if N/A. */
917 /** line number in the source file, 0 if N/A */
920 /** module index of module that produced the log message, APLOG_NO_MODULE if N/A. */
922 /** log level of error message (flags like APLOG_STARTUP have been removed), -1 if N/A */
925 /** apr error status related to the log message, 0 if no error */
928 /** 1 if logging using provider, 0 otherwise */
930 /** 1 if APLOG_STARTUP was set for the log message, 0 otherwise */
933 /** message format */
937 #define AP_ERRORLOG_PROVIDER_GROUP "error_log_writer"
938 #define AP_ERRORLOG_PROVIDER_VERSION "0"
939 #define AP_ERRORLOG_DEFAULT_PROVIDER "file"
941 /** add APR_EOL_STR to the end of log message */
942 #define AP_ERRORLOG_PROVIDER_ADD_EOL_STR 1
944 typedef struct ap_errorlog_provider ap_errorlog_provider;
946 struct ap_errorlog_provider {
947 /** Initializes the error log writer.
948 * @param p The pool to create any storage from
949 * @param s Server for which the logger is initialized
950 * @return Pointer to handle passed later to writer() function
951 * @note On success, the provider must return non-NULL, even if
952 * the handle is not necessary when the writer() function is
953 * called. On failure, the provider should log a startup error
954 * message and return NULL to abort httpd startup.
956 void * (*init)(apr_pool_t *p, server_rec *s);
958 /** Logs the error message to external error log.
959 * @param info Context of the error message
960 * @param handle Handle created by init() function
961 * @param errstr Error message
962 * @param len Length of the error message
964 apr_status_t (*writer)(const ap_errorlog_info *info, void *handle,
965 const char *errstr, apr_size_t len);
967 /** Checks syntax of ErrorLog directive argument.
968 * @param cmd The config directive
969 * @param arg ErrorLog directive argument (or the empty string if
970 * no argument was provided)
971 * @return Error message or NULL on success
972 * @remark The argument will be stored in the error_fname field
973 * of server_rec for access later.
975 const char * (*parse_errorlog_arg)(cmd_parms *cmd, const char *arg);
977 /** a combination of the AP_ERRORLOG_PROVIDER_* flags */
982 * callback function prototype for a external errorlog handler
983 * @note To avoid unbounded memory usage, these functions must not allocate
984 * memory from the server, connection, or request pools. If an errorlog
985 * handler absolutely needs a pool to pass to other functions, it must create
986 * and destroy a sub-pool.
988 typedef int ap_errorlog_handler_fn_t(const ap_errorlog_info *info,
989 const char *arg, char *buf, int buflen);
992 * Register external errorlog handler
993 * @param p config pool to use
994 * @param tag the new format specifier (i.e. the letter after the %)
995 * @param handler the handler function
996 * @param flags flags (reserved, set to 0)
998 AP_DECLARE(void) ap_register_errorlog_handler(apr_pool_t *p, char *tag,
999 ap_errorlog_handler_fn_t *handler,
1002 typedef struct ap_errorlog_handler {
1003 ap_errorlog_handler_fn_t *func;
1004 int flags; /* for future extensions */
1005 } ap_errorlog_handler;
1007 /** item starts a new field */
1008 #define AP_ERRORLOG_FLAG_FIELD_SEP 1
1009 /** item is the actual error message */
1010 #define AP_ERRORLOG_FLAG_MESSAGE 2
1011 /** skip whole line if item is zero-length */
1012 #define AP_ERRORLOG_FLAG_REQUIRED 4
1013 /** log zero-length item as '-' */
1014 #define AP_ERRORLOG_FLAG_NULL_AS_HYPHEN 8
1017 /** ap_errorlog_handler function */
1018 ap_errorlog_handler_fn_t *func;
1019 /** argument passed to item in {} */
1021 /** a combination of the AP_ERRORLOG_* flags */
1023 /** only log item if the message's log level is higher than this */
1024 unsigned int min_loglevel;
1025 } ap_errorlog_format_item;
1028 * hook method to log error messages
1030 * @param info pointer to ap_errorlog_info struct which contains all
1032 * @param errstr the (unformatted) message to log
1033 * @warning Allocating from the usual pools (pool, info->c->pool, info->p->pool)
1034 * must be avoided because it can cause memory leaks.
1035 * Use a subpool if necessary.
1037 AP_DECLARE_HOOK(void, error_log, (const ap_errorlog_info *info,
1038 const char *errstr))
1040 AP_CORE_DECLARE(void) ap_register_log_hooks(apr_pool_t *p);
1041 AP_CORE_DECLARE(void) ap_register_config_hooks(apr_pool_t *p);
1043 /* ----------------------------------------------------------------------
1045 * ident lookups with mod_ident
1048 APR_DECLARE_OPTIONAL_FN(const char *, ap_ident_lookup,
1051 /* ----------------------------------------------------------------------
1053 * authorization values with mod_authz_core
1056 APR_DECLARE_OPTIONAL_FN(int, authz_some_auth_required, (request_rec *r));
1057 APR_DECLARE_OPTIONAL_FN(const char *, authn_ap_auth_type, (request_rec *r));
1058 APR_DECLARE_OPTIONAL_FN(const char *, authn_ap_auth_name, (request_rec *r));
1060 /* ----------------------------------------------------------------------
1062 * authorization values with mod_access_compat
1065 APR_DECLARE_OPTIONAL_FN(int, access_compat_ap_satisfies, (request_rec *r));
1067 /* ---------------------------------------------------------------------- */
1069 /** Query the server for some state information
1070 * @param query_code Which information is requested
1071 * @return the requested state information
1073 AP_DECLARE(int) ap_state_query(int query_code);
1076 * possible values for query_code in ap_state_query()
1079 /** current status of the server */
1080 #define AP_SQ_MAIN_STATE 0
1081 /** are we going to serve requests or are we just testing/dumping config */
1082 #define AP_SQ_RUN_MODE 1
1083 /** generation of the top-level apache parent */
1084 #define AP_SQ_CONFIG_GEN 2
1087 * return values for ap_state_query()
1090 /** return value for unknown query_code */
1091 #define AP_SQ_NOT_SUPPORTED -1
1093 /* values returned for AP_SQ_MAIN_STATE */
1094 /** before the config preflight */
1095 #define AP_SQ_MS_INITIAL_STARTUP 1
1096 /** initial configuration run for setting up log config, etc. */
1097 #define AP_SQ_MS_CREATE_PRE_CONFIG 2
1098 /** tearing down configuration */
1099 #define AP_SQ_MS_DESTROY_CONFIG 3
1100 /** normal configuration run */
1101 #define AP_SQ_MS_CREATE_CONFIG 4
1102 /** running the MPM */
1103 #define AP_SQ_MS_RUN_MPM 5
1104 /** cleaning up for exit */
1105 #define AP_SQ_MS_EXITING 6
1107 /* values returned for AP_SQ_RUN_MODE */
1108 /** command line not yet parsed */
1109 #define AP_SQ_RM_UNKNOWN 1
1110 /** normal operation (server requests or signal server) */
1111 #define AP_SQ_RM_NORMAL 2
1112 /** config test only */
1113 #define AP_SQ_RM_CONFIG_TEST 3
1114 /** only dump some parts of the config */
1115 #define AP_SQ_RM_CONFIG_DUMP 4
1118 /* ---------------------------------------------------------------------- */
1120 /** Create a slave connection
1121 * @param c The connection to create the slave connection from/for
1122 * @return The slave connection
1124 AP_CORE_DECLARE(conn_rec *) ap_create_slave_connection(conn_rec *c);
1130 #endif /* !APACHE_HTTP_CORE_H */