| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
| <HTML> |
| <HEAD> |
| <TITLE>Apache module mod_userdir</TITLE> |
| </HEAD> |
| |
| <!-- Background white, links blue (unvisited), navy (visited), red (active) --> |
| <BODY |
| BGCOLOR="#FFFFFF" |
| TEXT="#000000" |
| LINK="#0000FF" |
| VLINK="#000080" |
| ALINK="#FF0000" |
| > |
| <!--#include virtual="header.html" --> |
| <H1 ALIGN="CENTER">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> |
| |
| |
| <h2><A name="userdir">UserDir</A></h2> |
| <!--%plaintext <?INDEX {\tt UserDir} directive> --> |
| <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 |
| UserDir http://www.foo.com/~*/ -> http://www.foo.com/~bob/one/two.html |
| </pre> |
| |
| <P> |
| <STRONG> |
| Be careful when using this directive; for instance, <SAMP>"UserDir |
| ./"</SAMP> would map <SAMP>"/~root"</SAMP> to |
| <SAMP>"/"</SAMP> - which is probably undesirable. See also |
| the |
| <A |
| HREF="core.html#directory" |
| ><Directory></A> |
| directive and the |
| <A |
| HREF="../misc/security_tips.html" |
| >Security Tips</A> |
| page for more information. |
| </STRONG> |
| </P> |
| |
| <!--#include virtual="footer.html" --> |
| </BODY> |
| </HTML> |
| |
