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.
18 #include "apr_strings.h"
20 #include "apr_fnmatch.h"
22 #include "apr_thread_proc.h" /* for RLIMIT stuff */
23 #include "apr_random.h"
25 #define APR_WANT_IOVEC
26 #define APR_WANT_STRFUNC
27 #define APR_WANT_MEMFUNC
30 #include "ap_config.h"
32 #include "http_config.h"
33 #include "http_core.h"
34 #include "http_protocol.h" /* For index_of_response(). Grump. */
35 #include "http_request.h"
36 #include "http_vhost.h"
37 #include "http_main.h" /* For the default_handler below... */
40 #include "http_connection.h"
41 #include "apr_buckets.h"
42 #include "util_filter.h"
43 #include "util_ebcdic.h"
44 #include "util_mutex.h"
45 #include "util_time.h"
46 #include "mpm_common.h"
47 #include "scoreboard.h"
49 #include "mod_proxy.h"
50 #include "ap_listen.h"
52 #include "mod_so.h" /* for ap_find_loaded_module_symbol */
54 #if defined(RLIMIT_CPU) || defined (RLIMIT_DATA) || defined (RLIMIT_VMEM) || defined(RLIMIT_AS) || defined (RLIMIT_NPROC)
61 /* LimitRequestBody handling */
62 #define AP_LIMIT_REQ_BODY_UNSET ((apr_off_t) -1)
63 #define AP_DEFAULT_LIMIT_REQ_BODY ((apr_off_t) 0)
65 /* LimitXMLRequestBody handling */
66 #define AP_LIMIT_UNSET ((long) -1)
67 #define AP_DEFAULT_LIMIT_XML_BODY ((apr_size_t)1000000)
69 #define AP_MIN_SENDFILE_BYTES (256)
71 /* maximum include nesting level */
72 #ifndef AP_MAX_INCLUDE_DEPTH
73 #define AP_MAX_INCLUDE_DEPTH (128)
76 /* valid in core-conf, but not in runtime r->used_path_info */
77 #define AP_ACCEPT_PATHINFO_UNSET 3
79 #define AP_CONTENT_MD5_OFF 0
80 #define AP_CONTENT_MD5_ON 1
81 #define AP_CONTENT_MD5_UNSET 2
84 APR_HOOK_LINK(get_mgmt_items)
85 APR_HOOK_LINK(insert_network_bucket)
88 AP_IMPLEMENT_HOOK_RUN_ALL(int, get_mgmt_items,
89 (apr_pool_t *p, const char *val, apr_hash_t *ht),
90 (p, val, ht), OK, DECLINED)
92 AP_IMPLEMENT_HOOK_RUN_FIRST(apr_status_t, insert_network_bucket,
93 (conn_rec *c, apr_bucket_brigade *bb,
94 apr_socket_t *socket),
95 (c, bb, socket), AP_DECLINED)
97 /* Server core module... This module provides support for really basic
98 * server operations, including options and commands which control the
99 * operation of other modules. Consider this the bureaucracy module.
101 * The core module also defines handlers, etc., to handle just enough
102 * to allow a server with the core module ONLY to actually serve documents.
104 * This file could almost be mod_core.c, except for the stuff which affects
105 * the http_conf_globals.
108 /* we know core's module_index is 0 */
109 #undef APLOG_MODULE_INDEX
110 #define APLOG_MODULE_INDEX AP_CORE_MODULE_INDEX
112 /* Handles for core filters */
113 AP_DECLARE_DATA ap_filter_rec_t *ap_subreq_core_filter_handle;
114 AP_DECLARE_DATA ap_filter_rec_t *ap_core_output_filter_handle;
115 AP_DECLARE_DATA ap_filter_rec_t *ap_content_length_filter_handle;
116 AP_DECLARE_DATA ap_filter_rec_t *ap_core_input_filter_handle;
118 /* Provide ap_document_root_check storage and default value = true */
119 AP_DECLARE_DATA int ap_document_root_check = 1;
121 /* magic pointer for ErrorDocument xxx "default" */
122 static char errordocument_default;
124 static apr_array_header_t *saved_server_config_defines = NULL;
125 static apr_table_t *server_config_defined_vars = NULL;
127 AP_DECLARE_DATA int ap_main_state = AP_SQ_MS_INITIAL_STARTUP;
128 AP_DECLARE_DATA int ap_run_mode = AP_SQ_RM_UNKNOWN;
129 AP_DECLARE_DATA int ap_config_generation = 0;
132 apr_ipsubnet_t *subnet;
133 struct ap_logconf log;
136 static void *create_core_dir_config(apr_pool_t *a, char *dir)
138 core_dir_config *conf;
140 conf = (core_dir_config *)apr_pcalloc(a, sizeof(core_dir_config));
142 /* conf->r and conf->d[_*] are initialized by dirsection() or left NULL */
144 conf->opts = dir ? OPT_UNSET : OPT_UNSET|OPT_SYM_LINKS;
145 conf->opts_add = conf->opts_remove = OPT_NONE;
146 conf->override = OR_UNSET|OR_NONE;
147 conf->override_opts = OPT_UNSET | OPT_ALL | OPT_SYM_OWNER | OPT_MULTI;
149 conf->content_md5 = AP_CONTENT_MD5_UNSET;
150 conf->accept_path_info = AP_ACCEPT_PATHINFO_UNSET;
152 conf->use_canonical_name = USE_CANONICAL_NAME_UNSET;
153 conf->use_canonical_phys_port = USE_CANONICAL_PHYS_PORT_UNSET;
155 conf->hostname_lookups = HOSTNAME_LOOKUP_UNSET;
158 * left as NULL (we use apr_pcalloc):
159 * conf->limit_cpu = NULL;
160 * conf->limit_mem = NULL;
161 * conf->limit_nproc = NULL;
162 * conf->sec_file = NULL;
163 * conf->sec_if = NULL;
166 conf->limit_req_body = AP_LIMIT_REQ_BODY_UNSET;
167 conf->limit_xml_body = AP_LIMIT_UNSET;
169 conf->server_signature = srv_sig_unset;
171 conf->add_default_charset = ADD_DEFAULT_CHARSET_UNSET;
172 conf->add_default_charset_name = DEFAULT_ADD_DEFAULT_CHARSET_NAME;
174 /* Overriding all negotiation
175 * Set NULL by apr_pcalloc:
176 * conf->mime_type = NULL;
177 * conf->handler = NULL;
178 * conf->output_filters = NULL;
179 * conf->input_filters = NULL;
183 * Flag for use of inodes in ETags.
185 conf->etag_bits = ETAG_UNSET;
186 conf->etag_add = ETAG_UNSET;
187 conf->etag_remove = ETAG_UNSET;
189 conf->enable_mmap = ENABLE_MMAP_UNSET;
190 conf->enable_sendfile = ENABLE_SENDFILE_UNSET;
191 conf->allow_encoded_slashes = 0;
192 conf->decode_encoded_slashes = 0;
194 conf->max_ranges = AP_MAXRANGES_UNSET;
195 conf->max_overlaps = AP_MAXRANGES_UNSET;
196 conf->max_reversals = AP_MAXRANGES_UNSET;
201 static void *merge_core_dir_configs(apr_pool_t *a, void *basev, void *newv)
203 core_dir_config *base = (core_dir_config *)basev;
204 core_dir_config *new = (core_dir_config *)newv;
205 core_dir_config *conf;
208 /* Create this conf by duplicating the base, replacing elements
209 * (or creating copies for merging) where new-> values exist.
211 conf = (core_dir_config *)apr_pmemdup(a, base, sizeof(core_dir_config));
214 conf->d_is_fnmatch = new->d_is_fnmatch;
215 conf->d_components = new->d_components;
217 conf->condition = new->condition;
219 if (new->opts & OPT_UNSET) {
220 /* there was no explicit setting of new->opts, so we merge
221 * preserve the invariant (opts_add & opts_remove) == 0
223 conf->opts_add = (conf->opts_add & ~new->opts_remove) | new->opts_add;
224 conf->opts_remove = (conf->opts_remove & ~new->opts_add)
226 conf->opts = (conf->opts & ~conf->opts_remove) | conf->opts_add;
228 /* If Includes was enabled with exec in the base config, but
229 * was enabled without exec in the new config, then disable
230 * exec in the merged set. */
231 if (((base->opts & (OPT_INCLUDES|OPT_INC_WITH_EXEC))
232 == (OPT_INCLUDES|OPT_INC_WITH_EXEC))
233 && ((new->opts & (OPT_INCLUDES|OPT_INC_WITH_EXEC))
235 conf->opts &= ~OPT_INC_WITH_EXEC;
239 /* otherwise we just copy, because an explicit opts setting
240 * overrides all earlier +/- modifiers
242 conf->opts = new->opts;
243 conf->opts_add = new->opts_add;
244 conf->opts_remove = new->opts_remove;
247 if (!(new->override & OR_UNSET)) {
248 conf->override = new->override;
251 if (!(new->override_opts & OPT_UNSET)) {
252 conf->override_opts = new->override_opts;
255 if (new->override_list != NULL) {
256 conf->override_list = new->override_list;
259 if (conf->response_code_strings == NULL) {
260 conf->response_code_strings = new->response_code_strings;
262 else if (new->response_code_strings != NULL) {
263 /* If we merge, the merge-result must have its own array
265 conf->response_code_strings = apr_pmemdup(a,
266 base->response_code_strings,
267 sizeof(*conf->response_code_strings) * RESPONSE_CODES);
269 for (i = 0; i < RESPONSE_CODES; ++i) {
270 if (new->response_code_strings[i] != NULL) {
271 conf->response_code_strings[i] = new->response_code_strings[i];
275 /* Otherwise we simply use the base->response_code_strings array
278 if (new->hostname_lookups != HOSTNAME_LOOKUP_UNSET) {
279 conf->hostname_lookups = new->hostname_lookups;
282 if (new->content_md5 != AP_CONTENT_MD5_UNSET) {
283 conf->content_md5 = new->content_md5;
286 if (new->accept_path_info != AP_ACCEPT_PATHINFO_UNSET) {
287 conf->accept_path_info = new->accept_path_info;
290 if (new->use_canonical_name != USE_CANONICAL_NAME_UNSET) {
291 conf->use_canonical_name = new->use_canonical_name;
294 if (new->use_canonical_phys_port != USE_CANONICAL_PHYS_PORT_UNSET) {
295 conf->use_canonical_phys_port = new->use_canonical_phys_port;
299 if (new->limit_cpu) {
300 conf->limit_cpu = new->limit_cpu;
304 #if defined(RLIMIT_DATA) || defined(RLIMIT_VMEM) || defined(RLIMIT_AS)
305 if (new->limit_mem) {
306 conf->limit_mem = new->limit_mem;
311 if (new->limit_nproc) {
312 conf->limit_nproc = new->limit_nproc;
316 if (new->limit_req_body != AP_LIMIT_REQ_BODY_UNSET) {
317 conf->limit_req_body = new->limit_req_body;
320 if (new->limit_xml_body != AP_LIMIT_UNSET)
321 conf->limit_xml_body = new->limit_xml_body;
323 if (!conf->sec_file) {
324 conf->sec_file = new->sec_file;
326 else if (new->sec_file) {
327 /* If we merge, the merge-result must have its own array
329 conf->sec_file = apr_array_append(a, base->sec_file, new->sec_file);
331 /* Otherwise we simply use the base->sec_file array
335 conf->sec_if = new->sec_if;
337 else if (new->sec_if) {
338 /* If we merge, the merge-result must have its own array
340 conf->sec_if = apr_array_append(a, base->sec_if, new->sec_if);
342 /* Otherwise we simply use the base->sec_if array
345 if (new->server_signature != srv_sig_unset) {
346 conf->server_signature = new->server_signature;
349 if (new->add_default_charset != ADD_DEFAULT_CHARSET_UNSET) {
350 conf->add_default_charset = new->add_default_charset;
351 conf->add_default_charset_name = new->add_default_charset_name;
354 /* Overriding all negotiation
356 if (new->mime_type) {
357 conf->mime_type = new->mime_type;
361 conf->handler = new->handler;
364 if (new->output_filters) {
365 conf->output_filters = new->output_filters;
368 if (new->input_filters) {
369 conf->input_filters = new->input_filters;
373 * Now merge the setting of the FileETag directive.
375 if (new->etag_bits == ETAG_UNSET) {
377 (conf->etag_add & (~ new->etag_remove)) | new->etag_add;
379 (conf->etag_remove & (~ new->etag_add)) | new->etag_remove;
381 (conf->etag_bits & (~ conf->etag_remove)) | conf->etag_add;
384 conf->etag_bits = new->etag_bits;
385 conf->etag_add = new->etag_add;
386 conf->etag_remove = new->etag_remove;
389 if (conf->etag_bits != ETAG_NONE) {
390 conf->etag_bits &= (~ ETAG_NONE);
393 if (new->enable_mmap != ENABLE_MMAP_UNSET) {
394 conf->enable_mmap = new->enable_mmap;
397 if (new->enable_sendfile != ENABLE_SENDFILE_UNSET) {
398 conf->enable_sendfile = new->enable_sendfile;
401 conf->allow_encoded_slashes = new->allow_encoded_slashes;
402 conf->decode_encoded_slashes = new->decode_encoded_slashes;
406 conf->log = new->log;
409 conf->log = ap_new_log_config(a, new->log);
410 ap_merge_log_config(base->log, conf->log);
414 conf->max_ranges = new->max_ranges != AP_MAXRANGES_UNSET ? new->max_ranges : base->max_ranges;
415 conf->max_overlaps = new->max_overlaps != AP_MAXRANGES_UNSET ? new->max_overlaps : base->max_overlaps;
416 conf->max_reversals = new->max_reversals != AP_MAXRANGES_UNSET ? new->max_reversals : base->max_reversals;
421 #if APR_HAS_SO_ACCEPTFILTER
422 #ifndef ACCEPT_FILTER_NAME
423 #define ACCEPT_FILTER_NAME "httpready"
424 #ifdef __FreeBSD_version
425 #if __FreeBSD_version < 411000 /* httpready broken before 4.1.1 */
426 #undef ACCEPT_FILTER_NAME
427 #define ACCEPT_FILTER_NAME "dataready"
433 static void *create_core_server_config(apr_pool_t *a, server_rec *s)
435 core_server_config *conf;
436 int is_virtual = s->is_virtual;
438 conf = (core_server_config *)apr_pcalloc(a, sizeof(core_server_config));
440 /* global-default / global-only settings */
443 conf->ap_document_root = DOCUMENT_LOCATION;
444 conf->access_name = DEFAULT_ACCESS_FNAME;
446 /* A mapping only makes sense in the global context */
447 conf->accf_map = apr_table_make(a, 5);
448 #if APR_HAS_SO_ACCEPTFILTER
449 apr_table_setn(conf->accf_map, "http", ACCEPT_FILTER_NAME);
450 apr_table_setn(conf->accf_map, "https", "dataready");
452 apr_table_setn(conf->accf_map, "http", "data");
453 apr_table_setn(conf->accf_map, "https", "data");
456 /* pcalloc'ed - we have NULL's/0's
457 else ** is_virtual ** {
458 conf->ap_document_root = NULL;
459 conf->access_name = NULL;
460 conf->accf_map = NULL;
464 /* initialization, no special case for global context */
466 conf->sec_dir = apr_array_make(a, 40, sizeof(ap_conf_vector_t *));
467 conf->sec_url = apr_array_make(a, 40, sizeof(ap_conf_vector_t *));
469 /* pcalloc'ed - we have NULL's/0's
470 conf->gprof_dir = NULL;
472 ** recursion stopper; 0 == unset
473 conf->redirect_limit = 0;
474 conf->subreq_limit = 0;
476 conf->protocol = NULL;
479 conf->trace_enable = AP_TRACE_UNSET;
484 static void *merge_core_server_configs(apr_pool_t *p, void *basev, void *virtv)
486 core_server_config *base = (core_server_config *)basev;
487 core_server_config *virt = (core_server_config *)virtv;
488 core_server_config *conf = (core_server_config *)
489 apr_pmemdup(p, base, sizeof(core_server_config));
491 if (virt->ap_document_root)
492 conf->ap_document_root = virt->ap_document_root;
494 if (virt->access_name)
495 conf->access_name = virt->access_name;
497 /* XXX optimize to keep base->sec_ pointers if virt->sec_ array is empty */
498 conf->sec_dir = apr_array_append(p, base->sec_dir, virt->sec_dir);
499 conf->sec_url = apr_array_append(p, base->sec_url, virt->sec_url);
501 if (virt->redirect_limit)
502 conf->redirect_limit = virt->redirect_limit;
504 if (virt->subreq_limit)
505 conf->subreq_limit = virt->subreq_limit;
507 if (virt->trace_enable != AP_TRACE_UNSET)
508 conf->trace_enable = virt->trace_enable;
510 if (virt->http09_enable != AP_HTTP09_UNSET)
511 conf->http09_enable = virt->http09_enable;
513 /* no action for virt->accf_map, not allowed per-vhost */
516 conf->protocol = virt->protocol;
519 conf->gprof_dir = virt->gprof_dir;
521 if (virt->error_log_format)
522 conf->error_log_format = virt->error_log_format;
524 if (virt->error_log_conn)
525 conf->error_log_conn = virt->error_log_conn;
527 if (virt->error_log_req)
528 conf->error_log_req = virt->error_log_req;
530 if (virt->conn_log_level) {
531 if (!conf->conn_log_level) {
532 conf->conn_log_level = virt->conn_log_level;
535 /* apr_array_append actually creates a new array */
536 conf->conn_log_level = apr_array_append(p, conf->conn_log_level,
537 virt->conn_log_level);
544 /* Add per-directory configuration entry (for <directory> section);
545 * these are part of the core server config.
548 AP_CORE_DECLARE(void) ap_add_per_dir_conf(server_rec *s, void *dir_config)
550 core_server_config *sconf = ap_get_core_module_config(s->module_config);
551 void **new_space = (void **)apr_array_push(sconf->sec_dir);
553 *new_space = dir_config;
556 AP_CORE_DECLARE(void) ap_add_per_url_conf(server_rec *s, void *url_config)
558 core_server_config *sconf = ap_get_core_module_config(s->module_config);
559 void **new_space = (void **)apr_array_push(sconf->sec_url);
561 *new_space = url_config;
564 AP_CORE_DECLARE(void) ap_add_file_conf(apr_pool_t *p, core_dir_config *conf,
570 conf->sec_file = apr_array_make(p, 2, sizeof(ap_conf_vector_t *));
572 new_space = (void **)apr_array_push(conf->sec_file);
573 *new_space = url_config;
576 AP_CORE_DECLARE(const char *) ap_add_if_conf(apr_pool_t *p,
577 core_dir_config *conf,
581 core_dir_config *new = ap_get_module_config(if_config, &core_module);
584 conf->sec_if = apr_array_make(p, 2, sizeof(ap_conf_vector_t *));
586 if (new->condition_ifelse & AP_CONDITION_ELSE) {
588 if (conf->sec_if->nelts > 0) {
589 core_dir_config *last;
590 ap_conf_vector_t *lastelt = APR_ARRAY_IDX(conf->sec_if,
591 conf->sec_if->nelts - 1,
593 last = ap_get_module_config(lastelt, &core_module);
594 if (last->condition_ifelse & AP_CONDITION_IF)
598 return "<Else> or <ElseIf> section without previous <If> or "
599 "<ElseIf> section in same scope";
602 new_space = (void **)apr_array_push(conf->sec_if);
603 *new_space = if_config;
608 /* We need to do a stable sort, qsort isn't stable. So to make it stable
609 * we'll be maintaining the original index into the list, and using it
610 * as the minor key during sorting. The major key is the number of
611 * components (where the root component is zero).
613 struct reorder_sort_rec {
614 ap_conf_vector_t *elt;
618 static int reorder_sorter(const void *va, const void *vb)
620 const struct reorder_sort_rec *a = va;
621 const struct reorder_sort_rec *b = vb;
622 core_dir_config *core_a;
623 core_dir_config *core_b;
625 core_a = ap_get_core_module_config(a->elt);
626 core_b = ap_get_core_module_config(b->elt);
628 /* a regex always sorts after a non-regex
630 if (!core_a->r && core_b->r) {
633 else if (core_a->r && !core_b->r) {
637 /* we always sort next by the number of components
639 if (core_a->d_components < core_b->d_components) {
642 else if (core_a->d_components > core_b->d_components) {
646 /* They have the same number of components, we now have to compare
647 * the minor key to maintain the original order (from the config.)
649 return a->orig_index - b->orig_index;
652 void ap_core_reorder_directories(apr_pool_t *p, server_rec *s)
654 core_server_config *sconf;
655 apr_array_header_t *sec_dir;
656 struct reorder_sort_rec *sortbin;
658 ap_conf_vector_t **elts;
662 sconf = ap_get_core_module_config(s->module_config);
663 sec_dir = sconf->sec_dir;
664 nelts = sec_dir->nelts;
665 elts = (ap_conf_vector_t **)sec_dir->elts;
668 /* simple case of already being sorted... */
669 /* We're not checking this condition to be fast... we're checking
670 * it to avoid trying to palloc zero bytes, which can trigger some
671 * memory debuggers to barf
676 /* we have to allocate tmp space to do a stable sort */
677 apr_pool_create(&tmp, p);
678 sortbin = apr_palloc(tmp, sec_dir->nelts * sizeof(*sortbin));
679 for (i = 0; i < nelts; ++i) {
680 sortbin[i].orig_index = i;
681 sortbin[i].elt = elts[i];
684 qsort(sortbin, nelts, sizeof(*sortbin), reorder_sorter);
686 /* and now copy back to the original array */
687 for (i = 0; i < nelts; ++i) {
688 elts[i] = sortbin[i].elt;
691 apr_pool_destroy(tmp);
694 /*****************************************************************
696 * There are some elements of the core config structures in which
697 * other modules have a legitimate interest (this is ugly, but necessary
698 * to preserve NCSA back-compatibility). So, we have a bunch of accessors
702 AP_DECLARE(int) ap_allow_options(request_rec *r)
704 core_dir_config *conf =
705 (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
710 AP_DECLARE(int) ap_allow_overrides(request_rec *r)
712 core_dir_config *conf;
713 conf = (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
715 return conf->override;
719 * Optional function coming from mod_authn_core, used for
720 * retrieving the type of autorization
722 static APR_OPTIONAL_FN_TYPE(authn_ap_auth_type) *authn_ap_auth_type;
724 AP_DECLARE(const char *) ap_auth_type(request_rec *r)
726 if (authn_ap_auth_type) {
727 return authn_ap_auth_type(r);
733 * Optional function coming from mod_authn_core, used for
734 * retrieving the authorization realm
736 static APR_OPTIONAL_FN_TYPE(authn_ap_auth_name) *authn_ap_auth_name;
738 AP_DECLARE(const char *) ap_auth_name(request_rec *r)
740 if (authn_ap_auth_name) {
741 return authn_ap_auth_name(r);
747 * Optional function coming from mod_access_compat, used to determine how
748 access control interacts with authentication/authorization
750 static APR_OPTIONAL_FN_TYPE(access_compat_ap_satisfies) *access_compat_ap_satisfies;
752 AP_DECLARE(int) ap_satisfies(request_rec *r)
754 if (access_compat_ap_satisfies) {
755 return access_compat_ap_satisfies(r);
757 return SATISFY_NOSPEC;
760 AP_DECLARE(const char *) ap_document_root(request_rec *r) /* Don't use this! */
762 core_server_config *sconf;
763 core_request_config *rconf = ap_get_core_module_config(r->request_config);
764 if (rconf->document_root)
765 return rconf->document_root;
766 sconf = ap_get_core_module_config(r->server->module_config);
767 return sconf->ap_document_root;
770 AP_DECLARE(const char *) ap_context_prefix(request_rec *r)
772 core_request_config *conf = ap_get_core_module_config(r->request_config);
773 if (conf->context_prefix)
774 return conf->context_prefix;
779 AP_DECLARE(const char *) ap_context_document_root(request_rec *r)
781 core_request_config *conf = ap_get_core_module_config(r->request_config);
782 if (conf->context_document_root)
783 return conf->context_document_root;
785 return ap_document_root(r);
788 AP_DECLARE(void) ap_set_document_root(request_rec *r, const char *document_root)
790 core_request_config *conf = ap_get_core_module_config(r->request_config);
791 conf->document_root = document_root;
794 AP_DECLARE(void) ap_set_context_info(request_rec *r, const char *context_prefix,
795 const char *context_document_root)
797 core_request_config *conf = ap_get_core_module_config(r->request_config);
799 conf->context_prefix = context_prefix;
800 if (context_document_root)
801 conf->context_document_root = context_document_root;
804 /* Should probably just get rid of this... the only code that cares is
805 * part of the core anyway (and in fact, it isn't publicised to other
809 char *ap_response_code_string(request_rec *r, int error_index)
811 core_dir_config *dirconf;
812 core_request_config *reqconf = ap_get_core_module_config(r->request_config);
814 /* check for string registered via ap_custom_response() first */
815 if (reqconf->response_code_strings != NULL &&
816 reqconf->response_code_strings[error_index] != NULL) {
817 return reqconf->response_code_strings[error_index];
820 /* check for string specified via ErrorDocument */
821 dirconf = ap_get_core_module_config(r->per_dir_config);
823 if (dirconf->response_code_strings == NULL) {
827 if (dirconf->response_code_strings[error_index] == &errordocument_default) {
831 return dirconf->response_code_strings[error_index];
835 /* Code from Harald Hanche-Olsen <hanche@imf.unit.no> */
836 static APR_INLINE void do_double_reverse (conn_rec *conn)
841 if (conn->double_reverse) {
846 if (conn->remote_host == NULL || conn->remote_host[0] == '\0') {
847 /* single reverse failed, so don't bother */
848 conn->double_reverse = -1;
852 rv = apr_sockaddr_info_get(&sa, conn->remote_host, APR_UNSPEC, 0, 0, conn->pool);
853 if (rv == APR_SUCCESS) {
855 if (apr_sockaddr_equal(sa, conn->client_addr)) {
856 conn->double_reverse = 1;
864 conn->double_reverse = -1;
867 AP_DECLARE(const char *) ap_get_remote_host(conn_rec *conn, void *dir_config,
868 int type, int *str_is_ip)
870 int hostname_lookups;
871 int ignored_str_is_ip;
873 if (!str_is_ip) { /* caller doesn't want to know */
874 str_is_ip = &ignored_str_is_ip;
878 /* If we haven't checked the host name, and we want to */
880 hostname_lookups = ((core_dir_config *)ap_get_core_module_config(dir_config))
883 if (hostname_lookups == HOSTNAME_LOOKUP_UNSET) {
884 hostname_lookups = HOSTNAME_LOOKUP_OFF;
889 hostname_lookups = HOSTNAME_LOOKUP_OFF;
892 if (type != REMOTE_NOLOOKUP
893 && conn->remote_host == NULL
894 && (type == REMOTE_DOUBLE_REV
895 || hostname_lookups != HOSTNAME_LOOKUP_OFF)) {
897 if (apr_getnameinfo(&conn->remote_host, conn->client_addr, 0)
899 ap_str_tolower(conn->remote_host);
901 if (hostname_lookups == HOSTNAME_LOOKUP_DOUBLE) {
902 do_double_reverse(conn);
903 if (conn->double_reverse != 1) {
904 conn->remote_host = NULL;
909 /* if failed, set it to the NULL string to indicate error */
910 if (conn->remote_host == NULL) {
911 conn->remote_host = "";
915 if (type == REMOTE_DOUBLE_REV) {
916 do_double_reverse(conn);
917 if (conn->double_reverse == -1) {
923 * Return the desired information; either the remote DNS name, if found,
924 * or either NULL (if the hostname was requested) or the IP address
925 * (if any identifier was requested).
927 if (conn->remote_host != NULL && conn->remote_host[0] != '\0') {
928 return conn->remote_host;
931 if (type == REMOTE_HOST || type == REMOTE_DOUBLE_REV) {
936 return conn->client_ip;
942 * Optional function coming from mod_ident, used for looking up ident user
944 static APR_OPTIONAL_FN_TYPE(ap_ident_lookup) *ident_lookup;
946 AP_DECLARE(const char *) ap_get_remote_logname(request_rec *r)
948 if (r->connection->remote_logname != NULL) {
949 return r->connection->remote_logname;
953 return ident_lookup(r);
959 /* There are two options regarding what the "name" of a server is. The
960 * "canonical" name as defined by ServerName and Port, or the "client's
961 * name" as supplied by a possible Host: header or full URI.
963 * The DNS option to UseCanonicalName causes this routine to do a
964 * reverse lookup on the local IP address of the connection and use
965 * that for the ServerName. This makes its value more reliable while
966 * at the same time allowing Demon's magic virtual hosting to work.
967 * The assumption is that DNS lookups are sufficiently quick...
970 AP_DECLARE(const char *) ap_get_server_name(request_rec *r)
972 conn_rec *conn = r->connection;
976 d = (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
978 switch (d->use_canonical_name) {
979 case USE_CANONICAL_NAME_ON:
980 retval = r->server->server_hostname;
982 case USE_CANONICAL_NAME_DNS:
983 if (conn->local_host == NULL) {
984 if (apr_getnameinfo(&conn->local_host,
985 conn->local_addr, 0) != APR_SUCCESS)
986 conn->local_host = apr_pstrdup(conn->pool,
987 r->server->server_hostname);
989 ap_str_tolower(conn->local_host);
992 retval = conn->local_host;
994 case USE_CANONICAL_NAME_OFF:
995 case USE_CANONICAL_NAME_UNSET:
996 retval = r->hostname ? r->hostname : r->server->server_hostname;
999 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(00109)
1000 "ap_get_server_name: Invalid UCN Option somehow");
1001 retval = "localhost";
1008 * Get the current server name from the request for the purposes
1009 * of using in a URL. If the server name is an IPv6 literal
1010 * address, it will be returned in URL format (e.g., "[fe80::1]").
1012 AP_DECLARE(const char *) ap_get_server_name_for_url(request_rec *r)
1014 const char *plain_server_name = ap_get_server_name(r);
1017 if (ap_strchr_c(plain_server_name, ':')) { /* IPv6 literal? */
1018 return apr_pstrcat(r->pool, "[", plain_server_name, "]", NULL);
1021 return plain_server_name;
1024 AP_DECLARE(apr_port_t) ap_get_server_port(const request_rec *r)
1027 core_dir_config *d =
1028 (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
1030 switch (d->use_canonical_name) {
1031 case USE_CANONICAL_NAME_OFF:
1032 case USE_CANONICAL_NAME_DNS:
1033 case USE_CANONICAL_NAME_UNSET:
1034 if (d->use_canonical_phys_port == USE_CANONICAL_PHYS_PORT_ON)
1035 port = r->parsed_uri.port_str ? r->parsed_uri.port :
1036 r->connection->local_addr->port ? r->connection->local_addr->port :
1037 r->server->port ? r->server->port :
1039 else /* USE_CANONICAL_PHYS_PORT_OFF or USE_CANONICAL_PHYS_PORT_UNSET */
1040 port = r->parsed_uri.port_str ? r->parsed_uri.port :
1041 r->server->port ? r->server->port :
1044 case USE_CANONICAL_NAME_ON:
1045 /* With UseCanonicalName on (and in all versions prior to 1.3)
1046 * Apache will use the hostname and port specified in the
1047 * ServerName directive to construct a canonical name for the
1048 * server. (If no port was specified in the ServerName
1049 * directive, Apache uses the port supplied by the client if
1050 * any is supplied, and finally the default port for the protocol
1053 if (d->use_canonical_phys_port == USE_CANONICAL_PHYS_PORT_ON)
1054 port = r->server->port ? r->server->port :
1055 r->connection->local_addr->port ? r->connection->local_addr->port :
1057 else /* USE_CANONICAL_PHYS_PORT_OFF or USE_CANONICAL_PHYS_PORT_UNSET */
1058 port = r->server->port ? r->server->port :
1062 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(00110)
1063 "ap_get_server_port: Invalid UCN Option somehow");
1064 port = ap_default_port(r);
1071 AP_DECLARE(char *) ap_construct_url(apr_pool_t *p, const char *uri,
1074 unsigned port = ap_get_server_port(r);
1075 const char *host = ap_get_server_name_for_url(r);
1077 if (ap_is_default_port(port, r)) {
1078 return apr_pstrcat(p, ap_http_scheme(r), "://", host, uri, NULL);
1081 return apr_psprintf(p, "%s://%s:%u%s", ap_http_scheme(r), host, port, uri);
1084 AP_DECLARE(apr_off_t) ap_get_limit_req_body(const request_rec *r)
1086 core_dir_config *d =
1087 (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
1089 if (d->limit_req_body == AP_LIMIT_REQ_BODY_UNSET) {
1090 return AP_DEFAULT_LIMIT_REQ_BODY;
1093 return d->limit_req_body;
1097 /*****************************************************************
1099 * Commands... this module handles almost all of the NCSA httpd.conf
1100 * commands, but most of the old srm.conf is in the the modules.
1104 /* returns a parent if it matches the given directive */
1105 static const ap_directive_t * find_parent(const ap_directive_t *dirp,
1108 while (dirp->parent != NULL) {
1109 dirp = dirp->parent;
1111 /* ### it would be nice to have atom-ized directives */
1112 if (strcasecmp(dirp->directive, what) == 0)
1119 AP_DECLARE(const char *) ap_check_cmd_context(cmd_parms *cmd,
1122 const char *gt = (cmd->cmd->name[0] == '<'
1123 && cmd->cmd->name[strlen(cmd->cmd->name)-1] != '>')
1125 const ap_directive_t *found;
1127 if ((forbidden & NOT_IN_VIRTUALHOST) && cmd->server->is_virtual) {
1128 return apr_pstrcat(cmd->pool, cmd->cmd->name, gt,
1129 " cannot occur within <VirtualHost> section", NULL);
1132 if ((forbidden & (NOT_IN_LIMIT | NOT_IN_DIR_LOC_FILE))
1133 && cmd->limited != -1) {
1134 return apr_pstrcat(cmd->pool, cmd->cmd->name, gt,
1135 " cannot occur within <Limit> or <LimitExcept> "
1139 if ((forbidden & NOT_IN_HTACCESS) && (cmd->pool == cmd->temp_pool)) {
1140 return apr_pstrcat(cmd->pool, cmd->cmd->name, gt,
1141 " cannot occur within htaccess files", NULL);
1144 if ((forbidden & NOT_IN_DIR_LOC_FILE) == NOT_IN_DIR_LOC_FILE) {
1145 if (cmd->path != NULL) {
1146 return apr_pstrcat(cmd->pool, cmd->cmd->name, gt,
1147 " cannot occur within <Directory/Location/Files> "
1150 if (cmd->cmd->req_override & EXEC_ON_READ) {
1151 /* EXEC_ON_READ must be NOT_IN_DIR_LOC_FILE, if not, it will
1152 * (deliberately) segfault below in the individual tests...
1158 if (((forbidden & NOT_IN_DIRECTORY)
1159 && ((found = find_parent(cmd->directive, "<Directory"))
1160 || (found = find_parent(cmd->directive, "<DirectoryMatch"))))
1161 || ((forbidden & NOT_IN_LOCATION)
1162 && ((found = find_parent(cmd->directive, "<Location"))
1163 || (found = find_parent(cmd->directive, "<LocationMatch"))))
1164 || ((forbidden & NOT_IN_FILES)
1165 && ((found = find_parent(cmd->directive, "<Files"))
1166 || (found = find_parent(cmd->directive, "<FilesMatch"))
1167 || (found = find_parent(cmd->directive, "<If"))
1168 || (found = find_parent(cmd->directive, "<ElseIf"))
1169 || (found = find_parent(cmd->directive, "<Else"))))) {
1170 return apr_pstrcat(cmd->pool, cmd->cmd->name, gt,
1171 " cannot occur within ", found->directive,
1178 static const char *set_access_name(cmd_parms *cmd, void *dummy,
1181 void *sconf = cmd->server->module_config;
1182 core_server_config *conf = ap_get_core_module_config(sconf);
1184 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
1189 conf->access_name = apr_pstrdup(cmd->pool, arg);
1193 AP_DECLARE(const char *) ap_resolve_env(apr_pool_t *p, const char * word)
1195 # define SMALL_EXPANSION 5
1200 } *result, *current, sresult[SMALL_EXPANSION];
1202 const char *s, *e, *ep;
1206 s = ap_strchr_c(word, '$');
1211 /* well, actually something to do */
1212 ep = word + strlen(word);
1214 result = current = &(sresult[spc++]);
1215 current->next = NULL;
1216 current->string = word;
1217 current->len = s - word;
1218 outlen = current->len;
1221 /* prepare next entry */
1223 current->next = (spc < SMALL_EXPANSION)
1225 : (struct sll *)apr_palloc(p,
1226 sizeof(*current->next));
1227 current = current->next;
1228 current->next = NULL;
1233 if (s[1] == '{' && (e = ap_strchr_c(s, '}'))) {
1234 char *name = apr_pstrndup(p, s+2, e-s-2);
1236 if (server_config_defined_vars)
1237 word = apr_table_get(server_config_defined_vars, name);
1239 word = getenv(name);
1241 current->string = word;
1242 current->len = strlen(word);
1243 outlen += current->len;
1246 if (ap_strchr(name, ':') == 0)
1247 ap_log_error(APLOG_MARK, APLOG_WARNING, 0, NULL, APLOGNO(00111)
1248 "Config variable ${%s} is not defined",
1250 current->string = s;
1251 current->len = e - s + 1;
1252 outlen += current->len;
1257 current->string = s++;
1264 s = ap_strchr_c(s, '$');
1265 current->string = word;
1266 current->len = s ? s - word : ep - word;
1267 outlen += current->len;
1271 /* assemble result */
1272 res_buf = cp = apr_palloc(p, outlen + 1);
1275 memcpy(cp, result->string, result->len);
1278 result = result->next;
1280 res_buf[outlen] = '\0';
1285 static int reset_config_defines(void *dummy)
1287 ap_server_config_defines = saved_server_config_defines;
1288 server_config_defined_vars = NULL;
1293 * Make sure we can revert the effects of Define/UnDefine when restarting.
1294 * This function must be called once per loading of the config, before
1295 * ap_server_config_defines is changed. This may be during reading of the
1296 * config, which is even before the pre_config hook is run (due to
1297 * EXEC_ON_READ for Define/UnDefine).
1299 static void init_config_defines(apr_pool_t *pconf)
1301 saved_server_config_defines = ap_server_config_defines;
1302 /* Use apr_array_copy instead of apr_array_copy_hdr because it does not
1303 * protect from the way unset_define removes entries.
1305 ap_server_config_defines = apr_array_copy(pconf, ap_server_config_defines);
1308 static const char *set_define(cmd_parms *cmd, void *dummy,
1309 const char *name, const char *value)
1311 const char *err = ap_check_cmd_context(cmd, NOT_IN_HTACCESS);
1314 if (ap_strchr_c(name, ':') != NULL)
1315 return "Variable name must not contain ':'";
1317 if (!saved_server_config_defines)
1318 init_config_defines(cmd->pool);
1319 if (!ap_exists_config_define(name)) {
1320 char **newv = (char **)apr_array_push(ap_server_config_defines);
1321 *newv = apr_pstrdup(cmd->pool, name);
1324 if (!server_config_defined_vars)
1325 server_config_defined_vars = apr_table_make(cmd->pool, 5);
1326 apr_table_setn(server_config_defined_vars, name, value);
1332 static const char *unset_define(cmd_parms *cmd, void *dummy,
1337 const char *err = ap_check_cmd_context(cmd, NOT_IN_HTACCESS);
1340 if (ap_strchr_c(name, ':') != NULL)
1341 return "Variable name must not contain ':'";
1343 if (!saved_server_config_defines)
1344 init_config_defines(cmd->pool);
1346 defines = (char **)ap_server_config_defines->elts;
1347 for (i = 0; i < ap_server_config_defines->nelts; i++) {
1348 if (strcmp(defines[i], name) == 0) {
1349 defines[i] = apr_array_pop(ap_server_config_defines);
1354 if (server_config_defined_vars) {
1355 apr_table_unset(server_config_defined_vars, name);
1361 static const char *generate_message(cmd_parms *cmd, void *dummy,
1364 /* cast with 64-bit warning avoidance */
1365 int level = (cmd->info==(void*)APLOG_ERR)? APLOG_ERR: APLOG_WARNING;
1368 /* get position information from wherever we can? */
1369 ap_configfile_t * cf = cmd->config_file;
1370 ap_directive_t const * ed1 = cmd->directive;
1371 ap_directive_t const * ed2 = cmd->err_directive;
1373 /* expect an argument */
1374 if (!arg || !*arg) {
1375 return "The Error or Warning directive was used with no message.";
1378 /* set message, strip off quotes if necessary */
1380 if (*arg == '"' || *arg == '\'') {
1381 apr_size_t len = strlen(arg);
1382 char last = *(arg + len - 1);
1385 msg = apr_pstrndup(cmd->pool, arg + 1, len - 2);
1389 /* generate error or warning with a configuration file position.
1390 * the log is displayed on the terminal as no log file is opened yet.
1392 ap_log_error(APLOG_MARK, APLOG_NOERRNO|level, 0, NULL,
1393 "%s on line %d of %s", msg,
1394 cf? cf->line_number:
1396 ed2? ed2->line_num: -1,
1399 ed2? ed2->filename: "<UNKNOWN>");
1401 /* message displayed above, return will stop configuration processing */
1402 return level==APLOG_ERR?
1403 "Configuration processing stopped by Error directive": NULL;
1407 static const char *set_gprof_dir(cmd_parms *cmd, void *dummy, const char *arg)
1409 void *sconf = cmd->server->module_config;
1410 core_server_config *conf = ap_get_core_module_config(sconf);
1412 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
1417 conf->gprof_dir = arg;
1422 static const char *set_add_default_charset(cmd_parms *cmd,
1423 void *d_, const char *arg)
1425 core_dir_config *d = d_;
1427 if (!strcasecmp(arg, "Off")) {
1428 d->add_default_charset = ADD_DEFAULT_CHARSET_OFF;
1430 else if (!strcasecmp(arg, "On")) {
1431 d->add_default_charset = ADD_DEFAULT_CHARSET_ON;
1432 d->add_default_charset_name = DEFAULT_ADD_DEFAULT_CHARSET_NAME;
1435 d->add_default_charset = ADD_DEFAULT_CHARSET_ON;
1436 d->add_default_charset_name = arg;
1442 static const char *set_document_root(cmd_parms *cmd, void *dummy,
1445 void *sconf = cmd->server->module_config;
1446 core_server_config *conf = ap_get_core_module_config(sconf);
1448 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
1453 /* When ap_document_root_check is false; skip all the stuff below */
1454 if (!ap_document_root_check) {
1455 conf->ap_document_root = arg;
1459 /* Make it absolute, relative to ServerRoot */
1460 arg = ap_server_root_relative(cmd->pool, arg);
1462 return "DocumentRoot must be a directory";
1465 /* TODO: ap_configtestonly */
1466 if (apr_filepath_merge((char**)&conf->ap_document_root, NULL, arg,
1467 APR_FILEPATH_TRUENAME, cmd->pool) != APR_SUCCESS
1468 || !ap_is_directory(cmd->pool, arg)) {
1469 if (cmd->server->is_virtual) {
1470 ap_log_perror(APLOG_MARK, APLOG_STARTUP, 0,
1471 cmd->pool, APLOGNO(00112)
1472 "Warning: DocumentRoot [%s] does not exist",
1474 conf->ap_document_root = arg;
1477 return "DocumentRoot must be a directory";
1483 AP_DECLARE(void) ap_custom_response(request_rec *r, int status,
1486 core_request_config *conf = ap_get_core_module_config(r->request_config);
1489 if (conf->response_code_strings == NULL) {
1490 conf->response_code_strings =
1491 apr_pcalloc(r->pool,
1492 sizeof(*conf->response_code_strings) * RESPONSE_CODES);
1495 idx = ap_index_of_response(status);
1497 conf->response_code_strings[idx] =
1498 ((ap_is_url(string) || (*string == '/')) && (*string != '"')) ?
1499 apr_pstrdup(r->pool, string) : apr_pstrcat(r->pool, "\"", string, NULL);
1502 static const char *set_error_document(cmd_parms *cmd, void *conf_,
1503 const char *errno_str, const char *msg)
1505 core_dir_config *conf = conf_;
1506 int error_number, index_number, idx500;
1507 enum { MSG, LOCAL_PATH, REMOTE_PATH } what = MSG;
1509 /* 1st parameter should be a 3 digit number, which we recognize;
1510 * convert it into an array index
1512 error_number = atoi(errno_str);
1513 idx500 = ap_index_of_response(HTTP_INTERNAL_SERVER_ERROR);
1515 if (error_number == HTTP_INTERNAL_SERVER_ERROR) {
1516 index_number = idx500;
1518 else if ((index_number = ap_index_of_response(error_number)) == idx500) {
1519 return apr_pstrcat(cmd->pool, "Unsupported HTTP response code ",
1523 /* Heuristic to determine second argument. */
1524 if (ap_strchr_c(msg,' '))
1526 else if (msg[0] == '/')
1528 else if (ap_is_url(msg))
1533 /* The entry should be ignored if it is a full URL for a 401 error */
1535 if (error_number == 401 && what == REMOTE_PATH) {
1536 ap_log_error(APLOG_MARK, APLOG_NOTICE, 0, cmd->server, APLOGNO(00113)
1537 "cannot use a full URL in a 401 ErrorDocument "
1538 "directive --- ignoring!");
1540 else { /* Store it... */
1541 if (conf->response_code_strings == NULL) {
1542 conf->response_code_strings =
1543 apr_pcalloc(cmd->pool,
1544 sizeof(*conf->response_code_strings) *
1548 if (strcmp(msg, "default") == 0) {
1549 /* special case: ErrorDocument 404 default restores the
1550 * canned server error response
1552 conf->response_code_strings[index_number] = &errordocument_default;
1555 /* hack. Prefix a " if it is a msg; as that is what
1556 * http_protocol.c relies on to distinguish between
1557 * a msg and a (local) path.
1559 conf->response_code_strings[index_number] = (what == MSG) ?
1560 apr_pstrcat(cmd->pool, "\"", msg, NULL) :
1561 apr_pstrdup(cmd->pool, msg);
1568 static const char *set_allow_opts(cmd_parms *cmd, allow_options_t *opts,
1571 allow_options_t opt;
1574 char *w, *p = (char *) l;
1577 while ((w = apr_strtok(p, ",", &tok_state)) != NULL) {
1585 if (!strcasecmp(w, "Indexes")) {
1588 else if (!strcasecmp(w, "Includes")) {
1589 /* If Includes is permitted, both Includes and
1590 * IncludesNOEXEC may be changed. */
1591 opt = (OPT_INCLUDES | OPT_INC_WITH_EXEC);
1593 else if (!strcasecmp(w, "IncludesNOEXEC")) {
1596 else if (!strcasecmp(w, "FollowSymLinks")) {
1597 opt = OPT_SYM_LINKS;
1599 else if (!strcasecmp(w, "SymLinksIfOwnerMatch")) {
1600 opt = OPT_SYM_OWNER;
1602 else if (!strcasecmp(w, "ExecCGI")) {
1605 else if (!strcasecmp(w, "MultiViews")) {
1608 else if (!strcasecmp(w, "RunScripts")) { /* AI backcompat. Yuck */
1609 opt = OPT_MULTI|OPT_EXECCGI;
1611 else if (!strcasecmp(w, "None")) {
1614 else if (!strcasecmp(w, "All")) {
1618 return apr_pstrcat(cmd->pool, "Illegal option ", w, NULL);
1624 (*opts) &= (~OPT_UNSET);
1629 static const char *set_override(cmd_parms *cmd, void *d_, const char *l)
1631 core_dir_config *d = d_;
1636 /* Throw a warning if we're in <Location> or <Files> */
1637 if (ap_check_cmd_context(cmd, NOT_IN_LOCATION | NOT_IN_FILES)) {
1638 ap_log_error(APLOG_MARK, APLOG_WARNING, 0, cmd->server, APLOGNO(00114)
1639 "Useless use of AllowOverride in line %d of %s.",
1640 cmd->directive->line_num, cmd->directive->filename);
1642 if ((err = ap_check_cmd_context(cmd, NOT_IN_HTACCESS)) != NULL)
1645 d->override = OR_NONE;
1647 w = ap_getword_conf(cmd->temp_pool, &l);
1655 if (!strcasecmp(w, "Limit")) {
1656 d->override |= OR_LIMIT;
1658 else if (!strcasecmp(k, "Options")) {
1659 d->override |= OR_OPTIONS;
1661 set_allow_opts(cmd, &(d->override_opts), v);
1663 d->override_opts = OPT_ALL;
1665 else if (!strcasecmp(w, "FileInfo")) {
1666 d->override |= OR_FILEINFO;
1668 else if (!strcasecmp(w, "AuthConfig")) {
1669 d->override |= OR_AUTHCFG;
1671 else if (!strcasecmp(w, "Indexes")) {
1672 d->override |= OR_INDEXES;
1674 else if (!strcasecmp(w, "Nonfatal")) {
1675 if (!strcasecmp(v, "Override")) {
1676 d->override |= NONFATAL_OVERRIDE;
1678 else if (!strcasecmp(v, "Unknown")) {
1679 d->override |= NONFATAL_UNKNOWN;
1681 else if (!strcasecmp(v, "All")) {
1682 d->override |= NONFATAL_ALL;
1685 else if (!strcasecmp(w, "None")) {
1686 d->override = OR_NONE;
1688 else if (!strcasecmp(w, "All")) {
1689 d->override = OR_ALL;
1692 return apr_pstrcat(cmd->pool, "Illegal override option ", w, NULL);
1695 d->override &= ~OR_UNSET;
1701 static const char *set_override_list(cmd_parms *cmd, void *d_, int argc, char *const argv[])
1703 core_dir_config *d = d_;
1707 /* Throw a warning if we're in <Location> or <Files> */
1708 if (ap_check_cmd_context(cmd, NOT_IN_LOCATION | NOT_IN_FILES)) {
1709 ap_log_error(APLOG_MARK, APLOG_WARNING, 0, cmd->server, APLOGNO(00115)
1710 "Useless use of AllowOverrideList at %s:%d",
1711 cmd->directive->filename, cmd->directive->line_num);
1713 if ((err = ap_check_cmd_context(cmd, NOT_IN_HTACCESS)) != NULL)
1716 d->override_list = apr_table_make(cmd->pool, argc);
1718 for (i=0;i<argc;i++){
1719 if (!strcasecmp(argv[i], "None")) {
1721 return "'None' not allowed with other directives in "
1722 "AllowOverrideList";
1727 const command_rec *result = NULL;
1728 module *mod = ap_top_module;
1729 result = ap_find_command_in_modules(argv[i], &mod);
1730 if (result == NULL) {
1731 ap_log_error(APLOG_MARK, APLOG_WARNING, 0, cmd->server,
1732 APLOGNO(00116) "Discarding unrecognized "
1733 "directive `%s' in AllowOverrideList at %s:%d",
1734 argv[i], cmd->directive->filename,
1735 cmd->directive->line_num);
1738 else if ((result->req_override & (OR_ALL|ACCESS_CONF)) == 0) {
1739 ap_log_error(APLOG_MARK, APLOG_WARNING, 0, cmd->server,
1740 APLOGNO(02304) "Discarding directive `%s' not "
1741 "allowed in AllowOverrideList at %s:%d",
1742 argv[i], cmd->directive->filename,
1743 cmd->directive->line_num);
1747 apr_table_set(d->override_list, argv[i], "1");
1755 static const char *set_options(cmd_parms *cmd, void *d_, const char *l)
1757 core_dir_config *d = d_;
1758 allow_options_t opt;
1765 char *w = ap_getword_conf(cmd->temp_pool, &l);
1768 if (*w == '+' || *w == '-') {
1770 if (!merge && !first && !all_none) {
1771 return "Either all Options must start with + or -, or no Option may.";
1779 return "Either all Options must start with + or -, or no Option may.";
1782 if (!strcasecmp(w, "Indexes")) {
1785 else if (!strcasecmp(w, "Includes")) {
1786 opt = (OPT_INCLUDES | OPT_INC_WITH_EXEC);
1788 else if (!strcasecmp(w, "IncludesNOEXEC")) {
1791 else if (!strcasecmp(w, "FollowSymLinks")) {
1792 opt = OPT_SYM_LINKS;
1794 else if (!strcasecmp(w, "SymLinksIfOwnerMatch")) {
1795 opt = OPT_SYM_OWNER;
1797 else if (!strcasecmp(w, "ExecCGI")) {
1800 else if (!strcasecmp(w, "MultiViews")) {
1803 else if (!strcasecmp(w, "RunScripts")) { /* AI backcompat. Yuck */
1804 opt = OPT_MULTI|OPT_EXECCGI;
1806 else if (!strcasecmp(w, "None")) {
1808 return "'Options None' must be the first Option given.";
1810 else if (merge) { /* Only works since None may not follow any other option. */
1811 return "You may not use 'Options +None' or 'Options -None'.";
1816 else if (!strcasecmp(w, "All")) {
1818 return "'Options All' must be the first option given.";
1820 else if (merge) { /* Only works since All may not follow any other option. */
1821 return "You may not use 'Options +All' or 'Options -All'.";
1827 return apr_pstrcat(cmd->pool, "Illegal option ", w, NULL);
1830 if ( (cmd->override_opts & opt) != opt ) {
1831 return apr_pstrcat(cmd->pool, "Option ", w, " not allowed here", NULL);
1833 else if (action == '-') {
1834 /* we ensure the invariant (d->opts_add & d->opts_remove) == 0 */
1835 d->opts_remove |= opt;
1836 d->opts_add &= ~opt;
1839 else if (action == '+') {
1841 d->opts_remove &= ~opt;
1854 static const char *set_default_type(cmd_parms *cmd, void *d_,
1857 if ((strcasecmp(arg, "off") != 0) && (strcasecmp(arg, "none") != 0)) {
1858 ap_log_error(APLOG_MARK, APLOG_WARNING, 0, cmd->server, APLOGNO(00117)
1859 "Ignoring deprecated use of DefaultType in line %d of %s.",
1860 cmd->directive->line_num, cmd->directive->filename);
1867 * Note what data should be used when forming file ETag values.
1868 * It would be nicer to do this as an ITERATE, but then we couldn't
1869 * remember the +/- state properly.
1871 static const char *set_etag_bits(cmd_parms *cmd, void *mconfig,
1874 core_dir_config *cfg;
1875 etag_components_t bit;
1883 cfg = (core_dir_config *)mconfig;
1888 while (args[0] != '\0') {
1892 token = ap_getword_conf(cmd->temp_pool, &args);
1893 if ((*token == '+') || (*token == '-')) {
1899 * The occurrence of an absolute setting wipes
1900 * out any previous relative ones. The first such
1901 * occurrence forgets any inherited ones, too.
1904 cfg->etag_bits = ETAG_UNSET;
1905 cfg->etag_add = ETAG_UNSET;
1906 cfg->etag_remove = ETAG_UNSET;
1911 if (strcasecmp(token, "None") == 0) {
1912 if (action != '*') {
1916 cfg->etag_bits = bit = ETAG_NONE;
1920 else if (strcasecmp(token, "All") == 0) {
1921 if (action != '*') {
1926 cfg->etag_bits = bit = ETAG_ALL;
1929 else if (strcasecmp(token, "Size") == 0) {
1932 else if ((strcasecmp(token, "LMTime") == 0)
1933 || (strcasecmp(token, "MTime") == 0)
1934 || (strcasecmp(token, "LastModified") == 0)) {
1937 else if (strcasecmp(token, "INode") == 0) {
1941 return apr_pstrcat(cmd->pool, "Unknown keyword '",
1942 token, "' for ", cmd->cmd->name,
1943 " directive", NULL);
1947 return apr_pstrcat(cmd->pool, cmd->cmd->name, " keyword '",
1948 token, "' cannot be used with '+' or '-'",
1952 if (action == '+') {
1954 * Make sure it's in the 'add' list and absent from the
1957 cfg->etag_add |= bit;
1958 cfg->etag_remove &= (~ bit);
1960 else if (action == '-') {
1961 cfg->etag_remove |= bit;
1962 cfg->etag_add &= (~ bit);
1966 * Non-relative values wipe out any + or - values
1967 * accumulated so far.
1969 cfg->etag_bits |= bit;
1970 cfg->etag_add = ETAG_UNSET;
1971 cfg->etag_remove = ETAG_UNSET;
1977 * Any setting at all will clear the 'None' and 'Unset' bits.
1980 if (cfg->etag_add != ETAG_UNSET) {
1981 cfg->etag_add &= (~ ETAG_UNSET);
1984 if (cfg->etag_remove != ETAG_UNSET) {
1985 cfg->etag_remove &= (~ ETAG_UNSET);
1989 cfg->etag_bits &= (~ ETAG_UNSET);
1991 if ((cfg->etag_bits & ETAG_NONE) != ETAG_NONE) {
1992 cfg->etag_bits &= (~ ETAG_NONE);
1999 static const char *set_enable_mmap(cmd_parms *cmd, void *d_,
2002 core_dir_config *d = d_;
2004 if (strcasecmp(arg, "on") == 0) {
2005 d->enable_mmap = ENABLE_MMAP_ON;
2007 else if (strcasecmp(arg, "off") == 0) {
2008 d->enable_mmap = ENABLE_MMAP_OFF;
2011 return "parameter must be 'on' or 'off'";
2017 static const char *set_enable_sendfile(cmd_parms *cmd, void *d_,
2020 core_dir_config *d = d_;
2022 if (strcasecmp(arg, "on") == 0) {
2023 d->enable_sendfile = ENABLE_SENDFILE_ON;
2025 else if (strcasecmp(arg, "off") == 0) {
2026 d->enable_sendfile = ENABLE_SENDFILE_OFF;
2029 return "parameter must be 'on' or 'off'";
2037 * Report a missing-'>' syntax error.
2039 static char *unclosed_directive(cmd_parms *cmd)
2041 return apr_pstrcat(cmd->pool, cmd->cmd->name,
2042 "> directive missing closing '>'", NULL);
2046 * Report a missing args in '<Foo >' syntax error.
2048 static char *missing_container_arg(cmd_parms *cmd)
2050 return apr_pstrcat(cmd->pool, cmd->cmd->name,
2051 "> directive requires additional arguments", NULL);
2054 AP_CORE_DECLARE_NONSTD(const char *) ap_limit_section(cmd_parms *cmd,
2058 const char *endp = ap_strrchr_c(arg, '>');
2059 const char *limited_methods;
2060 void *tog = cmd->cmd->cmd_data;
2061 apr_int64_t limited = 0;
2062 apr_int64_t old_limited = cmd->limited;
2066 return unclosed_directive(cmd);
2069 limited_methods = apr_pstrndup(cmd->temp_pool, arg, endp - arg);
2071 if (!limited_methods[0]) {
2072 return missing_container_arg(cmd);
2075 while (limited_methods[0]) {
2076 char *method = ap_getword_conf(cmd->temp_pool, &limited_methods);
2079 /* check for builtin or module registered method number */
2080 methnum = ap_method_number_of(method);
2082 if (methnum == M_TRACE && !tog) {
2083 return "TRACE cannot be controlled by <Limit>, see TraceEnable";
2085 else if (methnum == M_INVALID) {
2086 /* method has not been registered yet, but resorce restriction
2087 * is always checked before method handling, so register it.
2089 methnum = ap_method_register(cmd->pool,
2090 apr_pstrdup(cmd->pool, method));
2093 limited |= (AP_METHOD_BIT << methnum);
2096 /* Killing two features with one function,
2097 * if (tog == NULL) <Limit>, else <LimitExcept>
2099 limited = tog ? ~limited : limited;
2101 if (!(old_limited & limited)) {
2102 return apr_pstrcat(cmd->pool, cmd->cmd->name,
2103 "> directive excludes all methods", NULL);
2105 else if ((old_limited & limited) == old_limited) {
2106 return apr_pstrcat(cmd->pool, cmd->cmd->name,
2107 "> directive specifies methods already excluded",
2111 cmd->limited &= limited;
2113 errmsg = ap_walk_config(cmd->directive->first_child, cmd, cmd->context);
2115 cmd->limited = old_limited;
2120 /* XXX: Bogus - need to do this differently (at least OS2/Netware suffer
2121 * the same problem!!!
2122 * We use this in <DirectoryMatch> and <FilesMatch>, to ensure that
2123 * people don't get bitten by wrong-cased regex matches
2127 #define USE_ICASE AP_REG_ICASE
2132 static const char *dirsection(cmd_parms *cmd, void *mconfig, const char *arg)
2135 const char *endp = ap_strrchr_c(arg, '>');
2136 int old_overrides = cmd->override;
2137 char *old_path = cmd->path;
2138 core_dir_config *conf;
2139 ap_conf_vector_t *new_dir_conf = ap_create_per_dir_config(cmd->pool);
2140 ap_regex_t *r = NULL;
2141 const command_rec *thiscmd = cmd->cmd;
2143 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
2149 return unclosed_directive(cmd);
2152 arg = apr_pstrndup(cmd->temp_pool, arg, endp - arg);
2155 return missing_container_arg(cmd);
2158 cmd->path = ap_getword_conf(cmd->pool, &arg);
2159 cmd->override = OR_ALL|ACCESS_CONF;
2161 if (!strcmp(cmd->path, "~")) {
2162 cmd->path = ap_getword_conf(cmd->pool, &arg);
2164 return "<Directory ~ > block must specify a path";
2165 r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED|USE_ICASE);
2167 return "Regex could not be compiled";
2170 else if (thiscmd->cmd_data) { /* <DirectoryMatch> */
2171 r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED|USE_ICASE);
2173 return "Regex could not be compiled";
2176 else if (!strcmp(cmd->path, "/") == 0)
2181 * Ensure that the pathname is canonical, and append the trailing /
2183 apr_status_t rv = apr_filepath_merge(&newpath, NULL, cmd->path,
2184 APR_FILEPATH_TRUENAME, cmd->pool);
2185 if (rv != APR_SUCCESS && rv != APR_EPATHWILD) {
2186 return apr_pstrcat(cmd->pool, "<Directory \"", cmd->path,
2187 "\"> path is invalid.", NULL);
2190 cmd->path = newpath;
2191 if (cmd->path[strlen(cmd->path) - 1] != '/')
2192 cmd->path = apr_pstrcat(cmd->pool, cmd->path, "/", NULL);
2195 /* initialize our config and fetch it */
2196 conf = ap_set_config_vectors(cmd->server, new_dir_conf, cmd->path,
2197 &core_module, cmd->pool);
2199 errmsg = ap_walk_config(cmd->directive->first_child, cmd, new_dir_conf);
2204 conf->d = cmd->path;
2205 conf->d_is_fnmatch = (apr_fnmatch_test(conf->d) != 0);
2207 /* Make this explicit - the "/" root has 0 elements, that is, we
2208 * will always merge it, and it will always sort and merge first.
2209 * All others are sorted and tested by the number of slashes.
2211 if (strcmp(conf->d, "/") == 0)
2212 conf->d_components = 0;
2214 conf->d_components = ap_count_dirs(conf->d);
2216 ap_add_per_dir_conf(cmd->server, new_dir_conf);
2219 return apr_pstrcat(cmd->pool, "Multiple ", thiscmd->name,
2220 "> arguments not (yet) supported.", NULL);
2223 cmd->path = old_path;
2224 cmd->override = old_overrides;
2229 static const char *urlsection(cmd_parms *cmd, void *mconfig, const char *arg)
2232 const char *endp = ap_strrchr_c(arg, '>');
2233 int old_overrides = cmd->override;
2234 char *old_path = cmd->path;
2235 core_dir_config *conf;
2236 ap_regex_t *r = NULL;
2237 const command_rec *thiscmd = cmd->cmd;
2238 ap_conf_vector_t *new_url_conf = ap_create_per_dir_config(cmd->pool);
2239 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
2245 return unclosed_directive(cmd);
2248 arg = apr_pstrndup(cmd->temp_pool, arg, endp - arg);
2251 return missing_container_arg(cmd);
2254 cmd->path = ap_getword_conf(cmd->pool, &arg);
2255 cmd->override = OR_ALL|ACCESS_CONF;
2257 if (thiscmd->cmd_data) { /* <LocationMatch> */
2258 r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED);
2260 return "Regex could not be compiled";
2263 else if (!strcmp(cmd->path, "~")) {
2264 cmd->path = ap_getword_conf(cmd->pool, &arg);
2265 r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED);
2267 return "Regex could not be compiled";
2271 /* initialize our config and fetch it */
2272 conf = ap_set_config_vectors(cmd->server, new_url_conf, cmd->path,
2273 &core_module, cmd->pool);
2275 errmsg = ap_walk_config(cmd->directive->first_child, cmd, new_url_conf);
2279 conf->d = apr_pstrdup(cmd->pool, cmd->path); /* No mangling, please */
2280 conf->d_is_fnmatch = apr_fnmatch_test(conf->d) != 0;
2283 ap_add_per_url_conf(cmd->server, new_url_conf);
2286 return apr_pstrcat(cmd->pool, "Multiple ", thiscmd->name,
2287 "> arguments not (yet) supported.", NULL);
2290 cmd->path = old_path;
2291 cmd->override = old_overrides;
2296 static const char *filesection(cmd_parms *cmd, void *mconfig, const char *arg)
2299 const char *endp = ap_strrchr_c(arg, '>');
2300 int old_overrides = cmd->override;
2301 char *old_path = cmd->path;
2302 core_dir_config *conf;
2303 ap_regex_t *r = NULL;
2304 const command_rec *thiscmd = cmd->cmd;
2305 ap_conf_vector_t *new_file_conf = ap_create_per_dir_config(cmd->pool);
2306 const char *err = ap_check_cmd_context(cmd,
2307 NOT_IN_LOCATION | NOT_IN_LIMIT);
2314 return unclosed_directive(cmd);
2317 arg = apr_pstrndup(cmd->temp_pool, arg, endp - arg);
2320 return missing_container_arg(cmd);
2323 cmd->path = ap_getword_conf(cmd->pool, &arg);
2324 /* Only if not an .htaccess file */
2326 cmd->override = OR_ALL|ACCESS_CONF;
2329 if (thiscmd->cmd_data) { /* <FilesMatch> */
2330 r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED|USE_ICASE);
2332 return "Regex could not be compiled";
2335 else if (!strcmp(cmd->path, "~")) {
2336 cmd->path = ap_getword_conf(cmd->pool, &arg);
2337 r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED|USE_ICASE);
2339 return "Regex could not be compiled";
2344 /* Ensure that the pathname is canonical, but we
2345 * can't test the case/aliases without a fixed path */
2346 if (apr_filepath_merge(&newpath, "", cmd->path,
2347 0, cmd->pool) != APR_SUCCESS)
2348 return apr_pstrcat(cmd->pool, "<Files \"", cmd->path,
2349 "\"> is invalid.", NULL);
2350 cmd->path = newpath;
2353 /* initialize our config and fetch it */
2354 conf = ap_set_config_vectors(cmd->server, new_file_conf, cmd->path,
2355 &core_module, cmd->pool);
2357 errmsg = ap_walk_config(cmd->directive->first_child, cmd, new_file_conf);
2361 conf->d = cmd->path;
2362 conf->d_is_fnmatch = apr_fnmatch_test(conf->d) != 0;
2365 ap_add_file_conf(cmd->pool, (core_dir_config *)mconfig, new_file_conf);
2368 return apr_pstrcat(cmd->pool, "Multiple ", thiscmd->name,
2369 "> arguments not (yet) supported.", NULL);
2372 cmd->path = old_path;
2373 cmd->override = old_overrides;
2378 #define COND_IF ((void *)1)
2379 #define COND_ELSE ((void *)2)
2380 #define COND_ELSEIF ((void *)3)
2382 static const char *ifsection(cmd_parms *cmd, void *mconfig, const char *arg)
2385 const char *endp = ap_strrchr_c(arg, '>');
2386 int old_overrides = cmd->override;
2387 char *old_path = cmd->path;
2388 core_dir_config *conf;
2389 const command_rec *thiscmd = cmd->cmd;
2390 ap_conf_vector_t *new_if_conf = ap_create_per_dir_config(cmd->pool);
2391 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
2392 const char *condition;
2393 const char *expr_err;
2400 return unclosed_directive(cmd);
2403 arg = apr_pstrndup(cmd->temp_pool, arg, endp - arg);
2406 * Set a dummy value so that other directives notice that they are inside
2410 /* Only if not an .htaccess file */
2412 cmd->override = OR_ALL|ACCESS_CONF;
2415 /* initialize our config and fetch it */
2416 conf = ap_set_config_vectors(cmd->server, new_if_conf, cmd->path,
2417 &core_module, cmd->pool);
2419 if (cmd->cmd->cmd_data == COND_IF)
2420 conf->condition_ifelse = AP_CONDITION_IF;
2421 else if (cmd->cmd->cmd_data == COND_ELSEIF)
2422 conf->condition_ifelse = AP_CONDITION_ELSEIF;
2423 else if (cmd->cmd->cmd_data == COND_ELSE)
2424 conf->condition_ifelse = AP_CONDITION_ELSE;
2428 if (conf->condition_ifelse == AP_CONDITION_ELSE) {
2430 return "<Else> does not take an argument";
2434 return missing_container_arg(cmd);
2435 condition = ap_getword_conf(cmd->pool, &arg);
2436 conf->condition = ap_expr_parse_cmd(cmd, condition, 0, &expr_err, NULL);
2438 return apr_psprintf(cmd->pool, "Cannot parse condition clause: %s",
2442 errmsg = ap_walk_config(cmd->directive->first_child, cmd, new_if_conf);
2446 conf->d = cmd->path;
2447 conf->d_is_fnmatch = 0;
2450 errmsg = ap_add_if_conf(cmd->pool, (core_dir_config *)mconfig, new_if_conf);
2455 return apr_pstrcat(cmd->pool, "Multiple ", thiscmd->name,
2456 "> arguments not supported.", NULL);
2459 cmd->path = old_path;
2460 cmd->override = old_overrides;
2465 static module *find_module(server_rec *s, const char *name)
2467 module *found = ap_find_linked_module(name);
2469 /* search prelinked stuff */
2471 ap_module_symbol_t *current = ap_prelinked_module_symbols;
2473 for (; current->name; ++current) {
2474 if (!strcmp(current->name, name)) {
2475 found = current->modp;
2481 /* search dynamic stuff */
2483 APR_OPTIONAL_FN_TYPE(ap_find_loaded_module_symbol) *check_symbol =
2484 APR_RETRIEVE_OPTIONAL_FN(ap_find_loaded_module_symbol);
2488 * There are two phases where calling ap_find_loaded_module_symbol
2491 * During reading of the config, ap_server_conf is invalid but s
2492 * points to the main server config, if passed from cmd->server
2493 * of an EXEC_ON_READ directive.
2495 * During config parsing, s may be a virtual host that would cause
2496 * a segfault in mod_so if passed to ap_find_loaded_module_symbol,
2497 * because mod_so's server config for vhosts is initialized later.
2498 * But ap_server_conf is already set at this time.
2500 * Therefore we use s if it is not virtual and ap_server_conf if
2503 found = check_symbol(s->is_virtual ? ap_server_conf : s, name);
2511 static const char *start_ifmod(cmd_parms *cmd, void *mconfig, const char *arg)
2513 const char *endp = ap_strrchr_c(arg, '>');
2514 int not = (arg[0] == '!');
2518 return unclosed_directive(cmd);
2521 arg = apr_pstrndup(cmd->temp_pool, arg, endp - arg);
2528 return missing_container_arg(cmd);
2531 found = find_module(cmd->server, arg);
2533 if ((!not && found) || (not && !found)) {
2534 ap_directive_t *parent = NULL;
2535 ap_directive_t *current = NULL;
2538 retval = ap_build_cont_config(cmd->pool, cmd->temp_pool, cmd,
2539 ¤t, &parent, "<IfModule");
2540 *(ap_directive_t **)mconfig = current;
2544 *(ap_directive_t **)mconfig = NULL;
2545 return ap_soak_end_container(cmd, "<IfModule");
2549 AP_DECLARE(int) ap_exists_config_define(const char *name)
2554 defines = (char **)ap_server_config_defines->elts;
2555 for (i = 0; i < ap_server_config_defines->nelts; i++) {
2556 if (strcmp(defines[i], name) == 0) {
2564 static const char *start_ifdefine(cmd_parms *cmd, void *dummy, const char *arg)
2570 endp = ap_strrchr_c(arg, '>');
2572 return unclosed_directive(cmd);
2575 arg = apr_pstrndup(cmd->temp_pool, arg, endp - arg);
2577 if (arg[0] == '!') {
2583 return missing_container_arg(cmd);
2586 defined = ap_exists_config_define(arg);
2587 if ((!not && defined) || (not && !defined)) {
2588 ap_directive_t *parent = NULL;
2589 ap_directive_t *current = NULL;
2592 retval = ap_build_cont_config(cmd->pool, cmd->temp_pool, cmd,
2593 ¤t, &parent, "<IfDefine");
2594 *(ap_directive_t **)dummy = current;
2598 *(ap_directive_t **)dummy = NULL;
2599 return ap_soak_end_container(cmd, "<IfDefine");
2603 /* httpd.conf commands... beginning with the <VirtualHost> business */
2605 static const char *virtualhost_section(cmd_parms *cmd, void *dummy,
2608 server_rec *main_server = cmd->server, *s;
2610 const char *endp = ap_strrchr_c(arg, '>');
2611 apr_pool_t *p = cmd->pool;
2613 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
2619 return unclosed_directive(cmd);
2622 arg = apr_pstrndup(cmd->temp_pool, arg, endp - arg);
2625 return missing_container_arg(cmd);
2628 /* FIXME: There's another feature waiting to happen here -- since you
2629 can now put multiple addresses/names on a single <VirtualHost>
2630 you might want to use it to group common definitions and then
2631 define other "subhosts" with their individual differences. But
2632 personally I'd rather just do it with a macro preprocessor. -djg */
2633 if (main_server->is_virtual) {
2634 return "<VirtualHost> doesn't nest!";
2637 errmsg = ap_init_virtual_host(p, arg, main_server, &s);
2642 s->next = main_server->next;
2643 main_server->next = s;
2645 s->defn_name = cmd->directive->filename;
2646 s->defn_line_number = cmd->directive->line_num;
2650 errmsg = ap_walk_config(cmd->directive->first_child, cmd,
2651 s->lookup_defaults);
2653 cmd->server = main_server;
2658 static const char *set_server_alias(cmd_parms *cmd, void *dummy,
2661 if (!cmd->server->names) {
2662 return "ServerAlias only used in <VirtualHost>";
2666 char **item, *name = ap_getword_conf(cmd->pool, &arg);
2668 if (ap_is_matchexp(name)) {
2669 item = (char **)apr_array_push(cmd->server->wild_names);
2672 item = (char **)apr_array_push(cmd->server->names);
2681 static const char *set_accf_map(cmd_parms *cmd, void *dummy,
2682 const char *iproto, const char* iaccf)
2684 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
2685 core_server_config *conf =
2686 ap_get_core_module_config(cmd->server->module_config);
2693 proto = apr_pstrdup(cmd->pool, iproto);
2694 ap_str_tolower(proto);
2695 accf = apr_pstrdup(cmd->pool, iaccf);
2696 ap_str_tolower(accf);
2697 apr_table_setn(conf->accf_map, proto, accf);
2702 AP_DECLARE(const char*) ap_get_server_protocol(server_rec* s)
2704 core_server_config *conf = ap_get_core_module_config(s->module_config);
2705 return conf->protocol;
2708 AP_DECLARE(void) ap_set_server_protocol(server_rec* s, const char* proto)
2710 core_server_config *conf = ap_get_core_module_config(s->module_config);
2711 conf->protocol = proto;
2714 static const char *set_protocol(cmd_parms *cmd, void *dummy,
2717 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
2718 core_server_config *conf =
2719 ap_get_core_module_config(cmd->server->module_config);
2726 proto = apr_pstrdup(cmd->pool, arg);
2727 ap_str_tolower(proto);
2728 conf->protocol = proto;
2733 static const char *set_server_string_slot(cmd_parms *cmd, void *dummy,
2736 /* This one's pretty generic... */
2738 int offset = (int)(long)cmd->info;
2739 char *struct_ptr = (char *)cmd->server;
2741 const char *err = ap_check_cmd_context(cmd,
2742 NOT_IN_DIR_LOC_FILE);
2747 *(const char **)(struct_ptr + offset) = arg;
2752 * The ServerName directive takes one argument with format
2753 * [scheme://]fully-qualified-domain-name[:port], for instance
2754 * ServerName www.example.com
2755 * ServerName www.example.com:80
2756 * ServerName https://www.example.com:443
2759 static const char *server_hostname_port(cmd_parms *cmd, void *dummy, const char *arg)
2761 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
2762 const char *portstr, *part;
2770 if (apr_fnmatch_test(arg))
2771 return apr_pstrcat(cmd->temp_pool, "Invalid ServerName \"", arg,
2772 "\" use ServerAlias to set multiple server names.", NULL);
2774 part = ap_strstr_c(arg, "://");
2777 scheme = apr_pstrndup(cmd->pool, arg, part - arg);
2778 ap_str_tolower(scheme);
2779 cmd->server->server_scheme = (const char *)scheme;
2785 portstr = ap_strchr_c(part, ':');
2787 cmd->server->server_hostname = apr_pstrndup(cmd->pool, part,
2790 port = atoi(portstr);
2791 if (port <= 0 || port >= 65536) { /* 65536 == 1<<16 */
2792 return apr_pstrcat(cmd->temp_pool, "The port number \"", arg,
2793 "\" is outside the appropriate range "
2794 "(i.e., 1..65535).", NULL);
2798 cmd->server->server_hostname = apr_pstrdup(cmd->pool, part);
2802 cmd->server->port = port;
2806 static const char *set_signature_flag(cmd_parms *cmd, void *d_,
2809 core_dir_config *d = d_;
2811 if (strcasecmp(arg, "On") == 0) {
2812 d->server_signature = srv_sig_on;
2814 else if (strcasecmp(arg, "Off") == 0) {
2815 d->server_signature = srv_sig_off;
2817 else if (strcasecmp(arg, "EMail") == 0) {
2818 d->server_signature = srv_sig_withmail;
2821 return "ServerSignature: use one of: off | on | email";
2827 static const char *set_server_root(cmd_parms *cmd, void *dummy,
2830 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
2836 if ((apr_filepath_merge((char**)&ap_server_root, NULL, arg,
2837 APR_FILEPATH_TRUENAME, cmd->pool) != APR_SUCCESS)
2838 || !ap_is_directory(cmd->temp_pool, ap_server_root)) {
2839 return "ServerRoot must be a valid directory";
2845 static const char *set_runtime_dir(cmd_parms *cmd, void *dummy, const char *arg)
2847 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
2853 if ((apr_filepath_merge((char**)&ap_runtime_dir, NULL,
2854 ap_server_root_relative(cmd->pool, arg),
2855 APR_FILEPATH_TRUENAME, cmd->pool) != APR_SUCCESS)
2856 || !ap_is_directory(cmd->temp_pool, ap_runtime_dir)) {
2857 return "DefaultRuntimeDir must be a valid directory, absolute or relative to ServerRoot";
2863 static const char *set_timeout(cmd_parms *cmd, void *dummy, const char *arg)
2865 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
2871 cmd->server->timeout = apr_time_from_sec(atoi(arg));
2875 static const char *set_allow2f(cmd_parms *cmd, void *d_, const char *arg)
2877 core_dir_config *d = d_;
2879 if (0 == strcasecmp(arg, "on")) {
2880 d->allow_encoded_slashes = 1;
2881 d->decode_encoded_slashes = 1; /* for compatibility with 2.0 & 2.2 */
2882 } else if (0 == strcasecmp(arg, "off")) {
2883 d->allow_encoded_slashes = 0;
2884 d->decode_encoded_slashes = 0;
2885 } else if (0 == strcasecmp(arg, "nodecode")) {
2886 d->allow_encoded_slashes = 1;
2887 d->decode_encoded_slashes = 0;
2889 return apr_pstrcat(cmd->pool,
2890 cmd->cmd->name, " must be On, Off, or NoDecode",
2896 static const char *set_hostname_lookups(cmd_parms *cmd, void *d_,
2899 core_dir_config *d = d_;
2901 if (!strcasecmp(arg, "on")) {
2902 d->hostname_lookups = HOSTNAME_LOOKUP_ON;
2904 else if (!strcasecmp(arg, "off")) {
2905 d->hostname_lookups = HOSTNAME_LOOKUP_OFF;
2907 else if (!strcasecmp(arg, "double")) {
2908 d->hostname_lookups = HOSTNAME_LOOKUP_DOUBLE;
2911 return "parameter must be 'on', 'off', or 'double'";
2917 static const char *set_serverpath(cmd_parms *cmd, void *dummy,
2920 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
2926 cmd->server->path = arg;
2927 cmd->server->pathlen = (int)strlen(arg);
2931 static const char *set_content_md5(cmd_parms *cmd, void *d_, int arg)
2933 core_dir_config *d = d_;
2935 d->content_md5 = arg ? AP_CONTENT_MD5_ON : AP_CONTENT_MD5_OFF;
2939 static const char *set_accept_path_info(cmd_parms *cmd, void *d_, const char *arg)
2941 core_dir_config *d = d_;
2943 if (strcasecmp(arg, "on") == 0) {
2944 d->accept_path_info = AP_REQ_ACCEPT_PATH_INFO;
2946 else if (strcasecmp(arg, "off") == 0) {
2947 d->accept_path_info = AP_REQ_REJECT_PATH_INFO;
2949 else if (strcasecmp(arg, "default") == 0) {
2950 d->accept_path_info = AP_REQ_DEFAULT_PATH_INFO;
2953 return "AcceptPathInfo must be set to on, off or default";
2959 static const char *set_use_canonical_name(cmd_parms *cmd, void *d_,
2962 core_dir_config *d = d_;
2964 if (strcasecmp(arg, "on") == 0) {
2965 d->use_canonical_name = USE_CANONICAL_NAME_ON;
2967 else if (strcasecmp(arg, "off") == 0) {
2968 d->use_canonical_name = USE_CANONICAL_NAME_OFF;
2970 else if (strcasecmp(arg, "dns") == 0) {
2971 d->use_canonical_name = USE_CANONICAL_NAME_DNS;
2974 return "parameter must be 'on', 'off', or 'dns'";
2980 static const char *set_use_canonical_phys_port(cmd_parms *cmd, void *d_,
2983 core_dir_config *d = d_;
2985 if (strcasecmp(arg, "on") == 0) {
2986 d->use_canonical_phys_port = USE_CANONICAL_PHYS_PORT_ON;
2988 else if (strcasecmp(arg, "off") == 0) {
2989 d->use_canonical_phys_port = USE_CANONICAL_PHYS_PORT_OFF;
2992 return "parameter must be 'on' or 'off'";
2998 static const char *include_config (cmd_parms *cmd, void *dummy,
3001 ap_directive_t *conftree = NULL;
3002 const char *conffile, *error;
3003 unsigned *recursion;
3004 int optional = cmd->cmd->cmd_data ? 1 : 0;
3007 apr_pool_userdata_get(&data, "ap_include_sentinel", cmd->pool);
3012 data = recursion = apr_palloc(cmd->pool, sizeof(*recursion));
3014 apr_pool_userdata_setn(data, "ap_include_sentinel", NULL, cmd->pool);
3017 if (++*recursion > AP_MAX_INCLUDE_DEPTH) {
3019 return apr_psprintf(cmd->pool, "Exceeded maximum include depth of %u, "
3020 "There appears to be a recursion.",
3021 AP_MAX_INCLUDE_DEPTH);
3024 conffile = ap_server_root_relative(cmd->pool, name);
3027 return apr_pstrcat(cmd->pool, "Invalid Include path ",
3031 error = ap_process_fnmatch_configs(cmd->server, conffile, &conftree,
3032 cmd->pool, cmd->temp_pool,
3039 *(ap_directive_t **)dummy = conftree;
3041 /* recursion level done */
3049 static const char *update_loglevel(cmd_parms *cmd, struct ap_logconf *log,
3052 const char *level_str, *err;
3056 level_str = ap_strrchr_c(arg, ':');
3058 if (level_str == NULL) {
3059 err = ap_parse_log_level(arg, &log->level);
3062 ap_reset_module_loglevels(log, APLOG_NO_MODULE);
3063 ap_log_error(APLOG_MARK, APLOG_TRACE3, 0, cmd->server,
3064 "Setting %s for all modules to %s", cmd->cmd->name, arg);
3068 arg = apr_pstrmemdup(cmd->temp_pool, arg, level_str - arg);
3071 return apr_psprintf(cmd->temp_pool, "Module specifier '%s' must be "
3072 "followed by a log level keyword", arg);
3075 err = ap_parse_log_level(level_str, &level);
3077 return apr_psprintf(cmd->temp_pool, "%s:%s: %s", arg, level_str, err);
3079 if ((module = find_module(cmd->server, arg)) == NULL) {
3080 char *name = apr_psprintf(cmd->temp_pool, "%s_module", arg);
3081 ap_log_error(APLOG_MARK, APLOG_TRACE6, 0, cmd->server,
3082 "Cannot find module '%s', trying '%s'", arg, name);
3083 module = find_module(cmd->server, name);
3086 if (module == NULL) {
3087 return apr_psprintf(cmd->temp_pool, "Cannot find module %s", arg);
3090 ap_set_module_loglevel(cmd->pool, log, module->module_index, level);
3091 ap_log_error(APLOG_MARK, APLOG_TRACE3, 0, cmd->server,
3092 "Setting %s for module %s to %s", cmd->cmd->name,
3093 module->name, level_str);
3098 static const char *set_loglevel(cmd_parms *cmd, void *config_, const char *arg)
3100 struct ap_logconf *log;
3103 core_dir_config *dconf = config_;
3105 dconf->log = ap_new_log_config(cmd->pool, NULL);
3110 log = &cmd->server->log;
3114 return "LogLevel requires level keyword or module loglevel specifier";
3116 return update_loglevel(cmd, log, arg);
3119 static const char *set_loglevel_override(cmd_parms *cmd, void *d_, int argc,
3122 core_server_config *sconf;
3123 conn_log_config *entry;
3125 const char *addr, *mask, *err;
3128 return "LogLevelOverride requires at least two arguments";
3130 entry = apr_pcalloc(cmd->pool, sizeof(conn_log_config));
3131 sconf = ap_get_core_module_config(cmd->server->module_config);
3132 if (!sconf->conn_log_level)
3133 sconf->conn_log_level = apr_array_make(cmd->pool, 4, sizeof(entry));
3134 APR_ARRAY_PUSH(sconf->conn_log_level, conn_log_config *) = entry;
3137 mask = ap_strchr_c(addr, '/');
3139 addr = apr_pstrmemdup(cmd->temp_pool, addr, mask - addr);
3142 ret = apr_ipsubnet_create(&entry->subnet, addr, mask, cmd->pool);
3143 if (ret != APR_SUCCESS)
3144 return "parsing of subnet/netmask failed";
3146 for (i = 1; i < argc; i++) {
3147 if ((err = update_loglevel(cmd, &entry->log, argv[i])) != NULL)
3153 AP_DECLARE(const char *) ap_psignature(const char *prefix, request_rec *r)
3156 core_dir_config *conf;
3158 conf = (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
3159 if ((conf->server_signature == srv_sig_off)
3160 || (conf->server_signature == srv_sig_unset)) {
3164 apr_snprintf(sport, sizeof sport, "%u", (unsigned) ap_get_server_port(r));
3166 if (conf->server_signature == srv_sig_withmail) {
3167 return apr_pstrcat(r->pool, prefix, "<address>",
3168 ap_get_server_banner(),
3169 " Server at <a href=\"",
3170 ap_is_url(r->server->server_admin) ? "" : "mailto:",
3171 ap_escape_html(r->pool, r->server->server_admin),
3173 ap_escape_html(r->pool, ap_get_server_name(r)),
3174 "</a> Port ", sport,
3175 "</address>\n", NULL);
3178 return apr_pstrcat(r->pool, prefix, "<address>", ap_get_server_banner(),
3180 ap_escape_html(r->pool, ap_get_server_name(r)),
3182 "</address>\n", NULL);
3186 * Handle a request to include the server's OS platform in the Server
3187 * response header field (the ServerTokens directive). Unfortunately
3188 * this requires a new global in order to communicate the setting back to
3189 * http_main so it can insert the information in the right place in the
3193 static char *server_banner = NULL;
3194 static int banner_locked = 0;
3195 static const char *server_description = NULL;
3197 enum server_token_type {
3198 SrvTk_MAJOR, /* eg: Apache/2 */
3199 SrvTk_MINOR, /* eg. Apache/2.0 */
3200 SrvTk_MINIMAL, /* eg: Apache/2.0.41 */
3201 SrvTk_OS, /* eg: Apache/2.0.41 (UNIX) */
3202 SrvTk_FULL, /* eg: Apache/2.0.41 (UNIX) PHP/4.2.2 FooBar/1.2b */
3203 SrvTk_PRODUCT_ONLY /* eg: Apache */
3205 static enum server_token_type ap_server_tokens = SrvTk_FULL;
3207 static apr_status_t reset_banner(void *dummy)
3210 ap_server_tokens = SrvTk_FULL;
3211 server_banner = NULL;
3212 server_description = NULL;
3216 AP_DECLARE(void) ap_get_server_revision(ap_version_t *version)
3218 version->major = AP_SERVER_MAJORVERSION_NUMBER;
3219 version->minor = AP_SERVER_MINORVERSION_NUMBER;
3220 version->patch = AP_SERVER_PATCHLEVEL_NUMBER;
3221 version->add_string = AP_SERVER_ADD_STRING;
3224 AP_DECLARE(const char *) ap_get_server_description(void)
3226 return server_description ? server_description :
3227 AP_SERVER_BASEVERSION " (" PLATFORM ")";
3230 AP_DECLARE(const char *) ap_get_server_banner(void)
3232 return server_banner ? server_banner : AP_SERVER_BASEVERSION;
3235 AP_DECLARE(void) ap_add_version_component(apr_pool_t *pconf, const char *component)
3237 if (! banner_locked) {
3239 * If the version string is null, register our cleanup to reset the
3240 * pointer on pool destruction. We also know that, if NULL,
3241 * we are adding the original SERVER_BASEVERSION string.
3243 if (server_banner == NULL) {
3244 apr_pool_cleanup_register(pconf, NULL, reset_banner,
3245 apr_pool_cleanup_null);
3246 server_banner = apr_pstrdup(pconf, component);
3250 * Tack the given component identifier to the end of
3251 * the existing string.
3253 server_banner = apr_pstrcat(pconf, server_banner, " ",
3257 server_description = apr_pstrcat(pconf, server_description, " ",
3262 * This routine adds the real server base identity to the banner string,
3263 * and then locks out changes until the next reconfig.
3265 static void set_banner(apr_pool_t *pconf)
3267 if (ap_server_tokens == SrvTk_PRODUCT_ONLY) {
3268 ap_add_version_component(pconf, AP_SERVER_BASEPRODUCT);
3270 else if (ap_server_tokens == SrvTk_MINIMAL) {
3271 ap_add_version_component(pconf, AP_SERVER_BASEVERSION);
3273 else if (ap_server_tokens == SrvTk_MINOR) {
3274 ap_add_version_component(pconf, AP_SERVER_BASEPRODUCT "/" AP_SERVER_MINORREVISION);
3276 else if (ap_server_tokens == SrvTk_MAJOR) {
3277 ap_add_version_component(pconf, AP_SERVER_BASEPRODUCT "/" AP_SERVER_MAJORVERSION);
3280 ap_add_version_component(pconf, AP_SERVER_BASEVERSION " (" PLATFORM ")");
3284 * Lock the server_banner string if we're not displaying
3285 * the full set of tokens
3287 if (ap_server_tokens != SrvTk_FULL) {
3290 server_description = AP_SERVER_BASEVERSION " (" PLATFORM ")";
3293 static const char *set_serv_tokens(cmd_parms *cmd, void *dummy,
3294 const char *arg1, const char *arg2)
3296 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
3302 if (!strcasecmp(arg1, "OS")) {
3303 ap_server_tokens = SrvTk_OS;
3305 else if (!strcasecmp(arg1, "Min") || !strcasecmp(arg1, "Minimal")) {
3306 ap_server_tokens = SrvTk_MINIMAL;
3308 else if (!strcasecmp(arg1, "Major")) {
3309 ap_server_tokens = SrvTk_MAJOR;
3311 else if (!strcasecmp(arg1, "Minor") ) {
3312 ap_server_tokens = SrvTk_MINOR;
3314 else if (!strcasecmp(arg1, "Prod") || !strcasecmp(arg1, "ProductOnly")) {
3315 ap_server_tokens = SrvTk_PRODUCT_ONLY;
3317 else if (!strcasecmp(arg1, "Full")) {
3318 ap_server_tokens = SrvTk_FULL;
3321 return "ServerTokens takes 1 argument, 'Prod', 'Major', 'Minor', 'Min', 'OS', or 'Full'";
3327 static const char *set_limit_req_line(cmd_parms *cmd, void *dummy,
3330 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
3339 return apr_pstrcat(cmd->temp_pool, "LimitRequestLine \"", arg,
3340 "\" must be a non-negative integer", NULL);
3343 cmd->server->limit_req_line = lim;
3347 static const char *set_limit_req_fieldsize(cmd_parms *cmd, void *dummy,
3350 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
3359 return apr_pstrcat(cmd->temp_pool, "LimitRequestFieldsize \"", arg,
3360 "\" must be a non-negative integer",
3364 cmd->server->limit_req_fieldsize = lim;
3368 static const char *set_limit_req_fields(cmd_parms *cmd, void *dummy,
3371 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE);
3380 return apr_pstrcat(cmd->temp_pool, "LimitRequestFields \"", arg,
3381 "\" must be a non-negative integer (0 = no limit)",
3385 cmd->server->limit_req_fields = lim;
3389 static const char *set_limit_req_body(cmd_parms *cmd, void *conf_,
3392 core_dir_config *conf = conf_;
3395 if (APR_SUCCESS != apr_strtoff(&conf->limit_req_body, arg, &errp, 10)) {
3396 return "LimitRequestBody argument is not parsable.";
3398 if (*errp || conf->limit_req_body < 0) {
3399 return "LimitRequestBody requires a non-negative integer.";
3405 static const char *set_limit_xml_req_body(cmd_parms *cmd, void *conf_,
3408 core_dir_config *conf = conf_;
3410 conf->limit_xml_body = atol(arg);
3411 if (conf->limit_xml_body < 0)
3412 return "LimitXMLRequestBody requires a non-negative integer.";
3417 static const char *set_max_ranges(cmd_parms *cmd, void *conf_, const char *arg)
3419 core_dir_config *conf = conf_;
3422 if (!strcasecmp(arg, "none")) {
3423 val = AP_MAXRANGES_NORANGES;
3425 else if (!strcasecmp(arg, "default")) {
3426 val = AP_MAXRANGES_DEFAULT;
3428 else if (!strcasecmp(arg, "unlimited")) {
3429 val = AP_MAXRANGES_UNLIMITED;
3434 return "MaxRanges requires 'none', 'default', 'unlimited' or "
3435 "a positive integer";
3438 conf->max_ranges = val;
3443 static const char *set_max_overlaps(cmd_parms *cmd, void *conf_, const char *arg)
3445 core_dir_config *conf = conf_;
3448 if (!strcasecmp(arg, "none")) {
3449 val = AP_MAXRANGES_NORANGES;
3451 else if (!strcasecmp(arg, "default")) {
3452 val = AP_MAXRANGES_DEFAULT;
3454 else if (!strcasecmp(arg, "unlimited")) {
3455 val = AP_MAXRANGES_UNLIMITED;
3460 return "MaxRangeOverlaps requires 'none', 'default', 'unlimited' or "
3461 "a positive integer";
3464 conf->max_overlaps = val;
3469 static const char *set_max_reversals(cmd_parms *cmd, void *conf_, const char *arg)
3471 core_dir_config *conf = conf_;
3474 if (!strcasecmp(arg, "none")) {
3475 val = AP_MAXRANGES_NORANGES;
3477 else if (!strcasecmp(arg, "default")) {
3478 val = AP_MAXRANGES_DEFAULT;
3480 else if (!strcasecmp(arg, "unlimited")) {
3481 val = AP_MAXRANGES_UNLIMITED;
3486 return "MaxRangeReversals requires 'none', 'default', 'unlimited' or "
3487 "a positive integer";
3490 conf->max_reversals = val;
3495 AP_DECLARE(apr_size_t) ap_get_limit_xml_body(const request_rec *r)
3497 core_dir_config *conf;
3499 conf = ap_get_core_module_config(r->per_dir_config);
3500 if (conf->limit_xml_body == AP_LIMIT_UNSET)
3501 return AP_DEFAULT_LIMIT_XML_BODY;
3503 return (apr_size_t)conf->limit_xml_body;
3506 #if !defined (RLIMIT_CPU) || !(defined (RLIMIT_DATA) || defined (RLIMIT_VMEM) || defined(RLIMIT_AS)) || !defined (RLIMIT_NPROC)
3507 static const char *no_set_limit(cmd_parms *cmd, void *conf_,
3508 const char *arg, const char *arg2)
3510 ap_log_error(APLOG_MARK, APLOG_ERR, 0, cmd->server, APLOGNO(00118)
3511 "%s not supported on this platform", cmd->cmd->name);
3518 static const char *set_limit_cpu(cmd_parms *cmd, void *conf_,
3519 const char *arg, const char *arg2)
3521 core_dir_config *conf = conf_;
3523 ap_unixd_set_rlimit(cmd, &conf->limit_cpu, arg, arg2, RLIMIT_CPU);
3528 #if defined (RLIMIT_DATA) || defined (RLIMIT_VMEM) || defined(RLIMIT_AS)
3529 static const char *set_limit_mem(cmd_parms *cmd, void *conf_,
3530 const char *arg, const char * arg2)
3532 core_dir_config *conf = conf_;
3534 #if defined(RLIMIT_AS)
3535 ap_unixd_set_rlimit(cmd, &conf->limit_mem, arg, arg2 ,RLIMIT_AS);
3536 #elif defined(RLIMIT_DATA)
3537 ap_unixd_set_rlimit(cmd, &conf->limit_mem, arg, arg2, RLIMIT_DATA);
3538 #elif defined(RLIMIT_VMEM)
3539 ap_unixd_set_rlimit(cmd, &conf->limit_mem, arg, arg2, RLIMIT_VMEM);
3547 static const char *set_limit_nproc(cmd_parms *cmd, void *conf_,
3548 const char *arg, const char * arg2)
3550 core_dir_config *conf = conf_;
3552 ap_unixd_set_rlimit(cmd, &conf->limit_nproc, arg, arg2, RLIMIT_NPROC);
3557 static const char *set_recursion_limit(cmd_parms *cmd, void *dummy,
3558 const char *arg1, const char *arg2)
3560 core_server_config *conf =
3561 ap_get_core_module_config(cmd->server->module_config);
3562 int limit = atoi(arg1);
3565 return "The recursion limit must be greater than zero.";
3568 ap_log_error(APLOG_MARK, APLOG_WARNING, 0, cmd->server, APLOGNO(00119)
3569 "Limiting internal redirects to very low numbers may "
3570 "cause normal requests to fail.");
3573 conf->redirect_limit = limit;
3579 return "The recursion limit must be greater than zero.";
3582 ap_log_error(APLOG_MARK, APLOG_WARNING, 0, cmd->server, APLOGNO(00120)
3583 "Limiting the subrequest depth to a very low level may"
3584 " cause normal requests to fail.");
3588 conf->subreq_limit = limit;
3593 static void log_backtrace(const request_rec *r)
3595 const request_rec *top = r;
3597 ap_log_rerror(APLOG_MARK, APLOG_DEBUG, 0, r, APLOGNO(00121)
3598 "r->uri = %s", r->uri ? r->uri : "(unexpectedly NULL)");
3600 while (top && (top->prev || top->main)) {
3603 ap_log_rerror(APLOG_MARK, APLOG_DEBUG, 0, r, APLOGNO(00122)
3604 "redirected from r->uri = %s",
3605 top->uri ? top->uri : "(unexpectedly NULL)");
3608 if (!top->prev && top->main) {
3610 ap_log_rerror(APLOG_MARK, APLOG_DEBUG, 0, r, APLOGNO(00123)
3611 "subrequested from r->uri = %s",
3612 top->uri ? top->uri : "(unexpectedly NULL)");
3618 * check whether redirect limit is reached
3620 AP_DECLARE(int) ap_is_recursion_limit_exceeded(const request_rec *r)
3622 core_server_config *conf =
3623 ap_get_core_module_config(r->server->module_config);
3624 const request_rec *top = r;
3625 int redirects = 0, subreqs = 0;
3626 int rlimit = conf->redirect_limit
3627 ? conf->redirect_limit
3628 : AP_DEFAULT_MAX_INTERNAL_REDIRECTS;
3629 int slimit = conf->subreq_limit
3630 ? conf->subreq_limit
3631 : AP_DEFAULT_MAX_SUBREQ_DEPTH;
3634 while (top->prev || top->main) {
3636 if (++redirects >= rlimit) {
3637 /* uuh, too much. */
3638 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(00124)
3639 "Request exceeded the limit of %d internal "
3640 "redirects due to probable configuration error. "
3641 "Use 'LimitInternalRecursion' to increase the "
3642 "limit if necessary. Use 'LogLevel debug' to get "
3643 "a backtrace.", rlimit);
3645 /* post backtrace */
3648 /* return failure */
3655 if (!top->prev && top->main) {
3656 if (++subreqs >= slimit) {
3657 /* uuh, too much. */
3658 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(00125)
3659 "Request exceeded the limit of %d subrequest "
3660 "nesting levels due to probable configuration "
3661 "error. Use 'LimitInternalRecursion' to increase "
3662 "the limit if necessary. Use 'LogLevel debug' to "
3663 "get a backtrace.", slimit);
3665 /* post backtrace */
3668 /* return failure */
3676 /* recursion state: ok */
3680 static const char *set_trace_enable(cmd_parms *cmd, void *dummy,
3683 core_server_config *conf =
3684 ap_get_core_module_config(cmd->server->module_config);
3686 if (strcasecmp(arg1, "on") == 0) {
3687 conf->trace_enable = AP_TRACE_ENABLE;
3689 else if (strcasecmp(arg1, "off") == 0) {
3690 conf->trace_enable = AP_TRACE_DISABLE;
3692 else if (strcasecmp(arg1, "extended") == 0) {
3693 conf->trace_enable = AP_TRACE_EXTENDED;
3696 return "TraceEnable must be one of 'on', 'off', or 'extended'";
3702 static const char *set_http_protocol(cmd_parms *cmd, void *dummy,
3705 core_server_config *conf =
3706 ap_get_core_module_config(cmd->server->module_config);
3708 if (strncmp(arg, "min=", 4) == 0) {
3710 if (strcmp(arg, "0.9") == 0)
3711 conf->http09_enable = AP_HTTP09_ENABLE;
3712 else if (strcmp(arg, "1.0") == 0)
3713 conf->http09_enable = AP_HTTP09_DISABLE;
3715 return "HttpProtocol min must be one of '0.9' and '1.0'";
3718 return "HttpProtocol must be min=0.9|1.0";
3721 static const char *set_http_method(cmd_parms *cmd, void *conf, const char *arg)
3723 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
3726 ap_method_register(cmd->pool, arg);
3730 static apr_hash_t *errorlog_hash;
3732 static int log_constant_item(const ap_errorlog_info *info, const char *arg,
3733 char *buf, int buflen)
3735 char *end = apr_cpystrn(buf, arg, buflen);
3739 static char *parse_errorlog_misc_string(apr_pool_t *p,
3740 ap_errorlog_format_item *it,
3744 char scratch[MAX_STRING_LEN];
3747 * non-leading white space terminates this string to allow the next field
3748 * separator to be inserted
3752 it->func = log_constant_item;
3755 while (*s && *s != '%' && (*s != ' ' || at_start) && d < scratch + MAX_STRING_LEN) {
3778 /* handle end of string */
3782 /* copy next char verbatim */
3789 it->arg = apr_pstrdup(p, scratch);
3795 static char *parse_errorlog_item(apr_pool_t *p, ap_errorlog_format_item *it,
3798 const char *s = *sa;
3799 ap_errorlog_handler *handler;
3804 it->flags |= AP_ERRORLOG_FLAG_FIELD_SEP;
3806 return parse_errorlog_misc_string(p, it, sa);
3812 /* percent-space (% ) is a field separator */
3813 it->flags |= AP_ERRORLOG_FLAG_FIELD_SEP;
3816 return parse_errorlog_item(p, it, sa);
3818 else if (*s == '%') {
3820 it->func = log_constant_item;
3829 it->arg = ap_getword(p, &s, '}');
3833 it->flags |= AP_ERRORLOG_FLAG_REQUIRED;
3837 it->flags |= AP_ERRORLOG_FLAG_NULL_AS_HYPHEN;
3850 while (apr_isdigit(*++s))
3851 i = i * 10 + (*s) - '0';
3852 it->min_loglevel = i;
3856 it->flags |= AP_ERRORLOG_FLAG_MESSAGE;
3860 handler = (ap_errorlog_handler *)apr_hash_get(errorlog_hash, s, 1);
3866 return apr_pstrcat(p, "Unrecognized error log format directive %",
3869 it->func = handler->func;
3875 return "Ran off end of error log format parsing args to some directive";
3878 static apr_array_header_t *parse_errorlog_string(apr_pool_t *p,
3883 apr_array_header_t *a = apr_array_make(p, 30,
3884 sizeof(ap_errorlog_format_item));
3886 int seen_msg_fmt = 0;
3889 ap_errorlog_format_item *item =
3890 (ap_errorlog_format_item *)apr_array_push(a);
3891 memset(item, 0, sizeof(*item));
3892 res = parse_errorlog_item(p, item, &s);
3897 if (item->flags & AP_ERRORLOG_FLAG_MESSAGE) {
3899 *err = "%M cannot be used in once-per-request or "
3900 "once-per-connection formats";
3905 if (is_main_fmt && item->flags & AP_ERRORLOG_FLAG_REQUIRED) {
3906 *err = "The '+' flag cannot be used in the main error log format";
3909 if (!is_main_fmt && item->min_loglevel) {
3910 *err = "The loglevel cannot be used as a condition in "
3911 "once-per-request or once-per-connection formats";
3914 if (item->min_loglevel > APLOG_TRACE8) {
3915 *err = "The specified loglevel modifier is out of range";
3920 if (is_main_fmt && !seen_msg_fmt) {
3921 *err = "main ErrorLogFormat must contain message format string '%M'";
3928 static const char *set_errorlog_format(cmd_parms *cmd, void *dummy,
3929 const char *arg1, const char *arg2)
3931 const char *err_string = NULL;
3932 core_server_config *conf =
3933 ap_get_core_module_config(cmd->server->module_config);
3936 conf->error_log_format = parse_errorlog_string(cmd->pool, arg1,
3939 else if (!strcasecmp(arg1, "connection")) {
3940 if (!conf->error_log_conn) {
3941 conf->error_log_conn = apr_array_make(cmd->pool, 5,
3942 sizeof(apr_array_header_t *));
3946 apr_array_header_t **e;
3947 e = (apr_array_header_t **) apr_array_push(conf->error_log_conn);
3948 *e = parse_errorlog_string(cmd->pool, arg2, &err_string, 0);
3951 else if (!strcasecmp(arg1, "request")) {
3952 if (!conf->error_log_req) {
3953 conf->error_log_req = apr_array_make(cmd->pool, 5,
3954 sizeof(apr_array_header_t *));
3958 apr_array_header_t **e;
3959 e = (apr_array_header_t **) apr_array_push(conf->error_log_req);
3960 *e = parse_errorlog_string(cmd->pool, arg2, &err_string, 0);
3964 err_string = "ErrorLogFormat type must be one of request, connection";
3970 AP_DECLARE(void) ap_register_errorlog_handler(apr_pool_t *p, char *tag,
3971 ap_errorlog_handler_fn_t *handler,
3974 ap_errorlog_handler *log_struct = apr_palloc(p, sizeof(*log_struct));
3975 log_struct->func = handler;
3976 log_struct->flags = flags;
3978 apr_hash_set(errorlog_hash, tag, 1, (const void *)log_struct);
3982 /* Note --- ErrorDocument will now work from .htaccess files.
3983 * The AllowOverride of Fileinfo allows webmasters to turn it off
3986 static const command_rec core_cmds[] = {
3988 /* Old access config file commands */
3990 AP_INIT_RAW_ARGS("<Directory", dirsection, NULL, RSRC_CONF,
3991 "Container for directives affecting resources located in the specified "
3993 AP_INIT_RAW_ARGS("<Location", urlsection, NULL, RSRC_CONF,
3994 "Container for directives affecting resources accessed through the "
3995 "specified URL paths"),
3996 AP_INIT_RAW_ARGS("<VirtualHost", virtualhost_section, NULL, RSRC_CONF,
3997 "Container to map directives to a particular virtual host, takes one or "
3998 "more host addresses"),
3999 AP_INIT_RAW_ARGS("<Files", filesection, NULL, OR_ALL,
4000 "Container for directives affecting files matching specified patterns"),
4001 AP_INIT_RAW_ARGS("<Limit", ap_limit_section, NULL, OR_LIMIT | OR_AUTHCFG,
4002 "Container for authentication directives when accessed using specified HTTP "
4004 AP_INIT_RAW_ARGS("<LimitExcept", ap_limit_section, (void*)1,
4005 OR_LIMIT | OR_AUTHCFG,
4006 "Container for authentication directives to be applied when any HTTP "
4007 "method other than those specified is used to access the resource"),
4008 AP_INIT_TAKE1("<IfModule", start_ifmod, NULL, EXEC_ON_READ | OR_ALL,
4009 "Container for directives based on existence of specified modules"),
4010 AP_INIT_TAKE1("<IfDefine", start_ifdefine, NULL, EXEC_ON_READ | OR_ALL,
4011 "Container for directives based on existence of command line defines"),
4012 AP_INIT_RAW_ARGS("<DirectoryMatch", dirsection, (void*)1, RSRC_CONF,
4013 "Container for directives affecting resources located in the "
4014 "specified directories"),
4015 AP_INIT_RAW_ARGS("<LocationMatch", urlsection, (void*)1, RSRC_CONF,
4016 "Container for directives affecting resources accessed through the "
4017 "specified URL paths"),
4018 AP_INIT_RAW_ARGS("<FilesMatch", filesection, (void*)1, OR_ALL,
4019 "Container for directives affecting files matching specified patterns"),
4021 AP_INIT_TAKE1("GprofDir", set_gprof_dir, NULL, RSRC_CONF,
4022 "Directory to plop gmon.out files"),
4024 AP_INIT_TAKE1("AddDefaultCharset", set_add_default_charset, NULL, OR_FILEINFO,
4025 "The name of the default charset to add to any Content-Type without one or 'Off' to disable"),
4026 AP_INIT_TAKE1("AcceptPathInfo", set_accept_path_info, NULL, OR_FILEINFO,
4027 "Set to on or off for PATH_INFO to be accepted by handlers, or default for the per-handler preference"),
4028 AP_INIT_TAKE12("Define", set_define, NULL, EXEC_ON_READ|ACCESS_CONF|RSRC_CONF,
4029 "Define a variable, optionally to a value. Same as passing -D to the command line."),
4030 AP_INIT_TAKE1("UnDefine", unset_define, NULL, EXEC_ON_READ|ACCESS_CONF|RSRC_CONF,
4031 "Undefine the existence of a variable. Undo a Define."),
4032 AP_INIT_RAW_ARGS("Error", generate_message, (void*) APLOG_ERR, OR_ALL,
4033 "Generate error message from within configuration."),
4034 AP_INIT_RAW_ARGS("Warning", generate_message, (void*) APLOG_WARNING, OR_ALL,
4035 "Generate warning message from within configuration."),
4036 AP_INIT_RAW_ARGS("<If", ifsection, COND_IF, OR_ALL,
4037 "Container for directives to be conditionally applied"),
4038 AP_INIT_RAW_ARGS("<ElseIf", ifsection, COND_ELSEIF, OR_ALL,
4039 "Container for directives to be conditionally applied"),
4040 AP_INIT_RAW_ARGS("<Else", ifsection, COND_ELSE, OR_ALL,
4041 "Container for directives to be conditionally applied"),
4043 /* Old resource config file commands */
4045 AP_INIT_RAW_ARGS("AccessFileName", set_access_name, NULL, RSRC_CONF,
4046 "Name(s) of per-directory config files (default: .htaccess)"),
4047 AP_INIT_TAKE1("DocumentRoot", set_document_root, NULL, RSRC_CONF,
4048 "Root directory of the document tree"),
4049 AP_INIT_TAKE2("ErrorDocument", set_error_document, NULL, OR_FILEINFO,
4050 "Change responses for HTTP errors"),
4051 AP_INIT_RAW_ARGS("AllowOverride", set_override, NULL, ACCESS_CONF,
4052 "Controls what groups of directives can be configured by per-directory "
4054 AP_INIT_TAKE_ARGV("AllowOverrideList", set_override_list, NULL, ACCESS_CONF,
4055 "Controls what individual directives can be configured by per-directory "
4057 AP_INIT_RAW_ARGS("Options", set_options, NULL, OR_OPTIONS,
4058 "Set a number of attributes for a given directory"),
4059 AP_INIT_TAKE1("DefaultType", set_default_type, NULL, OR_FILEINFO,
4060 "the default media type for otherwise untyped files (DEPRECATED)"),
4061 AP_INIT_RAW_ARGS("FileETag", set_etag_bits, NULL, OR_FILEINFO,
4062 "Specify components used to construct a file's ETag"),
4063 AP_INIT_TAKE1("EnableMMAP", set_enable_mmap, NULL, OR_FILEINFO,
4064 "Controls whether memory-mapping may be used to read files"),
4065 AP_INIT_TAKE1("EnableSendfile", set_enable_sendfile, NULL, OR_FILEINFO,
4066 "Controls whether sendfile may be used to transmit files"),
4068 /* Old server config file commands */
4070 AP_INIT_TAKE1("Protocol", set_protocol, NULL, RSRC_CONF,
4071 "Set the Protocol for httpd to use."),
4072 AP_INIT_TAKE2("AcceptFilter", set_accf_map, NULL, RSRC_CONF,
4073 "Set the Accept Filter to use for a protocol"),
4074 AP_INIT_TAKE1("Port", ap_set_deprecated, NULL, RSRC_CONF,
4075 "Port was replaced with Listen in Apache 2.0"),
4076 AP_INIT_TAKE1("HostnameLookups", set_hostname_lookups, NULL,
4077 ACCESS_CONF|RSRC_CONF,
4078 "\"on\" to enable, \"off\" to disable reverse DNS lookups, or \"double\" to "
4079 "enable double-reverse DNS lookups"),
4080 AP_INIT_TAKE1("ServerAdmin", set_server_string_slot,
4081 (void *)APR_OFFSETOF(server_rec, server_admin), RSRC_CONF,
4082 "The email address of the server administrator"),
4083 AP_INIT_TAKE1("ServerName", server_hostname_port, NULL, RSRC_CONF,
4084 "The hostname and port of the server"),
4085 AP_INIT_TAKE1("ServerSignature", set_signature_flag, NULL, OR_ALL,
4086 "En-/disable server signature (on|off|email)"),
4087 AP_INIT_TAKE1("ServerRoot", set_server_root, NULL, RSRC_CONF | EXEC_ON_READ,
4088 "Common directory of server-related files (logs, confs, etc.)"),
4089 AP_INIT_TAKE1("DefaultRuntimeDir", set_runtime_dir, NULL, RSRC_CONF | EXEC_ON_READ,
4090 "Common directory for run-time files (shared memory, locks, etc.)"),
4091 AP_INIT_TAKE1("ErrorLog", set_server_string_slot,
4092 (void *)APR_OFFSETOF(server_rec, error_fname), RSRC_CONF,
4093 "The filename of the error log"),
4094 AP_INIT_TAKE12("ErrorLogFormat", set_errorlog_format, NULL, RSRC_CONF,
4095 "Format string for the ErrorLog"),
4096 AP_INIT_RAW_ARGS("ServerAlias", set_server_alias, NULL, RSRC_CONF,
4097 "A name or names alternately used to access the server"),
4098 AP_INIT_TAKE1("ServerPath", set_serverpath, NULL, RSRC_CONF,
4099 "The pathname the server can be reached at"),
4100 AP_INIT_TAKE1("Timeout", set_timeout, NULL, RSRC_CONF,
4101 "Timeout duration (sec)"),
4102 AP_INIT_FLAG("ContentDigest", set_content_md5, NULL, OR_OPTIONS,
4103 "whether or not to send a Content-MD5 header with each request"),
4104 AP_INIT_TAKE1("UseCanonicalName", set_use_canonical_name, NULL,
4105 RSRC_CONF|ACCESS_CONF,
4106 "How to work out the ServerName : Port when constructing URLs"),
4107 AP_INIT_TAKE1("UseCanonicalPhysicalPort", set_use_canonical_phys_port, NULL,
4108 RSRC_CONF|ACCESS_CONF,
4109 "Whether to use the physical Port when constructing URLs"),
4110 /* TODO: RlimitFoo should all be part of mod_cgi, not in the core */
4111 /* TODO: ListenBacklog in MPM */
4112 AP_INIT_TAKE1("Include", include_config, NULL,
4113 (RSRC_CONF | ACCESS_CONF | EXEC_ON_READ),
4114 "Name(s) of the config file(s) to be included; fails if the wildcard does "
4115 "not match at least one file"),
4116 AP_INIT_TAKE1("IncludeOptional", include_config, (void*)1,
4117 (RSRC_CONF | ACCESS_CONF | EXEC_ON_READ),
4118 "Name or pattern of the config file(s) to be included; ignored if the file "
4119 "does not exist or the pattern does not match any files"),
4120 AP_INIT_ITERATE("LogLevel", set_loglevel, NULL, RSRC_CONF|ACCESS_CONF,
4121 "Level of verbosity in error logging"),
4122 AP_INIT_TAKE_ARGV("LogLevelOverride", set_loglevel_override, NULL, RSRC_CONF,
4123 "Override LogLevel for clients with certain IPs"),
4124 AP_INIT_TAKE1("NameVirtualHost", ap_set_name_virtual_host, NULL, RSRC_CONF,
4125 "A numeric IP address:port, or the name of a host"),
4126 AP_INIT_TAKE12("ServerTokens", set_serv_tokens, NULL, RSRC_CONF,
4127 "Determine tokens displayed in the Server: header - Min(imal), "
4128 "Major, Minor, Prod, OS or Full"),
4129 AP_INIT_TAKE1("LimitRequestLine", set_limit_req_line, NULL, RSRC_CONF,
4130 "Limit on maximum size of an HTTP request line"),
4131 AP_INIT_TAKE1("LimitRequestFieldsize", set_limit_req_fieldsize, NULL,
4133 "Limit on maximum size of an HTTP request header field"),
4134 AP_INIT_TAKE1("LimitRequestFields", set_limit_req_fields, NULL, RSRC_CONF,
4135 "Limit (0 = unlimited) on max number of header fields in a request message"),
4136 AP_INIT_TAKE1("LimitRequestBody", set_limit_req_body,
4137 (void*)APR_OFFSETOF(core_dir_config, limit_req_body), OR_ALL,
4138 "Limit (in bytes) on maximum size of request message body"),
4139 AP_INIT_TAKE1("LimitXMLRequestBody", set_limit_xml_req_body, NULL, OR_ALL,
4140 "Limit (in bytes) on maximum size of an XML-based request "
4142 AP_INIT_RAW_ARGS("Mutex", ap_set_mutex, NULL, RSRC_CONF,
4143 "mutex (or \"default\") and mechanism"),
4145 AP_INIT_TAKE1("MaxRanges", set_max_ranges, NULL, RSRC_CONF|ACCESS_CONF,
4146 "Maximum number of Ranges in a request before returning the entire "
4147 "resource, or 0 for unlimited"),
4148 AP_INIT_TAKE1("MaxRangeOverlaps", set_max_overlaps, NULL, RSRC_CONF|ACCESS_CONF,
4149 "Maximum number of overlaps in Ranges in a request before returning the entire "
4150 "resource, or 0 for unlimited"),
4151 AP_INIT_TAKE1("MaxRangeReversals", set_max_reversals, NULL, RSRC_CONF|ACCESS_CONF,
4152 "Maximum number of reversals in Ranges in a request before returning the entire "
4153 "resource, or 0 for unlimited"),
4154 /* System Resource Controls */
4156 AP_INIT_TAKE12("RLimitCPU", set_limit_cpu,
4157 (void*)APR_OFFSETOF(core_dir_config, limit_cpu),
4158 OR_ALL, "Soft/hard limits for max CPU usage in seconds"),
4160 AP_INIT_TAKE12("RLimitCPU", no_set_limit, NULL,
4161 OR_ALL, "Soft/hard limits for max CPU usage in seconds"),
4163 #if defined (RLIMIT_DATA) || defined (RLIMIT_VMEM) || defined (RLIMIT_AS)
4164 AP_INIT_TAKE12("RLimitMEM", set_limit_mem,
4165 (void*)APR_OFFSETOF(core_dir_config, limit_mem),
4166 OR_ALL, "Soft/hard limits for max memory usage per process"),
4168 AP_INIT_TAKE12("RLimitMEM", no_set_limit, NULL,
4169 OR_ALL, "Soft/hard limits for max memory usage per process"),
4172 AP_INIT_TAKE12("RLimitNPROC", set_limit_nproc,
4173 (void*)APR_OFFSETOF(core_dir_config, limit_nproc),
4174 OR_ALL, "soft/hard limits for max number of processes per uid"),
4176 AP_INIT_TAKE12("RLimitNPROC", no_set_limit, NULL,
4177 OR_ALL, "soft/hard limits for max number of processes per uid"),
4180 /* internal recursion stopper */
4181 AP_INIT_TAKE12("LimitInternalRecursion", set_recursion_limit, NULL, RSRC_CONF,
4182 "maximum recursion depth of internal redirects and subrequests"),
4184 AP_INIT_TAKE1("ForceType", ap_set_string_slot_lower,
4185 (void *)APR_OFFSETOF(core_dir_config, mime_type), OR_FILEINFO,
4186 "a mime type that overrides other configured type"),
4187 AP_INIT_TAKE1("SetHandler", ap_set_string_slot_lower,
4188 (void *)APR_OFFSETOF(core_dir_config, handler), OR_FILEINFO,
4189 "a handler name that overrides any other configured handler"),
4190 AP_INIT_TAKE1("SetOutputFilter", ap_set_string_slot,
4191 (void *)APR_OFFSETOF(core_dir_config, output_filters), OR_FILEINFO,
4192 "filter (or ; delimited list of filters) to be run on the request content"),
4193 AP_INIT_TAKE1("SetInputFilter", ap_set_string_slot,
4194 (void *)APR_OFFSETOF(core_dir_config, input_filters), OR_FILEINFO,
4195 "filter (or ; delimited list of filters) to be run on the request body"),
4196 AP_INIT_TAKE1("AllowEncodedSlashes", set_allow2f, NULL, RSRC_CONF,
4197 "Allow URLs containing '/' encoded as '%2F'"),
4199 /* scoreboard.c directives */
4200 AP_INIT_TAKE1("ScoreBoardFile", ap_set_scoreboard, NULL, RSRC_CONF,
4201 "A file for Apache to maintain runtime process management information"),
4202 AP_INIT_FLAG("ExtendedStatus", ap_set_extended_status, NULL, RSRC_CONF,
4203 "\"On\" to track extended status information, \"Off\" to disable"),
4204 AP_INIT_FLAG("SeeRequestTail", ap_set_reqtail, NULL, RSRC_CONF,
4205 "For extended status, \"On\" to see the last 63 chars of "
4206 "the request line, \"Off\" (default) to see the first 63"),
4209 * These are default configuration directives that mpms can/should
4211 * XXX These are not for all platforms, and even some Unix MPMs might not want
4214 AP_INIT_TAKE1("PidFile", ap_mpm_set_pidfile, NULL, RSRC_CONF,
4215 "A file for logging the server process ID"),
4216 AP_INIT_TAKE1("MaxRequestsPerChild", ap_mpm_set_max_requests, NULL, RSRC_CONF,
4217 "Maximum number of connections a particular child serves before "
4218 "dying. (DEPRECATED, use MaxConnectionsPerChild)"),
4219 AP_INIT_TAKE1("MaxConnectionsPerChild", ap_mpm_set_max_requests, NULL, RSRC_CONF,
4220 "Maximum number of connections a particular child serves before dying."),
4221 AP_INIT_TAKE1("CoreDumpDirectory", ap_mpm_set_coredumpdir, NULL, RSRC_CONF,
4222 "The location of the directory Apache changes to before dumping core"),
4223 AP_INIT_TAKE1("MaxMemFree", ap_mpm_set_max_mem_free, NULL, RSRC_CONF,
4224 "Maximum number of 1k blocks a particular child's allocator may hold."),
4225 AP_INIT_TAKE1("ThreadStackSize", ap_mpm_set_thread_stacksize, NULL, RSRC_CONF,
4226 "Size in bytes of stack used by threads handling client connections"),
4227 #if AP_ENABLE_EXCEPTION_HOOK
4228 AP_INIT_TAKE1("EnableExceptionHook", ap_mpm_set_exception_hook, NULL, RSRC_CONF,
4229 "Controls whether exception hook may be called after a crash"),
4231 AP_INIT_TAKE1("TraceEnable", set_trace_enable, NULL, RSRC_CONF,
4232 "'on' (default), 'off' or 'extended' to trace request body content"),
4233 AP_INIT_TAKE1("HttpProtocol", set_http_protocol, NULL, RSRC_CONF,
4234 "'min=0.9' (default) or 'min=1.0' to allow/deny HTTP/0.9"),
4235 AP_INIT_ITERATE("RegisterHttpMethod", set_http_method, NULL, RSRC_CONF,
4236 "Registers non-standard HTTP methods"),
4240 /*****************************************************************
4242 * Core handlers for various phases of server operation...
4245 AP_DECLARE_NONSTD(int) ap_core_translate(request_rec *r)
4250 /* XXX this seems too specific, this should probably become
4251 * some general-case test
4254 return HTTP_FORBIDDEN;
4256 if (!r->uri || ((r->uri[0] != '/') && strcmp(r->uri, "*"))) {
4257 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(00126)
4258 "Invalid URI in request %s", r->the_request);
4259 return HTTP_BAD_REQUEST;
4263 && !strncmp(r->uri, r->server->path, r->server->pathlen)
4264 && (r->server->path[r->server->pathlen - 1] == '/'
4265 || r->uri[r->server->pathlen] == '/'
4266 || r->uri[r->server->pathlen] == '\0'))
4268 path = r->uri + r->server->pathlen;
4274 * Make sure that we do not mess up the translation by adding two
4275 * /'s in a row. This happens under windows when the document
4276 * root ends with a /
4278 /* skip all leading /'s (e.g. http://localhost///foo)
4279 * so we are looking at only the relative path.
4281 while (*path == '/') {
4284 if ((rv = apr_filepath_merge(&r->filename, ap_document_root(r), path,
4285 APR_FILEPATH_TRUENAME
4286 | APR_FILEPATH_SECUREROOT, r->pool))
4288 ap_log_rerror(APLOG_MARK, APLOG_ERR, rv, r, APLOGNO(00127)
4289 "Cannot map %s to file", r->the_request);
4290 return HTTP_FORBIDDEN;
4292 r->canonical_filename = r->filename;
4297 /*****************************************************************
4299 * Test the filesystem name through directory_walk and file_walk
4301 static int core_map_to_storage(request_rec *r)
4305 if ((access_status = ap_directory_walk(r))) {
4306 return access_status;
4309 if ((access_status = ap_file_walk(r))) {
4310 return access_status;
4317 static int do_nothing(request_rec *r) { return OK; }
4320 static int core_override_type(request_rec *r)
4322 core_dir_config *conf =
4323 (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
4325 /* Check for overrides with ForceType / SetHandler
4327 if (conf->mime_type && strcmp(conf->mime_type, "none"))
4328 ap_set_content_type(r, (char*) conf->mime_type);
4330 if (conf->handler && strcmp(conf->handler, "none"))
4331 r->handler = conf->handler;
4333 /* Deal with the poor soul who is trying to force path_info to be
4334 * accepted within the core_handler, where they will let the subreq
4335 * address its contents. This is toggled by the user in the very
4336 * beginning of the fixup phase (here!), so modules should override the user's
4337 * discretion in their own module fixup phase. It is tristate, if
4338 * the user doesn't specify, the result is AP_REQ_DEFAULT_PATH_INFO.
4339 * (which the module may interpret to its own customary behavior.)
4340 * It won't be touched if the value is no longer AP_ACCEPT_PATHINFO_UNSET,
4341 * so any module changing the value prior to the fixup phase
4342 * OVERRIDES the user's choice.
4344 if ((r->used_path_info == AP_REQ_DEFAULT_PATH_INFO)
4345 && (conf->accept_path_info != AP_ACCEPT_PATHINFO_UNSET)) {
4346 /* No module knew better, and the user coded AcceptPathInfo */
4347 r->used_path_info = conf->accept_path_info;
4353 static int default_handler(request_rec *r)
4355 conn_rec *c = r->connection;
4356 apr_bucket_brigade *bb;
4360 apr_file_t *fd = NULL;
4361 apr_status_t status;
4362 /* XXX if/when somebody writes a content-md5 filter we either need to
4363 * remove this support or coordinate when to use the filter vs.
4364 * when to use this code
4365 * The current choice of when to compute the md5 here matches the 1.3
4366 * support fairly closely (unlike 1.3, we don't handle computing md5
4367 * when the charset is translated).
4369 int bld_content_md5;
4371 d = (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
4372 bld_content_md5 = (d->content_md5 == AP_CONTENT_MD5_ON)
4373 && r->output_filters->frec->ftype != AP_FTYPE_RESOURCE;
4375 ap_allow_standard_methods(r, MERGE_ALLOW, M_GET, M_OPTIONS, M_POST, -1);
4377 /* If filters intend to consume the request body, they must
4378 * register an InputFilter to slurp the contents of the POST
4379 * data from the POST input stream. It no longer exists when
4380 * the output filters are invoked by the default handler.
4382 if ((errstatus = ap_discard_request_body(r)) != OK) {
4386 if (r->method_number == M_GET || r->method_number == M_POST) {
4387 if (r->finfo.filetype == APR_NOFILE) {
4388 ap_log_rerror(APLOG_MARK, APLOG_INFO, 0, r, APLOGNO(00128)
4389 "File does not exist: %s", r->filename);
4390 return HTTP_NOT_FOUND;
4393 /* Don't try to serve a dir. Some OSs do weird things with
4396 if (r->finfo.filetype == APR_DIR) {
4397 ap_log_rerror(APLOG_MARK, APLOG_INFO, 0, r, APLOGNO(00129)
4398 "Attempt to serve directory: %s", r->filename);
4399 return HTTP_NOT_FOUND;
4402 if ((r->used_path_info != AP_REQ_ACCEPT_PATH_INFO) &&
4403 r->path_info && *r->path_info)
4405 /* default to reject */
4406 ap_log_rerror(APLOG_MARK, APLOG_INFO, 0, r, APLOGNO(00130)
4407 "File does not exist: %s",
4408 apr_pstrcat(r->pool, r->filename, r->path_info, NULL));
4409 return HTTP_NOT_FOUND;
4412 /* We understood the (non-GET) method, but it might not be legal for
4413 this particular resource. Check to see if the 'deliver_script'
4414 flag is set. If so, then we go ahead and deliver the file since
4415 it isn't really content (only GET normally returns content).
4417 Note: based on logic further above, the only possible non-GET
4418 method at this point is POST. In the future, we should enable
4419 script delivery for all methods. */
4420 if (r->method_number != M_GET) {
4421 core_request_config *req_cfg;
4423 req_cfg = ap_get_core_module_config(r->request_config);
4424 if (!req_cfg->deliver_script) {
4425 /* The flag hasn't been set for this request. Punt. */
4426 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(00131)
4427 "This resource does not accept the %s method.",
4429 return HTTP_METHOD_NOT_ALLOWED;
4434 if ((status = apr_file_open(&fd, r->filename, APR_READ | APR_BINARY
4435 #if APR_HAS_SENDFILE
4436 | AP_SENDFILE_ENABLED(d->enable_sendfile)
4438 , 0, r->pool)) != APR_SUCCESS) {
4439 ap_log_rerror(APLOG_MARK, APLOG_ERR, status, r, APLOGNO(00132)
4440 "file permissions deny server access: %s", r->filename);
4441 return HTTP_FORBIDDEN;
4444 ap_update_mtime(r, r->finfo.mtime);
4445 ap_set_last_modified(r);
4447 ap_set_accept_ranges(r);
4448 ap_set_content_length(r, r->finfo.size);
4449 if (bld_content_md5) {
4450 apr_table_setn(r->headers_out, "Content-MD5",
4451 ap_md5digest(r->pool, fd));
4454 bb = apr_brigade_create(r->pool, c->bucket_alloc);
4456 if ((errstatus = ap_meets_conditions(r)) != OK) {
4458 r->status = errstatus;
4461 e = apr_brigade_insert_file(bb, fd, 0, r->finfo.size, r->pool);
4464 if (d->enable_mmap == ENABLE_MMAP_OFF) {
4465 (void)apr_bucket_file_enable_mmap(e, 0);
4470 e = apr_bucket_eos_create(c->bucket_alloc);
4471 APR_BRIGADE_INSERT_TAIL(bb, e);
4473 status = ap_pass_brigade(r->output_filters, bb);
4474 if (status == APR_SUCCESS
4475 || r->status != HTTP_OK
4480 /* no way to know what type of error occurred */
4481 ap_log_rerror(APLOG_MARK, APLOG_DEBUG, status, r, APLOGNO(00133)
4482 "default_handler: ap_pass_brigade returned %i",
4484 return HTTP_INTERNAL_SERVER_ERROR;
4487 else { /* unusual method (not GET or POST) */
4488 if (r->method_number == M_INVALID) {
4489 /* See if this looks like an undecrypted SSL handshake attempt.
4490 * It's safe to look a couple bytes into the_request if it exists, as it's
4491 * always allocated at least MIN_LINE_ALLOC (80) bytes.
4494 && r->the_request[0] == 0x16
4495 && (r->the_request[1] == 0x2 || r->the_request[1] == 0x3)) {
4496 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(00134)
4497 "Invalid method in request %s - possible attempt to establish SSL connection on non-SSL port", r->the_request);
4499 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(00135)
4500 "Invalid method in request %s", r->the_request);
4502 return HTTP_NOT_IMPLEMENTED;
4505 if (r->method_number == M_OPTIONS) {
4506 return ap_send_http_options(r);
4508 return HTTP_METHOD_NOT_ALLOWED;
4512 /* Optional function coming from mod_logio, used for logging of output
4515 APR_OPTIONAL_FN_TYPE(ap_logio_add_bytes_out) *ap__logio_add_bytes_out;
4516 APR_OPTIONAL_FN_TYPE(authz_some_auth_required) *ap__authz_ap_some_auth_required;
4518 /* Insist that at least one module will undertake to provide system
4519 * security by dropping startup privileges.
4521 static int sys_privileges = 0;
4522 AP_DECLARE(int) ap_sys_privileges_handlers(int inc)
4524 sys_privileges += inc;
4525 return sys_privileges;
4528 static int check_errorlog_dir(apr_pool_t *p, server_rec *s)
4530 if (!s->error_fname || s->error_fname[0] == '|'
4531 || strcmp(s->error_fname, "syslog") == 0) {
4535 char *abs = ap_server_root_relative(p, s->error_fname);
4536 char *dir = ap_make_dirstr_parent(p, abs);
4538 apr_status_t rv = apr_stat(&finfo, dir, APR_FINFO_TYPE, p);
4539 if (rv == APR_SUCCESS && finfo.filetype != APR_DIR)
4541 if (rv != APR_SUCCESS) {
4542 const char *desc = "main error log";
4544 desc = apr_psprintf(p, "error log of vhost defined at %s:%d",
4545 s->defn_name, s->defn_line_number);
4546 ap_log_error(APLOG_MARK, APLOG_STARTUP|APLOG_EMERG, rv,
4547 ap_server_conf, APLOGNO(02291)
4548 "Cannot access directory '%s' for %s", dir, desc);
4555 static int core_check_config(apr_pool_t *pconf, apr_pool_t *plog, apr_pool_t *ptemp, server_rec *s)
4559 if (check_errorlog_dir(ptemp, s) != OK)
4567 static int core_pre_config(apr_pool_t *pconf, apr_pool_t *plog, apr_pool_t *ptemp)
4569 ap_mutex_init(pconf);
4571 if (!saved_server_config_defines)
4572 init_config_defines(pconf);
4573 apr_pool_cleanup_register(pconf, NULL, reset_config_defines,
4574 apr_pool_cleanup_null);
4576 mpm_common_pre_config(pconf);
4581 static int core_post_config(apr_pool_t *pconf, apr_pool_t *plog, apr_pool_t *ptemp, server_rec *s)
4583 ap__logio_add_bytes_out = APR_RETRIEVE_OPTIONAL_FN(ap_logio_add_bytes_out);
4584 ident_lookup = APR_RETRIEVE_OPTIONAL_FN(ap_ident_lookup);
4585 ap__authz_ap_some_auth_required = APR_RETRIEVE_OPTIONAL_FN(authz_some_auth_required);
4586 authn_ap_auth_type = APR_RETRIEVE_OPTIONAL_FN(authn_ap_auth_type);
4587 authn_ap_auth_name = APR_RETRIEVE_OPTIONAL_FN(authn_ap_auth_name);
4588 access_compat_ap_satisfies = APR_RETRIEVE_OPTIONAL_FN(access_compat_ap_satisfies);
4591 ap_setup_make_content_type(pconf);
4592 ap_setup_auth_internal(ptemp);
4593 if (!sys_privileges) {
4594 ap_log_error(APLOG_MARK, APLOG_CRIT, 0, NULL, APLOGNO(00136)
4595 "Server MUST relinquish startup privileges before "
4596 "accepting connections. Please ensure mod_unixd "
4597 "or other system security module is loaded.");
4600 apr_pool_cleanup_register(pconf, NULL, ap_mpm_end_gen_helper,
4601 apr_pool_cleanup_null);
4605 static void core_insert_filter(request_rec *r)
4607 core_dir_config *conf = (core_dir_config *)
4608 ap_get_core_module_config(r->per_dir_config);
4609 const char *filter, *filters = conf->output_filters;
4612 while (*filters && (filter = ap_getword(r->pool, &filters, ';'))) {
4613 ap_add_output_filter(filter, NULL, r, r->connection);
4617 filters = conf->input_filters;
4619 while (*filters && (filter = ap_getword(r->pool, &filters, ';'))) {
4620 ap_add_input_filter(filter, NULL, r, r->connection);
4625 static apr_size_t num_request_notes = AP_NUM_STD_NOTES;
4627 static apr_status_t reset_request_notes(void *dummy)
4629 num_request_notes = AP_NUM_STD_NOTES;
4633 AP_DECLARE(apr_size_t) ap_register_request_note(void)
4635 apr_pool_cleanup_register(apr_hook_global_pool, NULL, reset_request_notes,
4636 apr_pool_cleanup_null);
4637 return num_request_notes++;
4640 AP_DECLARE(void **) ap_get_request_note(request_rec *r, apr_size_t note_num)
4642 core_request_config *req_cfg;
4644 if (note_num >= num_request_notes) {
4648 req_cfg = (core_request_config *)
4649 ap_get_core_module_config(r->request_config);
4655 return &(req_cfg->notes[note_num]);
4658 AP_DECLARE(apr_socket_t *) ap_get_conn_socket(conn_rec *c)
4660 return ap_get_core_module_config(c->conn_config);
4663 static int core_create_req(request_rec *r)
4665 /* Alloc the config struct and the array of request notes in
4666 * a single block for efficiency
4668 core_request_config *req_cfg;
4670 req_cfg = apr_pcalloc(r->pool, sizeof(core_request_config) +
4671 sizeof(void *) * num_request_notes);
4672 req_cfg->notes = (void **)((char *)req_cfg + sizeof(core_request_config));
4674 /* ### temporarily enable script delivery as the default */
4675 req_cfg->deliver_script = 1;
4678 core_request_config *main_req_cfg = (core_request_config *)
4679 ap_get_core_module_config(r->main->request_config);
4680 req_cfg->bb = main_req_cfg->bb;
4683 req_cfg->bb = apr_brigade_create(r->pool, r->connection->bucket_alloc);
4686 ap_set_core_module_config(r->request_config, req_cfg);
4691 static int core_create_proxy_req(request_rec *r, request_rec *pr)
4693 return core_create_req(pr);
4696 static conn_rec *core_create_conn(apr_pool_t *ptrans, server_rec *s,
4697 apr_socket_t *csd, long id, void *sbh,
4698 apr_bucket_alloc_t *alloc)
4701 conn_rec *c = (conn_rec *) apr_pcalloc(ptrans, sizeof(conn_rec));
4702 core_server_config *sconf = ap_get_core_module_config(s->module_config);
4705 (void)ap_update_child_status(c->sbh, SERVER_BUSY_READ, (request_rec *)NULL);
4707 /* Got a connection structure, so initialize what fields we can
4708 * (the rest are zeroed out by pcalloc).
4710 c->conn_config = ap_create_conn_config(ptrans);
4711 c->notes = apr_table_make(ptrans, 5);
4714 if ((rv = apr_socket_addr_get(&c->local_addr, APR_LOCAL, csd))
4716 ap_log_error(APLOG_MARK, APLOG_INFO, rv, s, APLOGNO(00137)
4717 "apr_socket_addr_get(APR_LOCAL)");
4718 apr_socket_close(csd);
4722 apr_sockaddr_ip_get(&c->local_ip, c->local_addr);
4723 if ((rv = apr_socket_addr_get(&c->client_addr, APR_REMOTE, csd))
4725 ap_log_error(APLOG_MARK, APLOG_INFO, rv, s, APLOGNO(00138)
4726 "apr_socket_addr_get(APR_REMOTE)");
4727 apr_socket_close(csd);
4731 apr_sockaddr_ip_get(&c->client_ip, c->client_addr);
4735 c->bucket_alloc = alloc;
4737 c->clogging_input_filters = 0;
4739 if (sconf->conn_log_level) {
4741 conn_log_config *conf;
4742 const struct ap_logconf *log = NULL;
4743 struct ap_logconf *merged;
4745 for (i = 0; i < sconf->conn_log_level->nelts; i++) {
4746 conf = APR_ARRAY_IDX(sconf->conn_log_level, i, conn_log_config *);
4747 if (apr_ipsubnet_test(conf->subnet, c->client_addr))
4751 merged = ap_new_log_config(c->pool, log);
4752 ap_merge_log_config(&s->log, merged);
4760 static int core_pre_connection(conn_rec *c, void *csd)
4762 core_net_rec *net = apr_palloc(c->pool, sizeof(*net));
4765 /* The Nagle algorithm says that we should delay sending partial
4766 * packets in hopes of getting more data. We don't want to do
4767 * this; we are not telnet. There are bad interactions between
4768 * persistent connections and Nagle's algorithm that have very severe
4769 * performance penalties. (Failing to disable Nagle is not much of a
4770 * problem with simple HTTP.)
4772 rv = apr_socket_opt_set(csd, APR_TCP_NODELAY, 1);
4773 if (rv != APR_SUCCESS && rv != APR_ENOTIMPL) {
4774 /* expected cause is that the client disconnected already,
4775 * hence the debug level
4777 ap_log_cerror(APLOG_MARK, APLOG_DEBUG, rv, c, APLOGNO(00139)
4778 "apr_socket_opt_set(APR_TCP_NODELAY)");
4781 /* The core filter requires the timeout mode to be set, which
4782 * incidentally sets the socket to be nonblocking. If this
4783 * is not initialized correctly, Linux - for example - will
4784 * be initially blocking, while Solaris will be non blocking
4785 * and any initial read will fail.
4787 rv = apr_socket_timeout_set(csd, c->base_server->timeout);
4788 if (rv != APR_SUCCESS) {
4789 /* expected cause is that the client disconnected already */
4790 ap_log_cerror(APLOG_MARK, APLOG_DEBUG, rv, c, APLOGNO(00140)
4791 "apr_socket_timeout_set");
4796 net->out_ctx = NULL;
4797 net->client_socket = csd;
4799 ap_set_core_module_config(net->c->conn_config, csd);
4800 ap_add_input_filter_handle(ap_core_input_filter_handle, net, NULL, net->c);
4801 ap_add_output_filter_handle(ap_core_output_filter_handle, net, NULL, net->c);
4805 AP_DECLARE(int) ap_state_query(int query)
4808 case AP_SQ_MAIN_STATE:
4809 return ap_main_state;
4810 case AP_SQ_RUN_MODE:
4812 case AP_SQ_CONFIG_GEN:
4813 return ap_config_generation;
4815 return AP_SQ_NOT_SUPPORTED;
4819 static apr_random_t *rng = NULL;
4821 static apr_thread_mutex_t *rng_mutex = NULL;
4824 static void core_child_init(apr_pool_t *pchild, server_rec *s)
4829 if (ap_mpm_query(AP_MPMQ_IS_THREADED, &threaded_mpm) == APR_SUCCESS
4832 apr_thread_mutex_create(&rng_mutex, APR_THREAD_MUTEX_DEFAULT, pchild);
4835 /* The MPMs use plain fork() and not apr_proc_fork(), so we have to call
4836 * apr_random_after_fork() manually in the child
4838 proc.pid = getpid();
4839 apr_random_after_fork(&proc);
4842 AP_CORE_DECLARE(void) ap_random_parent_after_fork(void)
4845 * To ensure that the RNG state in the parent changes after the fork, we
4846 * pull some data from the RNG and discard it. This ensures that the RNG
4847 * states in the children are different even after the pid wraps around.
4848 * As we only use apr_random for insecure random bytes, pulling 2 bytes
4850 * XXX: APR should probably have some dedicated API to do this, but it
4851 * XXX: currently doesn't.
4854 apr_random_insecure_bytes(rng, &data, sizeof(data));
4857 AP_CORE_DECLARE(void) ap_init_rng(apr_pool_t *p)
4859 unsigned char seed[8];
4861 rng = apr_random_standard_new(p);
4863 rv = apr_generate_random_bytes(seed, sizeof(seed));
4864 if (rv != APR_SUCCESS)
4866 apr_random_add_entropy(rng, seed, sizeof(seed));
4867 rv = apr_random_insecure_ready(rng);
4868 } while (rv == APR_ENOTENOUGHENTROPY);
4869 if (rv == APR_SUCCESS)
4872 ap_log_error(APLOG_MARK, APLOG_CRIT, rv, NULL, APLOGNO(00141)
4873 "Could not initialize random number generator");
4877 AP_DECLARE(void) ap_random_insecure_bytes(void *buf, apr_size_t size)
4881 apr_thread_mutex_lock(rng_mutex);
4883 /* apr_random_insecure_bytes can only fail with APR_ENOTENOUGHENTROPY,
4884 * and we have ruled that out during initialization. Therefore we don't
4885 * need to check the return code.
4887 apr_random_insecure_bytes(rng, buf, size);
4890 apr_thread_mutex_unlock(rng_mutex);
4895 * Finding a random number in a range.
4896 * n' = a + n(b-a+1)/(M+1)
4898 * n' = random number in range
4899 * a = low end of range
4900 * b = high end of range
4901 * n = random number of 0..M
4903 * Algorithm 'borrowed' from PHP's rand() function.
4905 #define RAND_RANGE(__n, __min, __max, __tmax) \
4906 (__n) = (__min) + (long) ((double) ((__max) - (__min) + 1.0) * ((__n) / ((__tmax) + 1.0)))
4907 AP_DECLARE(apr_uint32_t) ap_random_pick(apr_uint32_t min, apr_uint32_t max)
4909 apr_uint32_t number;
4912 ap_random_insecure_bytes(&num16, sizeof(num16));
4913 RAND_RANGE(num16, min, max, APR_UINT16_MAX);
4917 ap_random_insecure_bytes(&number, sizeof(number));
4918 RAND_RANGE(number, min, max, APR_UINT32_MAX);
4923 static apr_status_t core_insert_network_bucket(conn_rec *c,
4924 apr_bucket_brigade *bb,
4925 apr_socket_t *socket)
4927 apr_bucket *e = apr_bucket_socket_create(socket, c->bucket_alloc);
4928 APR_BRIGADE_INSERT_TAIL(bb, e);
4932 static apr_status_t core_dirwalk_stat(apr_finfo_t *finfo, request_rec *r,
4935 return apr_stat(finfo, r->filename, wanted, r->pool);
4938 static void core_dump_config(apr_pool_t *p, server_rec *s)
4940 core_server_config *sconf = ap_get_core_module_config(s->module_config);
4941 apr_file_t *out = NULL;
4943 const char **defines;
4945 if (!ap_exists_config_define("DUMP_RUN_CFG"))
4948 apr_file_open_stdout(&out, p);
4949 apr_file_printf(out, "ServerRoot: \"%s\"\n", ap_server_root);
4950 tmp = ap_server_root_relative(p, sconf->ap_document_root);
4951 apr_file_printf(out, "Main DocumentRoot: \"%s\"\n", tmp);
4952 if (s->error_fname[0] != '|' && strcmp(s->error_fname, "syslog") != 0)
4953 tmp = ap_server_root_relative(p, s->error_fname);
4955 tmp = s->error_fname;
4956 apr_file_printf(out, "Main ErrorLog: \"%s\"\n", tmp);
4957 if (ap_scoreboard_fname) {
4958 tmp = ap_runtime_dir_relative(p, ap_scoreboard_fname);
4959 apr_file_printf(out, "ScoreBoardFile: \"%s\"\n", tmp);
4961 ap_dump_mutexes(p, s, out);
4962 ap_mpm_dump_pidfile(p, out);
4964 defines = (const char **)ap_server_config_defines->elts;
4965 for (i = 0; i < ap_server_config_defines->nelts; i++) {
4966 const char *name = defines[i];
4967 const char *val = NULL;
4968 if (server_config_defined_vars)
4969 val = apr_table_get(server_config_defined_vars, name);
4971 apr_file_printf(out, "Define: %s=%s\n", name, val);
4973 apr_file_printf(out, "Define: %s\n", name);
4977 static void register_hooks(apr_pool_t *p)
4979 errorlog_hash = apr_hash_make(p);
4980 ap_register_log_hooks(p);
4981 ap_register_config_hooks(p);
4984 /* create_connection and pre_connection should always be hooked
4985 * APR_HOOK_REALLY_LAST by core to give other modules the opportunity
4986 * to install alternate network transports and stop other functions
4989 ap_hook_create_connection(core_create_conn, NULL, NULL,
4990 APR_HOOK_REALLY_LAST);
4991 ap_hook_pre_connection(core_pre_connection, NULL, NULL,
4992 APR_HOOK_REALLY_LAST);
4994 ap_hook_pre_config(core_pre_config, NULL, NULL, APR_HOOK_REALLY_FIRST);
4995 ap_hook_post_config(core_post_config,NULL,NULL,APR_HOOK_REALLY_FIRST);
4996 ap_hook_check_config(core_check_config,NULL,NULL,APR_HOOK_FIRST);
4997 ap_hook_test_config(core_dump_config,NULL,NULL,APR_HOOK_FIRST);
4998 ap_hook_translate_name(ap_core_translate,NULL,NULL,APR_HOOK_REALLY_LAST);
4999 ap_hook_map_to_storage(core_map_to_storage,NULL,NULL,APR_HOOK_REALLY_LAST);
5000 ap_hook_open_logs(ap_open_logs,NULL,NULL,APR_HOOK_REALLY_FIRST);
5001 ap_hook_child_init(core_child_init,NULL,NULL,APR_HOOK_REALLY_FIRST);
5002 ap_hook_child_init(ap_logs_child_init,NULL,NULL,APR_HOOK_MIDDLE);
5003 ap_hook_handler(default_handler,NULL,NULL,APR_HOOK_REALLY_LAST);
5004 /* FIXME: I suspect we can eliminate the need for these do_nothings - Ben */
5005 ap_hook_type_checker(do_nothing,NULL,NULL,APR_HOOK_REALLY_LAST);
5006 ap_hook_fixups(core_override_type,NULL,NULL,APR_HOOK_REALLY_FIRST);
5007 ap_hook_create_request(core_create_req, NULL, NULL, APR_HOOK_MIDDLE);
5008 APR_OPTIONAL_HOOK(proxy, create_req, core_create_proxy_req, NULL, NULL,
5010 ap_hook_pre_mpm(ap_create_scoreboard, NULL, NULL, APR_HOOK_MIDDLE);
5011 ap_hook_child_status(ap_core_child_status, NULL, NULL, APR_HOOK_MIDDLE);
5012 ap_hook_insert_network_bucket(core_insert_network_bucket, NULL, NULL,
5013 APR_HOOK_REALLY_LAST);
5014 ap_hook_dirwalk_stat(core_dirwalk_stat, NULL, NULL, APR_HOOK_REALLY_LAST);
5016 /* register the core's insert_filter hook and register core-provided
5019 ap_hook_insert_filter(core_insert_filter, NULL, NULL, APR_HOOK_MIDDLE);
5021 ap_core_input_filter_handle =
5022 ap_register_input_filter("CORE_IN", ap_core_input_filter,
5023 NULL, AP_FTYPE_NETWORK);
5024 ap_content_length_filter_handle =
5025 ap_register_output_filter("CONTENT_LENGTH", ap_content_length_filter,
5026 NULL, AP_FTYPE_PROTOCOL);
5027 ap_core_output_filter_handle =
5028 ap_register_output_filter("CORE", ap_core_output_filter,
5029 NULL, AP_FTYPE_NETWORK);
5030 ap_subreq_core_filter_handle =
5031 ap_register_output_filter("SUBREQ_CORE", ap_sub_req_output_filter,
5032 NULL, AP_FTYPE_CONTENT_SET);
5034 ap_register_output_filter("OLD_WRITE", ap_old_write_filter,
5035 NULL, AP_FTYPE_RESOURCE - 10);
5038 AP_DECLARE_MODULE(core) = {
5040 AP_PLATFORM_REWRITE_ARGS_HOOK, /* hook to run before apache parses args */
5041 create_core_dir_config, /* create per-directory config structure */
5042 merge_core_dir_configs, /* merge per-directory config structures */
5043 create_core_server_config, /* create per-server config structure */
5044 merge_core_server_configs, /* merge per-server config structures */
5045 core_cmds, /* command apr_table_t */
5046 register_hooks /* register hooks */