request.c revision fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb/* ====================================================================
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * The Apache Software License, Version 1.1
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Copyright (c) 2000-2001 The Apache Software Foundation. All rights
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * reserved.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Redistribution and use in source and binary forms, with or without
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * modification, are permitted provided that the following conditions
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * are met:
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * 1. Redistributions of source code must retain the above copyright
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * notice, this list of conditions and the following disclaimer.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * 2. Redistributions in binary form must reproduce the above copyright
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * notice, this list of conditions and the following disclaimer in
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * the documentation and/or other materials provided with the
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * distribution.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * 3. The end-user documentation included with the redistribution,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * if any, must include the following acknowledgment:
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * "This product includes software developed by the
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Apache Software Foundation (http://www.apache.org/)."
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Alternately, this acknowledgment may appear in the software itself,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * if and wherever such third-party acknowledgments normally appear.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * 4. The names "Apache" and "Apache Software Foundation" must
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * not be used to endorse or promote products derived from this
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * software without prior written permission. For written
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * permission, please contact apache@apache.org.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * 5. Products derived from this software may not be called "Apache",
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * nor may "Apache" appear in their name, without prior written
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * permission of the Apache Software Foundation.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * SUCH DAMAGE.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * ====================================================================
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * This software consists of voluntary contributions made by many
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * individuals on behalf of the Apache Software Foundation. For more
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * information on the Apache Software Foundation, please see
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Portions of this software are based upon public domain software
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * originally written at the National Center for Supercomputing Applications,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * University of Illinois, Urbana-Champaign.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * http_request.c: functions to get and process requests
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Rob McCool 3/21/93
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Thoroughly revamped by rst for Apache. NB this file reads
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * best from the bottom up.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbbAP_IMPLEMENT_HOOK_VOID(insert_filter, (request_rec *r), (r))
c3e342e5b0b9fea6617ee16d2da02c3ef2108126dougmAP_IMPLEMENT_HOOK_RUN_ALL(int,create_request,(request_rec *r),(r),OK,DECLINED)
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowestatic int decl_die(int status, char *phase, request_rec *r)
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_CRIT, 0, r,
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe "configuration error: couldn't %s: %s", phase, r->uri);
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe/* This is the master logic for processing requests. Do NOT duplicate
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * this logic elsewhere, or the security model will be broken by future
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * API changes. Each phase must be individually optimized to pick up
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * redundant/duplicate calls by subrequests, and redirects.
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewroweAP_DECLARE(int) ap_process_request_internal(request_rec *r)
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe /* Ignore embedded %2F's in path for proxy requests */
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe ap_getparents(r->uri); /* OK --- shrinking transformations... */
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe /* File-specific requests with no 'true' URI are a huge pain... they
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * cannot bubble through the next several steps. Only subrequests may
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * have an empty uri, otherwise let translate_name kill the request.
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe /* Reset to the server default config prior to running map_to_storage
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe /* This request wasn't in storage (e.g. TRACE) */
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe /* Excluding file-specific requests with no 'true' URI...
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe /* Rerun the location walk, which overrides any map_to_storage config.
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe /* Only on the main request! */
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe /* Skip authn/authz if the parent or prior request passed the authn/authz,
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * and that configuration didn't change (this requires optimized _walk()
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * functions in map_to_storage that use the same merge results given
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * identical input.) If the config changes, we must re-auth.
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe if (r->main && (r->main->per_dir_config == r->per_dir_config)) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe else if (r->prev && (r->prev->per_dir_config == r->per_dir_config)) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe switch (ap_satisfies(r)) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe if ((access_status = ap_run_access_checker(r)) != 0) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe if (((access_status = ap_run_check_user_id(r)) != 0) || !ap_auth_type(r)) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe ? "check user. No user file?"
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe : "perform authentication. AuthType not set!", r);
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe if (((access_status = ap_run_auth_checker(r)) != 0) || !ap_auth_type(r)) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe ? "check access. No groups file?"
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe : "perform authentication. AuthType not set!", r);
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe if (((access_status = ap_run_access_checker(r)) != 0) || !ap_auth_type(r)) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe ? "check access"
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe : "perform authentication. AuthType not set!", r);
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe if (((access_status = ap_run_check_user_id(r)) != 0) || !ap_auth_type(r)) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe ? "check user. No user file?"
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe : "perform authentication. AuthType not set!", r);
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe if (((access_status = ap_run_auth_checker(r)) != 0) || !ap_auth_type(r)) {
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe ? "check access. No groups file?"
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe : "perform authentication. AuthType not set!", r);
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe /* XXX Must make certain the ap_run_type_checker short circuits mime
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * in mod-proxy for r->proxyreq && r->parsed_uri.scheme
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * && !strcmp(r->parsed_uri.scheme, "http")
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe /* The new insert_filter stage makes sense here IMHO. We are sure that
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * we are going to run the request now, so we may as well insert filters
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * if any are available. Since the goal of this phase is to allow all
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * modules to insert a filter if they want to, this filter returns
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * void. I just can't see any way that this filter can reasonably
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe * fail, either your modules inserts something or it doesn't. rbb
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb/*****************************************************************
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Getting and checking directory configuration. Also checks the
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * FollowSymlinks and FollowSymOwner stuff, since this is really the
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * only place that can happen (barring a new mid_dir_walk callout).
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * We can't do it as an access_checker module function which gets
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * called with the final per_dir_config, since we could have a directory
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * with FollowSymLinks disabled, which contains a symlink to another
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * with a .htaccess file which turns FollowSymLinks back on --- and
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * access in such a case must be denied. So, whatever it is that
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * checks FollowSymLinks needs to know the state of the options as
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * they change, all the way down.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * We don't want people able to serve up pipes, or unix sockets, or other
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * scary things. Note that symlink tests are performed later.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb "object is not a file, directory or symlink: %s",
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * resolve_symlink must _always_ be called on an APR_LNK file type!
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * It will resolve the actual target file type, modification date, etc,
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * and provide any processing required for symlink evaluation.
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * Path must already be cleaned, no trailing slash, no multi-slashes,
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * and don't call this on the root!
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * Simply, the number of times we deref a symlink are minimal compared
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * to the number of times we had an extra lstat() since we 'weren't sure'.
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * To optimize, we stat() anything when given (opts & OPT_SYM_LINKS), otherwise
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * we start off with an lstat(). Every lstat() must be dereferenced in case
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * it points at a 'nasty' - we must always rerun check_safe_file (or similar.)
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowestatic int resolve_symlink(char *d, apr_finfo_t *lfi, int opts, apr_pool_t *p)
2f1949bb0e3c209db94c8d521cba7380b9d11421trawick if ((res = apr_stat(&fi, d, lfi->valid, p)) != APR_SUCCESS)
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe /* OPT_SYM_OWNER only works if we can get the owner of
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * both the file and symlink. First fill in a missing
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * owner of the symlink, then get the info of the target.
2f1949bb0e3c209db94c8d521cba7380b9d11421trawick if ((res = apr_lstat(&fi, d, lfi->valid | APR_FINFO_OWNER, p))
2f1949bb0e3c209db94c8d521cba7380b9d11421trawick if ((res = apr_stat(&fi, d, lfi->valid, p)) != APR_SUCCESS)
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe if (apr_compare_users(fi.user, lfi->user) != APR_SUCCESS)
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe /* Give back the target */
c6ed63d53853f79bf8265c434d2e25c9db8a7fd8trawick#endif /* REPLACE_PATH_INFO_METHOD */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbbstatic int check_symlinks(char *d, int opts, apr_pool_t *p)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb#if defined(OS2)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* OS/2 doesn't have symlinks */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Strip trailing '/', if any, off what we're checking; trailing slashes
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * make some systems follow symlinks to directories even in lstat().
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * After we've done the lstat, put it back. Also, don't bother checking
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * '/' at all...
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Note that we don't have to worry about multiple slashes here because of
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * no2slash() below...
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb res = apr_lstat(&lfi, d, APR_FINFO_TYPE | APR_FINFO_OWNER, p);
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Note that we don't reject accesses to nonexistent files (multiviews or
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * the like may cons up a way to run the transaction anyway)...
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* OK, it's a symlink. May still be OK with OPT_SYM_OWNER */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* OPT_SYM_OWNER only works if we can get the owner from the file */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb if (apr_stat(&fi, d, APR_FINFO_OWNER, p) != APR_SUCCESS)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* TODO: replace with an apr_compare_users() fn */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb/* Dealing with the file system to get PATH_INFO
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb#if defined(HAVE_DRIVE_LETTERS) || defined(HAVE_UNC_PATHS)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* assume path_info already set */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* If the directory is x:\, then we don't want to strip
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * the trailing slash since x: is not a valid directory.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb if (strlen(path) == 3 && path[1] == ':' && path[2] == '/')
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* If UNC name == //machine/share/, do not
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * advance over the trailing slash. Any other
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * UNC name is OK to strip the slash.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb#if defined(HAVE_DRIVE_LETTERS) || defined(HAVE_UNC_PATHS)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* Advance over trailing slashes ... NOT part of filename
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * if file is not a UNC name (Win32 only).
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* See if the pathname ending here exists... */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* ### We no longer need the test ap_os_is_filename_valid() here
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * since apr_stat isn't a posix thing - it's apr_stat's responsibility
b29f87f4b6c6886a04dccc296177a7033f70dfedtrawick * to handle whatever path string arrives at its door - by platform
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * and volume restrictions as applicable...
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * TODO: This code becomes even simpler if apr_stat grows
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * an APR_PATHINCOMPLETE result to indicate that we are staring at
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * an partial virtual root. Only OS2/Win32/Netware need apply it :-)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Aha! Found something. If it was a directory, we will search
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * contents of that directory for a multi_match, so the PATH_INFO
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * argument starts with the component after that.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb if (APR_STATUS_IS_ENOENT(rv) || APR_STATUS_IS_ENOTDIR(rv)) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb core_server_config *sconf = ap_get_module_config(r->server->module_config,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb ap_conf_vector_t *per_dir_defaults = r->server->lookup_defaults;
2fa5b5878e7567e2875807c3e2a2b3b0d3ef74bewrowe ap_conf_vector_t **sec_dir = (ap_conf_vector_t **) sconf->sec_dir->elts;
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb unsigned i, num_dirs;
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe /* "OK" as a response to a real problem is not _OK_, but to allow broken
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * modules to proceed, we will permit the not-a-path filename to pass here.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * We must catch it later if it's heading for the core handler. Leave an
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * INFO note here for module debugging.
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe if (r->filename == NULL || !ap_os_is_path_absolute(r->pool, r->filename)) {
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_INFO, 0, r,
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe "Module bug? Request filename path %s is missing or "
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe "or not absolute for uri %s",
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Go down the directory hierarchy. Where we have to check for symlinks,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * do so. Where a .htaccess file has permission to override anything,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * try to find one. If either of these things fails, we could poke
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * around, see why, and adjust the lookup_rec accordingly --- this might
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * save us a call to get_path_info (with the attendant stat()s); however,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * for the moment, that's not worth the trouble.
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe /* XXX Momentary period of extreme danger, Will Robinson.
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * Removed ap_os_canonical_filename. Anybody munging the
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * r->filename better have pre-canonicalized the name that
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * they just changed. Since the two most key functions
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * in the entire server, ap_server_root_relative() and
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * ap_make_full_path now canonicalize as they go.
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * To be very safe, the server is in hyper-paranoid mode.
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * That means that non-canonical paths will be captured and
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * denied. This is very cpu/fs intensive, we need to finish
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * auditing, and remove the paranoia trigger.
6fed20de38221f6f8a60c0ab1d907f1173c443f4wrowe if (apr_filepath_merge(&test_filename, "", r->filename,
6fed20de38221f6f8a60c0ab1d907f1173c443f4wrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
6fed20de38221f6f8a60c0ab1d907f1173c443f4wrowe "Module bug? Filepath: %s is not the canonical %s",
6fed20de38221f6f8a60c0ab1d907f1173c443f4wrowe /* Apparently, somebody didn't know to update r->canonical_filename
6fed20de38221f6f8a60c0ab1d907f1173c443f4wrowe * which is lucky, since they didn't canonicalize r->filename either.
6fed20de38221f6f8a60c0ab1d907f1173c443f4wrowe if (apr_filepath_merge(&test_filename, NULL, r->filename,
6fed20de38221f6f8a60c0ab1d907f1173c443f4wrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
6fed20de38221f6f8a60c0ab1d907f1173c443f4wrowe "Module bug? Filepath: %s is not an absolute path",
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * We will use test_dirname as scratch space while we build directory
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * names during the walk. Profiling shows directory_walk to be a busy
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * function so we try to avoid allocating lots of extra memory here.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * We need 2 extra bytes, one for trailing \0 and one because
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * make_dirstr_prefix will add potentially one extra /.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb test_dirname = apr_palloc(r->pool, test_filename_len + 2);
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe /* XXX The garbage below disappears in the new directory_walk;
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* If the name is a UNC name, then do not perform any true file test
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * against the machine name (start at //machine/share/)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * This is optimized to use the normal walk (skips the redundant '/' root)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb if (num_dirs > 3 && test_filename[0] == '/' && test_filename[1] == '/')
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb#if defined(NETWARE)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* If the name is a fully qualified volume name, then do not perform any
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * true file test on the machine name (start at machine/share:/)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * XXX: The implementation eludes me at this moment...
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Does this make sense? Please test!
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb if (num_dirs > 1 && strchr(test_filename, '/') < strchr(test_filename, ':'))
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe /* i keeps track of how many segments we are testing
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe * j keeps track of which section we're on, see core_reorder_directories
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb core_dir_config *core_dir = ap_get_module_config(per_dir_defaults,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * XXX: this could be made faster by only copying the next component
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * rather than copying the entire thing all over.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Do symlink checks first, because they are done with the
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * permissions appropriate to the *parent* directory...
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe /* Test only real names (after the root) against the real filesystem */
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe if ((i > iStart) && (res = check_symlinks(test_dirname, core_dir->opts, r->pool))) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Begin *this* level by looking for matching <Directory> sections
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb for (; j < num_sec; ++j) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb entry_core = ap_get_module_config(entry_config, &core_module);
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe /* We will always add in '0' element components, e.g. plain old
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe * <Directory >, and <Directory "/"> is classified as zero
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe * so that Win32/Netware/OS2 etc all pick that up.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb if (!apr_fnmatch(entry_dir, test_dirname, FNM_PATHNAME)) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* If .htaccess files are enabled, check for one. */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* Test only legal names against the real filesystem */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb res = ap_parse_htaccess(&htaccess_conf, r, overrides_here,
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe * Now we'll deal with the regexes.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb for (; j < num_sec; ++j) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb entry_core = ap_get_module_config(entry_config, &core_module);
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe if (!ap_regexec(entry_core->r, test_dirname, 0, NULL, REG_NOTEOL)) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Symlink permissions are determined by the parent. If the request is
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * for a directory then applying the symlink test here would use the
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * permissions of the directory as opposed to its parent. Consider a
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * symlink pointing to a dir with a .htaccess disallowing symlinks. If
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * you access /symlink (or /symlink/) you would get a 403 without this
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * APR_DIR test. But if you accessed /symlink/index.html, for example,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * you would *not* get the 403.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb && (res = check_symlinks(r->filename, ap_allow_options(r), r->pool))) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe /* Save a dummy userdata element till we optimize this function.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * If this userdata is set, directory_walk has run.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe apr_pool_userdata_set((void *)1, "ap_directory_walk::cache",
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * symlink goop. */
8aefbd756763807188d2e3ce336a8680e4893066wrowe#else /* defined REPLACE_PATH_INFO_METHOD */
8aefbd756763807188d2e3ce336a8680e4893066wrowe/*****************************************************************
8aefbd756763807188d2e3ce336a8680e4893066wrowe * Getting and checking directory configuration. Also checks the
8aefbd756763807188d2e3ce336a8680e4893066wrowe * FollowSymlinks and FollowSymOwner stuff, since this is really the
8aefbd756763807188d2e3ce336a8680e4893066wrowe * only place that can happen (barring a new mid_dir_walk callout).
8aefbd756763807188d2e3ce336a8680e4893066wrowe * We can't do it as an access_checker module function which gets
8aefbd756763807188d2e3ce336a8680e4893066wrowe * called with the final per_dir_config, since we could have a directory
8aefbd756763807188d2e3ce336a8680e4893066wrowe * with FollowSymLinks disabled, which contains a symlink to another
8aefbd756763807188d2e3ce336a8680e4893066wrowe * with a .htaccess file which turns FollowSymLinks back on --- and
8aefbd756763807188d2e3ce336a8680e4893066wrowe * access in such a case must be denied. So, whatever it is that
8aefbd756763807188d2e3ce336a8680e4893066wrowe * checks FollowSymLinks needs to know the state of the options as
8aefbd756763807188d2e3ce336a8680e4893066wrowe * they change, all the way down.
8aefbd756763807188d2e3ce336a8680e4893066wrowe core_server_config *sconf = ap_get_module_config(r->server->module_config,
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe ap_conf_vector_t *per_dir_defaults = r->per_dir_config;
2fa5b5878e7567e2875807c3e2a2b3b0d3ef74bewrowe ap_conf_vector_t **sec_ent = (ap_conf_vector_t **) sconf->sec_dir->elts;
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe /* XXX: Better (faster) tests needed!!!
8aa5ca8ff2a4d8e56f62ea3d461e2799136da085trawick * "OK" as a response to a real problem is not _OK_, but to allow broken
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * modules to proceed, we will permit the not-a-path filename to pass here.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * We must catch it later if it's heading for the core handler. Leave an
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * INFO note here for module debugging.
a8d11d78181478da6a672f7fbc58b8d523351f49wrowe if (r->filename == NULL || !ap_os_is_path_absolute(r->pool, r->filename)) {
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_INFO, 0, r,
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe "Module bug? Request filename path %s is missing or "
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe "or not absolute for uri %s",
8aefbd756763807188d2e3ce336a8680e4893066wrowe * Go down the directory hierarchy. Where we have to check for symlinks,
8aefbd756763807188d2e3ce336a8680e4893066wrowe * do so. Where a .htaccess file has permission to override anything,
8aefbd756763807188d2e3ce336a8680e4893066wrowe * try to find one. If either of these things fails, we could poke
8aefbd756763807188d2e3ce336a8680e4893066wrowe * around, see why, and adjust the lookup_rec accordingly --- this might
8aefbd756763807188d2e3ce336a8680e4893066wrowe * save us a call to get_path_info (with the attendant stat()s); however,
8aefbd756763807188d2e3ce336a8680e4893066wrowe * for the moment, that's not worth the trouble.
8aefbd756763807188d2e3ce336a8680e4893066wrowe * r->path_info tracks the remaining source path.
8aefbd756763807188d2e3ce336a8680e4893066wrowe * r->filename tracks the path as we build it.
8aefbd756763807188d2e3ce336a8680e4893066wrowe * we begin our adventure at the root...
8aefbd756763807188d2e3ce336a8680e4893066wrowe if ((rv = apr_filepath_merge(&r->path_info, NULL, r->filename,
8aefbd756763807188d2e3ce336a8680e4893066wrowe buflen = strlen(r->filename) + strlen(r->path_info) + 1;
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe r->finfo.filetype = APR_DIR; /* It's the root, of course it's a dir */
a8d11d78181478da6a672f7fbc58b8d523351f49wrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
a8d11d78181478da6a672f7fbc58b8d523351f49wrowe "Config bug? Request filename path %s is invalid or "
a8d11d78181478da6a672f7fbc58b8d523351f49wrowe "or not absolute for uri %s",
8aefbd756763807188d2e3ce336a8680e4893066wrowe * seg keeps track of which segment we've copied.
2fa5b5878e7567e2875807c3e2a2b3b0d3ef74bewrowe * sec_idx keeps track of which section we're on, since sections are
8aefbd756763807188d2e3ce336a8680e4893066wrowe * ordered by number of segments. See core_reorder_directories
8aefbd756763807188d2e3ce336a8680e4893066wrowe core_dir_config *core_dir = ap_get_module_config(per_dir_defaults,
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* We have no trailing slash, but we sure would appreciate one...
d11e96111ae8731e8785837b4c927d81bf33c9b6wrowe if (sec_idx && r->filename[strlen(r->filename)-1] != '/')
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* Begin *this* level by looking for matching <Directory> sections
8aefbd756763807188d2e3ce336a8680e4893066wrowe * from the server config.
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe const char *entry_dir;
8aefbd756763807188d2e3ce336a8680e4893066wrowe entry_core = ap_get_module_config(entry_config, &core_module);
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe /* No more possible matches for this many segments?
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe * We are done when we find relative/regex/longer components.
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe /* We will never skip '0' element components, e.g. plain old
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe * <Directory >, and <Directory "/"> are classified as zero
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe * so that Win32/Netware/OS2 etc all pick them up.
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe * Otherwise, skip over the mismatches.
4fca95918a9c0ae93593806544b425d0adc2fcc3wrowe ? (apr_fnmatch(entry_dir, r->filename, FNM_PATHNAME) != APR_SUCCESS)
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* If .htaccess files are enabled, check for one. */
8aefbd756763807188d2e3ce336a8680e4893066wrowe res = ap_parse_htaccess(&htaccess_conf, r, overrides_here,
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* That temporary trailing slash was useful, now drop it.
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* Time for all good things to come to an end?
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* Now it's time for the next segment...
8aefbd756763807188d2e3ce336a8680e4893066wrowe * We will assume the next element is an end node, and fix it up
8aefbd756763807188d2e3ce336a8680e4893066wrowe * below as necessary...
8aefbd756763807188d2e3ce336a8680e4893066wrowe delim = strchr(r->path_info + (*r->path_info == '/' ? 1 : 0), '/');
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* If nothing remained but a '/' string, we are finished
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* XXX: Optimization required:
8aefbd756763807188d2e3ce336a8680e4893066wrowe * If...we have allowed symlinks, and
8aefbd756763807188d2e3ce336a8680e4893066wrowe * if...we find the segment exists in the directory list
8aefbd756763807188d2e3ce336a8680e4893066wrowe * skip the lstat and dummy up an APR_DIR value for r->finfo
8aefbd756763807188d2e3ce336a8680e4893066wrowe * this means case sensitive platforms go quite quickly.
8aefbd756763807188d2e3ce336a8680e4893066wrowe * Case insensitive platforms might be given the wrong path,
8aefbd756763807188d2e3ce336a8680e4893066wrowe * but if it's not found in the cache, then we know we have
8aefbd756763807188d2e3ce336a8680e4893066wrowe * something to test (the misspelling is never cached.)
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* We choose apr_lstat here, rather that apr_stat, so that we
b29f87f4b6c6886a04dccc296177a7033f70dfedtrawick * capture this path object rather than its target. We will
8aefbd756763807188d2e3ce336a8680e4893066wrowe * replace the info with our target's info below. We especially
b29f87f4b6c6886a04dccc296177a7033f70dfedtrawick * want the name of this 'link' object, not the name of its
8aefbd756763807188d2e3ce336a8680e4893066wrowe * target, if we are fixing case.
8aefbd756763807188d2e3ce336a8680e4893066wrowe rv = apr_lstat(&r->finfo, r->filename, APR_FINFO_MIN | APR_FINFO_NAME, r->pool);
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* Nothing? That could be nice. But our directory walk is done.
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* If we hit ENOTDIR, we must have over-optimized, deny
8aefbd756763807188d2e3ce336a8680e4893066wrowe * rather than assume not found.
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* Fix up the path now if we have a name, and they don't agree
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* TODO: provide users an option that an internal/external
8aefbd756763807188d2e3ce336a8680e4893066wrowe * redirect is required here?
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* Is this an possibly acceptable symlink?
8aefbd756763807188d2e3ce336a8680e4893066wrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* Ok, we are done with the link's info, test the real target
8aefbd756763807188d2e3ce336a8680e4893066wrowe /* That was fun, nothing left for us here
8aefbd756763807188d2e3ce336a8680e4893066wrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
8aefbd756763807188d2e3ce336a8680e4893066wrowe "symlink doesn't point to a file or directory: %s",
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe * Now we'll deal with the regexes.
8aefbd756763807188d2e3ce336a8680e4893066wrowe entry_core = ap_get_module_config(entry_config, &core_module);
ac06e54654494445fd3d39e90bd23b436b4f84ccwrowe if (!ap_regexec(entry_core->r, r->filename, 0, NULL, REG_NOTEOL)) {
8aefbd756763807188d2e3ce336a8680e4893066wrowe/* It seems this shouldn't be needed anymore. We translated the symlink above
8aefbd756763807188d2e3ce336a8680e4893066wrowe x into a real resource, and should have died up there. Even if we keep this,
8aefbd756763807188d2e3ce336a8680e4893066wrowe x it needs more thought (maybe an r->file_is_symlink) perhaps it should actually
8aefbd756763807188d2e3ce336a8680e4893066wrowe x happen in file_walk, so we catch more obscure cases in autoindex sub requests, etc.
8aefbd756763807188d2e3ce336a8680e4893066wrowe x * Symlink permissions are determined by the parent. If the request is
8aefbd756763807188d2e3ce336a8680e4893066wrowe x * for a directory then applying the symlink test here would use the
8aefbd756763807188d2e3ce336a8680e4893066wrowe x * permissions of the directory as opposed to its parent. Consider a
8aefbd756763807188d2e3ce336a8680e4893066wrowe x * symlink pointing to a dir with a .htaccess disallowing symlinks. If
8aefbd756763807188d2e3ce336a8680e4893066wrowe x * you access /symlink (or /symlink/) you would get a 403 without this
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe x * APR_DIR test. But if you accessed /symlink/index.html, for example,
8aefbd756763807188d2e3ce336a8680e4893066wrowe x * you would *not* get the 403.
8aefbd756763807188d2e3ce336a8680e4893066wrowe x if (r->finfo.filetype != APR_DIR
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe x && (res = resolve_symlink(r->filename, r->info, ap_allow_options(r), r->pool))) {
8aefbd756763807188d2e3ce336a8680e4893066wrowe x ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, r,
8aefbd756763807188d2e3ce336a8680e4893066wrowe x "Symbolic link not allowed: %s", r->filename);
8aefbd756763807188d2e3ce336a8680e4893066wrowe x return res;
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe /* Save a dummy userdata element till we optimize this function.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * If this userdata is set, directory_walk has run.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe apr_pool_userdata_set((void *)1, "ap_directory_walk::cache",
8aefbd756763807188d2e3ce336a8680e4893066wrowe#endif /* defined REPLACE_PATH_INFO_METHOD */
948096a99010fccf648814fecf38f75c689172d7wrowetypedef struct walk_walked_t {
948096a99010fccf648814fecf38f75c689172d7wrowe ap_conf_vector_t *matched; /* A dir_conf sections we matched */
948096a99010fccf648814fecf38f75c689172d7wrowe ap_conf_vector_t *merged; /* The dir_conf merged result */
948096a99010fccf648814fecf38f75c689172d7wrowetypedef struct walk_cache_t {
948096a99010fccf648814fecf38f75c689172d7wrowe ap_conf_vector_t **dir_conf_tested;/* The sections we matched against */
948096a99010fccf648814fecf38f75c689172d7wrowe ap_conf_vector_t *per_dir_result; /* per_dir_config += walked result */
948096a99010fccf648814fecf38f75c689172d7wrowe apr_array_header_t *walked; /* The list of walk_walked_t results */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb core_server_config *sconf = ap_get_module_config(r->server->module_config,
053497224246c4dbef9af594cacf5c00ed271e6cwrowe ap_conf_vector_t **locations = (ap_conf_vector_t **) sconf->sec_url->elts;
948096a99010fccf648814fecf38f75c689172d7wrowe const char *entry_uri;
948096a99010fccf648814fecf38f75c689172d7wrowe /* Find the most relevant, recent entry to work from. That would be
948096a99010fccf648814fecf38f75c689172d7wrowe * this request (on the second call), or the parent request of a
948096a99010fccf648814fecf38f75c689172d7wrowe * subrequest, or the prior request of an internal redirect.
948096a99010fccf648814fecf38f75c689172d7wrowe if ((r->main && (apr_pool_userdata_get((void **)&cache,
948096a99010fccf648814fecf38f75c689172d7wrowe "ap_location_walk::cache",
948096a99010fccf648814fecf38f75c689172d7wrowe || (r->prev && (apr_pool_userdata_get((void **)&cache,
948096a99010fccf648814fecf38f75c689172d7wrowe "ap_location_walk::cache",
948096a99010fccf648814fecf38f75c689172d7wrowe cache->walked = apr_array_copy(r->pool, cache->walked);
948096a99010fccf648814fecf38f75c689172d7wrowe cache->walked = apr_array_make(r->pool, 4, sizeof(walk_walked_t));
948096a99010fccf648814fecf38f75c689172d7wrowe apr_pool_userdata_set(cache, "ap_location_walk::cache",
948096a99010fccf648814fecf38f75c689172d7wrowe /* No tricks here, there are no <Locations > to parse in this vhost.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * We won't destroy the cache, just in case _this_ redirect is later
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * redirected again to a vhost with <Location > blocks to optimize.
948096a99010fccf648814fecf38f75c689172d7wrowe /* Location and LocationMatch differ on their behaviour w.r.t. multiple
948096a99010fccf648814fecf38f75c689172d7wrowe * slashes. Location matches multiple slashes with a single slash,
948096a99010fccf648814fecf38f75c689172d7wrowe * LocationMatch doesn't. An exception, for backwards brokenness is
948096a99010fccf648814fecf38f75c689172d7wrowe * absoluteURIs... in which case neither match multiple slashes.
948096a99010fccf648814fecf38f75c689172d7wrowe /* If we have an cache->cached location that matches r->uri,
948096a99010fccf648814fecf38f75c689172d7wrowe * and the vhost's list of locations hasn't changed, we can skip
948096a99010fccf648814fecf38f75c689172d7wrowe * rewalking the location_walk entries.
948096a99010fccf648814fecf38f75c689172d7wrowe if (cache->cached && (cache->dir_conf_tested == locations)
948096a99010fccf648814fecf38f75c689172d7wrowe /* Well this looks really familiar! If our end-result (per_dir_result)
948096a99010fccf648814fecf38f75c689172d7wrowe * didn't change, we have absolutely nothing to do :)
948096a99010fccf648814fecf38f75c689172d7wrowe * Otherwise (as is the case with most dir_merged/file_merged requests)
948096a99010fccf648814fecf38f75c689172d7wrowe * we must merge our dir_conf_merged onto this new r->per_dir_config.
948096a99010fccf648814fecf38f75c689172d7wrowe /* We start now_merged from NULL since we want to build
948096a99010fccf648814fecf38f75c689172d7wrowe * a locations list that can be merged to any vhost.
948096a99010fccf648814fecf38f75c689172d7wrowe /* Go through the location entries, and check for matches.
948096a99010fccf648814fecf38f75c689172d7wrowe * We apply the directive sections in given order, we should
948096a99010fccf648814fecf38f75c689172d7wrowe * really try them with the most general first.
053497224246c4dbef9af594cacf5c00ed271e6cwrowe for (j = 0; j < num_loc; ++j) {
948096a99010fccf648814fecf38f75c689172d7wrowe entry_core = ap_get_module_config(locations[j], &core_module);
053497224246c4dbef9af594cacf5c00ed271e6cwrowe /* Test the regex, fnmatch or string as appropriate.
053497224246c4dbef9af594cacf5c00ed271e6cwrowe * If it's a strcmp, and the <Location > pattern was
053497224246c4dbef9af594cacf5c00ed271e6cwrowe * not slash terminated, then this uri must be slash
053497224246c4dbef9af594cacf5c00ed271e6cwrowe * terminated (or at the end of the string) to match.
948096a99010fccf648814fecf38f75c689172d7wrowe /* If we merged this same section last time, reuse it
948096a99010fccf648814fecf38f75c689172d7wrowe /* We fell out of sync. This is our own copy of walked,
948096a99010fccf648814fecf38f75c689172d7wrowe * so truncate the remaining matches and reset remaining.
948096a99010fccf648814fecf38f75c689172d7wrowe last_walk = (walk_walked_t*)apr_array_push(cache->walked);
948096a99010fccf648814fecf38f75c689172d7wrowe /* Whoops - everything matched in sequence, but the original walk
948096a99010fccf648814fecf38f75c689172d7wrowe * found some additional matches. Truncate them.
948096a99010fccf648814fecf38f75c689172d7wrowe /* Merge our cache->dir_conf_merged construct with the r->per_dir_configs,
948096a99010fccf648814fecf38f75c689172d7wrowe * and note the end result to (potentially) skip this step next time.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb core_dir_config *conf = ap_get_module_config(r->per_dir_config,
2fa5b5878e7567e2875807c3e2a2b3b0d3ef74bewrowe ap_conf_vector_t **file = (ap_conf_vector_t **) conf->sec_file->elts;
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe /* To allow broken modules to proceed, we allow missing filenames to pass.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * We will catch it later if it's heading for the core handler.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * directory_walk already posted an INFO note for module debugging.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* get the basename */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* Go through the file entries, and check for matches. */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* we apply the directive sections in some order;
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * should really try them with the most general first.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb for (j = 0; j < num_files; ++j) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb entry_core = ap_get_module_config(entry_config, &core_module);
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb if (!apr_fnmatch(entry_file, test_file, FNM_PATHNAME)) {
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe /* Save a dummy userdata element till we optimize this function.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe * If this userdata is set, file_walk has run.
dc8692c6c0ca616a09aa12dad005f2ef23baa1a0wrowe apr_pool_userdata_set((void *)1, "ap_file_walk::cache",
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb/*****************************************************************
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * The sub_request mechanism.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Fns to look up a relative URI from, e.g., a map file or SSI document.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * These do all access checks, etc., but don't actually run the transaction
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * ... use run_sub_req below for that. Also, be sure to use destroy_sub_req
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * as appropriate if you're likely to be creating more than a few of these.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * (An early Apache version didn't destroy the sub_reqs used in directory
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * indexing. The result, when indexing a directory with 800-odd files in
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * it, was massively excessive storage allocation).
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Note more manipulation of protocol-specific vars in the request
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * structure...
b38846b15c8891c6dec44dcc4f96ca40721bf663rbbstatic request_rec *make_sub_request(const request_rec *r)
e68544ae924174ca227ede8e2e722cefa00ea0d3wrowestatic void fill_in_sub_req_vars(request_rec *rnew, const request_rec *r,
e68544ae924174ca227ede8e2e722cefa00ea0d3wrowe rnew->request_config = ap_create_request_config(rnew->pool);
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe /* Start a clean config from this subrequest's vhost. Optimization in
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * Location/File/Dir walks from the parent request assure that if the
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * config blocks of the subrequest match the parent request, no merges
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * will actually occur (and generally a minimal number of merges are
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * required, even if the parent and subrequest aren't quite identical.)
e68544ae924174ca227ede8e2e722cefa00ea0d3wrowe rnew->allowed_methods = ap_make_method_list(rnew->pool, 2);
e68544ae924174ca227ede8e2e722cefa00ea0d3wrowe /* make a copy of the allowed-methods list */
e68544ae924174ca227ede8e2e722cefa00ea0d3wrowe ap_copy_method_list(rnew->allowed_methods, r->allowed_methods);
e68544ae924174ca227ede8e2e722cefa00ea0d3wrowe /* start with the same set of output filters */
e68544ae924174ca227ede8e2e722cefa00ea0d3wrowe ap_add_output_filter("SUBREQ_CORE", NULL, rnew, rnew->connection);
e68544ae924174ca227ede8e2e722cefa00ea0d3wrowe /* no input filters for a subrequest */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbbAP_CORE_DECLARE_NONSTD(apr_status_t) ap_sub_req_output_filter(ap_filter_t *f,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* Is there a require line configured for the type of *this* req? */
48d2edbfb84e5559b5da0f8d614ccab805cc67a8rbb if (reqs[i].method_mask & (AP_METHOD_BIT << r->method_number))
b67fb549910fa0faf4cdd8aeaf9aeab51d4b6a92wroweAP_DECLARE(request_rec *) ap_sub_req_method_uri(const char *method,
b67fb549910fa0faf4cdd8aeaf9aeab51d4b6a92wrowe const char *new_file,
1ab995011876f631740d68d960a6d729ddff5bfawrowe /* We have to run this after fill_in_sub_req_vars, or the r->main
b45c1c292ff1fa635004ae81fa691f8cb3cdda85rbb * pointer won't be setup
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* would be nicer to pass "method" to ap_set_sub_req_protocol */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb udir = ap_escape_uri(rnew->pool, udir); /* re-escape it */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb ap_parse_uri(rnew, ap_make_full_path(rnew->pool, udir, new_file));
b38846b15c8891c6dec44dcc4f96ca40721bf663rbbAP_DECLARE(request_rec *) ap_sub_req_lookup_uri(const char *new_file,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb return ap_sub_req_method_uri("GET", new_file, r, next_filter);
efa1a34b0a7785fc72863eff175b0cfc1ecb0e38wroweAP_DECLARE(request_rec *) ap_sub_req_lookup_dirent(const apr_finfo_t *dirent,
1ab995011876f631740d68d960a6d729ddff5bfawrowe /* We have to run this after fill_in_sub_req_vars, or the r->main
117026201e6d8fe7d82416b8a7324830f5a87292wrowe * pointer won't be setup
55eb5bb774cfb861542b827fbf4c30e6efbbfc44wrowe fdir = ap_make_dirstr_parent(rnew->pool, r->filename);
117026201e6d8fe7d82416b8a7324830f5a87292wrowe * Special case: we are looking at a relative lookup in the same directory.
117026201e6d8fe7d82416b8a7324830f5a87292wrowe * That means we won't have to redo directory_walk, and we may
117026201e6d8fe7d82416b8a7324830f5a87292wrowe * not even have to redo access checks.
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe /* This is 100% safe, since dirent->name just came from the filesystem */
117026201e6d8fe7d82416b8a7324830f5a87292wrowe rnew->uri = ap_make_full_path(rnew->pool, udir, dirent->name);
117026201e6d8fe7d82416b8a7324830f5a87292wrowe rnew->filename = ap_make_full_path(rnew->pool, fdir, dirent->name);
117026201e6d8fe7d82416b8a7324830f5a87292wrowe ap_parse_uri(rnew, rnew->uri); /* fill in parsed_uri values */
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe#if 0 /* XXX When this is reenabled, the cache triggers need to be set to faux
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * dir_walk/file_walk values. We also need to preserve the apr_stat
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * results into the new parser, which can't happen until the new dir_walk
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * is taught to recognize the condition, and perhaps we also tag that
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe * symlinks were tested and/or found for r->filename.
efa1a34b0a7785fc72863eff175b0cfc1ecb0e38wrowe if ((dirent->valid & APR_FINFO_MIN) != APR_FINFO_MIN) {
beda1fb2f11c52ca4612460a5d5ba47398143efbwrowe * apr_dir_read isn't very complete on this platform, so
beda1fb2f11c52ca4612460a5d5ba47398143efbwrowe * we need another apr_lstat (or simply apr_stat if we allow
beda1fb2f11c52ca4612460a5d5ba47398143efbwrowe * all symlinks here.) If this is an APR_LNK that resolves
beda1fb2f11c52ca4612460a5d5ba47398143efbwrowe * to an APR_DIR, then we will rerun everything anyways...
beda1fb2f11c52ca4612460a5d5ba47398143efbwrowe * this should be safe.
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe && (res = resolve_symlink(rnew->filename, &rnew->finfo,
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, rnew,
117026201e6d8fe7d82416b8a7324830f5a87292wrowe * no matter what, if it's a subdirectory, we need to re-run
117026201e6d8fe7d82416b8a7324830f5a87292wrowe * directory_walk
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe else if (rnew->finfo.filetype == APR_REG || !rnew->finfo.filetype) {
117026201e6d8fe7d82416b8a7324830f5a87292wrowe * do a file_walk, if it doesn't change the per_dir_config then
117026201e6d8fe7d82416b8a7324830f5a87292wrowe * we know that we don't have to redo all the access checks
b67fb549910fa0faf4cdd8aeaf9aeab51d4b6a92wroweAP_DECLARE(request_rec *) ap_sub_req_lookup_file(const char *new_file,
1ab995011876f631740d68d960a6d729ddff5bfawrowe /* We have to run this after fill_in_sub_req_vars, or the r->main
b67fb549910fa0faf4cdd8aeaf9aeab51d4b6a92wrowe * pointer won't be setup
ecc4a080f07af3fbc1b91bbd00997ec1d592c6f9wrowe /* Translate r->filename, if it was canonical, it stays canonical
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe if (apr_filepath_merge(&rnew->filename, fdir, new_file,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Check for a special case... if there are no '/' characters in new_file
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * at all, and the path was the same, then we are looking at a relative
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * lookup in the same directory. That means we won't have to redo
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * directory_walk, and we may not even have to redo access checks.
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * ### Someday we don't even have to redo the entire directory walk,
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe * either, if the base paths match, we can pick up where we leave off.
5bb29f57ae0184d2b3c1cdf35132f8ceb011f882wrowe && ap_strchr_c(rnew->filename + fdirlen, '/') == NULL)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb rnew->uri = ap_make_full_path(rnew->pool, udir, new_file);
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb ap_parse_uri(rnew, rnew->uri); /* fill in parsed_uri values */
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe#if 0 /* XXX When this is reenabled, the cache triggers need to be set to faux
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * If this is an APR_LNK that resolves to an APR_DIR, then
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe * we will rerun everything anyways... this should be safe.
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe && (res = resolve_symlink(rnew->filename, &rnew->finfo,
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, rnew,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * no matter what, if it's a subdirectory, we need to re-run
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * directory_walk
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe else if (rnew->finfo.filetype == APR_REG || !rnew->finfo.filetype) {
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * do a file_walk, if it doesn't change the per_dir_config then
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * we know that we don't have to redo all the access checks
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe ap_log_rerror(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, rnew,
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe "symlink doesn't point to a file or directory: %s",
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* XXX: @@@: What should be done with the parsed_uri values? */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb ap_parse_uri(rnew, new_file); /* fill in parsed_uri values */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * XXX: this should be set properly like it is in the same-dir case
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * but it's actually sometimes to impossible to do it... because the
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * file may not have a uri associated with it -djg
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb /* Reclaim the space */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Function to set the r->mtime field to the specified value if it's later
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * than what's already there.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbbAP_DECLARE(void) ap_update_mtime(request_rec *r, apr_time_t dependency_mtime)
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb * Is it the initial main request, which we only get *once* per HTTP request?
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb (r->main == NULL) /* otherwise, this is a sub-request */
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb (r->prev == NULL); /* otherwise, this is an internal redirect */