summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorKen Coar <coar@apache.org>1997-12-16 21:57:38 +0100
committerKen Coar <coar@apache.org>1997-12-16 21:57:38 +0100
commitdfb1f0fb923dc25424ca1742bee8a41b435ecb4d (patch)
treeba6a3f3f26e2a86ace69a28fe033b426b50207c6 /docs
parentChange to URL to the mod_rewrite practical solutions, because (diff)
downloadapache2-dfb1f0fb923dc25424ca1742bee8a41b435ecb4d.tar.xz
apache2-dfb1f0fb923dc25424ca1742bee8a41b435ecb4d.zip
Correct some misstatements about the Auth*File directives;
they're ServerRoot-relative if not absolute. PR: 1511 git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@79709 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs')
-rw-r--r--docs/manual/mod/mod_auth.html24
1 files changed, 15 insertions, 9 deletions
diff --git a/docs/manual/mod/mod_auth.html b/docs/manual/mod/mod_auth.html
index bfb47a795a..c2db0344d1 100644
--- a/docs/manual/mod/mod_auth.html
+++ b/docs/manual/mod/mod_auth.html
@@ -38,12 +38,14 @@ textual files.
<strong>Module:</strong> mod_auth<p>
The AuthGroupFile directive sets the name of a textual file containing the list
-of user groups for user authentication. <em>Filename</em> is the absolute path
-to the group file.<p>
+of user groups for user authentication. <em>Filename</em> is the path
+to the group file. If it is not absolute (<EM>i.e.</EM>, if it
+doesn't begin with a slash), it is treated as relative to the ServerRoot.
+<P>
Each line of the group file contains a groupname followed by a colon, followed
by the member usernames separated by spaces. Example:
<blockquote><code>mygroup: bob joe anne</code></blockquote>
-Note that searching large groups files is <em>very</em> inefficient;
+Note that searching large text files is <em>very</em> inefficient;
<A HREF="mod_auth_dbm.html#authdbmgroupfile">AuthDBMGroupFile</A> should
be used instead.<p>
@@ -65,13 +67,17 @@ See also <A HREF="core.html#authname">AuthName</A>,
The AuthUserFile directive sets the name of a textual file containing
the list of users and passwords for user
-authentication. <em>Filename</em> is the absolute path to the user
-file.<p> Each line of the user file file contains a username followed
+authentication. <em>Filename</em> is the path to the user
+file. If it is not absolute (<EM>i.e.</EM>, if it doesn't begin with a
+slash), it is treated as relative to the ServerRoot.
+<p> Each line of the user file file contains a username followed
by a colon, followed by the crypt() encrypted password. The behavior
-of multiple occurrences of the same user is undefined.<p> Note that
-searching user groups files is inefficient; <A
-HREF="mod_auth_dbm.html#authdbmuserfile">AuthDBMUserFile</A> should be
-used instead.<p>
+of multiple occurrences of the same user is undefined.
+<p> Note that
+searching large text files is <EM>very</EM> inefficient;
+<A HREF="mod_auth_dbm.html#authdbmuserfile">AuthDBMUserFile</A> should be
+used instead.
+<p>
Security: make sure that the AuthUserFile is stored outside the
document tree of the web-server; do <em>not</em> put it in the directory that