1 /* ====================================================================
2 * Copyright (c) 1995-1999 The Apache Group. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in
13 * the documentation and/or other materials provided with the
16 * 3. All advertising materials mentioning features or use of this
17 * software must display the following acknowledgment:
18 * "This product includes software developed by the Apache Group
19 * for use in the Apache HTTP server project (http://www.apache.org/)."
21 * 4. The names "Apache Server" and "Apache Group" must not be used to
22 * endorse or promote products derived from this software without
23 * prior written permission. For written permission, please contact
26 * 5. Products derived from this software may not be called "Apache"
27 * nor may "Apache" appear in their names without prior written
28 * permission of the Apache Group.
30 * 6. Redistributions of any form whatsoever must retain the following
32 * "This product includes software developed by the Apache Group
33 * for use in the Apache HTTP server project (http://www.apache.org/)."
35 * THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY
36 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
38 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE GROUP OR
39 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
41 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
42 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
44 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
45 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
46 * OF THE POSSIBILITY OF SUCH DAMAGE.
47 * ====================================================================
49 * This software consists of voluntary contributions made by many
50 * individuals on behalf of the Apache Group and was originally based
51 * on public domain software written at the National Center for
52 * Supercomputing Applications, University of Illinois, Urbana-Champaign.
53 * For more information on the Apache Group and the Apache HTTP server
54 * project, please see <http://www.apache.org/>.
61 #include "http_config.h"
62 #include "http_core.h"
63 #include "http_protocol.h" /* For index_of_response(). Grump. */
64 #include "http_request.h"
65 #include "http_vhost.h"
66 #include "http_main.h" /* For the default_handler below... */
70 #include "apr_fnmatch.h"
71 #include "http_connection.h"
73 /* Allow Apache to use ap_mmap */
77 /* mmap support for static files based on ideas from John Heidemann's
78 * patch against 1.0.5. See
79 * <http://www.isi.edu/~johnh/SOFTWARE/APACHE/index.html>.
82 /* Files have to be at least this big before they're mmap()d. This is to deal
83 * with systems where the expense of doing an mmap() and an munmap() outweighs
84 * the benefit for small files. It shouldn't be set lower than 1.
86 #ifndef MMAP_THRESHOLD
88 #define MMAP_THRESHOLD (8*1024)
90 #define MMAP_THRESHOLD 1
92 #endif /* MMAP_THRESHOLD */
94 #define MMAP_LIMIT (4*1024*1024)
96 #endif /* USE_MMAP_FILES */
98 /* Server core module... This module provides support for really basic
99 * server operations, including options and commands which control the
100 * operation of other modules. Consider this the bureaucracy module.
102 * The core module also defines handlers, etc., do handle just enough
103 * to allow a server with the core module ONLY to actually serve documents
104 * (though it slaps DefaultType on all of 'em); this was useful in testing,
105 * but may not be worth preserving.
107 * This file could almost be mod_core.c, except for the stuff which affects
108 * the http_conf_globals.
111 static void *create_core_dir_config(ap_context_t *a, char *dir)
113 core_dir_config *conf;
115 conf = (core_dir_config *)ap_pcalloc(a, sizeof(core_dir_config));
116 if (!dir || dir[strlen(dir) - 1] == '/') {
119 else if (strncmp(dir, "proxy:", 6) == 0) {
120 conf->d = ap_pstrdup(a, dir);
123 conf->d = ap_pstrcat(a, dir, "/", NULL);
125 conf->d_is_fnmatch = conf->d ? (ap_is_fnmatch(conf->d) != 0) : 0;
126 conf->d_components = conf->d ? ap_count_dirs(conf->d) : 0;
128 conf->opts = dir ? OPT_UNSET : OPT_UNSET|OPT_ALL;
129 conf->opts_add = conf->opts_remove = OPT_NONE;
130 conf->override = dir ? OR_UNSET : OR_UNSET|OR_ALL;
132 conf->content_md5 = 2;
134 conf->use_canonical_name = USE_CANONICAL_NAME_UNSET;
136 conf->hostname_lookups = HOSTNAME_LOOKUP_UNSET;
137 conf->do_rfc1413 = DEFAULT_RFC1413 | 2; /* set bit 1 to indicate default */
138 conf->satisfy = SATISFY_NOSPEC;
140 conf->limit_req_body = 0;
141 conf->sec = ap_make_array(a, 2, sizeof(void *));
143 conf->script_interpreter_source = INTERPRETER_SOURCE_UNSET;
146 conf->server_signature = srv_sig_unset;
151 static void *merge_core_dir_configs(ap_context_t *a, void *basev, void *newv)
153 core_dir_config *base = (core_dir_config *)basev;
154 core_dir_config *new = (core_dir_config *)newv;
155 core_dir_config *conf;
158 conf = (core_dir_config *)ap_palloc(a, sizeof(core_dir_config));
159 memcpy((char *)conf, (const char *)base, sizeof(core_dir_config));
160 if (base->response_code_strings) {
161 conf->response_code_strings =
162 ap_palloc(a, sizeof(*conf->response_code_strings)
164 memcpy(conf->response_code_strings, base->response_code_strings,
165 sizeof(*conf->response_code_strings) * RESPONSE_CODES);
169 conf->d_is_fnmatch = new->d_is_fnmatch;
170 conf->d_components = new->d_components;
173 if (new->opts & OPT_UNSET) {
174 /* there was no explicit setting of new->opts, so we merge
175 * preserve the invariant (opts_add & opts_remove) == 0
177 conf->opts_add = (conf->opts_add & ~new->opts_remove) | new->opts_add;
178 conf->opts_remove = (conf->opts_remove & ~new->opts_add)
180 conf->opts = (conf->opts & ~conf->opts_remove) | conf->opts_add;
181 if ((base->opts & OPT_INCNOEXEC) && (new->opts & OPT_INCLUDES)) {
182 conf->opts = (conf->opts & ~OPT_INCNOEXEC) | OPT_INCLUDES;
186 /* otherwise we just copy, because an explicit opts setting
187 * overrides all earlier +/- modifiers
189 conf->opts = new->opts;
190 conf->opts_add = new->opts_add;
191 conf->opts_remove = new->opts_remove;
194 if (!(new->override & OR_UNSET)) {
195 conf->override = new->override;
197 if (new->ap_default_type) {
198 conf->ap_default_type = new->ap_default_type;
201 if (new->ap_auth_type) {
202 conf->ap_auth_type = new->ap_auth_type;
204 if (new->ap_auth_name) {
205 conf->ap_auth_name = new->ap_auth_name;
207 if (new->ap_requires) {
208 conf->ap_requires = new->ap_requires;
211 if (new->response_code_strings) {
212 if (conf->response_code_strings == NULL) {
213 conf->response_code_strings = ap_palloc(a,
214 sizeof(*conf->response_code_strings) * RESPONSE_CODES);
215 memcpy(conf->response_code_strings, new->response_code_strings,
216 sizeof(*conf->response_code_strings) * RESPONSE_CODES);
219 for (i = 0; i < RESPONSE_CODES; ++i) {
220 if (new->response_code_strings[i] != NULL) {
221 conf->response_code_strings[i]
222 = new->response_code_strings[i];
227 if (new->hostname_lookups != HOSTNAME_LOOKUP_UNSET) {
228 conf->hostname_lookups = new->hostname_lookups;
230 if ((new->do_rfc1413 & 2) == 0) {
231 conf->do_rfc1413 = new->do_rfc1413;
233 if ((new->content_md5 & 2) == 0) {
234 conf->content_md5 = new->content_md5;
236 if (new->use_canonical_name != USE_CANONICAL_NAME_UNSET) {
237 conf->use_canonical_name = new->use_canonical_name;
240 if (new->limit_req_body) {
241 conf->limit_req_body = new->limit_req_body;
243 conf->sec = ap_append_arrays(a, base->sec, new->sec);
245 if (new->satisfy != SATISFY_NOSPEC) {
246 conf->satisfy = new->satisfy;
250 if (new->script_interpreter_source != INTERPRETER_SOURCE_UNSET) {
251 conf->script_interpreter_source = new->script_interpreter_source;
255 if (new->server_signature != srv_sig_unset) {
256 conf->server_signature = new->server_signature;
262 static void *create_core_server_config(ap_context_t *a, server_rec *s)
264 core_server_config *conf;
265 int is_virtual = s->is_virtual;
267 conf = (core_server_config *)ap_pcalloc(a, sizeof(core_server_config));
269 conf->gprof_dir = NULL;
271 conf->access_name = is_virtual ? NULL : DEFAULT_ACCESS_FNAME;
272 conf->ap_document_root = is_virtual ? NULL : DOCUMENT_LOCATION;
273 conf->sec = ap_make_array(a, 40, sizeof(void *));
274 conf->sec_url = ap_make_array(a, 40, sizeof(void *));
279 static void *merge_core_server_configs(ap_context_t *p, void *basev, void *virtv)
281 core_server_config *base = (core_server_config *)basev;
282 core_server_config *virt = (core_server_config *)virtv;
283 core_server_config *conf;
285 conf = (core_server_config *)ap_pcalloc(p, sizeof(core_server_config));
287 if (!conf->access_name) {
288 conf->access_name = base->access_name;
290 if (!conf->ap_document_root) {
291 conf->ap_document_root = base->ap_document_root;
293 conf->sec = ap_append_arrays(p, base->sec, virt->sec);
294 conf->sec_url = ap_append_arrays(p, base->sec_url, virt->sec_url);
299 /* Add per-directory configuration entry (for <directory> section);
300 * these are part of the core server config.
303 CORE_EXPORT(void) ap_add_per_dir_conf(server_rec *s, void *dir_config)
305 core_server_config *sconf = ap_get_module_config(s->module_config,
307 void **new_space = (void **)ap_push_array(sconf->sec);
309 *new_space = dir_config;
312 CORE_EXPORT(void) ap_add_per_url_conf(server_rec *s, void *url_config)
314 core_server_config *sconf = ap_get_module_config(s->module_config,
316 void **new_space = (void **)ap_push_array(sconf->sec_url);
318 *new_space = url_config;
321 CORE_EXPORT(void) ap_add_file_conf(core_dir_config *conf, void *url_config)
323 void **new_space = (void **)ap_push_array(conf->sec);
325 *new_space = url_config;
328 /* core_reorder_directories reorders the directory sections such that the
329 * 1-component sections come first, then the 2-component, and so on, finally
330 * followed by the "special" sections. A section is "special" if it's a regex,
331 * or if it doesn't start with / -- consider proxy: matching. All movements
332 * are in-order to preserve the ordering of the sections from the config files.
333 * See directory_walk().
336 #ifdef HAVE_DRIVE_LETTERS
337 #define IS_SPECIAL(entry_core) \
338 ((entry_core)->r != NULL \
339 || ((entry_core)->d[0] != '/' && (entry_core)->d[1] != ':'))
341 #define IS_SPECIAL(entry_core) \
342 ((entry_core)->r != NULL || (entry_core)->d[0] != '/')
345 /* We need to do a stable sort, qsort isn't stable. So to make it stable
346 * we'll be maintaining the original index into the list, and using it
347 * as the minor key during sorting. The major key is the number of
348 * components (where a "special" section has infinite components).
350 struct reorder_sort_rec {
355 static int reorder_sorter(const void *va, const void *vb)
357 const struct reorder_sort_rec *a = va;
358 const struct reorder_sort_rec *b = vb;
359 core_dir_config *core_a;
360 core_dir_config *core_b;
362 core_a = (core_dir_config *)ap_get_module_config(a->elt, &core_module);
363 core_b = (core_dir_config *)ap_get_module_config(b->elt, &core_module);
364 if (IS_SPECIAL(core_a)) {
365 if (!IS_SPECIAL(core_b)) {
369 else if (IS_SPECIAL(core_b)) {
373 /* we know they're both not special */
374 if (core_a->d_components < core_b->d_components) {
377 else if (core_a->d_components > core_b->d_components) {
381 /* Either they're both special, or they're both not special and have the
382 * same number of components. In any event, we now have to compare
384 return a->orig_index - b->orig_index;
387 void ap_core_reorder_directories(ap_context_t *p, server_rec *s)
389 core_server_config *sconf;
390 ap_array_header_t *sec;
391 struct reorder_sort_rec *sortbin;
397 sconf = ap_get_module_config(s->module_config, &core_module);
400 elts = (void **)sec->elts;
402 /* we have to allocate tmp space to do a stable sort */
403 ap_create_context(&tmp, p);
404 sortbin = ap_palloc(tmp, sec->nelts * sizeof(*sortbin));
405 for (i = 0; i < nelts; ++i) {
406 sortbin[i].orig_index = i;
407 sortbin[i].elt = elts[i];
410 qsort(sortbin, nelts, sizeof(*sortbin), reorder_sorter);
412 /* and now copy back to the original array */
413 for (i = 0; i < nelts; ++i) {
414 elts[i] = sortbin[i].elt;
417 ap_destroy_pool(tmp);
420 /*****************************************************************
422 * There are some elements of the core config structures in which
423 * other modules have a legitimate interest (this is ugly, but necessary
424 * to preserve NCSA back-compatibility). So, we have a bunch of accessors
428 API_EXPORT(int) ap_allow_options(request_rec *r)
430 core_dir_config *conf =
431 (core_dir_config *)ap_get_module_config(r->per_dir_config, &core_module);
436 API_EXPORT(int) ap_allow_overrides(request_rec *r)
438 core_dir_config *conf;
439 conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
442 return conf->override;
445 API_EXPORT(const char *) ap_auth_type(request_rec *r)
447 core_dir_config *conf;
449 conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
451 return conf->ap_auth_type;
454 API_EXPORT(const char *) ap_auth_name(request_rec *r)
456 core_dir_config *conf;
458 conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
460 return conf->ap_auth_name;
463 API_EXPORT(const char *) ap_default_type(request_rec *r)
465 core_dir_config *conf;
467 conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
469 return conf->ap_default_type
470 ? conf->ap_default_type
471 : DEFAULT_CONTENT_TYPE;
474 API_EXPORT(const char *) ap_document_root(request_rec *r) /* Don't use this! */
476 core_server_config *conf;
478 conf = (core_server_config *)ap_get_module_config(r->server->module_config,
480 return conf->ap_document_root;
483 API_EXPORT(const ap_array_header_t *) ap_requires(request_rec *r)
485 core_dir_config *conf;
487 conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
489 return conf->ap_requires;
492 API_EXPORT(int) ap_satisfies(request_rec *r)
494 core_dir_config *conf;
496 conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
499 return conf->satisfy;
502 /* Should probably just get rid of this... the only code that cares is
503 * part of the core anyway (and in fact, it isn't publicised to other
507 char *ap_response_code_string(request_rec *r, int error_index)
509 core_dir_config *conf;
511 conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
514 if (conf->response_code_strings == NULL) {
517 return conf->response_code_strings[error_index];
521 /* Code from Harald Hanche-Olsen <hanche@imf.unit.no> */
522 static ap_inline void do_double_reverse (conn_rec *conn)
524 struct hostent *hptr;
526 if (conn->double_reverse) {
530 if (conn->remote_host == NULL || conn->remote_host[0] == '\0') {
531 /* single reverse failed, so don't bother */
532 conn->double_reverse = -1;
535 hptr = gethostbyname(conn->remote_host);
539 for (haddr = hptr->h_addr_list; *haddr; haddr++) {
540 if (((struct in_addr *)(*haddr))->s_addr
541 == conn->remote_addr.sin_addr.s_addr) {
542 conn->double_reverse = 1;
547 conn->double_reverse = -1;
550 API_EXPORT(const char *) ap_get_remote_host(conn_rec *conn, void *dir_config,
553 struct in_addr *iaddr;
554 struct hostent *hptr;
555 int hostname_lookups;
557 /* If we haven't checked the host name, and we want to */
560 ((core_dir_config *)ap_get_module_config(dir_config, &core_module))
562 if (hostname_lookups == HOSTNAME_LOOKUP_UNSET) {
563 hostname_lookups = HOSTNAME_LOOKUP_OFF;
568 hostname_lookups = HOSTNAME_LOOKUP_OFF;
571 if (type != REMOTE_NOLOOKUP
572 && conn->remote_host == NULL
573 && (type == REMOTE_DOUBLE_REV
574 || hostname_lookups != HOSTNAME_LOOKUP_OFF)) {
575 iaddr = &(conn->remote_addr.sin_addr);
576 hptr = gethostbyaddr((char *)iaddr, sizeof(struct in_addr), AF_INET);
578 conn->remote_host = ap_pstrdup(conn->pool, (void *)hptr->h_name);
579 ap_str_tolower(conn->remote_host);
581 if (hostname_lookups == HOSTNAME_LOOKUP_DOUBLE) {
582 do_double_reverse(conn);
583 if (conn->double_reverse != 1) {
584 conn->remote_host = NULL;
588 /* if failed, set it to the NULL string to indicate error */
589 if (conn->remote_host == NULL) {
590 conn->remote_host = "";
593 if (type == REMOTE_DOUBLE_REV) {
594 do_double_reverse(conn);
595 if (conn->double_reverse == -1) {
601 * Return the desired information; either the remote DNS name, if found,
602 * or either NULL (if the hostname was requested) or the IP address
603 * (if any identifier was requested).
605 if (conn->remote_host != NULL && conn->remote_host[0] != '\0') {
606 return conn->remote_host;
609 if (type == REMOTE_HOST || type == REMOTE_DOUBLE_REV) {
613 return conn->remote_ip;
618 API_EXPORT(const char *) ap_get_remote_logname(request_rec *r)
620 core_dir_config *dir_conf;
622 if (r->connection->remote_logname != NULL) {
623 return r->connection->remote_logname;
626 /* If we haven't checked the identity, and we want to */
627 dir_conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
630 if (dir_conf->do_rfc1413 & 1) {
631 return ap_rfc1413(r->connection, r->server);
638 /* There are two options regarding what the "name" of a server is. The
639 * "canonical" name as defined by ServerName and Port, or the "client's
640 * name" as supplied by a possible Host: header or full URI. We never
641 * trust the port passed in the client's headers, we always use the
642 * port of the actual socket.
644 * The DNS option to UseCanonicalName causes this routine to do a
645 * reverse lookup on the local IP address of the connectiona and use
646 * that for the ServerName. This makes its value more reliable while
647 * at the same time allowing Demon's magic virtual hosting to work.
648 * The assumption is that DNS lookups are sufficiently quick...
651 API_EXPORT(const char *) ap_get_server_name(request_rec *r)
653 conn_rec *conn = r->connection;
656 d = (core_dir_config *)ap_get_module_config(r->per_dir_config,
659 if (d->use_canonical_name == USE_CANONICAL_NAME_OFF) {
660 return r->hostname ? r->hostname : r->server->server_hostname;
662 if (d->use_canonical_name == USE_CANONICAL_NAME_DNS) {
663 if (conn->local_host == NULL) {
664 struct in_addr *iaddr;
665 struct hostent *hptr;
666 iaddr = &(conn->local_addr.sin_addr);
667 hptr = gethostbyaddr((char *)iaddr, sizeof(struct in_addr),
670 conn->local_host = ap_pstrdup(conn->pool,
671 (void *)hptr->h_name);
672 ap_str_tolower(conn->local_host);
675 conn->local_host = ap_pstrdup(conn->pool,
676 r->server->server_hostname);
679 return conn->local_host;
682 return r->server->server_hostname;
685 API_EXPORT(unsigned) ap_get_server_port(const request_rec *r)
689 (core_dir_config *)ap_get_module_config(r->per_dir_config, &core_module);
691 port = r->server->port ? r->server->port : ap_default_port(r);
693 if (d->use_canonical_name == USE_CANONICAL_NAME_OFF
694 || d->use_canonical_name == USE_CANONICAL_NAME_DNS) {
695 return r->hostname ? ntohs(r->connection->local_addr.sin_port)
702 API_EXPORT(char *) ap_construct_url(ap_context_t *p, const char *uri,
705 unsigned port = ap_get_server_port(r);
706 const char *host = ap_get_server_name(r);
708 if (ap_is_default_port(port, r)) {
709 return ap_pstrcat(p, ap_http_method(r), "://", host, uri, NULL);
711 return ap_psprintf(p, "%s://%s:%u%s", ap_http_method(r), host, port, uri);
714 API_EXPORT(unsigned long) ap_get_limit_req_body(const request_rec *r)
717 (core_dir_config *)ap_get_module_config(r->per_dir_config, &core_module);
719 return d->limit_req_body;
723 static char* get_interpreter_from_win32_registry(ap_context_t *p, const char* ext)
725 char extension_path[] = "SOFTWARE\\Classes\\";
726 char executable_path[] = "\\SHELL\\OPEN\\COMMAND";
739 * Future optimization:
740 * When the registry is successfully searched, store the interpreter
741 * string in a ap_table_t to make subsequent look-ups faster
744 /* Open the key associated with the script extension */
745 keyName = ap_pstrcat(p, extension_path, ext, NULL);
747 result = RegOpenKeyEx(HKEY_LOCAL_MACHINE, keyName, 0, KEY_QUERY_VALUE,
750 if (result != ERROR_SUCCESS)
753 /* Read to NULL buffer to find value size */
755 result = RegQueryValueEx(hkeyOpen, "", NULL, &type, NULL, &size);
757 if (result == ERROR_SUCCESS) {
758 buffer = ap_palloc(p, size);
759 result = RegQueryValueEx(hkeyOpen, "", NULL, &type, buffer, &size);
762 RegCloseKey(hkeyOpen);
764 if (result != ERROR_SUCCESS)
767 /* Open the key associated with the interpreter path */
768 keyName = ap_pstrcat(p, extension_path, buffer, executable_path, NULL);
770 result = RegOpenKeyEx(HKEY_LOCAL_MACHINE, keyName, 0, KEY_QUERY_VALUE,
773 if (result != ERROR_SUCCESS)
776 /* Read to NULL buffer to find value size */
778 result = RegQueryValueEx(hkeyOpen, "", 0, &type, NULL, &size);
780 if (result == ERROR_SUCCESS) {
781 buffer = ap_palloc(p, size);
782 result = RegQueryValueEx(hkeyOpen, "", 0, &type, buffer, &size);
785 RegCloseKey(hkeyOpen);
787 if (result != ERROR_SUCCESS)
791 * The canonical way shell command entries are entered in the Win32
792 * registry is as follows:
793 * shell [options] "%1"
795 * shell - full path name to interpreter or shell to run.
796 * E.g., c:\usr\local\ntreskit\perl\bin\perl.exe
797 * options - optional switches
799 * "%1" - Place holder for file to run the shell against.
802 * If we find a %1 or a quoted %1, lop it off.
804 if (buffer && *buffer) {
805 if ((s = strstr(buffer, "\"%1")))
807 else if ((s = strstr(buffer, "%1")))
814 API_EXPORT (file_type_e) ap_get_win32_interpreter(const request_rec *r,
823 file_type_e fileType = eFileTypeUNKNOWN;
825 char *exename = NULL;
827 d = (core_dir_config *)ap_get_module_config(r->per_dir_config,
830 /* Find the file extension */
831 exename = strrchr(r->filename, '/');
833 exename = strrchr(r->filename, '\\');
836 exename = r->filename;
841 ext = strrchr(exename, '.');
843 if (ext && (!strcasecmp(ext,".bat") || !strcasecmp(ext,".cmd"))) {
844 return eFileTypeEXE32;
847 /* If the file has an extension and it is not .com and not .exe and
848 * we've been instructed to search the registry, then do it!
850 if (ext && strcasecmp(ext,".exe") && strcasecmp(ext,".com") &&
851 d->script_interpreter_source == INTERPRETER_SOURCE_REGISTRY) {
852 /* Check the registry */
853 *interpreter = get_interpreter_from_win32_registry(r->pool, ext);
855 return eFileTypeSCRIPT;
857 ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_INFO, 0, r->server,
858 "ScriptInterpreterSource config directive set to \"registry\".\n\t"
859 "Registry was searched but interpreter not found. Trying the shebang line.");
863 /* Need to peek into the file figure out what it really is... */
864 hFile = CreateFile(r->filename, GENERIC_READ, FILE_SHARE_READ, NULL,
865 OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL);
866 if (hFile == INVALID_HANDLE_VALUE) {
867 return eFileTypeUNKNOWN;
869 bResult = ReadFile(hFile, (void*) &buffer, sizeof(buffer) - 1,
871 if (!bResult || (nBytesRead == 0)) {
872 ap_log_rerror(APLOG_MARK, APLOG_ERR, GetLastError(), r,
873 "ReadFile(%s) failed", r->filename);
875 return eFileTypeUNKNOWN;
878 buffer[nBytesRead] = '\0';
880 /* Script or executable, that is the question... */
881 if ((buffer[0] == '#') && (buffer[1] == '!')) {
882 /* Assuming file is a script since it starts with a shebang */
883 fileType = eFileTypeSCRIPT;
884 for (i = 2; i < sizeof(buffer); i++) {
885 if ((buffer[i] == '\r')
886 || (buffer[i] == '\n')) {
891 for (i = 2; buffer[i] == ' ' ; ++i)
893 *interpreter = ap_pstrdup(r->pool, buffer + i );
896 /* Not a script, is it an executable? */
897 IMAGE_DOS_HEADER *hdr = (IMAGE_DOS_HEADER*)buffer;
898 if ((nBytesRead >= sizeof(IMAGE_DOS_HEADER)) && (hdr->e_magic == IMAGE_DOS_SIGNATURE)) {
899 if (hdr->e_lfarlc < 0x40)
900 fileType = eFileTypeEXE16;
902 fileType = eFileTypeEXE32;
905 fileType = eFileTypeUNKNOWN;
912 /*****************************************************************
914 * Commands... this module handles almost all of the NCSA httpd.conf
915 * commands, but most of the old srm.conf is in the the modules.
918 static const char end_directory_section[] = "</Directory>";
919 static const char end_directorymatch_section[] = "</DirectoryMatch>";
920 static const char end_location_section[] = "</Location>";
921 static const char end_locationmatch_section[] = "</LocationMatch>";
922 static const char end_files_section[] = "</Files>";
923 static const char end_filesmatch_section[] = "</FilesMatch>";
924 static const char end_virtualhost_section[] = "</VirtualHost>";
925 static const char end_ifmodule_section[] = "</IfModule>";
926 static const char end_ifdefine_section[] = "</IfDefine>";
929 API_EXPORT(const char *) ap_check_cmd_context(cmd_parms *cmd,
932 const char *gt = (cmd->cmd->name[0] == '<'
933 && cmd->cmd->name[strlen(cmd->cmd->name)-1] != '>')
936 if ((forbidden & NOT_IN_VIRTUALHOST) && cmd->server->is_virtual) {
937 return ap_pstrcat(cmd->pool, cmd->cmd->name, gt,
938 " cannot occur within <VirtualHost> section", NULL);
941 if ((forbidden & NOT_IN_LIMIT) && cmd->limited != -1) {
942 return ap_pstrcat(cmd->pool, cmd->cmd->name, gt,
943 " cannot occur within <Limit> section", NULL);
946 if ((forbidden & NOT_IN_DIR_LOC_FILE) == NOT_IN_DIR_LOC_FILE
947 && cmd->path != NULL) {
948 return ap_pstrcat(cmd->pool, cmd->cmd->name, gt,
949 " cannot occur within <Directory/Location/Files> "
953 if (((forbidden & NOT_IN_DIRECTORY)
954 && (cmd->end_token == end_directory_section
955 || cmd->end_token == end_directorymatch_section))
956 || ((forbidden & NOT_IN_LOCATION)
957 && (cmd->end_token == end_location_section
958 || cmd->end_token == end_locationmatch_section))
959 || ((forbidden & NOT_IN_FILES)
960 && (cmd->end_token == end_files_section
961 || cmd->end_token == end_filesmatch_section))) {
962 return ap_pstrcat(cmd->pool, cmd->cmd->name, gt,
963 " cannot occur within <", cmd->end_token+2,
970 static const char *set_access_name(cmd_parms *cmd, void *dummy, char *arg)
972 void *sconf = cmd->server->module_config;
973 core_server_config *conf = ap_get_module_config(sconf, &core_module);
975 const char *err = ap_check_cmd_context(cmd,
976 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
981 conf->access_name = ap_pstrdup(cmd->pool, arg);
986 static const char *set_gprof_dir(cmd_parms *cmd, void *dummy, char *arg)
988 void *sconf = cmd->server->module_config;
989 core_server_config *conf = ap_get_module_config(sconf, &core_module);
991 const char *err = ap_check_cmd_context(cmd,
992 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
997 conf->gprof_dir = ap_pstrdup(cmd->pool, arg);
1002 static const char *set_document_root(cmd_parms *cmd, void *dummy, char *arg)
1004 void *sconf = cmd->server->module_config;
1005 core_server_config *conf = ap_get_module_config(sconf, &core_module);
1007 const char *err = ap_check_cmd_context(cmd,
1008 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1013 arg = ap_os_canonical_filename(cmd->pool, arg);
1014 if (/* TODO: ap_configtestonly && ap_docrootcheck && */ !ap_is_directory(arg)) {
1015 if (cmd->server->is_virtual) {
1016 ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL,
1017 "Warning: DocumentRoot [%s] does not exist",
1021 return "DocumentRoot must be a directory";
1025 conf->ap_document_root = arg;
1029 API_EXPORT(void) ap_custom_response(request_rec *r, int status, char *string)
1031 core_dir_config *conf =
1032 ap_get_module_config(r->per_dir_config, &core_module);
1035 if(conf->response_code_strings == NULL) {
1036 conf->response_code_strings =
1038 sizeof(*conf->response_code_strings) *
1042 idx = ap_index_of_response(status);
1044 conf->response_code_strings[idx] =
1045 ((ap_is_url(string) || (*string == '/')) && (*string != '"')) ?
1046 ap_pstrdup(r->pool, string) : ap_pstrcat(r->pool, "\"", string, NULL);
1049 static const char *set_error_document(cmd_parms *cmd, core_dir_config *conf,
1052 int error_number, index_number, idx500;
1055 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
1060 /* 1st parameter should be a 3 digit number, which we recognize;
1061 * convert it into an array index
1064 w = ap_getword_conf_nc(cmd->pool, &line);
1065 error_number = atoi(w);
1067 idx500 = ap_index_of_response(HTTP_INTERNAL_SERVER_ERROR);
1069 if (error_number == HTTP_INTERNAL_SERVER_ERROR) {
1070 index_number = idx500;
1072 else if ((index_number = ap_index_of_response(error_number)) == idx500) {
1073 return ap_pstrcat(cmd->pool, "Unsupported HTTP response code ",
1077 /* The entry should be ignored if it is a full URL for a 401 error */
1079 if (error_number == 401 &&
1080 line[0] != '/' && line[0] != '"') { /* Ignore it... */
1081 ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_NOTICE, 0, cmd->server,
1082 "cannot use a full URL in a 401 ErrorDocument "
1083 "directive --- ignoring!");
1085 else { /* Store it... */
1086 if (conf->response_code_strings == NULL) {
1087 conf->response_code_strings =
1088 ap_pcalloc(cmd->pool,
1089 sizeof(*conf->response_code_strings) * RESPONSE_CODES);
1091 conf->response_code_strings[index_number] = ap_pstrdup(cmd->pool, line);
1097 /* access.conf commands...
1099 * The *only* thing that can appear in access.conf at top level is a
1100 * <Directory> section. NB we need to have a way to cut the srm_command_loop
1101 * invoked by dirsection (i.e., <Directory>) short when </Directory> is seen.
1102 * We do that by returning an error, which dirsection itself recognizes and
1103 * discards as harmless. Cheesy, but it works.
1106 static const char *set_override(cmd_parms *cmd, core_dir_config *d,
1111 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
1116 d->override = OR_NONE;
1118 w = ap_getword_conf(cmd->pool, &l);
1119 if (!strcasecmp(w, "Limit")) {
1120 d->override |= OR_LIMIT;
1122 else if (!strcasecmp(w, "Options")) {
1123 d->override |= OR_OPTIONS;
1125 else if (!strcasecmp(w, "FileInfo")) {
1126 d->override |= OR_FILEINFO;
1128 else if (!strcasecmp(w, "AuthConfig")) {
1129 d->override |= OR_AUTHCFG;
1131 else if (!strcasecmp(w, "Indexes")) {
1132 d->override |= OR_INDEXES;
1134 else if (!strcasecmp(w, "None")) {
1135 d->override = OR_NONE;
1137 else if (!strcasecmp(w, "All")) {
1138 d->override = OR_ALL;
1141 return ap_pstrcat(cmd->pool, "Illegal override option ", w, NULL);
1143 d->override &= ~OR_UNSET;
1149 static const char *set_options(cmd_parms *cmd, core_dir_config *d,
1152 allow_options_t opt;
1157 char *w = ap_getword_conf(cmd->pool, &l);
1160 if (*w == '+' || *w == '-') {
1168 if (!strcasecmp(w, "Indexes")) {
1171 else if (!strcasecmp(w, "Includes")) {
1174 else if (!strcasecmp(w, "IncludesNOEXEC")) {
1175 opt = (OPT_INCLUDES | OPT_INCNOEXEC);
1177 else if (!strcasecmp(w, "FollowSymLinks")) {
1178 opt = OPT_SYM_LINKS;
1180 else if (!strcasecmp(w, "SymLinksIfOwnerMatch")) {
1181 opt = OPT_SYM_OWNER;
1183 else if (!strcasecmp(w, "execCGI")) {
1186 else if (!strcasecmp(w, "MultiViews")) {
1189 else if (!strcasecmp(w, "RunScripts")) { /* AI backcompat. Yuck */
1190 opt = OPT_MULTI|OPT_EXECCGI;
1192 else if (!strcasecmp(w, "None")) {
1195 else if (!strcasecmp(w, "All")) {
1199 return ap_pstrcat(cmd->pool, "Illegal option ", w, NULL);
1202 /* we ensure the invariant (d->opts_add & d->opts_remove) == 0 */
1203 if (action == '-') {
1204 d->opts_remove |= opt;
1205 d->opts_add &= ~opt;
1208 else if (action == '+') {
1210 d->opts_remove &= ~opt;
1221 static const char *satisfy(cmd_parms *cmd, core_dir_config *c, char *arg)
1223 if (!strcasecmp(arg, "all")) {
1224 c->satisfy = SATISFY_ALL;
1226 else if (!strcasecmp(arg, "any")) {
1227 c->satisfy = SATISFY_ANY;
1230 return "Satisfy either 'any' or 'all'.";
1235 static const char *require(cmd_parms *cmd, core_dir_config *c, char *arg)
1239 if (!c->ap_requires) {
1240 c->ap_requires = ap_make_array(cmd->pool, 2, sizeof(require_line));
1242 r = (require_line *)ap_push_array(c->ap_requires);
1243 r->requirement = ap_pstrdup(cmd->pool, arg);
1244 r->method_mask = cmd->limited;
1248 CORE_EXPORT_NONSTD(const char *) ap_limit_section(cmd_parms *cmd, void *dummy,
1251 const char *limited_methods = ap_getword(cmd->pool, &arg, '>');
1252 void *tog = cmd->cmd->cmd_data;
1255 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
1260 /* XXX: NB: Currently, we have no way of checking
1261 * whether <Limit> or <LimitExcept> sections are closed properly.
1262 * (If we would add a srm_command_loop() here we might...)
1265 while (limited_methods[0]) {
1266 char *method = ap_getword_conf(cmd->pool, &limited_methods);
1267 int methnum = ap_method_number_of(method);
1269 if (methnum == M_TRACE && !tog) {
1270 return "TRACE cannot be controlled by <Limit>";
1272 else if (methnum == M_INVALID) {
1273 return ap_pstrcat(cmd->pool, "unknown method \"", method,
1274 "\" in <Limit", tog ? "Except>" : ">", NULL);
1277 limited |= (1 << methnum);
1281 /* Killing two features with one function,
1282 * if (tog == NULL) <Limit>, else <LimitExcept>
1284 cmd->limited = tog ? ~limited : limited;
1288 static const char *endlimit_section(cmd_parms *cmd, void *dummy, void *dummy2)
1290 void *tog = cmd->cmd->cmd_data;
1292 if (cmd->limited == -1) {
1293 return tog ? "</LimitExcept> unexpected" : "</Limit> unexpected";
1301 * When a section is not closed properly when end-of-file is reached,
1302 * then an error message should be printed:
1304 static const char *missing_endsection(cmd_parms *cmd, int nest)
1307 return ap_psprintf(cmd->pool, "Missing %s directive at end-of-file",
1310 return ap_psprintf(cmd->pool, "%d missing %s directives at end-of-file",
1311 nest, cmd->end_token);
1314 /* We use this in <DirectoryMatch> and <FilesMatch>, to ensure that
1315 * people don't get bitten by wrong-cased regex matches
1319 #define USE_ICASE REG_ICASE
1324 static const char *end_nested_section(cmd_parms *cmd, void *dummy)
1326 if (cmd->end_token == NULL) {
1327 return ap_pstrcat(cmd->pool, cmd->cmd->name,
1328 " without matching <", cmd->cmd->name + 2,
1332 * This '!=' may look weird on a string comparison, but it's correct --
1333 * it's been set up so that checking for two pointers to the same datum
1334 * is valid here. And faster.
1336 if (cmd->cmd->name != cmd->end_token) {
1337 return ap_pstrcat(cmd->pool, "Expected ", cmd->end_token, " but saw ",
1338 cmd->cmd->name, NULL);
1340 return cmd->end_token;
1344 * Report a missing-'>' syntax error.
1346 static char *unclosed_directive(cmd_parms *cmd)
1348 return ap_pstrcat(cmd->pool, cmd->cmd->name,
1349 "> directive missing closing '>'", NULL);
1352 static const char *dirsection(cmd_parms *cmd, void *dummy, const char *arg)
1355 char *endp = strrchr(arg, '>');
1356 int old_overrides = cmd->override;
1357 char *old_path = cmd->path;
1358 core_dir_config *conf;
1359 void *new_dir_conf = ap_create_per_dir_config(cmd->pool);
1361 const char *old_end_token;
1362 const command_rec *thiscmd = cmd->cmd;
1364 const char *err = ap_check_cmd_context(cmd,
1365 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1371 return unclosed_directive(cmd);
1376 cmd->path = ap_getword_conf(cmd->pool, &arg);
1377 cmd->override = OR_ALL|ACCESS_CONF;
1379 if (thiscmd->cmd_data) { /* <DirectoryMatch> */
1380 r = ap_pregcomp(cmd->pool, cmd->path, REG_EXTENDED|USE_ICASE);
1382 else if (!strcmp(cmd->path, "~")) {
1383 cmd->path = ap_getword_conf(cmd->pool, &arg);
1384 r = ap_pregcomp(cmd->pool, cmd->path, REG_EXTENDED|USE_ICASE);
1387 /* Ensure that the pathname is canonical */
1388 cmd->path = ap_os_canonical_filename(cmd->pool, cmd->path);
1391 old_end_token = cmd->end_token;
1392 cmd->end_token = thiscmd->cmd_data ? end_directorymatch_section : end_directory_section;
1393 errmsg = ap_srm_command_loop(cmd, new_dir_conf);
1394 if (errmsg == NULL) {
1395 errmsg = missing_endsection(cmd, 1);
1397 cmd->end_token = old_end_token;
1398 if (errmsg != (thiscmd->cmd_data
1399 ? end_directorymatch_section
1400 : end_directory_section)) {
1404 conf = (core_dir_config *)ap_get_module_config(new_dir_conf, &core_module);
1407 ap_add_per_dir_conf(cmd->server, new_dir_conf);
1410 return ap_pstrcat(cmd->pool, "Multiple ", thiscmd->name,
1411 "> arguments not (yet) supported.", NULL);
1414 cmd->path = old_path;
1415 cmd->override = old_overrides;
1420 static const char *urlsection(cmd_parms *cmd, void *dummy, const char *arg)
1423 char *endp = strrchr(arg, '>');
1424 int old_overrides = cmd->override;
1425 char *old_path = cmd->path;
1426 core_dir_config *conf;
1428 const char *old_end_token;
1429 const command_rec *thiscmd = cmd->cmd;
1431 void *new_url_conf = ap_create_per_dir_config(cmd->pool);
1433 const char *err = ap_check_cmd_context(cmd,
1434 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1440 return unclosed_directive(cmd);
1445 cmd->path = ap_getword_conf(cmd->pool, &arg);
1446 cmd->override = OR_ALL|ACCESS_CONF;
1448 if (thiscmd->cmd_data) { /* <LocationMatch> */
1449 r = ap_pregcomp(cmd->pool, cmd->path, REG_EXTENDED);
1451 else if (!strcmp(cmd->path, "~")) {
1452 cmd->path = ap_getword_conf(cmd->pool, &arg);
1453 r = ap_pregcomp(cmd->pool, cmd->path, REG_EXTENDED);
1456 old_end_token = cmd->end_token;
1457 cmd->end_token = thiscmd->cmd_data ? end_locationmatch_section
1458 : end_location_section;
1459 errmsg = ap_srm_command_loop(cmd, new_url_conf);
1460 if (errmsg == NULL) {
1461 errmsg = missing_endsection(cmd, 1);
1463 cmd->end_token = old_end_token;
1464 if (errmsg != (thiscmd->cmd_data
1465 ? end_locationmatch_section
1466 : end_location_section)) {
1470 conf = (core_dir_config *)ap_get_module_config(new_url_conf, &core_module);
1471 conf->d = ap_pstrdup(cmd->pool, cmd->path); /* No mangling, please */
1472 conf->d_is_fnmatch = ap_is_fnmatch(conf->d) != 0;
1475 ap_add_per_url_conf(cmd->server, new_url_conf);
1478 return ap_pstrcat(cmd->pool, "Multiple ", thiscmd->name,
1479 "> arguments not (yet) supported.", NULL);
1482 cmd->path = old_path;
1483 cmd->override = old_overrides;
1488 static const char *filesection(cmd_parms *cmd, core_dir_config *c,
1492 char *endp = strrchr(arg, '>');
1493 int old_overrides = cmd->override;
1494 char *old_path = cmd->path;
1495 core_dir_config *conf;
1497 const char *old_end_token;
1498 const command_rec *thiscmd = cmd->cmd;
1500 void *new_file_conf = ap_create_per_dir_config(cmd->pool);
1502 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT|NOT_IN_LOCATION);
1508 return unclosed_directive(cmd);
1513 cmd->path = ap_getword_conf(cmd->pool, &arg);
1514 /* Only if not an .htaccess file */
1516 cmd->override = OR_ALL|ACCESS_CONF;
1519 if (thiscmd->cmd_data) { /* <FilesMatch> */
1520 r = ap_pregcomp(cmd->pool, cmd->path, REG_EXTENDED|USE_ICASE);
1522 else if (!strcmp(cmd->path, "~")) {
1523 cmd->path = ap_getword_conf(cmd->pool, &arg);
1524 r = ap_pregcomp(cmd->pool, cmd->path, REG_EXTENDED|USE_ICASE);
1527 /* Ensure that the pathname is canonical */
1528 cmd->path = ap_os_canonical_filename(cmd->pool, cmd->path);
1531 old_end_token = cmd->end_token;
1532 cmd->end_token = thiscmd->cmd_data ? end_filesmatch_section : end_files_section;
1533 errmsg = ap_srm_command_loop(cmd, new_file_conf);
1534 if (errmsg == NULL) {
1535 errmsg = missing_endsection(cmd, 1);
1537 cmd->end_token = old_end_token;
1538 if (errmsg != (thiscmd->cmd_data
1539 ? end_filesmatch_section
1540 : end_files_section)) {
1544 conf = (core_dir_config *)ap_get_module_config(new_file_conf,
1546 conf->d = cmd->path;
1547 conf->d_is_fnmatch = ap_is_fnmatch(conf->d) != 0;
1550 ap_add_file_conf(c, new_file_conf);
1553 return ap_pstrcat(cmd->pool, "Multiple ", thiscmd->name,
1554 "> arguments not (yet) supported.", NULL);
1557 cmd->path = old_path;
1558 cmd->override = old_overrides;
1563 /* XXX: NB: Currently, we have no way of checking
1564 * whether <IfModule> sections are closed properly.
1565 * Extra (redundant, unpaired) </IfModule> directives are
1566 * simply silently ignored.
1568 static const char *end_ifmod(cmd_parms *cmd, void *dummy)
1573 static const char *start_ifmod(cmd_parms *cmd, void *dummy, char *arg)
1575 char *endp = strrchr(arg, '>');
1576 char l[MAX_STRING_LEN];
1577 int not = (arg[0] == '!');
1582 return unclosed_directive(cmd);
1591 found = ap_find_linked_module(arg);
1593 if ((!not && found) || (not && !found)) {
1597 while (nest && !(ap_cfg_getline(l, MAX_STRING_LEN, cmd->config_file))) {
1598 if (!strncasecmp(l, "<IfModule", 9)) {
1601 if (!strcasecmp(l, "</IfModule>")) {
1607 cmd->end_token = end_ifmodule_section;
1608 return missing_endsection(cmd, nest);
1613 API_EXPORT(int) ap_exists_config_define(char *name)
1618 defines = (char **)ap_server_config_defines->elts;
1619 for (i = 0; i < ap_server_config_defines->nelts; i++) {
1620 if (strcmp(defines[i], name) == 0) {
1627 static const char *end_ifdefine(cmd_parms *cmd, void *dummy)
1632 static const char *start_ifdefine(cmd_parms *cmd, void *dummy, char *arg)
1635 char l[MAX_STRING_LEN];
1640 endp = strrchr(arg, '>');
1642 return unclosed_directive(cmd);
1647 if (arg[0] == '!') {
1652 defined = ap_exists_config_define(arg);
1654 if ((!not && defined) || (not && !defined)) {
1658 while (nest && !(ap_cfg_getline(l, MAX_STRING_LEN, cmd->config_file))) {
1659 if (!strncasecmp(l, "<IfDefine", 9)) {
1662 if (!strcasecmp(l, "</IfDefine>")) {
1667 cmd->end_token = end_ifdefine_section;
1668 return missing_endsection(cmd, nest);
1673 /* httpd.conf commands... beginning with the <VirtualHost> business */
1675 static const char *virtualhost_section(cmd_parms *cmd, void *dummy, char *arg)
1677 server_rec *main_server = cmd->server, *s;
1679 char *endp = strrchr(arg, '>');
1680 ap_context_t *p = cmd->pool, *ptemp = cmd->temp_pool;
1681 const char *old_end_token;
1683 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
1689 return unclosed_directive(cmd);
1694 /* FIXME: There's another feature waiting to happen here -- since you
1695 can now put multiple addresses/names on a single <VirtualHost>
1696 you might want to use it to group common definitions and then
1697 define other "subhosts" with their individual differences. But
1698 personally I'd rather just do it with a macro preprocessor. -djg */
1699 if (main_server->is_virtual) {
1700 return "<VirtualHost> doesn't nest!";
1703 errmsg = ap_init_virtual_host(p, arg, main_server, &s);
1708 s->next = main_server->next;
1709 main_server->next = s;
1711 s->defn_name = cmd->config_file->name;
1712 s->defn_line_number = cmd->config_file->line_number;
1714 old_end_token = cmd->end_token;
1715 cmd->end_token = end_virtualhost_section;
1717 errmsg = ap_srm_command_loop(cmd, s->lookup_defaults);
1718 cmd->server = main_server;
1719 if (errmsg == NULL) {
1720 errmsg = missing_endsection(cmd, 1);
1722 cmd->end_token = old_end_token;
1724 if (s->srm_confname) {
1725 ap_process_resource_config(s, s->srm_confname, p, ptemp);
1728 if (s->access_confname) {
1729 ap_process_resource_config(s, s->access_confname, p, ptemp);
1732 if (errmsg == end_virtualhost_section) {
1738 static const char *set_server_alias(cmd_parms *cmd, void *dummy,
1741 if (!cmd->server->names) {
1742 return "ServerAlias only used in <VirtualHost>";
1745 char **item, *name = ap_getword_conf(cmd->pool, &arg);
1746 if (ap_is_matchexp(name)) {
1747 item = (char **)ap_push_array(cmd->server->wild_names);
1750 item = (char **)ap_push_array(cmd->server->names);
1757 static const char *add_module_command(cmd_parms *cmd, void *dummy, char *arg)
1759 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
1764 if (!ap_add_named_module(arg)) {
1765 return ap_pstrcat(cmd->pool, "Cannot add module via name '", arg,
1766 "': not in list of loaded modules", NULL);
1771 static const char *clear_module_list_command(cmd_parms *cmd, void *dummy)
1773 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
1778 ap_clear_module_list();
1782 static const char *set_server_string_slot(cmd_parms *cmd, void *dummy,
1785 /* This one's pretty generic... */
1787 int offset = (int)(long)cmd->info;
1788 char *struct_ptr = (char *)cmd->server;
1790 const char *err = ap_check_cmd_context(cmd,
1791 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1796 *(char **)(struct_ptr + offset) = arg;
1800 static const char *server_port(cmd_parms *cmd, void *dummy, char *arg)
1802 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1809 if (port <= 0 || port >= 65536) { /* 65536 == 1<<16 */
1810 return ap_pstrcat(cmd->temp_pool, "The port number \"", arg,
1811 "\" is outside the appropriate range "
1812 "(i.e., 1..65535).", NULL);
1814 cmd->server->port = port;
1818 static const char *set_signature_flag(cmd_parms *cmd, core_dir_config *d,
1821 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
1826 if (strcasecmp(arg, "On") == 0) {
1827 d->server_signature = srv_sig_on;
1829 else if (strcasecmp(arg, "Off") == 0) {
1830 d->server_signature = srv_sig_off;
1832 else if (strcasecmp(arg, "EMail") == 0) {
1833 d->server_signature = srv_sig_withmail;
1836 return "ServerSignature: use one of: off | on | email";
1841 static const char *set_server_root(cmd_parms *cmd, void *dummy, char *arg)
1843 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
1849 arg = ap_os_canonical_filename(cmd->pool, arg);
1851 if (!ap_is_directory(arg)) {
1852 return "ServerRoot must be a valid directory";
1854 ap_server_root = arg;
1858 static const char *set_timeout(cmd_parms *cmd, void *dummy, char *arg)
1860 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1865 cmd->server->timeout = atoi(arg);
1869 static const char *set_keep_alive_timeout(cmd_parms *cmd, void *dummy,
1872 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1877 cmd->server->keep_alive_timeout = atoi(arg);
1881 static const char *set_keep_alive(cmd_parms *cmd, void *dummy, char *arg)
1883 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1888 /* We've changed it to On/Off, but used to use numbers
1889 * so we accept anything but "Off" or "0" as "On"
1891 if (!strcasecmp(arg, "off") || !strcmp(arg, "0")) {
1892 cmd->server->keep_alive = 0;
1895 cmd->server->keep_alive = 1;
1900 static const char *set_keep_alive_max(cmd_parms *cmd, void *dummy, char *arg)
1902 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1907 cmd->server->keep_alive_max = atoi(arg);
1911 static const char *set_idcheck(cmd_parms *cmd, core_dir_config *d, int arg)
1913 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
1918 d->do_rfc1413 = arg != 0;
1922 static const char *set_hostname_lookups(cmd_parms *cmd, core_dir_config *d,
1925 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
1930 if (!strcasecmp(arg, "on")) {
1931 d->hostname_lookups = HOSTNAME_LOOKUP_ON;
1933 else if (!strcasecmp(arg, "off")) {
1934 d->hostname_lookups = HOSTNAME_LOOKUP_OFF;
1936 else if (!strcasecmp(arg, "double")) {
1937 d->hostname_lookups = HOSTNAME_LOOKUP_DOUBLE;
1940 return "parameter must be 'on', 'off', or 'double'";
1945 static const char *set_serverpath(cmd_parms *cmd, void *dummy, char *arg)
1947 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1952 cmd->server->path = arg;
1953 cmd->server->pathlen = strlen(arg);
1957 static const char *set_content_md5(cmd_parms *cmd, core_dir_config *d, int arg)
1959 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
1964 d->content_md5 = arg != 0;
1968 static const char *set_use_canonical_name(cmd_parms *cmd, core_dir_config *d,
1971 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
1976 if (strcasecmp(arg, "on") == 0) {
1977 d->use_canonical_name = USE_CANONICAL_NAME_ON;
1979 else if (strcasecmp(arg, "off") == 0) {
1980 d->use_canonical_name = USE_CANONICAL_NAME_OFF;
1982 else if (strcasecmp(arg, "dns") == 0) {
1983 d->use_canonical_name = USE_CANONICAL_NAME_DNS;
1986 return "parameter must be 'on', 'off', or 'dns'";
1992 static const char *include_config (cmd_parms *cmd, void *dummy, char *name)
1994 ap_process_resource_config(cmd->server,
1995 ap_server_root_relative(cmd->pool, name),
1996 cmd->pool, cmd->temp_pool);
2000 static const char *set_loglevel(cmd_parms *cmd, void *dummy, const char *arg)
2004 const char *err = ap_check_cmd_context(cmd,
2005 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
2010 if ((str = ap_getword_conf(cmd->pool, &arg))) {
2011 if (!strcasecmp(str, "emerg")) {
2012 cmd->server->loglevel = APLOG_EMERG;
2014 else if (!strcasecmp(str, "alert")) {
2015 cmd->server->loglevel = APLOG_ALERT;
2017 else if (!strcasecmp(str, "crit")) {
2018 cmd->server->loglevel = APLOG_CRIT;
2020 else if (!strcasecmp(str, "error")) {
2021 cmd->server->loglevel = APLOG_ERR;
2023 else if (!strcasecmp(str, "warn")) {
2024 cmd->server->loglevel = APLOG_WARNING;
2026 else if (!strcasecmp(str, "notice")) {
2027 cmd->server->loglevel = APLOG_NOTICE;
2029 else if (!strcasecmp(str, "info")) {
2030 cmd->server->loglevel = APLOG_INFO;
2032 else if (!strcasecmp(str, "debug")) {
2033 cmd->server->loglevel = APLOG_DEBUG;
2036 return "LogLevel requires level keyword: one of "
2037 "emerg/alert/crit/error/warn/notice/info/debug";
2041 return "LogLevel requires level keyword";
2047 API_EXPORT(const char *) ap_psignature(const char *prefix, request_rec *r)
2050 core_dir_config *conf;
2052 conf = (core_dir_config *)ap_get_module_config(r->per_dir_config,
2054 if ((conf->server_signature == srv_sig_off)
2055 || (conf->server_signature == srv_sig_unset)) {
2059 ap_snprintf(sport, sizeof sport, "%u", (unsigned) ap_get_server_port(r));
2061 if (conf->server_signature == srv_sig_withmail) {
2062 return ap_pstrcat(r->pool, prefix, "<ADDRESS>" SERVER_BASEVERSION
2063 " Server at <A HREF=\"mailto:",
2064 r->server->server_admin, "\">",
2065 ap_get_server_name(r), "</A> Port ", sport,
2066 "</ADDRESS>\n", NULL);
2068 return ap_pstrcat(r->pool, prefix, "<ADDRESS>" SERVER_BASEVERSION
2069 " Server at ", ap_get_server_name(r), " Port ", sport,
2070 "</ADDRESS>\n", NULL);
2074 * Load an authorisation realm into our location configuration, applying the
2075 * usual rules that apply to realms.
2077 static const char *set_authname(cmd_parms *cmd, void *mconfig, char *word1)
2079 core_dir_config *aconfig = (core_dir_config *)mconfig;
2081 aconfig->ap_auth_name = ap_escape_quotes(cmd->pool, word1);
2085 #ifdef _OSD_POSIX /* BS2000 Logon Passwd file */
2086 static const char *set_bs2000_account(cmd_parms *cmd, void *dummy, char *name)
2088 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
2093 return os_set_account(cmd->pool, name);
2095 #endif /*_OSD_POSIX*/
2098 * Handle a request to include the server's OS platform in the Server
2099 * response header field (the ServerTokens directive). Unfortunately
2100 * this requires a new global in order to communicate the setting back to
2101 * http_main so it can insert the information in the right place in the
2105 static const char *set_serv_tokens(cmd_parms *cmd, void *dummy, char *arg)
2107 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
2112 /* TODO: reimplement the server token stuff. */
2114 if (!strcasecmp(arg, "OS")) {
2115 ap_server_tokens = SrvTk_OS;
2117 else if (!strcasecmp(arg, "Min") || !strcasecmp(arg, "Minimal")) {
2118 ap_server_tokens = SrvTk_MIN;
2121 ap_server_tokens = SrvTk_FULL;
2127 static const char *set_limit_req_line(cmd_parms *cmd, void *dummy, char *arg)
2129 const char *err = ap_check_cmd_context(cmd,
2130 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
2138 return ap_pstrcat(cmd->temp_pool, "LimitRequestLine \"", arg,
2139 "\" must be a non-negative integer", NULL);
2141 if (lim > DEFAULT_LIMIT_REQUEST_LINE) {
2142 return ap_psprintf(cmd->temp_pool, "LimitRequestLine \"%s\" "
2143 "must not exceed the precompiled maximum of %d",
2144 arg, DEFAULT_LIMIT_REQUEST_LINE);
2146 cmd->server->limit_req_line = lim;
2150 static const char *set_limit_req_fieldsize(cmd_parms *cmd, void *dummy,
2153 const char *err = ap_check_cmd_context(cmd,
2154 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
2162 return ap_pstrcat(cmd->temp_pool, "LimitRequestFieldsize \"", arg,
2163 "\" must be a non-negative integer (0 = no limit)",
2166 if (lim > DEFAULT_LIMIT_REQUEST_FIELDSIZE) {
2167 return ap_psprintf(cmd->temp_pool, "LimitRequestFieldsize \"%s\" "
2168 "must not exceed the precompiled maximum of %d",
2169 arg, DEFAULT_LIMIT_REQUEST_FIELDSIZE);
2171 cmd->server->limit_req_fieldsize = lim;
2175 static const char *set_limit_req_fields(cmd_parms *cmd, void *dummy, char *arg)
2177 const char *err = ap_check_cmd_context(cmd,
2178 NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
2186 return ap_pstrcat(cmd->temp_pool, "LimitRequestFields \"", arg,
2187 "\" must be a non-negative integer (0 = no limit)",
2190 cmd->server->limit_req_fields = lim;
2194 static const char *set_limit_req_body(cmd_parms *cmd, core_dir_config *conf,
2197 const char *err = ap_check_cmd_context(cmd, NOT_IN_LIMIT);
2202 /* WTF: If strtoul is not portable, then write a replacement.
2203 * Instead we have an idiotic define in httpd.h that prevents
2204 * it from being used even when it is available. Sheesh.
2206 conf->limit_req_body = (unsigned long)strtol(arg, (char **)NULL, 10);
2211 static const char *set_interpreter_source(cmd_parms *cmd, core_dir_config *d,
2214 if (!strcasecmp(arg, "registry")) {
2215 d->script_interpreter_source = INTERPRETER_SOURCE_REGISTRY;
2216 } else if (!strcasecmp(arg, "script")) {
2217 d->script_interpreter_source = INTERPRETER_SOURCE_SHEBANG;
2219 d->script_interpreter_source = INTERPRETER_SOURCE_SHEBANG;
2225 /* Note --- ErrorDocument will now work from .htaccess files.
2226 * The AllowOverride of Fileinfo allows webmasters to turn it off
2229 static const command_rec core_cmds[] = {
2231 /* Old access config file commands */
2233 { "<Directory", dirsection, NULL, RSRC_CONF, RAW_ARGS,
2234 "Container for directives affecting resources located in the specified "
2236 { end_directory_section, end_nested_section, NULL, ACCESS_CONF, NO_ARGS,
2237 "Marks end of <Directory>" },
2238 { "<Location", urlsection, NULL, RSRC_CONF, RAW_ARGS,
2239 "Container for directives affecting resources accessed through the "
2240 "specified URL paths" },
2241 { end_location_section, end_nested_section, NULL, ACCESS_CONF, NO_ARGS,
2242 "Marks end of <Location>" },
2243 { "<VirtualHost", virtualhost_section, NULL, RSRC_CONF, RAW_ARGS,
2244 "Container to map directives to a particular virtual host, takes one or "
2245 "more host addresses" },
2246 { end_virtualhost_section, end_nested_section, NULL, RSRC_CONF, NO_ARGS,
2247 "Marks end of <VirtualHost>" },
2248 { "<Files", filesection, NULL, OR_ALL, RAW_ARGS, "Container for directives "
2249 "affecting files matching specified patterns" },
2250 { end_files_section, end_nested_section, NULL, OR_ALL, NO_ARGS,
2251 "Marks end of <Files>" },
2252 { "<Limit", ap_limit_section, NULL, OR_ALL, RAW_ARGS, "Container for "
2253 "authentication directives when accessed using specified HTTP methods" },
2254 { "</Limit>", endlimit_section, NULL, OR_ALL, NO_ARGS,
2255 "Marks end of <Limit>" },
2256 { "<LimitExcept", ap_limit_section, (void*)1, OR_ALL, RAW_ARGS,
2257 "Container for authentication directives to be applied when any HTTP "
2258 "method other than those specified is used to access the resource" },
2259 { "</LimitExcept>", endlimit_section, (void*)1, OR_ALL, NO_ARGS,
2260 "Marks end of <LimitExcept>" },
2261 { "<IfModule", start_ifmod, NULL, OR_ALL, TAKE1,
2262 "Container for directives based on existance of specified modules" },
2263 { end_ifmodule_section, end_ifmod, NULL, OR_ALL, NO_ARGS,
2264 "Marks end of <IfModule>" },
2265 { "<IfDefine", start_ifdefine, NULL, OR_ALL, TAKE1,
2266 "Container for directives based on existance of command line defines" },
2267 { end_ifdefine_section, end_ifdefine, NULL, OR_ALL, NO_ARGS,
2268 "Marks end of <IfDefine>" },
2269 { "<DirectoryMatch", dirsection, (void*)1, RSRC_CONF, RAW_ARGS,
2270 "Container for directives affecting resources located in the "
2271 "specified directories" },
2272 { end_directorymatch_section, end_nested_section, NULL, ACCESS_CONF, NO_ARGS,
2273 "Marks end of <DirectoryMatch>" },
2274 { "<LocationMatch", urlsection, (void*)1, RSRC_CONF, RAW_ARGS,
2275 "Container for directives affecting resources accessed through the "
2276 "specified URL paths" },
2277 { end_locationmatch_section, end_nested_section, NULL, ACCESS_CONF, NO_ARGS,
2278 "Marks end of <LocationMatch>" },
2279 { "<FilesMatch", filesection, (void*)1, OR_ALL, RAW_ARGS,
2280 "Container for directives affecting files matching specified patterns" },
2281 { end_filesmatch_section, end_nested_section, NULL, OR_ALL, NO_ARGS,
2282 "Marks end of <FilesMatch>" },
2283 { "AuthType", ap_set_string_slot,
2284 (void*)XtOffsetOf(core_dir_config, ap_auth_type), OR_AUTHCFG, TAKE1,
2285 "An HTTP authorization type (e.g., \"Basic\")" },
2286 { "AuthName", set_authname, NULL, OR_AUTHCFG, TAKE1,
2287 "The authentication realm (e.g. \"Members Only\")" },
2288 { "Require", require, NULL, OR_AUTHCFG, RAW_ARGS,
2289 "Selects which authenticated users or groups may access a protected space" },
2290 { "Satisfy", satisfy, NULL, OR_AUTHCFG, TAKE1,
2291 "access policy if both allow and require used ('all' or 'any')" },
2293 { "GprofDir", set_gprof_dir, NULL, RSRC_CONF, TAKE1,
2294 "Directory to plop gmon.out files" },
2297 /* Old resource config file commands */
2299 { "AccessFileName", set_access_name, NULL, RSRC_CONF, RAW_ARGS,
2300 "Name(s) of per-directory config files (default: .htaccess)" },
2301 { "DocumentRoot", set_document_root, NULL, RSRC_CONF, TAKE1,
2302 "Root directory of the document tree" },
2303 { "ErrorDocument", set_error_document, NULL, OR_FILEINFO, RAW_ARGS,
2304 "Change responses for HTTP errors" },
2305 { "AllowOverride", set_override, NULL, ACCESS_CONF, RAW_ARGS,
2306 "Controls what groups of directives can be configured by per-directory "
2308 { "Options", set_options, NULL, OR_OPTIONS, RAW_ARGS,
2309 "Set a number of attributes for a given directory" },
2310 { "DefaultType", ap_set_string_slot,
2311 (void*)XtOffsetOf (core_dir_config, ap_default_type),
2312 OR_FILEINFO, TAKE1, "the default MIME type for untypable files" },
2314 /* Old server config file commands */
2316 { "Port", server_port, NULL, RSRC_CONF, TAKE1, "A TCP port number"},
2317 { "HostnameLookups", set_hostname_lookups, NULL, ACCESS_CONF|RSRC_CONF, TAKE1,
2318 "\"on\" to enable, \"off\" to disable reverse DNS lookups, or \"double\" to "
2319 "enable double-reverse DNS lookups" },
2320 { "ServerAdmin", set_server_string_slot,
2321 (void *)XtOffsetOf (server_rec, server_admin), RSRC_CONF, TAKE1,
2322 "The email address of the server administrator" },
2323 { "ServerName", set_server_string_slot,
2324 (void *)XtOffsetOf (server_rec, server_hostname), RSRC_CONF, TAKE1,
2325 "The hostname of the server" },
2326 { "ServerSignature", set_signature_flag, NULL, OR_ALL, TAKE1,
2327 "En-/disable server signature (on|off|email)" },
2328 { "ServerRoot", set_server_root, NULL, RSRC_CONF, TAKE1,
2329 "Common directory of server-related files (logs, confs, etc.)" },
2330 { "ErrorLog", set_server_string_slot,
2331 (void *)XtOffsetOf (server_rec, error_fname), RSRC_CONF, TAKE1,
2332 "The filename of the error log" },
2333 { "AccessConfig", set_server_string_slot,
2334 (void *)XtOffsetOf (server_rec, access_confname), RSRC_CONF, TAKE1,
2335 "The filename of the access config file" },
2336 { "ResourceConfig", set_server_string_slot,
2337 (void *)XtOffsetOf (server_rec, srm_confname), RSRC_CONF, TAKE1,
2338 "The filename of the resource config file" },
2339 { "ServerAlias", set_server_alias, NULL, RSRC_CONF, RAW_ARGS,
2340 "A name or names alternately used to access the server" },
2341 { "ServerPath", set_serverpath, NULL, RSRC_CONF, TAKE1,
2342 "The pathname the server can be reached at" },
2343 { "Timeout", set_timeout, NULL, RSRC_CONF, TAKE1, "Timeout duration (sec)" },
2344 { "KeepAliveTimeout", set_keep_alive_timeout, NULL, RSRC_CONF, TAKE1,
2345 "Keep-Alive timeout duration (sec)"},
2346 { "MaxKeepAliveRequests", set_keep_alive_max, NULL, RSRC_CONF, TAKE1,
2347 "Maximum number of Keep-Alive requests per connection, or 0 for infinite" },
2348 { "KeepAlive", set_keep_alive, NULL, RSRC_CONF, TAKE1,
2349 "Whether persistent connections should be On or Off" },
2350 { "IdentityCheck", set_idcheck, NULL, RSRC_CONF|ACCESS_CONF, FLAG,
2351 "Enable identd (RFC 1413) user lookups - SLOW" },
2352 { "ContentDigest", set_content_md5, NULL, OR_OPTIONS,
2353 FLAG, "whether or not to send a Content-MD5 header with each request" },
2354 { "UseCanonicalName", set_use_canonical_name, NULL,
2356 "How to work out the ServerName : Port when constructing URLs" },
2357 /* TODOC: MaxServers is deprecated */
2358 /* TODOC: ServersSafetyLimit is deprecated */
2359 /* TODO: RlimitFoo should all be part of mod_cgi, not in the core */
2360 /* TODOC: BindAddress deprecated */
2361 { "AddModule", add_module_command, NULL, RSRC_CONF, ITERATE,
2362 "The name of a module" },
2363 { "ClearModuleList", clear_module_list_command, NULL, RSRC_CONF, NO_ARGS,
2365 /* TODO: ListenBacklog in MPM */
2366 { "Include", include_config, NULL, (RSRC_CONF | ACCESS_CONF), TAKE1,
2367 "Name of the config file to be included" },
2368 { "LogLevel", set_loglevel, NULL, RSRC_CONF, TAKE1,
2369 "Level of verbosity in error logging" },
2370 { "NameVirtualHost", ap_set_name_virtual_host, NULL, RSRC_CONF, TAKE1,
2371 "A numeric IP address:port, or the name of a host" },
2373 { "BS2000Account", set_bs2000_account, NULL, RSRC_CONF, TAKE1,
2374 "Name of server User's bs2000 logon account name" },
2377 { "ScriptInterpreterSource", set_interpreter_source, NULL, OR_FILEINFO, TAKE1,
2378 "Where to find interpreter to run Win32 scripts (Registry or script shebang line)" },
2380 { "ServerTokens", set_serv_tokens, NULL, RSRC_CONF, TAKE1,
2381 "Determine tokens displayed in the Server: header - Min(imal), OS or Full" },
2382 { "LimitRequestLine", set_limit_req_line, NULL, RSRC_CONF, TAKE1,
2383 "Limit on maximum size of an HTTP request line"},
2384 { "LimitRequestFieldsize", set_limit_req_fieldsize, NULL, RSRC_CONF, TAKE1,
2385 "Limit on maximum size of an HTTP request header field"},
2386 { "LimitRequestFields", set_limit_req_fields, NULL, RSRC_CONF, TAKE1,
2387 "Limit (0 = unlimited) on max number of header fields in a request message"},
2388 { "LimitRequestBody", set_limit_req_body,
2389 (void*)XtOffsetOf(core_dir_config, limit_req_body),
2391 "Limit (in bytes) on maximum size of request message body" },
2395 /*****************************************************************
2397 * Core handlers for various phases of server operation...
2400 static int core_translate(request_rec *r)
2402 void *sconf = r->server->module_config;
2403 core_server_config *conf = ap_get_module_config(sconf, &core_module);
2406 return HTTP_FORBIDDEN;
2408 if ((r->uri[0] != '/') && strcmp(r->uri, "*")) {
2409 ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
2410 "Invalid URI in request %s", r->the_request);
2415 && !strncmp(r->uri, r->server->path, r->server->pathlen)
2416 && (r->server->path[r->server->pathlen - 1] == '/'
2417 || r->uri[r->server->pathlen] == '/'
2418 || r->uri[r->server->pathlen] == '\0')) {
2419 r->filename = ap_pstrcat(r->pool, conf->ap_document_root,
2420 (r->uri + r->server->pathlen), NULL);
2424 * Make sure that we do not mess up the translation by adding two
2425 * /'s in a row. This happens under windows when the document
2426 * root ends with a /
2428 if ((conf->ap_document_root[strlen(conf->ap_document_root)-1] == '/')
2429 && (*(r->uri) == '/')) {
2430 r->filename = ap_pstrcat(r->pool, conf->ap_document_root, r->uri+1,
2434 r->filename = ap_pstrcat(r->pool, conf->ap_document_root, r->uri,
2442 static int do_nothing(request_rec *r) { return OK; }
2445 * Default handler for MIME types without other handlers. Only GET
2446 * and OPTIONS at this point... anyone who wants to write a generic
2447 * handler for PUT or POST is free to do so, but it seems unwise to provide
2448 * any defaults yet... So, for now, we assume that this will always be
2449 * the last handler called and return 405 or 501.
2452 static int default_handler(request_rec *r)
2454 core_dir_config *d =
2455 (core_dir_config *)ap_get_module_config(r->per_dir_config, &core_module);
2456 int rangestatus, errstatus;
2457 ap_file_t *fd = NULL;
2459 #ifdef USE_MMAP_FILES
2460 ap_mmap_t *mm = NULL;
2462 #ifdef CHARSET_EBCDIC
2463 /* To make serving of "raw ASCII text" files easy (they serve faster
2464 * since they don't have to be converted from EBCDIC), a new
2465 * "magic" type prefix was invented: text/x-ascii-{plain,html,...}
2466 * If we detect one of these content types here, we simply correct
2467 * the type to the real text/{plain,html,...} type. Otherwise, we
2468 * set a flag that translation is required later on.
2470 int convert_flag = ap_checkconv(r);
2473 /* This handler has no use for a request body (yet), but we still
2474 * need to read and discard it if the client sent one.
2476 if ((errstatus = ap_discard_request_body(r)) != OK) {
2480 r->allowed |= (1 << M_GET) | (1 << M_OPTIONS);
2482 if (r->method_number == M_INVALID) {
2483 ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
2484 "Invalid method in request %s", r->the_request);
2485 return NOT_IMPLEMENTED;
2487 if (r->method_number == M_OPTIONS) {
2488 return ap_send_http_options(r);
2490 if (r->method_number == M_PUT) {
2491 return METHOD_NOT_ALLOWED;
2493 if (r->finfo.st_mode == 0 || (r->path_info && *r->path_info)) {
2494 ap_log_rerror(APLOG_MARK, APLOG_ERR|APLOG_NOERRNO, 0, r,
2495 "File does not exist: %s",r->path_info ?
2496 ap_pstrcat(r->pool, r->filename, r->path_info, NULL)
2498 return HTTP_NOT_FOUND;
2500 if (r->method_number != M_GET) {
2501 return METHOD_NOT_ALLOWED;
2504 if ((status = ap_open(&fd, r->filename, APR_READ | APR_BINARY, 0, r->pool)) != APR_SUCCESS) {
2505 ap_log_rerror(APLOG_MARK, APLOG_ERR, status, r,
2506 "file permissions deny server access: %s", r->filename);
2510 ap_update_mtime(r, r->finfo.st_mtime);
2511 ap_set_last_modified(r);
2513 ap_table_setn(r->headers_out, "Accept-Ranges", "bytes");
2514 if (((errstatus = ap_meets_conditions(r)) != OK)
2515 || (errstatus = ap_set_content_length(r, r->finfo.st_size))) {
2520 #ifdef USE_MMAP_FILES
2521 if ((r->finfo.st_size >= MMAP_THRESHOLD)
2522 && (r->finfo.st_size < MMAP_LIMIT)
2523 && (!r->header_only || (d->content_md5 & 1))) {
2524 /* we need to protect ourselves in case we die while we've got the
2526 if (ap_mmap_create(&mm, fd, 0, r->finfo.st_size, r->pool) != APR_SUCCESS){
2527 ap_log_rerror(APLOG_MARK, APLOG_CRIT, errno, r,
2528 "default_handler: mmap failed: %s", r->filename);
2539 #ifdef CHARSET_EBCDIC
2540 if (d->content_md5 & 1) {
2541 ap_table_setn(r->headers_out, "Content-MD5",
2542 ap_md5digest(r->pool, fd, convert_flag));
2545 if (d->content_md5 & 1) {
2546 ap_table_setn(r->headers_out, "Content-MD5",
2547 ap_md5digest(r->pool, fd));
2549 #endif /* CHARSET_EBCDIC */
2551 rangestatus = ap_set_byterange(r);
2553 ap_send_http_header(r);
2555 if (!r->header_only) {
2563 while (ap_each_byterange(r, &offset, &length)) {
2564 if ((status = ap_seek(fd, APR_SET, &offset)) != APR_SUCCESS) {
2565 ap_log_error(APLOG_MARK, APLOG_ERR, status, r->server,
2566 "error byteserving file: %s", r->filename);
2568 return HTTP_INTERNAL_SERVER_ERROR;
2570 ap_send_fd_length(fd, r, length);
2575 #ifdef USE_MMAP_FILES
2579 ap_mmap_offset((void**)&addr, mm ,0);
2581 if (d->content_md5 & 1) {
2584 ap_MD5Init(&context);
2585 ap_MD5Update(&context, addr, (unsigned int)r->finfo.st_size);
2586 ap_table_setn(r->headers_out, "Content-MD5",
2587 ap_md5contextTo64(r->pool, &context));
2590 rangestatus = ap_set_byterange(r);
2591 ap_send_http_header(r);
2593 if (!r->header_only) {
2595 ap_send_mmap(mm, r, 0, r->finfo.st_size);
2600 while (ap_each_byterange(r, &offset, &length)) {
2601 ap_send_mmap(mm, r, offset, length);
2612 static const handler_rec core_handlers[] = {
2613 { "*/*", default_handler },
2614 { "default-handler", default_handler },
2618 static void core_open_logs(ap_context_t *pconf, ap_context_t *plog, ap_context_t *ptemp, server_rec *s)
2620 ap_open_logs(s, pconf);
2623 static const char *core_method(const request_rec *r)
2626 static unsigned short core_port(const request_rec *r)
2627 { return DEFAULT_HTTP_PORT; }
2629 static void register_hooks(void)
2631 ap_hook_translate_name(core_translate,NULL,NULL,HOOK_REALLY_LAST);
2632 ap_hook_process_connection(ap_process_http_connection,NULL,NULL,
2634 ap_hook_http_method(core_method,NULL,NULL,HOOK_REALLY_LAST);
2635 ap_hook_default_port(core_port,NULL,NULL,HOOK_REALLY_LAST);
2636 ap_hook_open_logs(core_open_logs,NULL,NULL,HOOK_MIDDLE);
2637 /* FIXME: I suspect we can eliminate the need for these - Ben */
2638 ap_hook_type_checker(do_nothing,NULL,NULL,HOOK_REALLY_LAST);
2639 ap_hook_access_checker(do_nothing,NULL,NULL,HOOK_REALLY_LAST);
2642 API_VAR_EXPORT module core_module = {
2643 STANDARD20_MODULE_STUFF,
2644 create_core_dir_config, /* create per-directory config structure */
2645 merge_core_dir_configs, /* merge per-directory config structures */
2646 create_core_server_config, /* create per-server config structure */
2647 merge_core_server_configs, /* merge per-server config structures */
2648 core_cmds, /* command ap_table_t */
2649 core_handlers, /* handlers */
2650 register_hooks /* register hooks */