PR:

Obtained from:
Submitted by:	Mathijs Maassen <mathijs@xs4all.nl>
Reviewed by:	Jim, Lars
Add the new DocumentRootCheck directive. This determines if we
check for each DocumentRoot during startup.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@83325 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/core.html b/docs/manual/mod/core.html
index 899eadd8009a0adeaf91293696b4197785b33046..588508df2abe01be6580303e58c75ea57a23edd0 100644 (file)
--- a/docs/manual/mod/core.html
+++ b/docs/manual/mod/core.html
@@ -36,6 +36,7 @@ always available.
 <LI><A HREF="#directory">&lt;Directory&gt;</A>
 <LI><A HREF="#directorymatch">&lt;DirectoryMatch&gt;</A>
 <LI><A HREF="#documentroot">DocumentRoot</A>
+<LI><A HREF="#documentrootCheck">DocumentRootCheck</A>
 <LI><A HREF="#errordocument">ErrorDocument</A>
 <LI><A HREF="#errorlog">ErrorLog</A>
 <LI><A HREF="#files">&lt;Files&gt;</A>
@@ -744,6 +745,41 @@ to <CODE>/usr/web/index.html</CODE>.
 DocumentRoot has a trailing slash (<EM>i.e.</EM>, "DocumentRoot /usr/web/") so
 please avoid that.
 
+<P><HR>
+
+<H2><A NAME="documentrootcheck">DocumentRootCheck directive</A></H2>
+<!--%plaintext &lt;?INDEX {\tt DocumentRootCheck} directive&gt; -->
+<A
+ HREF="directive-dict.html#Syntax"
+ REL="Help"
+><STRONG>Syntax:</STRONG></A> DocumentRootCheck <EM>On/Off</EM><BR>
+<A
+ HREF="directive-dict.html#Default"
+ REL="Help"
+><STRONG>Default:</STRONG></A> <CODE>DocumentRootCheck On</CODE><BR>
+<A
+ HREF="directive-dict.html#Context"
+ REL="Help"
+><STRONG>Context:</STRONG></A> server config<BR>
+<A
+ HREF="directive-dict.html#Status"
+ REL="Help"
+><STRONG>Status:</STRONG></A> core<BR>
+<A
+ HREF="directive-dict.html#Compatibility"
+ REL="Help"
+><STRONG>Compatibility:</STRONG></A> Available in Apache 1.3.7 and later
+<P>
+During startup, Apache does a <CODE>stat</CODE> of each
+<A HREF="#documentroot">DocumentRoot</A>
+to determine if the directory exists. If your server is
+configured with lots of DocumentRoot directives (for example,
+if you server numerous virtual hosts), this can <em>greatly</em> increase
+the startup time. If you are sure that all the DocumentRoot
+entries exist, you can tell Apache to bypass this check using
+<BLOCKQUOTE><CODE>DocumentRootCheck Off</CODE></BLOCKQUOTE>
+
+
 <P><HR>
 
 <H2><A NAME="errordocument">ErrorDocument directive</A></H2>

diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html
index a95fe97ec6bd40583eb174749c26646b9136def1..bfa608d6d8004d7d6a987c0cccfe060a737b39fb 100644 (file)
--- a/docs/manual/mod/directives.html
+++ b/docs/manual/mod/directives.html
@@ -95,6 +95,7 @@ of the terms used in their descriptions available.
 <LI><A HREF="core.html#directorymatch">&lt;DirectoryMatch&gt;</A>
 <LI><A HREF="mod_dir.html#directoryindex">DirectoryIndex</A>
 <LI><A HREF="core.html#documentroot">DocumentRoot</A>
+<LI><A HREF="core.html#documentrootcheck">DocumentRootCheck</A>
 <LI><A HREF="core.html#errordocument">ErrorDocument</A>
 <LI><A HREF="core.html#errorlog">ErrorLog</A>
 <LI><A HREF="mod_example.html#example">Example</A>