http_request.c revision 7e79e8fd53348f9fc6e8009a4a2522425ab6f08f
/* ====================================================================
* The Apache Software License, Version 1.1
*
* Copyright (c) 2000 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Apache" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
* software without prior written permission. For written
* permission, please contact apache@apache.org.
*
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
*
* Portions of this software are based upon public domain software
* originally written at the National Center for Supercomputing Applications,
* University of Illinois, Urbana-Champaign.
*/
/*
* http_request.c: functions to get and process requests
*
* Rob McCool 3/21/93
*
* Thoroughly revamped by rst for Apache. NB this file reads
* best from the bottom up.
*
*/
#define CORE_PRIVATE
#include "ap_config.h"
#include "httpd.h"
#include "http_config.h"
#include "http_request.h"
#include "http_core.h"
#include "http_protocol.h"
#include "http_log.h"
#include "http_main.h"
#include "apr_fnmatch.h"
)
/*****************************************************************
*
* Getting and checking directory configuration. Also checks the
* FollowSymlinks and FollowSymOwner stuff, since this is really the
* only place that can happen (barring a new mid_dir_walk callout).
*
* We can't do it as an access_checker module function which gets
* called with the final per_dir_config, since we could have a directory
* with FollowSymLinks disabled, which contains a symlink to another
* with a .htaccess file which turns FollowSymLinks back on --- and
* access in such a case must be denied. So, whatever it is that
* checks FollowSymLinks needs to know the state of the options as
* they change, all the way down.
*/
/*
* We don't want people able to serve up pipes, or unix sockets, or other
* scary things. Note that symlink tests are performed later.
*/
static int check_safe_file(request_rec *r)
{
return OK;
}
"object is not a file, directory or symlink: %s",
r->filename);
return HTTP_FORBIDDEN;
}
static int check_symlinks(char *d, int opts)
{
/* OS/2 doesn't have symlinks */
return OK;
#else
char *lastp;
int res;
if (opts & OPT_SYM_LINKS)
return OK;
/*
* Strip trailing '/', if any, off what we're checking; trailing slashes
* make some systems follow symlinks to directories even in lstat().
* After we've done the lstat, put it back. Also, don't bother checking
* '/' at all...
*
* Note that we don't have to worry about multiple slashes here because of
* no2slash() below...
*/
if (lastp == d)
return OK; /* Root directory, '/' */
if (*lastp == '/')
*lastp = '\0';
else
if (lastp)
*lastp = '/';
/*
* Note that we don't reject accesses to nonexistent files (multiviews or
* the like may cons up a way to run the transaction anyway)...
*/
return OK;
/* OK, it's a symlink. May still be OK with OPT_SYM_OWNER */
if (!(opts & OPT_SYM_OWNER))
return HTTP_FORBIDDEN;
return HTTP_FORBIDDEN;
#endif
}
/* Dealing with the file system to get PATH_INFO
*/
static int get_path_info(request_rec *r)
{
char *cp;
int rv;
#ifdef HAVE_DRIVE_LETTERS
char bStripSlash=1;
#endif
if (r->finfo.protection) {
/* assume path_info already set */
return OK;
}
#ifdef HAVE_DRIVE_LETTERS
/* If the directory is x:\, then we don't want to strip
* the trailing slash since x: is not a valid directory.
*/
bStripSlash = 0;
* advance over the trailing slash. Any other
* UNC name is OK to strip the slash.
*/
char *p;
int iCount=0;
p = path;
p++;
iCount++;
}
if (iCount == 4)
bStripSlash = 0;
}
if (bStripSlash)
#endif
/* Advance over trailing slashes ... NOT part of filename
* if file is not a UNC name (Win32 only).
*/
continue;
/* See if the pathname ending here exists... */
*cp = '\0';
/* We must not stat() filenames that may cause os-specific system
* So pretend that they do not exist by returning an ENOENT error.
* This will force us to drop that part of the path and keep
* looking back for a "real" file that exists, while still allowing
* the "invalid" path parts within the PATH_INFO.
*/
if (!ap_os_is_filename_valid(path)) {
rv = -1;
}
else {
errno = 0;
}
*cp = '/';
if (rv == APR_SUCCESS) {
/*
* Aha! Found something. If it was a directory, we will search
* contents of that directory for a multi_match, so the PATH_INFO
* argument starts with the component after that.
*/
}
*cp = '\0';
return OK;
}
/* must set this to zero, some stat()s may have corrupted it
* even if they returned an error.
*/
r->finfo.protection = 0;
#if defined(APR_ENOENT) && defined(APR_ENOTDIR)
continue;
--cp;
}
else {
#if defined(APR_EACCES)
if (rv != APR_EACCES)
#endif
"access to %s failed", r->uri);
return HTTP_FORBIDDEN;
}
#else
/*
* If ENOENT || ENOTDIR is not defined in one of the your OS's
* include files, Apache does not know how to check to see why the
* stat() of the index file failed; there are cases where it can fail
* even though the file exists. This means that it is possible for
* someone to get a directory listing of a directory even though
* there is an index (eg. index.html) file in it. If you do not have
* a problem with this, delete the above #error lines and start the
* compile again. If you need to do this, please submit a bug report
* from http://www.apache.org/bug_report.html letting us know that
* you needed to do this. Please be sure to include the operating
* system you are using.
*/
continue;
--cp;
#endif /* ENOENT && ENOTDIR */
}
return OK;
}
static int directory_walk(request_rec *r)
{
&core_module);
char *test_filename;
char *test_dirname;
int res;
int j, test_filename_len;
/*
* Are we dealing with a file? If not, we can (hopefuly) safely assume we
* have a handler that doesn't require one, but for safety's sake, and so
* we have something find_types() can get something out of, fake one. But
* don't run through the directory entries.
*/
return OK;
}
/*
* Go down the directory hierarchy. Where we have to check for symlinks,
* do so. Where a .htaccess file has permission to override anything,
* try to find one. If either of these things fails, we could poke
* around, see why, and adjust the lookup_rec accordingly --- this might
* save us a call to get_path_info (with the attendant stat()s); however,
* for the moment, that's not worth the trouble.
*
* Fake filenames (i.e. proxy:) only match Directory sections.
*/
if (!ap_os_is_path_absolute(r->filename))
{
void *this_conf, *entry_config;
char *entry_dir;
for (j = 0; j < num_sec; ++j) {
entry_config = sec[j];
entry_core = (core_dir_config *)
entry_dir = entry_core->d;
if (entry_core->r) {
}
else if (entry_core->d_is_fnmatch) {
}
if (this_conf)
}
return OK;
}
res = get_path_info(r);
return res;
}
if (!ap_os_is_filename_valid(r->filename)) {
"Filename is not valid: %s", r->filename);
return HTTP_FORBIDDEN;
}
if ((res = check_safe_file(r))) {
return res;
}
--num_dirs;
++num_dirs;
/*
* We will use test_dirname as scratch space while we build directory
* names during the walk. Profiling shows directory_walk to be a busy
* function so we try to avoid allocating lots of extra memory here.
* We need 2 extra bytes, one for trailing \0 and one because
* make_dirstr_prefix will add potentially one extra /.
*/
iStart = 1;
#ifdef WIN32
/* If the name is a UNC name, then do not walk through the
* machine and share name (e.g. \\machine\share\)
*/
iStart = 4;
#endif
/* j keeps track of which section we're on, see core_reorder_directories */
j = 0;
int overrides_here;
/*
* XXX: this could be made faster by only copying the next component
* rather than copying the entire thing all over.
*/
/*
* Do symlink checks first, because they are done with the
* permissions appropriate to the *parent* directory...
*/
"Symbolic link not allowed: %s", test_dirname);
return res;
}
/*
* Begin *this* level by looking for matching <Directory> sections
* from access.conf.
*/
for (; j < num_sec; ++j) {
void *entry_config = sec[j];
char *entry_dir;
void *this_conf;
entry_core = (core_dir_config *)
entry_dir = entry_core->d;
if (entry_core->r
|| entry_core->d_components > i)
break;
if (entry_core->d_is_fnmatch) {
}
}
if (this_conf) {
core_dir = (core_dir_config *)
}
}
/* If .htaccess files are enabled, check for one. */
if (overrides_here) {
void *htaccess_conf = NULL;
sconf->access_name);
if (res)
return res;
if (htaccess_conf) {
}
}
}
/*
* There's two types of IS_SPECIAL sections (see http_core.c), and we've
* already handled the proxy:-style stuff. Now we'll deal with the
* regexes.
*/
for (; j < num_sec; ++j) {
void *entry_config = sec[j];
entry_core = (core_dir_config *)
if (entry_core->r) {
}
}
}
/*
* Symlink permissions are determined by the parent. If the request is
* for a directory then applying the symlink test here would use the
* permissions of the directory as opposed to its parent. Consider a
* symlink pointing to a dir with a .htaccess disallowing symlinks. If
* you access /symlink (or /symlink/) you would get a 403 without this
* S_ISDIR test. But if you accessed /symlink/index.html, for example,
* you would *not* get the 403.
*/
"Symbolic link not allowed: %s", r->filename);
return res;
}
return OK; /* Can only "fail" if access denied by the
* symlink goop. */
}
static int location_walk(request_rec *r)
{
&core_module);
void *per_dir_defaults = r->per_dir_config;
char *test_location;
void *this_conf, *entry_config;
char *entry_url;
int j;
if (!num_url) {
return OK;
}
/* Location and LocationMatch differ on their behaviour w.r.t. multiple
* slashes. Location matches multiple slashes with a single slash,
* LocationMatch doesn't. An exception, for backwards brokenness is
* absoluteURIs... in which case neither match multiple slashes.
*/
if (r->uri[0] != '/') {
test_location = r->uri;
}
else {
}
/* Go through the location entries, and check for matches. */
/* we apply the directive sections in some order;
* should really try them with the most general first.
*/
for (j = 0; j < num_url; ++j) {
entry_config = url[j];
entry_core = (core_dir_config *)
entry_url = entry_core->d;
if (entry_core->r) {
}
else if (entry_core->d_is_fnmatch) {
}
}
if (this_conf)
}
return OK;
}
static int file_walk(request_rec *r)
{
void *per_dir_defaults = r->per_dir_config;
char *test_file;
/* get the basename */
}
else {
++test_file;
}
/* Go through the file entries, and check for matches. */
if (num_files) {
void *this_conf, *entry_config;
char *entry_file;
int j;
/* we apply the directive sections in some order;
* should really try them with the most general first.
*/
for (j = 0; j < num_files; ++j) {
entry_config = file[j];
entry_core = (core_dir_config *)
entry_file = entry_core->d;
if (entry_core->r) {
}
else if (entry_core->d_is_fnmatch) {
}
}
}
if (this_conf)
}
}
return OK;
}
/*****************************************************************
*
* The sub_request mechanism.
*
* Fns to look up a relative URI from, e.g., a map file or SSI document.
* These do all access checks, etc., but don't actually run the transaction
* ... use run_sub_req below for that. Also, be sure to use destroy_sub_req
* as appropriate if you're likely to be creating more than a few of these.
* (An early Apache version didn't destroy the sub_reqs used in directory
* indexing. The result, when indexing a directory with 800-odd files in
* it, was massively excessive storage allocation).
*
* Note more manipulation of protocol-specific vars in the request
* structure...
*/
{
return rr;
}
const char *new_file,
const request_rec *r)
{
int res;
char *udir;
rnew = make_sub_request(r);
/* would be nicer to pass "method" to ap_set_sub_req_protocol */
if (new_file[0] == '/')
else {
}
if (res) {
return rnew;
}
return rnew;
}
if (res) {
return rnew;
}
/*
* We could be clever at this point, and avoid calling directory_walk,
* etc. However, we'd need to test that the old and new filenames contain
* the same directory components, so it would require duplicating the
* start of translate_name. Instead we rely on the cache of .htaccess
* results.
*
* NB: directory_walk() clears the per_dir_config, so we don't inherit
* from location_walk() above
*/
&& (!ap_some_auth_required(rnew)
)
) {
}
return rnew;
}
const request_rec *r)
{
}
const request_rec *r)
{
int res;
char *fdir;
rnew = make_sub_request(r);
/*
* Check for a special case... if there are no '/' characters in new_file
* at all, then we are looking at a relative lookup in the same
* directory. That means we won't have to redo directory_walk, and we may
* not even have to redo access checks.
*/
}
return rnew;
}
/*
* no matter what, if it's a subdirectory, we need to re-run
* directory_walk
*/
if (!res) {
}
}
else {
return rnew;
}
/*
* do a file_walk, if it doesn't change the per_dir_config then
* we know that we don't have to redo all the access checks
*/
return rnew;
}
}
return rnew;
}
}
}
else {
/* XXX: @@@: What should be done with the parsed_uri values? */
/*
* XXX: this should be set properly like it is in the same-dir case
* but it's actually sometimes to impossible to do it... because the
* file may not have a uri associated with it -djg
*/
if (!res) {
}
}
if (res
&& (!ap_some_auth_required(rnew)
)
) {
}
return rnew;
}
{
#ifndef CHARSET_EBCDIC
int retval = ap_invoke_handler(r);
#else /*CHARSET_EBCDIC*/
/* Save the EBCDIC conversion setting of the caller across subrequests */
int retval = ap_invoke_handler(r);
#endif /*CHARSET_EBCDIC*/
return retval;
}
{
/* Reclaim the space */
ap_destroy_pool(r->pool);
}
/*****************************************************************
*
* Mainline request processing...
*/
{
int recursive_error = 0;
return;
}
/*
* The following takes care of Apache redirects to custom response URLs
* Note that if we are already dealing with the response to some other
* error condition, we just report on the original error, and give up on
* any attempt to handle the other thing "intelligently"...
*/
r = r->prev; /* Get back to original error */
}
/*
* This test is done here so that none of the auth modules needs to know
* about proxy authentication. They treat it like normal auth, and then
* we tweak the status.
*/
}
/*
* If we want to keep the connection, be sure that the request body
* (if any) has been read.
*/
&& !ap_status_drops_connection(r->status)
(void) ap_discard_request_body(r);
}
/*
* Two types of custom redirects --- plain text, and URLs. Plain text has
* a leading '"', so the URL code, here, is triggered on its absence
*/
if (ap_is_url(custom_response)) {
/*
* The URL isn't local, so lets drop through the rest of this
* apache code, and continue with the usual REDIRECT handler.
* But note that the client will ultimately see the wrong
* status...
*/
}
else if (custom_response[0] == '/') {
const char *error_notes;
* error documents! */
/*
* This redirect needs to be a GET no matter what the original
* method was.
*/
/*
* Provide a special method for modules to communicate
* more informative (than the plain canned) messages to us.
* Propagate them to ErrorDocuments via the ERROR_NOTES variable:
*/
}
r->method_number = M_GET;
return;
}
else {
/*
* Dumb user has given us a bad url to redirect to --- fake up
* dying with a recursive server error...
*/
"Invalid error redirection directive: %s",
}
}
}
{
ap_die(SERVER_ERROR, r);
}
else
}
{
/* Is there a require line configured for the type of *this* req? */
int i;
if (!reqs_arr)
return 0;
return 1;
return 0;
}
static void process_request_internal(request_rec *r)
{
int access_status;
/* Ignore embedded %2F's in path for proxy requests */
if (access_status) {
ap_die(access_status, r);
return;
}
}
if ((access_status = location_walk(r))) {
ap_die(access_status, r);
return;
}
if ((access_status = ap_run_translate_name(r))) {
return;
}
if (!r->proxyreq) {
/*
* We don't want TRACE to run through the normal handler set, we
* handle it specially.
*/
if (r->method_number == M_TRACE) {
if ((access_status = ap_send_http_trace(r)))
ap_die(access_status, r);
else
return;
}
}
}
/*
* NB: directory_walk() clears the per_dir_config, so we don't inherit
* from location_walk() above
*/
if ((access_status = directory_walk(r))) {
ap_die(access_status, r);
return;
}
if ((access_status = file_walk(r))) {
ap_die(access_status, r);
return;
}
if ((access_status = location_walk(r))) {
ap_die(access_status, r);
return;
}
if ((access_status = ap_run_header_parser(r))) {
ap_die(access_status, r);
return;
}
switch (ap_satisfies(r)) {
case SATISFY_ALL:
case SATISFY_NOSPEC:
if ((access_status = ap_run_access_checker(r)) != 0) {
return;
}
if (ap_some_auth_required(r)) {
? "check user. No user file?"
: "perform authentication. AuthType not set!", r);
return;
}
? "check access. No groups file?"
: "perform authentication. AuthType not set!", r);
return;
}
}
break;
case SATISFY_ANY:
if (!ap_some_auth_required(r)) {
? "check access"
: "perform authentication. AuthType not set!", r);
return;
}
? "check user. No user file?"
: "perform authentication. AuthType not set!", r);
return;
}
? "check access. No groups file?"
: "perform authentication. AuthType not set!", r);
return;
}
}
break;
}
if (! (r->proxyreq
if ((access_status = ap_run_type_checker(r)) != 0) {
return;
}
}
if ((access_status = ap_run_fixups(r)) != 0) {
ap_die(access_status, r);
return;
}
if ((access_status = ap_invoke_handler(r)) != 0) {
ap_die(access_status, r);
return;
}
/* Take care of little things that need to happen when we're done */
}
void ap_process_request(request_rec *r)
{
/*
* We want to flush the last packet if this isn't a pipelining connection
* *before* we start into logging. Suppose that the logging causes a DNS
* lookup to occur, which may have a high latency. If we hold off on
* this packet, then it'll appear like the link is stalled when really
* it's the application that's stalled.
*/
/* TODO: reimplement ap_bhalfduplex... not sure how yet */
/* //ap_bhalfduplex(r->connection->client); */
}
{
int i;
continue;
}
return new;
}
{
int access_status;
/*
* A whole lot of this really ought to be shared with http_protocol.c...
* another missing cleanup. It's particularly inappropriate to be
* setting header_only, etc., here.
*/
/* Inherit the rest of the protocol info... */
/*
* XXX: hmm. This is because mod_setenvif and mod_unique_id really need
* to do their thing on internal redirects as well. Perhaps this is a
* misnamed function.
*/
return NULL;
}
return new;
}
{
}
/* This function is designed for things like actions or CGI scripts, when
* using AddHandler, and you want to preserve the content type across
* an internal redirect.
*/
{
if (r->handler)
}
/*
* Is it the initial main request, which we only get *once* per HTTP request?
*/
{
return
&&
}
/*
* Function to set the r->mtime field to the specified value if it's later
* than what's already there.
*/
{
if (r->mtime < dependency_mtime) {
r->mtime = dependency_mtime;
}
}