mod_userdir.html revision d8b36a1d3cff82bbf78f1cc49babc67eb4dde481
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<HTML>
<HEAD>
<TITLE>Apache module mod_userdir</TITLE>
</HEAD>
<BODY>
<!--#include virtual="header.html" -->
<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.
<ul>
<li><A HREF="#userdir">UserDir</A>
</ul>
<hr>
<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<br>
<strong>Compatibility:</strong> All forms except the <code>UserDir
public_html</code> form are only available in Apache 1.1 or above.<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/~bob/one/two.html</code> will be translated to:
<pre>
UserDir public_html -> ~bob/public_html/one/two.html
UserDir /usr/web -> /usr/web/bob/one/two.html
UserDir /home/*/www -> /home/bob/www/one/two.html
</pre>
The following directives will send redirects to the client:
<pre>
UserDir http://www.foo.com/users -> http//www.foo.com/users/bob/one/two.html
UserDir http://www.foo.com/*/usr -> http://www.foo.com/bob/usr/one/two.html
</pre>
<!--#include virtual="footer.html" -->
</BODY>
</HTML>