summaryrefslogtreecommitdiff
path: root/docs/manual/mod/mod_userdir.html
diff options
context:
space:
mode:
authorJoshua Slive <slive@apache.org>2002-03-06 17:08:19 +0000
committerJoshua Slive <slive@apache.org>2002-03-06 17:08:19 +0000
commitc3dcbcbfd937230afad94ab57556871a70e2890d (patch)
tree6db276ee96866f8447ae95eadbd535e134e2073a /docs/manual/mod/mod_userdir.html
parentc04a96e8632028fead450e85c2f0fdad8e3dcf51 (diff)
downloadhttpd-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.html208
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&nbsp;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&nbsp;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