blob: a1a517faff8957eb59f2eb1d7b6af5b4f35b61f0 [file] [log] [blame]
<!--%hypertext -->
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<HTML>
<HEAD>
<TITLE>Apache module mod_userdir</TITLE>
</HEAD>
<BODY>
<IMG SRC="../images/apache_sub.gif" ALT="">
<!--/%hypertext -->
<H1>Module mod_userdir</h1>
This module is contained in the <code>mod_userdir.c</code> file, and
is compiled in by default. It provides for user-specific directories.
<!--%hypertext -->
<ul>
<li><A HREF="#userdir">UserDir</A>
</ul>
<hr>
<!--/%hypertext -->
<A name="userdir"><h2>UserDir</h2></A>
<!--%plaintext &lt;?INDEX {\tt UserDir} directive&gt; -->
<strong>Syntax:</strong> UserDir <em>directory/filename</em><br>
<strong>Default:</strong> <code>UserDir public_html</code><br>
<Strong>Context:</strong> server config, virtual host<br>
<strong>Status:</strong> Base<br>
<strong>Module:</strong> mod_userdir<p>
The UserDir directive sets the real directory in a user's home directory
to use when a request for a document for a user is received.
<em>Directory</em> is either <code>disabled</code>, to disable this feature,
or the name of a directory, following one of the following
patterns. If not disabled, then a request for
<code>http://www.foo.com/~bar/one/two.html</code> will be translated to:
<pre>
UserDir public_html -> ~bar/public_html/one/two.html
UserDir /usr/web -> /usr/web/bar/one/two.html
UserDir /home/*/www -> /home/bar/www/one/two.html
</pre>
The following directives will send redirects to the client:
<pre>
UserDir http://www.x.com/users -> http//www.x.com/users/bar/one/two.html
UserDir http://www.x.com/*/y -> http://www.x.com/y/one/two.html
</pre>
<!--%hypertext -->
<hr>
<A HREF="../"><IMG SRC="../images/apache_home.gif" ALT="Home"></A>
<A HREF="./"><IMG SRC="../images/apache_index.gif" ALT="Index"></A>
</BODY>
</HTML>
<!--/%hypertext -->