1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
<!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"
>
<DIV ALIGN="CENTER">
<IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]">
<H3>
Apache HTTP Server Version 1.3
</H3>
</DIV>
<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> -->
<A
HREF="directive-dict.html#Syntax"
REL="Help"
><STRONG>Syntax:</STRONG></A> UserDir <EM>directory/filename</EM><BR>
<A
HREF="directive-dict.html#Default"
REL="Help"
><STRONG>Default:</STRONG></A> <CODE>UserDir public_html</CODE><BR>
<A
HREF="directive-dict.html#Context"
REL="Help"
><STRONG>Context:</STRONG></A> server config, virtual host<BR>
<A
HREF="directive-dict.html#Status"
REL="Help"
><STRONG>Status:</STRONG></A> Base<BR>
<A
HREF="directive-dict.html#Module"
REL="Help"
><STRONG>Module:</STRONG></A> mod_userdir<BR>
<A
HREF="directive-dict.html#Compatibility"
REL="Help"
><STRONG>Compatibility:</STRONG></A> All forms except the <CODE>UserDir
public_html</CODE> form are only available in Apache 1.1 or above. Use
of the <SAMP>enabled</SAMP> keyword, or <SAMP>disabled</SAMP> with a
list of usernames, is only available in Apache 1.3 and 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/filename</EM> is one of the following:
</P>
<UL>
<LI>The name of a directory or a pattern such as those shown below.
</LI>
<LI>The keyword <SAMP>disabled</SAMP>. This turns off <EM>all</EM>
username-to-directory translations except those explicitly named with
the <SAMP>enabled</SAMP> keyword (see below).
</LI>
<LI>The keyword <SAMP>disabled</SAMP> 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 <SAMP>enabled</SAMP> clause.
</LI>
<LI>The keyword <SAMP>enabled</SAMP> 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 <SAMP>disabled</SAMP> clause.
</LI>
</UL>
<P>
If neither the <SAMP>enabled</SAMP> nor the <SAMP>disabled</SAMP>
keywords appear in the <SAMP>Userdir</SAMP> directive, the argument is
treated as a filename pattern, and is used to turn the name into a
directory specification. 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>
<BLOCKQUOTE>
<STRONG>
Be careful when using this directive; for instance,
<SAMP>"UserDir ./"</SAMP> would map
<SAMP>"/~root"</SAMP> to
<SAMP>"/"</SAMP> - which is probably undesirable. If you are
running Apache 1.3 or above, it is strongly recommended that your
configuration include a
"<SAMP>UserDir disabled root</SAMP>" declaration.
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>
</BLOCKQUOTE>
<HR>
<H3 ALIGN="CENTER">
Apache HTTP Server Version 1.3
</H3>
<A HREF="./"><IMG SRC="../images/index.gif" ALT="Index"></A>
<A HREF="../"><IMG SRC="../images/home.gif" ALT="Home"></A>
</BODY>
</HTML>
|
