mod_userdir.c revision b980ad7fdc218b4855cde9f75a747527f50c554d
3802a3d3d7af51ddff31943d5514382f01265770Lennart Poettering/* ====================================================================
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * The Apache Software License, Version 1.1
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Copyright (c) 2000 The Apache Software Foundation. All rights
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Redistribution and use in source and binary forms, with or without
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek * modification, are permitted provided that the following conditions
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek * 1. Redistributions of source code must retain the above copyright
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek * notice, this list of conditions and the following disclaimer.
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * 2. Redistributions in binary form must reproduce the above copyright
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek * notice, this list of conditions and the following disclaimer in
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek * the documentation and/or other materials provided with the
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * 3. The end-user documentation included with the redistribution,
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek * if any, must include the following acknowledgment:
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek * "This product includes software developed by the
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Apache Software Foundation (http://www.apache.org/)."
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Alternately, this acknowledgment may appear in the software itself,
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * if and wherever such third-party acknowledgments normally appear.
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * 4. The names "Apache" and "Apache Software Foundation" must
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * not be used to endorse or promote products derived from this
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * software without prior written permission. For written
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * permission, please contact apache@apache.org.
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * 5. Products derived from this software may not be called "Apache",
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * nor may "Apache" appear in their name, without prior written
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * permission of the Apache Software Foundation.
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * ====================================================================
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * This software consists of voluntary contributions made by many
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * individuals on behalf of the Apache Software Foundation. For more
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * information on the Apache Software Foundation, please see
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Portions of this software are based upon public domain software
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * originally written at the National Center for Supercomputing Applications,
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * University of Illinois, Urbana-Champaign.
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * mod_userdir... implement the UserDir command. Broken away from the
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * Alias stuff for a couple of good and not-so-good reasons:
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * 1) It shows a real minimal working example of how to do something like
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * 2) I know people who are actually interested in changing this *particular*
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * aspect of server functionality without changing the rest of it. That's
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * what this whole modular arrangement is supposed to be good at...
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Modified by Alexei Kosut to support the following constructs
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * (server running at www.foo.com, request for /~bar/one/two.html)
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * UserDir public_html -> ~bar/public_html/one/two.html
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * UserDir /usr/web -> /usr/web/bar/one/two.html
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * UserDir /home/ * /www -> /home/bar/www/one/two.html
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * NOTE: theses ^ ^ space only added allow it to work in a comment, ignore
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * UserDir http://x/users -> (302) http://x/users/bar/one/two.html
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * UserDir http://x/ * /y -> (302) http://x/bar/y/one/two.html
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * NOTE: here also ^ ^
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * In addition, you can use multiple entries, to specify alternate
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * user directories (a la Directory Index). For example:
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * UserDir public_html /usr/web http://www.xyz.com/users
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Modified by Ken Coar to provide for the following:
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * UserDir disable[d] username ...
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * UserDir enable[d] username ...
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * If "disabled" has no other arguments, *all* ~<username> references are
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * disabled, except those explicitly turned on with the "enabled" keyword.
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering#if !defined(WIN32) && !defined(OS2) && !defined(BEOS)
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering#include "unixd.h" /* Contains the suexec_identity hook used on Unix */
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering/* The default directory in user's home dir */
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek#define DEFAULT_USER_DIR "public_html"
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * Server config for this module: global disablement flag, a list of usernames
7f3fdb7f19a109fa3d1be92926bfe4cea1817da5Jakub Wilk * ineligible for UserDir access, a list of those immune to global (but not
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * explicit) disablement, and the replacement string for all others.
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poetteringstatic void *create_userdir_config(apr_pool_t *p, server_rec *s)
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * newcfg = (userdir_config *) apr_pcalloc(p, sizeof(userdir_config));
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering newcfg->enabled_users = apr_make_table(p, 4);
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering newcfg->disabled_users = apr_make_table(p, 4);
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering return (void *) newcfg;
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poetteringstatic const char *set_user_dir(cmd_parms *cmd, void *dummy, const char *arg)
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering * s_cfg = (userdir_config *) ap_get_module_config
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek char *kw = ap_getword_conf(cmd->pool, &usernames);
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Let's do the comparisons once.
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek if ((!strcasecmp(kw, "disable")) || (!strcasecmp(kw, "disabled"))) {
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * If there are no usernames specified, this is a global disable - we
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * need do no more at this point than record the fact.
8474b70c3a3842cdf3d51f331dd117ab6421f6d0Zbigniew Jędrzejewski-Szmek usertable = s_cfg->disabled_users;
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek else if ((!strcasecmp(kw, "enable")) || (!strcasecmp(kw, "enabled"))) {
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * The "disable" keyword can stand alone or take a list of names, but
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * the "enable" keyword requires the list. Whinge if it doesn't have
cc98b3025eeb89addb76a27390cb2baca4eab8b9Torstein Husebø return "UserDir \"enable\" keyword requires a list of usernames";
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek usertable = s_cfg->enabled_users;
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * If the first (only?) value isn't one of our keywords, just copy
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * the string to the userdir string.
8474b70c3a3842cdf3d51f331dd117ab6421f6d0Zbigniew Jędrzejewski-Szmek s_cfg->userdir = apr_pstrdup(cmd->pool, arg);
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * Now we just take each word in turn from the command line and add it to
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * the appropriate table.
8474b70c3a3842cdf3d51f331dd117ab6421f6d0Zbigniew Jędrzejewski-Szmek username = ap_getword_conf(cmd->pool, &usernames);
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek apr_table_setn(usertable, username, kw);
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmekstatic const command_rec userdir_cmds[] = {
8474b70c3a3842cdf3d51f331dd117ab6421f6d0Zbigniew Jędrzejewski-Szmek AP_INIT_RAW_ARGS("UserDir", set_user_dir, NULL, RSRC_CONF,
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek "the public subdirectory in users' home directories, or "
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek "'disabled', or 'disabled username username...', or "
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek "'enabled username username...'"),
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poetteringstatic int translate_userdir(request_rec *r)
dc83f27a7cf03757dec11a69ec18504ad4ea8f89Lennart Poettering void *server_conf = r->server->module_config;
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek (userdir_config *) ap_get_module_config(server_conf, &userdir_module);
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek const char *userdirs = s_cfg->userdir;
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek const char *w, *dname;
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * If the URI doesn't match our basic pattern, we've nothing to do with
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * The 'dname' funny business involves backing it up to capture the '/'
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * delimiting the "/~user" part from the rest of the URL, in case there
edf2573743b25273bee020230a60f1a054b8ec60Zbigniew Jędrzejewski-Szmek * was one (the case where there wasn't being just "GET /~user HTTP/1.0",
--dname;
return DECLINED;
return DECLINED;
return DECLINED;
while (*userdirs) {
#ifdef HAVE_DRIVE_LETTERS
return HTTP_MOVED_TEMPORARILY;
return HTTP_MOVED_TEMPORARILY;
#if APR_HAS_USER
char *homedir;
return DECLINED;
return OK;
return DECLINED;
#ifdef HAVE_UNIX_SUEXEC
return NULL;
return NULL;
return ugid;
#ifdef HAVE_UNIX_SUEXEC