diff options
author | Joshua Slive <slive@apache.org> | 2002-03-06 17:08:19 +0000 |
---|---|---|
committer | Joshua Slive <slive@apache.org> | 2002-03-06 17:08:19 +0000 |
commit | c3dcbcbfd937230afad94ab57556871a70e2890d (patch) | |
tree | 6db276ee96866f8447ae95eadbd535e134e2073a /docs/manual/mod/mod_userdir.html | |
parent | c04a96e8632028fead450e85c2f0fdad8e3dcf51 (diff) | |
download | httpd-c3dcbcbfd937230afad94ab57556871a70e2890d.tar.gz |
Bring the html transformations up-to-date.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@93731 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mod_userdir.html')
-rw-r--r-- | docs/manual/mod/mod_userdir.html | 208 |
1 files changed, 49 insertions, 159 deletions
diff --git a/docs/manual/mod/mod_userdir.html b/docs/manual/mod/mod_userdir.html index 7dd4ece574..fb51735aef 100644 --- a/docs/manual/mod/mod_userdir.html +++ b/docs/manual/mod/mod_userdir.html @@ -1,132 +1,47 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> -<!-- +<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ---> -<title>mod_userdir - Apache HTTP Server</title> -<link href="../style/manual.css" type="text/css" rel="stylesheet"> -</head> -<body> -<blockquote> -<div align="center"> -<img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"><h3>Apache HTTP Server Version 2.0</h3> -</div> -<h1 align="center">Apache Module mod_userdir</h1> -<table cellspacing="1" cellpadding="0" bgcolor="#cccccc"> -<tr> -<td> -<table bgcolor="#ffffff"> -<tr> -<td><span class="help">Description:</span></td><td> -<description>This module provides for user-specific -directories.</description> -</td> -</tr> -<tr> -<td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td> -</tr> -<tr> -<td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>userdir_module</td> -</tr> -</table> -</td> -</tr> -</table> -<h2>Summary</h2> -<summary> - -</summary> -<h2>Directives</h2> -<ul> -<li> -<a href="#userdir">UserDir</a> -</li> -</ul> -<hr> -<h2> -<a name="UserDir">UserDir</a> <a name="userdir">Directive</a> -</h2> -<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"> -<tr> -<td> -<table width="100%" bgcolor="#ffffff"> -<tr> -<td><strong>Description: </strong></td><td>Sets the directory from which to serve files when requests +--><title>mod_userdir - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_userdir</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>This module provides for user-specific +directories.</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>userdir_module</td></tr></table></td></tr></table><h2>Summary</h2><summary> +</summary><h2>Directives</h2><ul><li><a href="#userdir">UserDir</a></li></ul><hr/><h2><a name="UserDir">UserDir</a> <a name="userdir">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Sets the directory from which to serve files when requests for a particular user are received, denoted by requests containing ~username, such as -http://server.example.com/~bob/</td> -</tr> -<tr> -<td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td> -<syntax>UserDir <em>directory-filename</em> -</syntax> -</td> -</tr> -<tr> -<td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>UserDir public_html</code></td> -</tr> -<tr> -<td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual -host</td> -</tr> -<tr> -<td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td> -</tr> -<tr> -<td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_userdir</td> -</tr> -<tr> -<td><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>All forms except the UserDir public_html +http://server.example.com/~bob/</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>UserDir <em>directory-filename</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>UserDir public_html</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual +host</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_userdir</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>All forms except the UserDir public_html form are only available in Apache 1.1 or above. Use of the enabled keyword, or disabled with a list of usernames, is only available in Apache 1.3 and -above.</td> -</tr> -</table> -</td> -</tr> -</table> -<usage> +above.</td></tr></table></td></tr></table><usage> - -<p>The <code class="directive">UserDir</code> directive sets the real + <p>The <code class="directive">UserDir</code> 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-filename</em> is one of the following:</p> - -<ul> - -<li>The name of a directory or a pattern such as those shown + <ul> + <li>The name of a directory or a pattern such as those shown below.</li> - -<li>The keyword <code>disabled</code>. This turns off + <li>The keyword <code>disabled</code>. This turns off <em>all</em> username-to-directory translations except those explicitly named with the <code>enabled</code> keyword (see below).</li> - -<li>The keyword <code>disabled</code> followed by a + <li>The keyword <code>disabled</code> followed by a space-delimited list of usernames. Usernames that appear in such a list will <em>never</em> have directory translation performed, even if they appear in an <code>enabled</code> clause.</li> - -<li>The keyword <code>enabled</code> followed by a + <li>The keyword <code>enabled</code> followed by a space-delimited list of usernames. These usernames will have directory translation performed even if a global disable is in effect, but not if they also appear in a <code>disabled</code> clause.</li> - -</ul> + </ul> - -<p>If neither the <code>enabled</code> nor the + <p>If neither the <code>enabled</code> nor the <code>disabled</code> keywords appear in the <code>Userdir</code> directive, the argument is treated as a filename pattern, and is used to turn the name into a directory @@ -134,79 +49,54 @@ above.</td> <code>http://www.foo.com/~bob/one/two.html</code> will be translated to:</p> - <table> - -<tr> -<th>UserDir directive used</th> -<th>Translated path</th> -</tr> - -<tr> -<td>UserDir public_html</td><td>~bob/public_html/one/two.html</td> -</tr> - -<tr> -<td>UserDir /usr/web</td><td>/usr/web/bob/one/two.html</td> -</tr> - -<tr> -<td>UserDir /home/*/www</td><td>/home/bob/www/one/two.html</td> -</tr> - +<tr><th>UserDir directive used</th> +<th>Translated path</th></tr> +<tr><td>UserDir public_html</td><td>~bob/public_html/one/two.html</td></tr> +<tr><td>UserDir /usr/web</td><td>/usr/web/bob/one/two.html</td></tr> +<tr><td>UserDir /home/*/www</td><td>/home/bob/www/one/two.html</td></tr> </table> - -<p>The following directives will send redirects to the client:</p> - + <p>The following directives will send redirects to the client:</p> <table> - -<tr> -<th>UserDir directive used</th> -<th>Translated path</th> -</tr> - -<tr> -<td>UserDir http://www.foo.com/users</td><td>http://www.foo.com/users/bob/one/two.html</td> -</tr> - -<tr> -<td>UserDir -http://www.foo.com/*/usr</td><td>http://www.foo.com/bob/usr/one/two.html</td> -</tr> - -<tr> -<td>UserDir -http://www.foo.com/~*/</td><td>http://www.foo.com/~bob/one/two.html</td> -</tr> - +<tr><th>UserDir directive used</th> +<th>Translated path</th></tr> +<tr><td>UserDir http://www.foo.com/users</td><td>http://www.foo.com/users/bob/one/two.html</td></tr> +<tr><td>UserDir +http://www.foo.com/*/usr</td><td>http://www.foo.com/bob/usr/one/two.html</td></tr> +<tr><td>UserDir +http://www.foo.com/~*/</td><td>http://www.foo.com/~bob/one/two.html</td></tr> </table> - -<blockquote> -<table> -<tr> -<td bgcolor="#e0e5f5"> +<blockquote><table><tr><td bgcolor="#e0e5f5"> <strong>Be careful when using this directive; for instance, <code>"UserDir ./"</code> would map <code>"/~root"</code> to <code>"/"</code> - which is probably undesirable. If you are running Apache 1.3 or above, it is strongly recommended that your configuration include a "<code>UserDir disabled root</code>" declaration. - See also the <code class="directive"><a href="core.html#directory" class="directive">Directory</a></code> + See also the <a href="core.html#directory" class="directive"><code class="directive">Directory</code></a> directive and the <a href="../misc/security_tips.html">Security Tips</a> page for more information.</strong> -</td> -</tr> -</table> -</blockquote> +</td></tr></table></blockquote> + +<p>Additional examples:</p> + +<p>To allow a few users to have <code>UserDir</code> directories, but +not anyone else, use the following:</p> + +<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code> +UserDir disabled<br> +UserDir enabled user1 user2 user3 +</code></td></tr></table></blockquote> + +<p>To allow most users to have <code>UserDir</code> directories, but +deny this to a few, use the following:</p> +<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code> +UserDir enabled<br> +UserDir disabled user4 user5 user6 +</code></td></tr></table></blockquote> -</usage> -<hr> -<h3 align="center">Apache HTTP Server Version 2.0</h3> -<a href="./"><img alt="Index" src="../images/index.gif"></a><a href="../"><img alt="Home" src="../images/home.gif"></a> -</blockquote> -</body> -</html> +</usage><hr/><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img alt="Index" src="../images/index.gif"/></a><a href="../"><img alt="Home" src="../images/home.gif"/></a></blockquote></body></html>
\ No newline at end of file |