core.html.en revision 05201775eaa6b363b8a119c8aea5db246b967591
530eba85dbd41b8a0fa5255d3648d1440199a661slive<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
e942c741056732f50da2074b36fe59805d370650slive<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd This file is generated from xml source: DO NOT EDIT
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding --><title>core - Apache HTTP Server</title><link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /><link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /><link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link href="/images/favicon.ico" rel="shortcut icon" /></head><body><div id="page-header"><p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p><p class="apache">Apache HTTP Server Version 2.0</p><img alt="" src="/images/feather.gif" /></div><div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.0</a> > <a href="./">Modules</a></div><div id="page-content"><div id="preamble"><h1>Apache Module core</h1><table class="module"><tr><th><a href="module-dict.html#Description">Description:
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding </a></th><td>Core Apache HTTP Server features that are always
db479b48bd4d75423ed4a45e15b75089d1a8ad72fieldingavailable</td></tr><tr><th><a href="module-dict.html#Status">Status:
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding </a></th><td>Core</td></tr></table></div><div id="quickview"><h3 class="directives">Directives</h3><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding<li><img alt="" src="/images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding<li><img alt="" src="/images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#authname">AuthName</a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#authtype">AuthType</a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#directory"><Directory></a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<li><img alt="" src="/images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
7db9f691a00ead175b03335457ca296a33ddf31bnd<li><img alt="" src="/images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<li><img alt="" src="/images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<li><img alt="" src="/images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<li><img alt="" src="/images/down.gif" /> <a href="#fileetag">FileETag</a></li>
530eba85dbd41b8a0fa5255d3648d1440199a661slive<li><img alt="" src="/images/down.gif" /> <a href="#files"><Files></a></li>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<li><img alt="" src="/images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#forcetype">ForceType</a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#identitycheck">IdentityCheck</a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen<li><img alt="" src="/images/down.gif" /> <a href="#include">Include</a></li>
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen<li><img alt="" src="/images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#limit"><Limit></a></li>
e4e60c2f7ba8f12b687f588b89e413842e9f2d76igalic<li><img alt="" src="/images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
31127de9133204b2f09f6226250592ed93b61023rbowen<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
e4e60c2f7ba8f12b687f588b89e413842e9f2d76igalic<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
e4e60c2f7ba8f12b687f588b89e413842e9f2d76igalic<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
e4e60c2f7ba8f12b687f588b89e413842e9f2d76igalic<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor<li><img alt="" src="/images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe<li><img alt="" src="/images/down.gif" /> <a href="#location"><Location></a></li>
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe<li><img alt="" src="/images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe<li><img alt="" src="/images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor<li><img alt="" src="/images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe<li><img alt="" src="/images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe<li><img alt="" src="/images/down.gif" /> <a href="#options">Options</a></li>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic<li><img alt="" src="/images/down.gif" /> <a href="#require">Require</a></li>
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh<li><img alt="" src="/images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic<li><img alt="" src="/images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
4e9f8c5414e5fe39b5393641533edca65f6e8b91poirier<li><img alt="" src="/images/down.gif" /> <a href="#satisfy">Satisfy</a></li>
4e9f8c5414e5fe39b5393641533edca65f6e8b91poirier<li><img alt="" src="/images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
4e9f8c5414e5fe39b5393641533edca65f6e8b91poirier<li><img alt="" src="/images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
4e9f8c5414e5fe39b5393641533edca65f6e8b91poirier<li><img alt="" src="/images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
4e9f8c5414e5fe39b5393641533edca65f6e8b91poirier<li><img alt="" src="/images/down.gif" /> <a href="#servername">ServerName</a></li>
4e9f8c5414e5fe39b5393641533edca65f6e8b91poirier<li><img alt="" src="/images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic<li><img alt="" src="/images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic<li><img alt="" src="/images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic<li><img alt="" src="/images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic<li><img alt="" src="/images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor<li><img alt="" src="/images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna<li><img alt="" src="/images/down.gif" /> <a href="#timeout">TimeOut</a></li>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna</ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor </a></th><td>Resources accept trailing pathname information</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna </a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna </a></th><td><code>AcceptPathInfo Default</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>core</td></tr><tr><th><a href="directive-dict.html#Compatibility">Compatibility:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Available in Apache 2.0.30 and later</td></tr></table>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna <p>This directive controls whether requests that contain trailing
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna pathname information that follows an actual filename (or
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor non-existent file in an existing directory) will be accepted or
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna rejected. The trailing pathname information can be made
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor available to scripts in the PATH_INFO environment variable.</p>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna <p>For example, assume the location <code>/test/</code> points to
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna a directory that contains only the single file
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe <p>The three possible arguments for the
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe <code class="directive">AcceptPathInfo</code> directive are:</p>
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe <dt><code>off</code></dt><dd>A request will only be accepted if it
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe maps to a literal path that exists. Therefore a request with
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe trailing pathname information after the true filename such as
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe <code>/test/here.html/more</code> in the above example will return
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe a 404 NOT FOUND error.</dd>
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe <dt><code>on</code></dt><dd>A request will be accepted if a
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe leading path component maps to a file that exists. The above
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe example <code>/test/here.html/more</code> will be accepted if
e4e60c2f7ba8f12b687f588b89e413842e9f2d76igalic <code>/test/here.html</code> maps to a valid file.</dd>
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe <dt><code>default</code></dt><dd>The treatment of requests with
5ae609a8a09239d20f48a4a95c4f21b713995babwrowe trailing pathname information is determined by the <a href="/handler.html">handler</a> responsible for the request.
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor The core handler for normal files defaults to rejecting PATH_INFO.
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna Handlers that serve scripts, such as <a href="mod_cgi.html">cgi-script</a> and <a href="mod_isapi.html">isapi-isa</a>, generally accept PATH_INFO by
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna default.</dd>
7e8f5c6496b3825b6b128e2aacc4b1b09d28553dpquerna <p>The primary purpose of the <code>AcceptPathInfo</code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directive is to allow you to override the handler's choice of
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive accepting or rejecting PATH_INFO. This override is required, for
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess example, when you use a <a href="/filter.html">filter</a>, such
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive as <a href="mod_include.html">INCLUDES</a>, to generate content
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive based on PATH_INFO. The core handler would usually reject the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive request, so you can use the following configuration to enable
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive such a script:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Options +Includes<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive SetOutputFilter INCLUDES<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive AcceptPathInfo on<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </Files>
fb77c505254b6e9c925e23e734463e87574f8f40kess</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Name of the distributed configuration file</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>AccessFileName .htaccess</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
fb77c505254b6e9c925e23e734463e87574f8f40kess <p>When returning a document to the client the server looks for
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the first existing configuration file from this list of names in
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive every directory of the path to the document, if distributed
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive configuration files are enabled for that directory. For
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive example:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive AccessFileName .acl
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>before returning the document
fb77c505254b6e9c925e23e734463e87574f8f40kess <code>/usr/local/web/index.html</code>, the server will read
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code>/usr/local/.acl</code> and <code>/usr/local/web/.acl</code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive for directives, unless they have been disabled with</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <Directory /><br />
fb77c505254b6e9c925e23e734463e87574f8f40kess AllowOverride None<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </Directory>
fb77c505254b6e9c925e23e734463e87574f8f40kess<h3>See also</h3><ul><li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li><li><a href="/configuring.html">Configuration Files</a></li><li><a href="/howto/htaccess.html">.htaccess Files</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveresponse without an explicit character set</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>AddDefaultCharset Off</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
fb77c505254b6e9c925e23e734463e87574f8f40kess </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
fb77c505254b6e9c925e23e734463e87574f8f40kess </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
fb77c505254b6e9c925e23e734463e87574f8f40kess <p>This directive specifies the name of the character set that
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive will be added to any response that does not have any parameter on
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd the content type in the HTTP headers. This will override any
2aa51ed61adb484602e94de3d2214ec267aecedbigalic character set specified in the body of the document via a
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <code>META</code> tag. A setting of <code>AddDefaultCharset
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh Off</code> disables this
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh functionality. <code>AddDefaultCharset On</code> enables
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh Apache's internal default charset of <code>iso-8859-1</code> as
2aa51ed61adb484602e94de3d2214ec267aecedbigalic required by the directive. You can also specify an alternate
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive AddDefaultCharset utf-8
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>assigns an output filter to a particular MIME-type</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
003f0c9fda6664daf5092a0e42f65ede20098153slive </a></th><td><code>AddOutputFilterByType <var>filter</var>[;<var>filter</var>...] <var>MIME-type</var>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd[<var>MIME-type</var>] ...</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>core</td></tr><tr><th><a href="directive-dict.html#Compatibility">Compatibility:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Available in Apache 2.0.33 and later</td></tr></table>
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <p>This directive activates a particular output <a href="/filter.html">filter</a> for a request depending on the
003f0c9fda6664daf5092a0e42f65ede20098153slive response MIME-type.</p>
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess <p>The following example uses the DEFLATE filter, which is provided by
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code>. It will compress all output (either static
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive or dynamic) which is labeled as <code>text/html</code> or
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh <code>text/plain</code> before it is sent to the client.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>If you want the content to be processed by more than one filter, they
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive have to be separated by semicolons. It's also possible to use one
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <code class="directive">AddOutputFilterByType</code> directive for each of
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>The configuration below causes all script output labeled as
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <code>text/html</code> to be processed at first by the INCLUDES filter
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive and then by the DEFLATE filter.</p>
1a3f62ca37273a15a06bb94a61d3c6fcf4bf38c9rbowen <Location /cgi-bin/><br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Options Includes<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding </Location>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The output filters are not applied on proxy requests.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><code class="directive"><a href="/mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li><li><code class="module"><a href="/mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code></li><li><a href="/filter.html">The filters documentation</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive.htaccess files</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>AllowOverride All|None|<var>directive-type</var>
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding[<var>directive-type</var>] ...</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding </a></th><td><code>AllowOverride All</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding </a></th><td>directory</td></tr><tr><th><a href="directive-dict.html#Status">Status:
684f2a9a422185adda0692a1203c5ad6687fc5c5nd </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
684f2a9a422185adda0692a1203c5ad6687fc5c5nd <p>When the server finds an .htaccess file (as specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>) it needs to know
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding which directives declared in that file can override earlier
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding access information.</p>
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding <p>When this directive is set to <code>None</code>, then
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding .htaccess files are completely ignored. In this case, the
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding server will not even attempt to read .htaccess files in the
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding filesystem.</p>
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh <p>When this directive is set to <code>All</code>, then any
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding directive which has the .htaccess <a href="directive-dict.html#Context">Context</a> is allowed in
684f2a9a422185adda0692a1203c5ad6687fc5c5nd .htaccess files.</p>
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding <p>The <var>directive-type</var> can be one of the following
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding groupings of directives.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Allow use of the authorization directives (<code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
843a03fe0b138a4c1f64cb90a014e9417ac30691fielding <code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code class="directive"><a href="#authname">AuthName</a></code>,
77ead9e0262e4f08ec336d1a65b2edef7705c839nd <code class="directive"><a href="#authtype">AuthType</a></code>, <code class="directive"><a href="/mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="#require">Require</a></code>, <em>etc.</em>).</dd>
77ead9e0262e4f08ec336d1a65b2edef7705c839nd Allow use of the directives controlling document types (<code class="directive"><a href="#defaulttype">DefaultType</a></code>, <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="/mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
77ead9e0262e4f08ec336d1a65b2edef7705c839nd <code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, and
77ead9e0262e4f08ec336d1a65b2edef7705c839nd <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> Add* and Remove*
77ead9e0262e4f08ec336d1a65b2edef7705c839nd Allow use of the directives controlling directory indexing
77ead9e0262e4f08ec336d1a65b2edef7705c839nd (<code class="directive"><a href="/mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
3770ed746d69c7a4111cba9966169bd5d7a509a6poirier <code class="directive"><a href="/mod/mod_autoindex.html#addicon">AddIcon</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></code>,
3770ed746d69c7a4111cba9966169bd5d7a509a6poirier <code class="directive"><a href="/mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
3770ed746d69c7a4111cba9966169bd5d7a509a6poirier <code class="directive"><a href="/mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#fancyindexing">FancyIndexing</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#readmename">ReadmeName</a></code>,
3770ed746d69c7a4111cba9966169bd5d7a509a6poirier Allow use of the directives controlling host access (<code class="directive"><a href="/mod/mod_authz_host.html#allow">Allow</a></code>, <code class="directive"><a href="/mod/mod_authz_host.html#deny">Deny</a></code> and <code class="directive"><a href="/mod/mod_authz_host.html#order">Order</a></code>).</dd>
77ead9e0262e4f08ec336d1a65b2edef7705c839nd Allow use of the directives controlling specific directory
77ead9e0262e4f08ec336d1a65b2edef7705c839nd features (<code class="directive"><a href="#options">Options</a></code> and
3770ed746d69c7a4111cba9966169bd5d7a509a6poirier <code class="directive"><a href="/mod/mod_include.html#xbithack">XBitHack</a></code>).</dd>
77ead9e0262e4f08ec336d1a65b2edef7705c839nd AllowOverride AuthConfig Indexes
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li><li><a href="/configuring.html">Configuration Files</a></li><li><a href="/howto/htaccess.html">.htaccess Files</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="AuthName" id="AuthName">AuthName</a> <a name="authname" id="authname">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
003f0c9fda6664daf5092a0e42f65ede20098153sliveauthentication</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess </a></th><td><code>AuthName <var>auth-domain</var></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
fb77c505254b6e9c925e23e734463e87574f8f40kess </a></th><td>directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>AuthConfig</td></tr><tr><th><a href="directive-dict.html#Status">Status:
4ea161d94782fa56f4b36d496f35ff8577c43065covener </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>This directive sets the name of the authorization realm for a
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directory. This realm is given to the client so that the user
fb77c505254b6e9c925e23e734463e87574f8f40kess knows which username and password to send.
fb77c505254b6e9c925e23e734463e87574f8f40kess <code class="directive">AuthName</code> takes a single argument; if the
fb77c505254b6e9c925e23e734463e87574f8f40kess realm name contains spaces, it must be enclosed in quotation
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess marks. It must be accompanied by <code class="directive"><a href="#authtype">AuthType</a></code> and <code class="directive"><a href="#require">Require</a></code> directives, and directives such
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive as <code class="directive"><a href="/mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> and
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> to
b12b918ae6baf9c5762ed61b7393d0e2198378c0nd AuthName "Top Secret"
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <p>The string provided for the <code>AuthName</code> is what will
113961f0559eb026ea0d379cb7350f82bc09d710druggeri appear in the password dialog provided by most browsers.</p>
113961f0559eb026ea0d379cb7350f82bc09d710druggeri<h3>See also</h3><ul><li><a href="/howto/auth.html">Authentication, Authorization, and
113961f0559eb026ea0d379cb7350f82bc09d710druggeri Access Control</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="AuthType" id="AuthType">AuthType</a> <a name="authtype" id="authtype">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
113961f0559eb026ea0d379cb7350f82bc09d710druggeri </a></th><td>Type of user authentication</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>AuthType Basic|Digest</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>AuthConfig</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>This directive selects the type of user authentication for a
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd directory. Only <code>Basic</code> and <code>Digest</code> are
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive currently implemented.
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive It must be accompanied by <code class="directive"><a href="#authname">AuthName</a></code> and <code class="directive"><a href="#require">Require</a></code> directives, and directives such
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive as <code class="directive"><a href="/mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> and
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><a href="/howto/auth.html">Authentication, Authorization,
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveand Access Control</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
0834a50e694f91f4bf20ddf030fd0812e65cafc7rbowen </a></th><td>Technique for locating the interpreter for CGI
1f53e295ebd19aed1767d12da7abfab9936c148cjerenkrantzscripts</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
9ed9eaf871c58d281af02e76125ceadb5060afa5nd </a></th><td><code>CGIMapExtension cgi-path .extension</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
9cd3b05d7b70f07a742bbaf548fa4fa2bdbe5ce6noodl </a></th><td><code>None</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
9cd3b05d7b70f07a742bbaf548fa4fa2bdbe5ce6noodl </a></th><td>directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
1f53e295ebd19aed1767d12da7abfab9936c148cjerenkrantz </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
9cd3b05d7b70f07a742bbaf548fa4fa2bdbe5ce6noodl </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>core</td></tr><tr><th><a href="directive-dict.html#Compatibility">Compatibility:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>This directive is used to control how Apache finds the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive interpreter used to run CGI scripts. For example, setting <code>CGIMapExtension sys:\foo.nlm .foo</code> will
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding cause all CGI script files with a .foo extension to be passed to the FOO interpreter.</p>
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding </a></th><td>Enables the generation of Content-MD5 HTTP Response
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fieldingheaders</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding </a></th><td><code>ContentDigest on|off</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding </a></th><td><code>ContentDigest off</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding </a></th><td>Options</td></tr><tr><th><a href="directive-dict.html#Status">Status:
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem <p>This directive enables the generation of
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem <code>Content-MD5</code> headers as defined in RFC1864
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem respectively RFC2068.</p>
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem <p>MD5 is an algorithm for computing a "message digest"
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem (sometimes called "fingerprint") of arbitrary-length data, with
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem a high degree of confidence that any alterations in the data
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem will be reflected in alterations in the message digest.</p>
c94e2389b3470486af5b341013b8def7e201db30humbedooh <p>The <code>Content-MD5</code> header provides an end-to-end
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem message integrity check (MIC) of the entity-body. A proxy or
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem client may check this header for detecting accidental
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem modification of the entity-body in transit. Example header:</p>
86554dc60e298c76fd567161f47abd687008d6cchumbedooh Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
86554dc60e298c76fd567161f47abd687008d6cchumbedooh <p>Note that this can cause performance problems on your server
86554dc60e298c76fd567161f47abd687008d6cchumbedooh since the message digest is computed on every request (the
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem values are not cached).</p>
5528d1a30ae8560e2d7a96d734ffe31500dc6113rpluem <p><code>Content-MD5</code> is only sent for documents served
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive by the core, and not by any module. For example, SSI documents,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive output from CGI scripts, and byte range responses do not have
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive this header.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>MIME content-type that will be sent if the
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveserver cannot determine a type in any other way</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>DefaultType <var>MIME-type</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>DefaultType text/plain</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
06cec0eb90affb7f85de964d1822fddc77553c32humbedooh <p>There will be times when the server is asked to provide a
0834a50e694f91f4bf20ddf030fd0812e65cafc7rbowen document whose type cannot be determined by its MIME types
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive mappings.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The server must inform the client of the content-type of the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive document, so in the event of an unknown type it uses the
8cb1b3a3753304d51919865f588cbe19cbd0182arbowen <p>would be appropriate for a directory which contained many gif
8cb1b3a3753304d51919865f588cbe19cbd0182arbowen images with filenames missing the .gif extension.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Note that unlike <code class="directive"><a href="#forcetype">ForceType</a></code>, this directive is only
83f7a8612f5d7899d2d84d6f3f83f1ca4f86cc56rbowen provides the default mime-type. All other mime-type definitions,
83f7a8612f5d7899d2d84d6f3f83f1ca4f86cc56rbowen including filename extensions, that might identify the media type
83f7a8612f5d7899d2d84d6f3f83f1ca4f86cc56rbowen will override this default.</p>
eb73941bd697cd7e8226ceaf04183ade6c66934dniq</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
e67969aeb443b18bbb3837690c4010c3f1961842jim </a></th><td>Enclose a group of directives that apply only to the
e67969aeb443b18bbb3837690c4010c3f1961842jimnamed file-system directory and sub-directories</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
eb73941bd697cd7e8226ceaf04183ade6c66934dniq </a></th><td><code><Directory <var>directory-path</var>>
eb73941bd697cd7e8226ceaf04183ade6c66934dniq... </Directory></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
eb73941bd697cd7e8226ceaf04183ade6c66934dniq </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
eb73941bd697cd7e8226ceaf04183ade6c66934dniq </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
eb73941bd697cd7e8226ceaf04183ade6c66934dniq <code></Directory></code> are used to enclose a group of
eb73941bd697cd7e8226ceaf04183ade6c66934dniq directives that will apply only to the named directory and
eb73941bd697cd7e8226ceaf04183ade6c66934dniq sub-directories of that directory. Any directive that is allowed
eb73941bd697cd7e8226ceaf04183ade6c66934dniq in a directory context may be used. <var>Directory-path</var> is
eb73941bd697cd7e8226ceaf04183ade6c66934dniq either the full path to a directory, or a wild-card string using
eb73941bd697cd7e8226ceaf04183ade6c66934dniq Unix shell-style matching. In a wild-card string, `?' matches any
eb73941bd697cd7e8226ceaf04183ade6c66934dniq single character, and `*' matches any sequences of characters.
eb73941bd697cd7e8226ceaf04183ade6c66934dniq You may also use `[]' character ranges. None of the wildcards
184255c60354393e95feca30bbc8dec660f612abnd match a `/' character, so <code><Directory
eb73941bd697cd7e8226ceaf04183ade6c66934dniq /*/public_html></code> will not match
eb73941bd697cd7e8226ceaf04183ade6c66934dniq <code>/home/user/public_html</code>, but <code><Directory
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Options Indexes FollowSymLinks<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </Directory>
f23fb63b05f89f47d7a3099491f2c68dcce432e9kess <p>Be careful with the <var>directory-path</var> arguments:
9970ad80054f477c708284a0d030a5bd26e412a9covener They have to literally match the filesystem path which Apache uses
9970ad80054f477c708284a0d030a5bd26e412a9covener to access the files. Directives applied to a particular
9970ad80054f477c708284a0d030a5bd26e412a9covener <Directory> will not apply to files accessed from that same
f7acc4b00a8bf92fea10fce6ac09aa57eafec0ecjim directory via a different path, such as via different symbolic
f7acc4b00a8bf92fea10fce6ac09aa57eafec0ecjim links.</p>
9970ad80054f477c708284a0d030a5bd26e412a9covener <p>Extended regular
9970ad80054f477c708284a0d030a5bd26e412a9covener expressions can also be used, with the addition of the
08a6627a8cb9a9c85392cd0d8680c112a7f857cetrawick <Directory ~ "^/www/.*/[0-9]{3}">
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>would match directories in /www/ that consisted of three
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive numbers.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>If multiple (non-regular expression) directory sections
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh match the directory (or its parents) containing a document,
b12b918ae6baf9c5762ed61b7393d0e2198378c0nd then the directives are applied in the order of shortest match
b12b918ae6baf9c5762ed61b7393d0e2198378c0nd first, interspersed with the directives from the <a href="#accessfilename">.htaccess</a> files. For example,
da637bcae7b6e150470e701af29da5604a34a17erbowen <Directory /><br />
da637bcae7b6e150470e701af29da5604a34a17erbowen AllowOverride None<br />
da637bcae7b6e150470e701af29da5604a34a17erbowen </Directory><br />
da637bcae7b6e150470e701af29da5604a34a17erbowen <Directory /home/><br />
7802d43d20007fa575e43b6ae77d5177ceffdb71sf AllowOverride FileInfo<br />
7802d43d20007fa575e43b6ae77d5177ceffdb71sf </Directory>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>for access to the document <code>/home/web/dir/doc.html</code>
113961f0559eb026ea0d379cb7350f82bc09d710druggeri the steps are:</p>
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <li>Apply directive <code>AllowOverride None</code>
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <li>Apply directive <code>AllowOverride FileInfo</code> (for
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <li>Apply any FileInfo directives in
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <p>Regular expressions are not considered until after all of the
113961f0559eb026ea0d379cb7350f82bc09d710druggeri normal sections have been applied. Then all of the regular
113961f0559eb026ea0d379cb7350f82bc09d710druggeri expressions are tested in the order they appeared in the
113961f0559eb026ea0d379cb7350f82bc09d710druggeri configuration file. For example, with</p>
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <Directory ~ abc$><br />
113961f0559eb026ea0d379cb7350f82bc09d710druggeri # ... directives here ...<br />
113961f0559eb026ea0d379cb7350f82bc09d710druggeri </Directory>
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <p>The regular expression section won't be considered until after
113961f0559eb026ea0d379cb7350f82bc09d710druggeri all normal <Directory>s and <code>.htaccess</code> files
113961f0559eb026ea0d379cb7350f82bc09d710druggeri have been applied. Then the regular expression will match on
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <code>/home/abc/public_html/abc</code> and be applied.</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <Directory /> is <code>Allow from All</code>. This means
2aa51ed61adb484602e94de3d2214ec267aecedbigalic that Apache will serve any file mapped from an URL. It is
2aa51ed61adb484602e94de3d2214ec267aecedbigalic recommended that you change this with a block such
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <Directory /><br />
113961f0559eb026ea0d379cb7350f82bc09d710druggeri Order Deny,Allow<br />
113961f0559eb026ea0d379cb7350f82bc09d710druggeri Deny from All<br />
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </Directory>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p><strong>and then override this for directories you
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <em>want</em> accessible. See the <a href="/misc/security_tips.html">Security Tips</a> page for more
113961f0559eb026ea0d379cb7350f82bc09d710druggeri <p>The directory sections typically occur in
44d199e4e31c535de0afd97844a2146529a03ed1rbowen the access.conf file, but they may appear in any configuration
113961f0559eb026ea0d379cb7350f82bc09d710druggeri file. <code class="directive"><Directory></code> directives
113961f0559eb026ea0d379cb7350f82bc09d710druggeri cannot nest, and cannot appear in a <code class="directive"><a href="#limit"><Limit></a></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section.</p>
113961f0559eb026ea0d379cb7350f82bc09d710druggeri<h3>See also</h3><ul><li><a href="/sections.html">How
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Directory, Location and Files sections work</a> for an
113961f0559eb026ea0d379cb7350f82bc09d710druggeri explanation of how these different sections are combined when a
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive request is received</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slivefile-system directories matching a regular expression and their
80c4526970a11f37c0f8e3b82afdf03902dac3f3slivesubdirectories</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes </a></th><td><code><DirectoryMatch <var>regex</var>>
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes... </Directory></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
fb77c505254b6e9c925e23e734463e87574f8f40kess </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes <p><code class="directive"><DirectoryMatch></code> and
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes <code></DirectoryMatch></code> are used to enclose a group
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes of directives which will apply only to the named directory and
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes sub-directories of that directory, the same as <code class="directive"><a href="#directory"><Directory></a></code>. However, it
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes takes as an argument a regular expression. For example:</p>
fb77c505254b6e9c925e23e734463e87574f8f40kess <DirectoryMatch "^/www/.*/[0-9]{3}">
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <p>would match directories in <code>/www/</code> that consisted of three
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes numbers.</p>
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholes<h3>See also</h3><ul><li><code class="directive"><a href="#directory"><Directory></a></code> for
4c7bdb15764021d39e486adb7bc2166d3f683773bnicholesa description of how regular expressions are mixed in with normal
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<code><Directory></code>s</li><li><a href="/sections.html">How Directory, Location and Files sections
80c4526970a11f37c0f8e3b82afdf03902dac3f3slivework</a> for an explanation of how these different sections are
313bb560bc5c323cfd40c9cad7335b4b8e060aedkesscombined when a request is received</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
fb77c505254b6e9c925e23e734463e87574f8f40kess </a></th><td>Directory that forms the main document tree visible
fb77c505254b6e9c925e23e734463e87574f8f40kessfrom the web</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
fb77c505254b6e9c925e23e734463e87574f8f40kess </a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>This directive sets the directory from which httpd will
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive serve files. Unless matched by a directive like Alias, the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive server appends the path from the requested URL to the document
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive root to make the path to the document. Example:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>then an access to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code>http://www.my.host.com/index.html</code> refers to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive">DocumentRoot</code> should be specified without
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive a trailing slash.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><a href="/urlmapping.html">Mapping URLs to Filesystem
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cndLocation</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>Use memory-mapping to read files during delivery</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td><code>EnableMMAP on|off</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td><code>EnableMMAP on</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>This directive controls whether the httpd may use
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive memory-mapping if it needs to read the contents of a file during
fb77c505254b6e9c925e23e734463e87574f8f40kess delivery. By default, when the handling of a request requires
fb77c505254b6e9c925e23e734463e87574f8f40kess access to the data within a file-- for example, when delivering a
fb77c505254b6e9c925e23e734463e87574f8f40kess server-parsed file using <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>-- Apache
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive memory-maps the file if the OS supports it.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>This memory-mapping sometimes yields a performance improvement.
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim But in some environments, it is better to disable the memory-mapping
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim to prevent operational problems:</p>
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim <li>On some multiprocessor systems, memory-mapping can reduce the
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim performance of the httpd.</li>
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim <li>With an NFS-mounted <code class="directive"><a href="#documentroot">DocumentRoot</a></code>,
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim the httpd may crash due to a segmentation fault if a file is deleted
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim or truncated while the httpd has it memory-mapped.</li>
3339ba66526d917876a7c4453c6face113f7d5a1trawick <p>For server configurations that are vulnerable to these problems,
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim you should disable memory-mapping of delivered files by specifying:</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic EnableMMAP off
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim <p>For NFS mounted files, this feature may be disabled explicitly for
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim the offending files by specifying:</p>
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim <Directory "/path-to-nfs-files">
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim EnableMMAP off
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim </Directory>
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim </a></th><td>Use the kernel sendfile support to deliver files to the client</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim </a></th><td><code>EnableSendfile on|off</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim </a></th><td><code>EnableSendfile on</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
2dada762fb99649c2a57bb9e19fe1666f2c20c38jim </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding <p>This directive controls whether the httpd may use the sendfile
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding support from the kernel to transmit file contents to the client.
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding By default, when the handling of a request requires no access
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding to the data within a file -- for example, when delivering a
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding static file -- Apache uses sendfile to deliver the file contents
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding without ever reading the file if the OS supports it.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>This sendfile mechanism avoids seperate read and send operations,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive and buffer allocations. But on some platforms or within some
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive filesystems, it is better to disable this feature to avoid
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive operational problems:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <li>Some platforms may have broken sendfile support that the build
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding system did not detect, especially if the binaries were built on
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding another box and moved to such a machine with broken sendfile support.</li>
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding <li>With an NFS-mounted <code class="directive"><a href="#documentroot">DocumentRoot</a></code>,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the kernel may be unable to serve the network file through
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh it's own cache.</li>
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding <p>For server configurations that are vulnerable to these problems,
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding you should disable this feature by specifying:</p>
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding EnableSendfile off
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding <p>For NFS mounted files, this feature may be disabled explicitly for
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding the offending files by specifying:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <Directory "/path-to-nfs-files">
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl EnableSendfile off
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl </Directory>
141fd59714368d3bbe3a3d8f5b8dc8a516c48f9fsf</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
141fd59714368d3bbe3a3d8f5b8dc8a516c48f9fsfin case of an error</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl </a></th><td><code>ErrorDocument <var>error-code</var> <var>document</var></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
141fd59714368d3bbe3a3d8f5b8dc8a516c48f9fsf </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
141fd59714368d3bbe3a3d8f5b8dc8a516c48f9fsf </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
141fd59714368d3bbe3a3d8f5b8dc8a516c48f9fsf </a></th><td>core</td></tr><tr><th><a href="directive-dict.html#Compatibility">Compatibility:
141fd59714368d3bbe3a3d8f5b8dc8a516c48f9fsf </a></th><td>Quoting syntax for text messages is different in Apache
141fd59714368d3bbe3a3d8f5b8dc8a516c48f9fsf <p>In the event of a problem or error, Apache can be configured
141fd59714368d3bbe3a3d8f5b8dc8a516c48f9fsf to do one of four things,</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <li>redirect to a local <var>URL-path</var> to handle the
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <li>redirect to an external <var>URL</var> to handle the
b69e5120af5b107504c74dbe0228946378ab80b2rbowen <p>The first option is the default, while options 2-4 are
b69e5120af5b107504c74dbe0228946378ab80b2rbowen configured using the <code class="directive">ErrorDocument</code>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic directive, which is followed by the HTTP response code and a URL
cba8c0896ba04d42cf9a9e50df5040fd6bae14a4sf or a message. Apache will sometimes offer additional information
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl <p>URLs can begin with a slash (/) for local URLs, or be a full
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl URL which the client can resolve. Alternatively, a message can
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl be provided to be displayed by the browser. Examples:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive ErrorDocument 403 "Sorry can't allow you access today"
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Note that when you specify an <code class="directive">ErrorDocument</code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive that points to a remote URL (ie. anything with a method such as
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive "http" in front of it), Apache will send a redirect to the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive client to tell it where to find the document, even if the
898475b582dd849de5915df0f2089b72ed8b2e2bcovener document ends up being on the same server. This has several
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor implications, the most important being that the client will not
898475b582dd849de5915df0f2089b72ed8b2e2bcovener receive the original error status code, but instead will
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd receive a redirect status code. This in turn can confuse web
003f0c9fda6664daf5092a0e42f65ede20098153slive robots and other clients which try to determine if a URL is
fb77c505254b6e9c925e23e734463e87574f8f40kess valid using the status code. In addition, if you use a remote
fb77c505254b6e9c925e23e734463e87574f8f40kess URL in an <code>ErrorDocument 401</code>, the client will not
fb77c505254b6e9c925e23e734463e87574f8f40kess know to prompt the user for a password since it will not
fb77c505254b6e9c925e23e734463e87574f8f40kess receive the 401 status code. Therefore, <strong>if you use an
003f0c9fda6664daf5092a0e42f65ede20098153slive "ErrorDocument 401" directive then it must refer to a local
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>Microsoft Internet Explorer (MSIE) will ignore server-generated
2aa51ed61adb484602e94de3d2214ec267aecedbigalic error messages when they are "too small" and substitute its own
2aa51ed61adb484602e94de3d2214ec267aecedbigalic "friendly" error messages. The size threshold varies depending on
2aa51ed61adb484602e94de3d2214ec267aecedbigalic the type of error, but in general, if you make your error document
2aa51ed61adb484602e94de3d2214ec267aecedbigalic greater than 512 bytes, then MSIE will show the server-generated
2aa51ed61adb484602e94de3d2214ec267aecedbigalic error rather than masking it. More information is available in
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd Microsoft Knowledgebase article <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>Prior to version 2.0, messages were indicated by prefixing
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen them with a single unmatched double quote character.</p>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd<h3>See also</h3><ul><li><a href="/custom-error.html">documentation of
fb77c505254b6e9c925e23e734463e87574f8f40kess customizable responses</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
fb77c505254b6e9c925e23e734463e87574f8f40kess </a></th><td>Location where the server will log errors</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td><code> ErrorLog <var>file-path</var>|syslog[:<var>facility</var>]</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
b06660a3ed3d885e15d99c0209a46c4657df33fbrbowenErrorLog logs/error.log (Windows and OS/2)</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
030108b1816bcda3d925df65357feabdce83bc94slive </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
030108b1816bcda3d925df65357feabdce83bc94slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>The <code class="directive">ErrorLog</code> directive sets the name of
f03f2609a2fc7a0d920842390738080bc0e1304bhumbedooh the file to which the server will log any errors it encounters. If
2531f46e415fc4e43fd1724a8687782fcc58be77humbedooh the <var>file-path</var> does not begin with a slash (/) then it is
f03f2609a2fc7a0d920842390738080bc0e1304bhumbedooh assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess begins with a pipe (|) then it is assumed to be a command to spawn
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess to handle the error log.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Using <code>syslog</code> instead of a filename enables logging
2aa51ed61adb484602e94de3d2214ec267aecedbigalic via syslogd(8) if the system supports it. The default is to use
2aa51ed61adb484602e94de3d2214ec267aecedbigalic syslog facility <code>local7</code>, but you can override this by
2aa51ed61adb484602e94de3d2214ec267aecedbigalic using the <code>syslog:<var>facility</var></code> syntax where
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <var>facility</var> can be one of the names usually documented in
2aa51ed61adb484602e94de3d2214ec267aecedbigalic syslog(1).</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic ErrorLog syslog:user
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>SECURITY: See the <a href="/misc/security_tips.html#serverroot">security tips</a>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive document for details on why your security could be compromised
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive if the directory where logfiles are stored is writable by
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive anyone other than the user that starts the server.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><code class="directive"><a href="#loglevel">LogLevel</a></code></li><li><a href="/logs.html">Apache Log Files</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveHTTP response header</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>FileETag <var>component</var> ...</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess </a></th><td><code>FileETag INode MTime Size</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive The <code class="directive">FileETag</code> directive configures the file
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive attributes that are used to create the ETag (entity tag) response
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive header field when the document is based on a file. (The ETag
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive value is used in cache management to save network bandwidth.) In
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Apache 1.3.22 and earlier, the ETag value was <em>always</em> formed
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive from the file's inode, size, and last-modified time (mtime). The
2aa51ed61adb484602e94de3d2214ec267aecedbigalic FileETag directive allows you to choose which of these -- if any
2aa51ed61adb484602e94de3d2214ec267aecedbigalic -- should be used. The recognized keywords are:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <dd>The file's i-node number will be included in the calculation</dd>
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess <dd>The date and time the file was last modified will be included</dd>
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess <dd>The number of bytes in the file will be included</dd>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <dd>All available fields will be used. This is equivalent to:
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen <div class="example"><p><code>FileETag INode MTime Size</code></p></div></dd>
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen <dd>If a document is file-based, no ETag field will be included in the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive response</dd>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>The <code>INode</code>, <code>MTime</code>, and <code>Size</code>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic keywords may be prefixed with either <code>+</code> or <code>-</code>,
2aa51ed61adb484602e94de3d2214ec267aecedbigalic which allow changes to be made to the default setting inherited
2aa51ed61adb484602e94de3d2214ec267aecedbigalic from a broader scope. Any keyword appearing without such a prefix
2aa51ed61adb484602e94de3d2214ec267aecedbigalic immediately and completely cancels the inherited setting.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>If a directory's configuration includes
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive subdirectory's includes <code>FileETag�-INode</code>,
fb77c505254b6e9c925e23e734463e87574f8f40kess the setting for that subdirectory (which will be inherited by
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive any sub-subdirectories that don't override it) will be equivalent to
fb77c505254b6e9c925e23e734463e87574f8f40kess</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="Files" id="Files"><Files></a> <a name="files" id="files">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Contains directives that apply to matched
80c4526970a11f37c0f8e3b82afdf03902dac3f3slivefilenames</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code><Files <var>filename</var>> ... </Files></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive"><Files></code> directive
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive provides for access control by filename. It is comparable to the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code class="directive"><a href="#directory">Directory</a></code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directive and <code class="directive"><a href="#location">Location</a></code> directives. It should be
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive matched with a <code></Files></code> directive. The
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess directives given within this section will be applied to any object
898475b582dd849de5915df0f2089b72ed8b2e2bcovener with a basename (last component of filename) matching the
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd specified filename. <code class="directive"><Files></code>
7b5535ed88e0f561b3bfb3330137bd804846afd4slive sections are processed in the order they appear in the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code>.htaccess</code> files are read, but before <code class="directive"><a href="#location"><Location></a></code> sections. Note
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive that <code class="directive"><Files></code> can be nested
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive inside <code class="directive"><a href="#directory"><Directory></a></code> sections to restrict the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive portion of the filesystem they apply to.</p>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor <p>The <var>filename</var> argument should include a filename, or
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor a wild-card string, where `?' matches any single character, and
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor `*' matches any sequences of characters. Extended regular
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener expressions can also be used, with the addition of the
f03f2609a2fc7a0d920842390738080bc0e1304bhumbedooh <Files ~ "\.(gif|jpe?g|png)$">
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>would match most common Internet graphics formats. In Apache 1.3
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive and later, <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> is preferred, however.</p>
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener <p>Note that unlike <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#location"><Location></a></code> sections, <code class="directive"><Files></code> sections can be used inside
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener .htaccess files. This allows users to control access to their own
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener files, at a file-by-file level.</p>
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener<h3>See also</h3><ul><li><a href="/sections.html">How
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener Directory, Location and Files sections work</a> for an
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener explanation of how these different sections are combined when a
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener request is received</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a> <a name="filesmatch" id="filesmatch">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener </a></th><td>Contains directives that apply to regular-expression matched
fa1c7ce09927decc1eecd1e9a35cc5331078a052covenerfilenames</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor </a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
fa1c7ce09927decc1eecd1e9a35cc5331078a052covener </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive"><FilesMatch></code> directive
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive provides for access control by filename, just as the <code class="directive"><a href="#files"><Files></a></code> directive
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess does. However, it accepts a regular expression. For example:</p>
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <FilesMatch "\.(gif|jpe?g|png)$">
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>would match most common Internet graphics formats.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Directory, Location and Files sections work</a> for an
003f0c9fda6664daf5092a0e42f65ede20098153slive explanation of how these different sections are combined when a
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive request is received</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>Forces all matching files to be served with the specified
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveMIME content-type</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>ForceType <var>MIME-type</var>|none</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
a1ef40892ffa2b44fc249423c5b6c42a74a84c68nd </a></th><td>core</td></tr><tr><th><a href="directive-dict.html#Compatibility">Compatibility:
fb77c505254b6e9c925e23e734463e87574f8f40kess </a></th><td>Moved to the core in Apache 2.0</td></tr></table>
fb77c505254b6e9c925e23e734463e87574f8f40kess <p>When placed into an <code>.htaccess</code> file or a
fb77c505254b6e9c925e23e734463e87574f8f40kess <code class="directive"><a href="#directory"><Directory></a></code>, or
fb77c505254b6e9c925e23e734463e87574f8f40kess <code class="directive"><a href="#location"><Location></a></code> or
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <code class="directive"><a href="#files"><Files></a></code>
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh section, this directive forces all matching files to be served
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd with the content type identification given by
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <var>MIME-type</var>. For example, if you had a directory full of
ffe8ed2cd88be2c415ddef11f50394c52df9190ctrawick GIF files, but did not want to label them all with ".gif", you
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor might want to use:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Note that unlike <code class="directive"><a href="#defaulttype">DefaultType</a></code>,
1b01d1ee11c612226cb3141eed4581dc179266c1rbowen this directive overrides all mime-type associations, including
1b01d1ee11c612226cb3141eed4581dc179266c1rbowen filename extensions, that might identify the media type.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>You can override any <code class="directive">ForceType</code> setting
6b15044d54a096e6323ff1540f1a491e8de7622dsf <Location /images><br />
6b15044d54a096e6323ff1540f1a491e8de7622dsf </Location><br />
6b15044d54a096e6323ff1540f1a491e8de7622dsf # but normal mime-type associations here:<br />
6b15044d54a096e6323ff1540f1a491e8de7622dsf ForceType none<br />
6b15044d54a096e6323ff1540f1a491e8de7622dsf </Location>
6b15044d54a096e6323ff1540f1a491e8de7622dsf</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td>Enables DNS lookups on client IP addresses</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td><code>HostnameLookups on|off|double</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td><code>HostnameLookups off</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>server config, virtual host, directory</td></tr><tr><th><a href="directive-dict.html#Status">Status:
c8b79d4b8796531f19dd54bd59d88c3b68338ceahumbedooh </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>This directive enables DNS lookups so that host names can be
c8b79d4b8796531f19dd54bd59d88c3b68338ceahumbedooh logged (and passed to CGIs/SSIs in <code>REMOTE_HOST</code>).
2aa51ed61adb484602e94de3d2214ec267aecedbigalic The value <code>double</code> refers to doing double-reverse
2aa51ed61adb484602e94de3d2214ec267aecedbigalic DNS. That is, after a reverse lookup is performed, a forward
6b15044d54a096e6323ff1540f1a491e8de7622dsf lookup is then performed on that result. At least one of the ip
6b15044d54a096e6323ff1540f1a491e8de7622dsf addresses in the forward lookup must match the original
6b15044d54a096e6323ff1540f1a491e8de7622dsf address. (In "tcpwrappers" terminology this is called
6b15044d54a096e6323ff1540f1a491e8de7622dsf <p>Regardless of the setting, when <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> is
6b15044d54a096e6323ff1540f1a491e8de7622dsf used for controlling access by hostname, a double reverse lookup
6b15044d54a096e6323ff1540f1a491e8de7622dsf will be performed. This is necessary for security. Note that the
6b15044d54a096e6323ff1540f1a491e8de7622dsf result of this double-reverse isn't generally available unless you
6b15044d54a096e6323ff1540f1a491e8de7622dsf set <code>HostnameLookups double</code>. For example, if only
6b15044d54a096e6323ff1540f1a491e8de7622dsf <code>HostnameLookups on</code> and a request is made to an object
6b15044d54a096e6323ff1540f1a491e8de7622dsf that is protected by hostname restrictions, regardless of whether
6b15044d54a096e6323ff1540f1a491e8de7622dsf the double-reverse fails or not, CGIs will still be passed the
6b15044d54a096e6323ff1540f1a491e8de7622dsf <p>The default is off in order to save the network
6b15044d54a096e6323ff1540f1a491e8de7622dsf traffic for those sites that don't truly need the reverse
6b15044d54a096e6323ff1540f1a491e8de7622dsf lookups done. It is also better for the end users because they
6b15044d54a096e6323ff1540f1a491e8de7622dsf don't have to suffer the extra latency that a lookup entails.
6b15044d54a096e6323ff1540f1a491e8de7622dsf Heavily loaded sites should leave this directive
6b15044d54a096e6323ff1540f1a491e8de7622dsf <code>off</code>, since DNS lookups can take considerable
6b15044d54a096e6323ff1540f1a491e8de7622dsf amounts of time. The utility <a href="/programs/logresolve.html">logresolve</a>, provided in
6b15044d54a096e6323ff1540f1a491e8de7622dsf the <var>/support</var> directory, can be used to look up host
6b15044d54a096e6323ff1540f1a491e8de7622dsf names from logged IP addresses offline.</p>
6b15044d54a096e6323ff1540f1a491e8de7622dsf</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="IdentityCheck" id="IdentityCheck">IdentityCheck</a> <a name="identitycheck" id="identitycheck">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td>Enables logging of the RFC1413 identity of the remote
6b15044d54a096e6323ff1540f1a491e8de7622dsfuser</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td><code>IdentityCheck on|off</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td><code>IdentityCheck off</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td>server config, virtual host, directory</td></tr><tr><th><a href="directive-dict.html#Status">Status:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
6b15044d54a096e6323ff1540f1a491e8de7622dsf <p>This directive enables RFC1413-compliant logging of the
6b15044d54a096e6323ff1540f1a491e8de7622dsf remote user name for each connection, where the client machine
6b15044d54a096e6323ff1540f1a491e8de7622dsf runs identd or something similar. This information is logged in
6b15044d54a096e6323ff1540f1a491e8de7622dsf the access log.</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>The information should not be trusted in any way except for
2aa51ed61adb484602e94de3d2214ec267aecedbigalic rudimentary usage tracking.</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>Note that this can cause serious latency problems accessing
2aa51ed61adb484602e94de3d2214ec267aecedbigalic your server since every request requires one of these lookups
e32a6a51d27e311db1e1d5920ac7bd0de33823cfhumbedooh to be performed. When firewalls are involved each lookup might
2aa51ed61adb484602e94de3d2214ec267aecedbigalic possibly fail and add 30 seconds of latency to each hit. So in
2aa51ed61adb484602e94de3d2214ec267aecedbigalic general this is not very useful on public servers accessible
e32a6a51d27e311db1e1d5920ac7bd0de33823cfhumbedooh from the Internet.</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a> <a name="ifdefine" id="ifdefine">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Encloses directives that will be processed only
6b15044d54a096e6323ff1540f1a491e8de7622dsfif a test is true at startup</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td><code><IfDefine [!]<var>parameter-name</var>> ...
6b15044d54a096e6323ff1540f1a491e8de7622dsf </IfDefine></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
6b15044d54a096e6323ff1540f1a491e8de7622dsf </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
6b15044d54a096e6323ff1540f1a491e8de7622dsf <p>The <code><IfDefine <var>test</var>>...</IfDefine>
6b15044d54a096e6323ff1540f1a491e8de7622dsf </code> section is used to mark directives that are conditional. The
6b15044d54a096e6323ff1540f1a491e8de7622dsf directives within an <code class="directive"><IfDefine></code>
6b15044d54a096e6323ff1540f1a491e8de7622dsf section are only processed if the <var>test</var> is true. If <var>
6b15044d54a096e6323ff1540f1a491e8de7622dsf test</var> is false, everything between the start and end markers is
6b15044d54a096e6323ff1540f1a491e8de7622dsf ignored.</p>
6b15044d54a096e6323ff1540f1a491e8de7622dsf <p>The <var>test</var> in the <code class="directive"><IfDefine></code> section directive can be one of two forms:</p>
003f0c9fda6664daf5092a0e42f65ede20098153slive <p>In the former case, the directives between the start and end
fb77c505254b6e9c925e23e734463e87574f8f40kess markers are only processed if the parameter named
fb77c505254b6e9c925e23e734463e87574f8f40kess <var>parameter-name</var> is defined. The second format reverses
af18698b10b429b270551ca3a5d51a75e1c9db22brianp the test, and only processes the directives if
af18698b10b429b270551ca3a5d51a75e1c9db22brianp <var>parameter-name</var> is <strong>not</strong> defined.</p>
003f0c9fda6664daf5092a0e42f65ede20098153slive <p>The <var>parameter-name</var> argument is a define as given on
af18698b10b429b270551ca3a5d51a75e1c9db22brianp the <code>httpd</code> command line via <code>-D<var>parameter-</var>
003f0c9fda6664daf5092a0e42f65ede20098153slive <p><code class="directive"><IfDefine></code> sections are
003f0c9fda6664daf5092a0e42f65ede20098153slive nest-able, which can be used to implement simple
fb77c505254b6e9c925e23e734463e87574f8f40kess multiple-parameter tests. Example:</p>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd httpd -DReverseProxy ...<br />
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <IfDefine ReverseProxy><br />
af18698b10b429b270551ca3a5d51a75e1c9db22brianp LoadModule rewrite_module modules/mod_rewrite.so<br />
13cbe1d8f52c8097cb581e7eb259693b64d41d10poirier </IfDefine>
13cbe1d8f52c8097cb581e7eb259693b64d41d10poirier</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a> <a name="ifmodule" id="ifmodule">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
13cbe1d8f52c8097cb581e7eb259693b64d41d10poirier </a></th><td>Encloses directives that are processed conditional on the
af18698b10b429b270551ca3a5d51a75e1c9db22brianppresence or absence of a specific module</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td><code><IfModule [!]<var>module-name</var>> ...
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </IfModule></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
41ef8b3051855b802104193ee0a587515af60a37wrowe <p>The <code><IfModule <var>test</var>>...</IfModule></code>
41ef8b3051855b802104193ee0a587515af60a37wrowe section is used to mark directives that are conditional on the presence of a
41ef8b3051855b802104193ee0a587515af60a37wrowe specific module. The directives within an <code class="directive"><IfModule></code> section are only processed if the <var>test</var>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic is true. If <var>test</var> is false, everything between the start and
2aa51ed61adb484602e94de3d2214ec267aecedbigalic end markers is ignored.</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>The <var>test</var> in the <code class="directive"><IfModule></code> section directive can be one of two forms:</p>
fb77c505254b6e9c925e23e734463e87574f8f40kess <p>In the former case, the directives between the start and end
9c233808c898095865fcc0a2dc1cf594d0d8faf3sf markers are only processed if the module named <var>module
41ef8b3051855b802104193ee0a587515af60a37wrowe name</var> is included in Apache -- either compiled in or
41ef8b3051855b802104193ee0a587515af60a37wrowe dynamically loaded using <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>. The second format reverses the test,
41ef8b3051855b802104193ee0a587515af60a37wrowe and only processes the directives if <var>module name</var> is
9c233808c898095865fcc0a2dc1cf594d0d8faf3sf <p>The <var>module name</var> argument is the file name of the
41ef8b3051855b802104193ee0a587515af60a37wrowe module, at the time it was compiled. For example,
41ef8b3051855b802104193ee0a587515af60a37wrowe <code>mod_rewrite.c</code>. If a module consists of several
a1ef40892ffa2b44fc249423c5b6c42a74a84c68nd source files, use the name of the file containing the string
41ef8b3051855b802104193ee0a587515af60a37wrowe <p><code class="directive"><IfModule></code> sections are
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen nest-able, which can be used to implement simple multiple-module
9b5e2c5e769dc678a1aca06df75c32022b2f1492trawick <div class="note">This section should only be used if you need to have one
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess configuration file that works whether or not a specific module
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess is available. In normal operation, directives need not be
41ef8b3051855b802104193ee0a587515af60a37wrowe placed in <code class="directive"><IfModule></code>
41ef8b3051855b802104193ee0a587515af60a37wrowe sections.</div>
41ef8b3051855b802104193ee0a587515af60a37wrowe</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
41ef8b3051855b802104193ee0a587515af60a37wrowe </a></th><td>Includes other configuration files from within
41ef8b3051855b802104193ee0a587515af60a37wrowethe server configuration files</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
9fb925624300c864fe3969a264e52aa83f3c2dd0slive </a></th><td><code>Include <var>file-path</var>|<var>directory-path</var></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess </a></th><td>server config, virtual host, directory</td></tr><tr><th><a href="directive-dict.html#Status">Status:
78f4d313fd5edf76dc5cfb8725e082a08cd29740jwoolley </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
2025fe01de41805f6148851335693aa5ebe2faffnd <p>This directive allows inclusion of other configuration files
2025fe01de41805f6148851335693aa5ebe2faffnd from within the server configuration files.</p>
9c233808c898095865fcc0a2dc1cf594d0d8faf3sf <p>If <code class="directive">Include</code> points to a directory, rather than a
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess file, Apache will read all files in that directory and any
9fb925624300c864fe3969a264e52aa83f3c2dd0slive subdirectory in alphabetical order, and parse those as configuration
9c233808c898095865fcc0a2dc1cf594d0d8faf3sf <p>The file path specified may be a fully qualified path (i.e.
9c233808c898095865fcc0a2dc1cf594d0d8faf3sf starting with a slash), or may be relative to the
41ef8b3051855b802104193ee0a587515af60a37wrowe <code class="directive"><a href="#serverroot">ServerRoot</a></code> directory.</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>Or, providing paths relative to your <code>ServerRoot</code>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic directory:</p>
af18698b10b429b270551ca3a5d51a75e1c9db22brianp <p>Make sure that an included directory does not contain any stray
af18698b10b429b270551ca3a5d51a75e1c9db22brianp files, such as editor temporary files, for example, as Apache will
af18698b10b429b270551ca3a5d51a75e1c9db22brianp attempt to read them in and use the contents as configuration
79c754eb51681c3389cd966753e902c429f78939trawick directives, which may cause the server to fail on start up.
79c754eb51681c3389cd966753e902c429f78939trawick Running <code>apachectl configtest</code> will give you a list of
79c754eb51681c3389cd966753e902c429f78939trawick the files that are being processed during the configuration
79c754eb51681c3389cd966753e902c429f78939trawick root@host# apachectl configtest<br />
79c754eb51681c3389cd966753e902c429f78939trawick Processing config directory: /usr/local/apache/conf/vhosts<br />
79c754eb51681c3389cd966753e902c429f78939trawick Processing config file: /usr/local/apache/conf/vhosts/vhost1<br />
79c754eb51681c3389cd966753e902c429f78939trawick Processing config file: /usr/local/apache/conf/vhosts/vhost2<br />
79c754eb51681c3389cd966753e902c429f78939trawick <p>This will help in verifying that you are getting only the files
79c754eb51681c3389cd966753e902c429f78939trawick that you intended as part of your configuration.</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic<h3>See also</h3><ul><li><a href="/programs/apachectl.html">apachectl</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh </a></th><td>Enables HTTP persistent connections</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td><code>KeepAlive on|off</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td><code>KeepAlive On</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
e2c56835b9788101b569d70661151ba7bb0ea2d6humbedooh </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>The Keep-Alive extension to HTTP/1.0 and the persistent
2aa51ed61adb484602e94de3d2214ec267aecedbigalic connection feature of HTTP/1.1 provide long-lived HTTP sessions
2aa51ed61adb484602e94de3d2214ec267aecedbigalic which allow multiple requests to be sent over the same TCP
e2c56835b9788101b569d70661151ba7bb0ea2d6humbedooh connection. In some cases this has been shown to result in an
2aa51ed61adb484602e94de3d2214ec267aecedbigalic almost 50% speedup in latency times for HTML documents with
2aa51ed61adb484602e94de3d2214ec267aecedbigalic many images. To enable Keep-Alive connections in Apache 1.2 and
e2c56835b9788101b569d70661151ba7bb0ea2d6humbedooh <p>For HTTP/1.0 clients, Keep-Alive connections will only be
2aa51ed61adb484602e94de3d2214ec267aecedbigalic used if they are specifically requested by a client. In
2aa51ed61adb484602e94de3d2214ec267aecedbigalic addition, a Keep-Alive connection with an HTTP/1.0 client can
2aa51ed61adb484602e94de3d2214ec267aecedbigalic only be used when the length of the content is known in
79c754eb51681c3389cd966753e902c429f78939trawick advance. This implies that dynamic content such as CGI output,
79c754eb51681c3389cd966753e902c429f78939trawick SSI pages, and server-generated directory listings will
79c754eb51681c3389cd966753e902c429f78939trawick generally not use Keep-Alive connections to HTTP/1.0 clients.
79c754eb51681c3389cd966753e902c429f78939trawick For HTTP/1.1 clients, persistent connections are the default
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive unless otherwise specified. If the client requests it, chunked
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive encoding will be used in order to send content of unknown
003f0c9fda6664daf5092a0e42f65ede20098153slive length over persistent connections.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>Amount of time the server will wait for subsequent
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliverequests on a persistent connection</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>KeepAliveTimeout <var>seconds</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>KeepAliveTimeout 15</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen <p>The number of seconds Apache will wait for a subsequent
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive request before closing the connection. Once a request has been
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive received, the timeout value specified by the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code class="directive"><a href="#timeout">Timeout</a></code> directive applies.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Setting <code class="directive">KeepAliveTimeout</code> to a high value
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive may cause performance problems in heavily loaded servers. The
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive higher the timeout, the more server processes will be kept
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd occupied waiting on connections with idle clients.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a> <a name="limit" id="limit">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Restrict enclosed access controls to only certain HTTP
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cndmethods</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code><Limit <var>method</var> [<var>method</var>] ... > ...
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </Limit></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen <p>Access controls are normally effective for
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <strong>all</strong> access methods, and this is the usual
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive desired behavior. <strong>In the general case, access control
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslive directives should not be placed within a
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslive <code class="directive"><Limit></code> section.</strong></p>
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslive <p>The purpose of the <code class="directive"><Limit></code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directive is to restrict the effect of the access controls to the
2aa51ed61adb484602e94de3d2214ec267aecedbigalic nominated HTTP methods. For all other methods, the access
2aa51ed61adb484602e94de3d2214ec267aecedbigalic restrictions that are enclosed in the <code><Limit></code>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic bracket <strong>will have no effect</strong>. The following
2aa51ed61adb484602e94de3d2214ec267aecedbigalic example applies the access control only to the methods POST, PUT,
2aa51ed61adb484602e94de3d2214ec267aecedbigalic and DELETE, leaving all other methods unprotected:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <Limit POST PUT DELETE><br />
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen Require valid-user<br />
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen </Limit>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>The method names listed can be one or more of: <code>GET</code>,
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <code>CONNECT</code>, <code>OPTIONS</code>, <code>TRACE</code>,
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <code>LOCK</code>, and <code>UNLOCK</code>. <strong>The method name is
2aa51ed61adb484602e94de3d2214ec267aecedbigalic case-sensitive.</strong> If <code>GET</code> is used it will also
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a> <a name="limitexcept" id="limitexcept">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Restrict access controls to all HTTP methods
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowenexcept the named ones</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code><LimitExcept <var>method</var> [<var>method</var>] ... > ...
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </LimitExcept></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p><code class="directive"><LimitExcept></code> and
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive a group of access control directives which will then apply to any
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive HTTP access method <strong>not</strong> listed in the arguments;
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess i.e., it is the opposite of a <code class="directive"><a href="#limit"><Limit></a></code> section and can be used to control
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive both standard and nonstandard/unrecognized methods. See the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive documentation for <code class="directive"><a href="#limit"><Limit></a></code> for more details.</p>
4f854c24127e28f7ad72ce9a39d4448aaf910fc1slive <LimitExcept POST GET><br />
9b5e2c5e769dc678a1aca06df75c32022b2f1492trawick Require valid-user<br />
fb77c505254b6e9c925e23e734463e87574f8f40kess <LimitExcept>
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslive</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslive </a></th><td>Restricts the total size of the HTTP request body sent
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslivefrom the client</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslive </a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslive </a></th><td><code>LimitRequestBody 0</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
69fba5b8aa0b0dc408f649cfdaab064ce120b05bslive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
b5d3d68a9f683722eac7a3ca507c3e571908dfc0rbowen </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
b5d3d68a9f683722eac7a3ca507c3e571908dfc0rbowen <p>This directive specifies the number of <var>bytes</var> from 0
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen (meaning unlimited) to 2147483647 (2GB) that are allowed in a
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive request body. The default value is defined by the compile-time
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive constant <code>DEFAULT_LIMIT_REQUEST_BODY</code> (0 as
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive distributed).</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive">LimitRequestBody</code> directive allows
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the user to set a limit on the allowed size of an HTTP request
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive message body within the context in which the directive is given
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive (server, per-directory, per-file or per-location). If the client
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess request exceeds that limit, the server will return an error
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd response instead of servicing the request. The size of a normal
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh request message body will vary greatly depending on the nature of
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the resource and the methods allowed on that resource. CGI scripts
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive typically use the message body for passing form information to the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive server. Implementations of the PUT method will require a value at
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive least as large as any representation that the server wishes to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive accept for that resource.</p>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor <p>This directive gives the server administrator greater
c68acc9d712af079afa2bd1a5a4aeef9a3ea573ckess control over abnormal client request behavior, which may be
fb109b84906e3ee61680aa289953c2f9e859354erbowen useful for avoiding some forms of denial-of-service
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh attacks.</p>
fb109b84906e3ee61680aa289953c2f9e859354erbowen <p>If, for example, you are permitting file upload to a particular
960188481b7025ac8ef7221b67af83dd27e46cd0rjung location, and wich to limit the size of the uploaded file to 100K,
960188481b7025ac8ef7221b67af83dd27e46cd0rjung you might use the following directive:</p>
fb109b84906e3ee61680aa289953c2f9e859354erbowen LimitRequestBody 102400
960188481b7025ac8ef7221b67af83dd27e46cd0rjung</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Limits the number of HTTP request header fields that
80c4526970a11f37c0f8e3b82afdf03902dac3f3slivewill be accepted from the client</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>LimitRequestFields <var>number</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td><code>LimitRequestFields 100</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>server config</td></tr><tr><th><a href="directive-dict.html#Status">Status:
5155e92c6100b47513159eee1b2b9914ab204a5acovener </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
5155e92c6100b47513159eee1b2b9914ab204a5acovener <p><var>Number</var> is an integer from 0 (meaning unlimited) to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive 32767. The default value is defined by the compile-time
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh constant <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 as
fb109b84906e3ee61680aa289953c2f9e859354erbowen distributed).</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive">LimitRequestFields</code> directive allows
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the server administrator to modify the limit on the number of
9b5e2c5e769dc678a1aca06df75c32022b2f1492trawick request header fields allowed in an HTTP request. A server needs
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive this value to be larger than the number of fields that a normal
2bac697634d965d9d9a921a99a68b2c454c8a95dbnicholes client request might include. The number of request header fields
2bac697634d965d9d9a921a99a68b2c454c8a95dbnicholes used by a client rarely exceeds 20, but this may vary among
d950cf9262224a223e2ff5c51393708071e14b94covener different client implementations, often depending upon the extent
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor to which a user has configured their browser to support detailed
2bac697634d965d9d9a921a99a68b2c454c8a95dbnicholes content negotiation. Optional HTTP extensions are often expressed
2bac697634d965d9d9a921a99a68b2c454c8a95dbnicholes using request header fields.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>This directive gives the server administrator greater
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen control over abnormal client request behavior, which may be
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive useful for avoiding some forms of denial-of-service attacks.
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive The value should be increased if normal clients see an error
e302f38fd646764ce1a1e1c578d794aef514a9e5sf response from the server that indicates too many fields were
e302f38fd646764ce1a1e1c578d794aef514a9e5sf sent in the request.</p>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf LimitRequestFields 50
e302f38fd646764ce1a1e1c578d794aef514a9e5sf</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>Limits the size of the HTTP request header allowed from the
e302f38fd646764ce1a1e1c578d794aef514a9e5sfclient</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td><code>LimitRequestFieldsize <var>bytes</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh </a></th><td><code>LimitRequestFieldsize 8190</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh </a></th><td>server config</td></tr><tr><th><a href="directive-dict.html#Status">Status:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>This directive specifies the number of <var>bytes</var> from 0
e302f38fd646764ce1a1e1c578d794aef514a9e5sf to the value of the compile-time constant
18ee8bb3db5cc3b04291f89301bd5d14dc271066lgentis <code>DEFAULT_LIMIT_REQUEST_FIELDSIZE</code> (8190 as
e302f38fd646764ce1a1e1c578d794aef514a9e5sf distributed) that will be allowed in an HTTP request
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen header.</p>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>The <code class="directive">LimitRequestFieldsize</code> directive
e302f38fd646764ce1a1e1c578d794aef514a9e5sf allows the server administrator to reduce the limit on the allowed
e302f38fd646764ce1a1e1c578d794aef514a9e5sf size of an HTTP request header field below the normal input buffer
e302f38fd646764ce1a1e1c578d794aef514a9e5sf size compiled with the server. A server needs this value to be
e302f38fd646764ce1a1e1c578d794aef514a9e5sf large enough to hold any one header field from a normal client
e302f38fd646764ce1a1e1c578d794aef514a9e5sf request. The size of a normal request header field will vary
e302f38fd646764ce1a1e1c578d794aef514a9e5sf greatly among different client implementations, often depending
e32a6a51d27e311db1e1d5920ac7bd0de33823cfhumbedooh upon the extent to which a user has configured their browser to
e302f38fd646764ce1a1e1c578d794aef514a9e5sf support detailed content negotiation.</p>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>This directive gives the server administrator greater
e32a6a51d27e311db1e1d5920ac7bd0de33823cfhumbedooh control over abnormal client request behavior, which may be
e302f38fd646764ce1a1e1c578d794aef514a9e5sf useful for avoiding some forms of denial-of-service attacks.</p>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf LimitRequestFieldSize 16380
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <div class="note">Under normal conditions, the value should not be changed from
b5c4b00201fdc3ed11c6cc05cf3f9a7912ac0cfbsf the default.</div>
e32a6a51d27e311db1e1d5920ac7bd0de33823cfhumbedooh</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>Limit the size of the HTTP request line that will be accepted
b5c4b00201fdc3ed11c6cc05cf3f9a7912ac0cfbsffrom the client</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
b5c4b00201fdc3ed11c6cc05cf3f9a7912ac0cfbsf </a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
b5c4b00201fdc3ed11c6cc05cf3f9a7912ac0cfbsf </a></th><td><code>LimitRequestLine 8190</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
b5c4b00201fdc3ed11c6cc05cf3f9a7912ac0cfbsf </a></th><td>server config</td></tr><tr><th><a href="directive-dict.html#Status">Status:
b5c4b00201fdc3ed11c6cc05cf3f9a7912ac0cfbsf </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
221a06bb836af6024708190895834af79c90d1c8rbowen <p>This directive sets the number of <var>bytes</var> from 0 to
221a06bb836af6024708190895834af79c90d1c8rbowen the value of the compile-time constant
221a06bb836af6024708190895834af79c90d1c8rbowen <code>DEFAULT_LIMIT_REQUEST_LINE</code> (8190 as distributed)
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen that will be allowed on the HTTP request-line.</p>
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen <p>The <code class="directive">LimitRequestLine</code> directive allows
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen the server administrator to reduce the limit on the allowed size
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen of a client's HTTP request-line below the normal input buffer size
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen compiled with the server. Since the request-line consists of the
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen HTTP method, URI, and protocol version, the
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen <code class="directive">LimitRequestLine</code> directive places a
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen restriction on the length of a request-URI allowed for a request
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen on the server. A server needs this value to be large enough to
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen hold any of its resource names, including any information that
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen might be passed in the query part of a GET request.</p>
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen <p>This directive gives the server administrator greater
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen control over abnormal client request behavior, which may be
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen useful for avoiding some forms of denial-of-service attacks.</p>
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen LimitRequestLine 16380
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <div class="note">Under normal conditions, the value should not be changed from
e302f38fd646764ce1a1e1c578d794aef514a9e5sf the default.</div>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>Limits the size of an XML-based request body</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td><code>LimitXMLRequestBody <var>number</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen <p>Limit (in bytes) on maximum size of an XML-based request
2d391792b33e3c27e070739f74d74989c77fea8eminfrin body. A value of <code>0</code> will disable any checking.</p>
2a781ea98a32c069ae57a89566ee9628e19a2ec2minfrin LimitXMLRequestBody 0
e302f38fd646764ce1a1e1c578d794aef514a9e5sf</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="Location" id="Location"><Location></a> <a name="location" id="location">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen </a></th><td>Applies the enclosed directives only to matching
0b5f11662dee7135ff8dd04311a4ee6df7fe2b1crbowenURLs</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen URL-path|URL> ... </Location></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>The <code class="directive"><Location></code> directive
e302f38fd646764ce1a1e1c578d794aef514a9e5sf provides for access control by URL. It is similar to the
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen <code class="directive"><a href="#directory"><Directory></a></code>
0b5f11662dee7135ff8dd04311a4ee6df7fe2b1crbowen directive, and starts a subsection which is terminated with a
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <code></Location></code> directive. <code class="directive"><Location></code> sections are processed in the
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen order they appear in the configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <code>.htaccess</code> files are read, and after the <code class="directive"><a href="#files"><Files></a></code> sections.</p>
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen <p>Note that URLs do not have to line up with the filesystem at
e302f38fd646764ce1a1e1c578d794aef514a9e5sf all, it should be emphasized that <Location> operates
e302f38fd646764ce1a1e1c578d794aef514a9e5sf completely outside the filesystem.</p>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>For all origin (non-proxy) requests, the URL to be matched is a
e302f38fd646764ce1a1e1c578d794aef514a9e5sf URL-path of the form <code>/path/</code>. No scheme, hostname,
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen port, or query string may be included. For proxy requests, the
e302f38fd646764ce1a1e1c578d794aef514a9e5sf URL to be matched is of the form
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <code>scheme://servername/path</code>, and you must include the
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen prefix.</p>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>The URL may use wildcards In a wild-card string, `?' matches
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen any single character, and `*' matches any sequences of
e302f38fd646764ce1a1e1c578d794aef514a9e5sf characters.</p>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>Extended regular
e302f38fd646764ce1a1e1c578d794aef514a9e5sf expressions can also be used, with the addition of the
4497075b5e08b0c8ee89425a1758258ae80550fcsf <Location ~ "/(extra|special)/data">
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>would match URLs that contained the substring "/extra/data" or
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen "/special/data". In Apache 1.3 and above, a new directive
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <code class="directive"><a href="#locationmatch"><LocationMatch></a></code>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf exists which behaves identical to the regex version of
b08558bf6a64f9501ad3eca34eaf4d978bd928cfsf functionality is especially useful when combined with the
b89fea36d9c12cec3344576824f4e6798da90ad4rbowen <code class="directive"><a href="#sethandler">SetHandler</a></code>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf directive. For example, to enable status requests, but allow them
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <Location /status><br />
e302f38fd646764ce1a1e1c578d794aef514a9e5sf SetHandler server-status<br />
e302f38fd646764ce1a1e1c578d794aef514a9e5sf Order Deny,Allow<br />
e302f38fd646764ce1a1e1c578d794aef514a9e5sf Deny from all<br />
9228509ac5da8374df4a5d50b7da139e7b31f8a3sf </Location>
9228509ac5da8374df4a5d50b7da139e7b31f8a3sf <p>The slash character has special meaning depending on where in a
9228509ac5da8374df4a5d50b7da139e7b31f8a3sf URL it appears. People may be used to its behavior in the filesystem
9228509ac5da8374df4a5d50b7da139e7b31f8a3sf where multiple adjacent slashes are frequently collapsed to a single
e302f38fd646764ce1a1e1c578d794aef514a9e5sf slash (<em>i.e.</em>, <code>/home///foo</code> is the same as
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <code>/home/foo</code>). In URL-space this is not necessarily true.
e302f38fd646764ce1a1e1c578d794aef514a9e5sf The <code class="directive"><a href="#locationmatch"><LocationMatch></a></code>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf directive and the regex version of <code class="directive"><Location></code> require you to explicitly specify multiple
e302f38fd646764ce1a1e1c578d794aef514a9e5sf slashes if that is your intention.</p>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>For example, <code><LocationMatch ^/abc></code> would match
e302f38fd646764ce1a1e1c578d794aef514a9e5sf the request URL <code>/abc</code> but not the request URL <code>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf //abc</code>. The (non-regex) <code class="directive"><Location></code> directive behaves similarly when used for
e302f38fd646764ce1a1e1c578d794aef514a9e5sf proxy requests. But when (non-regex) <code class="directive"><Location></code> is used for non-proxy requests it will
e302f38fd646764ce1a1e1c578d794aef514a9e5sf implicitly match multiple slashes with a single slash. For example,
e302f38fd646764ce1a1e1c578d794aef514a9e5sf if you specify <code><Location /abc/def></code> and the
ce4dc40a4e87991087488f70d96d3447d7557294sf request is to <code>/abc//def</code> then it will match.</p>
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh Directory, Location and Files sections work</a> for an
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh explanation of how these different sections are combined when a
2aa51ed61adb484602e94de3d2214ec267aecedbigalic request is received</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a> <a name="locationmatch" id="locationmatch">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Applies the enclosed directives only to regular-expression
e302f38fd646764ce1a1e1c578d794aef514a9e5sfmatching URLs</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
abdaaa23d72ef7e7ff91eab9c5581d40130680c1rbowen <var>regex</var>> ... </Location></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
abdaaa23d72ef7e7ff91eab9c5581d40130680c1rbowen </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
abdaaa23d72ef7e7ff91eab9c5581d40130680c1rbowen <p>The <code class="directive"><LocationMatch></code> directive
e32a6a51d27e311db1e1d5920ac7bd0de33823cfhumbedooh provides for access control by URL, in an identical manner to
abdaaa23d72ef7e7ff91eab9c5581d40130680c1rbowen <code class="directive"><a href="#location"><Location></a></code>. However,
abdaaa23d72ef7e7ff91eab9c5581d40130680c1rbowen it takes a regular expression as an argument instead of a simple
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh string. For example:</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <LocationMatch "/(extra|special)/data">
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh <p>would match URLs that contained the substring <code>/extra/data</code>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic Directory, Location and Files sections work</a> for an
2aa51ed61adb484602e94de3d2214ec267aecedbigalic explanation of how these different sections are combined when a
2aa51ed61adb484602e94de3d2214ec267aecedbigalic request is received</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Controls the verbosity of the ErrorLog</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td><code>LogLevel <var>level</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td><code>LogLevel warn</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p><code class="directive">LogLevel</code> adjusts the verbosity of the
e302f38fd646764ce1a1e1c578d794aef514a9e5sf messages recorded in the error logs (see <code class="directive"><a href="#errorlog">ErrorLog</a></code> directive). The following
a8ee031b2224ce5473826c9d4f603681589245fawrowe <var>level</var>s are available, in order of decreasing
a8ee031b2224ce5473826c9d4f603681589245fawrowe significance:</p>
a8ee031b2224ce5473826c9d4f603681589245fawrowe <td>"getpwuid: couldn't determine user name from uid"</td>
a8ee031b2224ce5473826c9d4f603681589245fawrowe <td>"socket: Failed to get a socket, exiting child"</td>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <td>"child process 1234 did not exit, sending another
fb77c505254b6e9c925e23e734463e87574f8f40kess SIGHUP"</td>
530eba85dbd41b8a0fa5255d3648d1440199a661slive <td>"httpd: caught SIGBUS, attempting to dump core in
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <td>"Server seems busy, (you may need to increase
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>When a particular level is specified, messages from all
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd other levels of higher significance will be reported as well.
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <em>E.g.</em>, when <code>LogLevel info</code> is specified,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive then messages with log levels of <code>notice</code> and
0db981f8fdfb62c5149efa079f0369b73d472d04rpluem recommended.</p>
0db981f8fdfb62c5149efa079f0369b73d472d04rpluem LogLevel notice
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor </a></th><td>Number of requests allowed on a persistent
a5f060e0c74a44cb8896ae794c08f94f7c9a46a7covenerconnection</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
a5f060e0c74a44cb8896ae794c08f94f7c9a46a7covener </a></th><td><code>MaxKeepAliveRequests <var>number</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
a5f060e0c74a44cb8896ae794c08f94f7c9a46a7covener </a></th><td><code>MaxKeepAliveRequests 100</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive">MaxKeepAliveRequests</code> directive
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive limits the number of requests allowed per connection when
003f0c9fda6664daf5092a0e42f65ede20098153slive <code class="directive"><a href="#keepalive">KeepAlive</a></code> is on. If it is
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive set to "<code>0</code>", unlimited requests will be allowed. We
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd recommend that this setting be kept to a high value for maximum
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive server performance.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive MaxKeepAliveRequests 500
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
6b64034fa2a644ba291c484c0c01c7df5b8d982ckesshosting</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess </a></th><td><code>NameVirtualHost <var>addr</var>[:<var>port</var>]</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess </a></th><td>server config</td></tr><tr><th><a href="directive-dict.html#Status">Status:
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive">NameVirtualHost</code> directive is a
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive required directive if you want to configure <a href="/vhosts/">name-based virtual hosts</a>.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Although <var>addr</var> can be hostname it is recommended
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive NameVirtualHost 111.22.33.44
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>With the <code class="directive">NameVirtualHost</code> directive you
fb77c505254b6e9c925e23e734463e87574f8f40kess specify the IP address on which the server will receive requests
062fa302e571fe5fcb2af6470f173fe71d3d041bhumbedooh for the name-based virtual hosts. This will usually be the address
1532c34f7521c6d2457ea0c40d159b4998ea2334humbedooh to which your name-based virtual host names resolve. In cases
1532c34f7521c6d2457ea0c40d159b4998ea2334humbedooh where a firewall or other proxy receives the requests and forwards
1532c34f7521c6d2457ea0c40d159b4998ea2334humbedooh them on a different IP address to the server, you must specify the
1532c34f7521c6d2457ea0c40d159b4998ea2334humbedooh IP address of the physical interface on the machine which will be
1532c34f7521c6d2457ea0c40d159b4998ea2334humbedooh servicing the requests. If you have multiple name-based hosts on
1532c34f7521c6d2457ea0c40d159b4998ea2334humbedooh multiple addresses, repeat the directive for each address.</p>
1532c34f7521c6d2457ea0c40d159b4998ea2334humbedooh <p>Note: the "main server" and any _default_ servers will
1532c34f7521c6d2457ea0c40d159b4998ea2334humbedooh <strong>never</strong> be served for a request to a
062fa302e571fe5fcb2af6470f173fe71d3d041bhumbedooh <code class="directive">NameVirtualHost</code> IP Address (unless for some
030108b1816bcda3d925df65357feabdce83bc94slive reason you specify <code class="directive">NameVirtualHost</code> but then
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive don't define any VirtualHosts for that address).</p>
f03f2609a2fc7a0d920842390738080bc0e1304bhumbedooh <p>Optionally you can specify a port number on which the
f03f2609a2fc7a0d920842390738080bc0e1304bhumbedooh NameVirtualHost 111.22.33.44:8080
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <p>IPv6 addresses must be enclosed in square brackets, as shown
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess in the following example:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive NameVirtualHost [fe80::a00:20ff:fea7:ccea]:8080
fb77c505254b6e9c925e23e734463e87574f8f40kess <p>To receive requests on all interfaces, you can use an argument of
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess NameVirtualHost *
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <div class="note"><h3>Argument to <VirtualHost> directive</h3>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Note that the argument to the <VirtualHost> directive must
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive exactly match the argument to the <code class="directive">NameVirtualHost</code> directive.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive NameVirtualHost 1.2.3.4<br />
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <VirtualHost 1.2.3.4><br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive # ...<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </VirtualHost><br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><a href="/vhosts/">Virtual Hosts
80c4526970a11f37c0f8e3b82afdf03902dac3f3slivedocumentation</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Configures what features are available in a particular
6b64034fa2a644ba291c484c0c01c7df5b8d982ckessdirectory</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
030108b1816bcda3d925df65357feabdce83bc94slive </a></th><td><code>Options All</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
8f5222d1bb4ace11af7add6932362e4c3822e548humbedooh </a></th><td>Options</td></tr><tr><th><a href="directive-dict.html#Status">Status:
8f5222d1bb4ace11af7add6932362e4c3822e548humbedooh </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
8f5222d1bb4ace11af7add6932362e4c3822e548humbedooh <p>The <code class="directive">Options</code> directive controls which
8f5222d1bb4ace11af7add6932362e4c3822e548humbedooh server features are available in a particular directory.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p><var>option</var> can be set to <code>None</code>, in which
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive case none of the extra features are enabled, or one or more of
6b64034fa2a644ba291c484c0c01c7df5b8d982ckess the following:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <dd>All options except for MultiViews. This is the default
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive setting.</dd>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Execution of CGI scripts is permitted.</dd>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive The server will follow symbolic links in this directory.
fb77c505254b6e9c925e23e734463e87574f8f40kess <p>Even though the server follows the symlink it does <em>not</em>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive change the pathname used to match against <code class="directive"><a href="#directory"><Directory></a></code> sections.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Note also, that this option <strong>gets ignored</strong> if set
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive inside a <code class="directive"><a href="#location"><Location></a></code>
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding section.</p>
b24c77ceb4cea5ffa92536e19f0aa83608960dc4fielding Server-side includes are permitted.</dd>
c97e8972ab1f4dd167e3dc4db87daf91114009fbnd Server-side includes are permitted, but the #exec command and
7654193c1faf603feec999850322ad79e6c551bcnd #exec CGI are disabled. It is still possible to #include
2aa51ed61adb484602e94de3d2214ec267aecedbigalic virtual CGI scripts from ScriptAliase'd directories.</dd>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic If a URL which maps to a directory is requested, and the
2aa51ed61adb484602e94de3d2214ec267aecedbigalic there is no DirectoryIndex (<em>e.g.</em>, index.html) in
2aa51ed61adb484602e94de3d2214ec267aecedbigalic that directory, then the server will return a formatted
2aa51ed61adb484602e94de3d2214ec267aecedbigalic listing of the directory.</dd>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor <a href="/content-negotiation.html">Content negotiated</a>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor MultiViews are allowed.</dd>
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener The server will only follow symbolic links for which the target
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener file or directory is owned by the same user id as the link.<br /> <strong>Note</strong>: this option gets ignored if set inside
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener a <code class="directive"><a href="#location"><Location></a></code>
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener section.</dd>
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener <p>Normally, if multiple <code class="directive">Options</code> could apply to a
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener directory, then the most specific one is taken complete; the
e32a6a51d27e311db1e1d5920ac7bd0de33823cfhumbedooh options are not merged. However if <em>all</em> the options on
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener the <code class="directive">Options</code> directive are preceded by a + or -
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener symbol, the options are merged. Any options preceded by a + are
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener added to the options currently in force, and any options
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener preceded by a - are removed from the options currently in
c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6covener force. </p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Options Indexes FollowSymLinks<br />
fb77c505254b6e9c925e23e734463e87574f8f40kess </Directory><br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Options Includes<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </Directory>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code class="directive">Options</code> directive uses the + and - symbols:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Options Indexes FollowSymLinks<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </Directory><br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive Options +Includes -Indexes<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </Directory>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code>Includes</code> are set for the /web/docs/spec directory.</p>
a1ef40892ffa2b44fc249423c5b6c42a74a84c68nd <p><strong>Note:</strong> Using <code>-IncludesNOEXEC</code> or
a1ef40892ffa2b44fc249423c5b6c42a74a84c68nd <code>-Includes</code> disables server-side includes completely
a1ef40892ffa2b44fc249423c5b6c42a74a84c68nd regardless of the previous setting.</p>
e40b2d66f8592e45981ea1cbdac42db076ea1da6rbowen <p>The default in the absence of any other settings is
e40b2d66f8592e45981ea1cbdac42db076ea1da6rbowen</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="Require" id="Require">Require</a> <a name="require" id="require">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
e40b2d66f8592e45981ea1cbdac42db076ea1da6rbowen </a></th><td>Selects which authenticated users can access
e40b2d66f8592e45981ea1cbdac42db076ea1da6rbowena resource</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>Require <var>entity-name</var> [<var>entity-name</var>] ...</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>AuthConfig</td></tr><tr><th><a href="directive-dict.html#Status">Status:
750d12c59545dbbac70390988de94f7e901b08f2niq </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
750d12c59545dbbac70390988de94f7e901b08f2niq <p>This directive selects which authenticated users can access
750d12c59545dbbac70390988de94f7e901b08f2niq a directory. The allowed syntaxes are:</p>
750d12c59545dbbac70390988de94f7e901b08f2niq Require group <var>group-name</var> [<var>group-name</var>] ...
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh <p>Only users in the named groups can access the
750d12c59545dbbac70390988de94f7e901b08f2niq directory.</p>
6b15044d54a096e6323ff1540f1a491e8de7622dsf Require valid-user
6b15044d54a096e6323ff1540f1a491e8de7622dsf <p><code class="directive">Require</code> must be accompanied by
6b15044d54a096e6323ff1540f1a491e8de7622dsf <code class="directive"><a href="#authname">AuthName</a></code> and <code class="directive"><a href="#authtype">AuthType</a></code> directives, and directives such
6b15044d54a096e6323ff1540f1a491e8de7622dsf as <code class="directive"><a href="/mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
6b15044d54a096e6323ff1540f1a491e8de7622dsf and <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> (to
6b15044d54a096e6323ff1540f1a491e8de7622dsf define users and groups) in order to work correctly. Example:</p>
750d12c59545dbbac70390988de94f7e901b08f2niq AuthType Basic<br />
94aba9caa9b2f7a0e95a55f51264c908b69470e2igalic AuthName "Restricted Directory"<br />
6b15044d54a096e6323ff1540f1a491e8de7622dsf Require group admin
750d12c59545dbbac70390988de94f7e901b08f2niq <p>Access controls which are applied in this way are effective for
6b15044d54a096e6323ff1540f1a491e8de7622dsf <strong>all</strong> methods. <strong>This is what is normally
6b15044d54a096e6323ff1540f1a491e8de7622dsf desired.</strong> If you wish to apply access controls only to
6b15044d54a096e6323ff1540f1a491e8de7622dsf specific methods, while leaving other methods unprotected, then
750d12c59545dbbac70390988de94f7e901b08f2niq place the <code class="directive">Require</code> statement into a
750d12c59545dbbac70390988de94f7e901b08f2niq <code class="directive"><a href="#limit"><Limit></a></code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive section.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><code class="directive"><a href="#satisfy">Satisfy</a></code></li><li><code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Limits the CPU consumption of processes launched
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveby Apache children</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td><code>RLimitCPU <var>number</var>|max [<var>number</var>|max]</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>Unset; uses operating system defaults</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Takes 1 or 2 parameters. The first parameter sets the soft
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive resource limit for all processes and the second parameter sets
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd the maximum resource limit. Either parameter can be a number,
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd or <code>max</code> to indicate to the server that the limit should
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd be set to the maximum allowed by the operating system
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd configuration. Raising the maximum resource limit requires that
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd the server is running as root, or in the initial startup
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd phase.</p>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>This applies to processes forked off from Apache children
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd servicing requests, not the Apache children themselves. This
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive includes CGI scripts and SSI exec commands, but not any
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive processes forked off from the Apache parent such as piped
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>CPU resource limits are expressed in seconds per
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive process.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li><li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Limits the memory consumption of processes launched
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveby Apache children</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td><code>RLimitMEM <var>number</var>|max [<var>number</var>|max]</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>Unset; uses operating system defaults</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl <p>Takes 1 or 2 parameters. The first parameter sets the soft
6e483e0b8aa3fa574288a7452221392a03e2b9a3noodl resource limit for all processes and the second parameter sets
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the maximum resource limit. Either parameter can be a number,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive or <code>max</code> to indicate to the server that the limit should
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive be set to the maximum allowed by the operating system
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive configuration. Raising the maximum resource limit requires that
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the server is running as root, or in the initial startup
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>This applies to processes forked off from Apache children
2aa51ed61adb484602e94de3d2214ec267aecedbigalic servicing requests, not the Apache children themselves. This
2aa51ed61adb484602e94de3d2214ec267aecedbigalic includes CGI scripts and SSI exec commands, but not any
2aa51ed61adb484602e94de3d2214ec267aecedbigalic processes forked off from the Apache parent such as piped
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>Memory resource limits are expressed in bytes per
2aa51ed61adb484602e94de3d2214ec267aecedbigalic process.</p>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic<h3>See also</h3><ul><li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li><li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Limits the number of processes that can be launched by
2aa51ed61adb484602e94de3d2214ec267aecedbigalicprocesses launched by Apache children</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td><code>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td><code>Unset; uses operating system defaults</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>Takes 1 or 2 parameters. The first parameter sets the soft
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive resource limit for all processes and the second parameter sets
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the maximum resource limit. Either parameter can be a number,
a04a96aae08a62f2d9d5833b3313a9751fa3f680yoshiki or <code>max</code> to indicate to the server that the limit
55d36f9b61520c2374ab463e77e8a62daa416398nd should be set to the maximum allowed by the operating system
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess configuration. Raising the maximum resource limit requires that
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the server is running as root, or in the initial startup
003f0c9fda6664daf5092a0e42f65ede20098153slive <p>This applies to processes forked off from Apache children
55d36f9b61520c2374ab463e77e8a62daa416398nd servicing requests, not the Apache children themselves. This
55d36f9b61520c2374ab463e77e8a62daa416398nd includes CGI scripts and SSI exec commands, but not any
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive processes forked off from the Apache parent such as piped
fb77c505254b6e9c925e23e734463e87574f8f40kess <p>Process limits control the number of processes per user.</p>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>Note: If CGI processes are <strong>not</strong> running
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd under userids other than the web server userid, this directive
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd will limit the number of processes that the server itself can
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd create. Evidence of this situation will be indicated by
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <strong><code>cannot fork</code></strong> messages in the
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd error_log.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li><li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="Satisfy" id="Satisfy">Satisfy</a> <a name="satisfy" id="satisfy">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Interaction between host-level access control and
55d36f9b61520c2374ab463e77e8a62daa416398nduser authentication</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>Satisfy any|all</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
55d36f9b61520c2374ab463e77e8a62daa416398nd </a></th><td><code>Satisfy all</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>AuthConfig</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen <p>Access policy if both <code class="directive"><a href="/mod/mod_authz_host.html#allow">Allow</a></code> and <code class="directive"><a href="#require">Require</a></code> used. The parameter can be
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive either <var>all</var> or <var>any</var>. This directive is only
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd useful if access to a particular area is being restricted by both
55d36f9b61520c2374ab463e77e8a62daa416398nd username/password <em>and</em> client host address. In this case
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd the default behavior (<var>all</var>) is to require that the client passes
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the address access restriction <em>and</em> enters a valid
55d36f9b61520c2374ab463e77e8a62daa416398nd username and password. With the "any" option the client will be
55d36f9b61520c2374ab463e77e8a62daa416398nd granted access if they either pass the host restriction or enter a
55d36f9b61520c2374ab463e77e8a62daa416398nd valid username and password. This can be used to password restrict
55d36f9b61520c2374ab463e77e8a62daa416398nd an area, but to let clients from particular addresses in without
55d36f9b61520c2374ab463e77e8a62daa416398nd prompting for a password.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>For example, if you wanted to let people on your network have
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive unrestricted access to a portion of your website, but require that
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive people outside of your network provide a password, you could use a
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive configuration similar to the following:</p>
bea526116133aa3d7dabd1924bfc580b37fbf22aslive Require valid-user<br />
fb77c505254b6e9c925e23e734463e87574f8f40kess Allow from 192.168.1<br />
bea526116133aa3d7dabd1924bfc580b37fbf22aslive Satisfy any
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><code class="directive"><a href="/mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="#require">Require</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Technique for locating the interpreter for CGI
80c4526970a11f37c0f8e3b82afdf03902dac3f3slivescripts</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>ScriptInterpreterSource registry|script</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>ScriptInterpreterSource script</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
69d4a64874fd7161f80bb0484341c60857b6fd6esf </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
003f0c9fda6664daf5092a0e42f65ede20098153slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
003f0c9fda6664daf5092a0e42f65ede20098153slive </a></th><td>core</td></tr><tr><th><a href="directive-dict.html#Compatibility">Compatibility:
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin <p>This directive is used to control how Apache finds the
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin interpreter used to run CGI scripts. The default technique is to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive use the interpreter pointed to by the #! line in the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive script. Setting <code>ScriptInterpreterSource registry</code> will
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive cause the Windows Registry to be searched using the script file
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
5b258a8d58679c6587757189339bb3c2d0488f93poirier </a></th><td>Email address that the server includes in error
cf8a8738330694e60bad421fcc8361d80b0e9124minfrinmessages sent to the client</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin </a></th><td><code>ServerAdmin <var>email-address</var></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin <p>The <code class="directive">ServerAdmin</code> sets the e-mail address
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin that the server includes in any error messages it returns to the
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin client.</p>
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin <p>It may be worth setting up a dedicated address for this, e.g.</p>
cb43dee5b65f707dfd575fc681ef863d6f6b0385sf ServerAdmin www-admin@foo.example.com
03aa31ad82759363ba1a55589e517b16308ef635minfrin <p>as users do not always mention that they are talking about the
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor server!</p>
c68acc9d712af079afa2bd1a5a4aeef9a3ea573ckess</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Alternate names for a host used when matching requests
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveto name-virtual hosts</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>The <code class="directive">ServerAlias</code> directive sets the
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd alternate names for a host, for use with <a href="/vhosts/name-based.html">name-based virtual hosts</a>.</p>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <VirtualHost *><br />
2aa51ed61adb484602e94de3d2214ec267aecedbigalic # ...<br />
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </VirtualHost>
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin<h3>See also</h3><ul><li><a href="/vhosts/">Apache Virtual Host documentation</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
69d4a64874fd7161f80bb0484341c60857b6fd6esf </a></th><td>Hostname and port that the server uses to identify
cb43dee5b65f707dfd575fc681ef863d6f6b0385sfitself</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor </a></th><td><code>ServerName <var>fully-qualified-domain-name</var>[:<var>port</var>]</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
cf8a8738330694e60bad421fcc8361d80b0e9124minfrin </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
69d4a64874fd7161f80bb0484341c60857b6fd6esf </a></th><td>core</td></tr><tr><th><a href="directive-dict.html#Compatibility">Compatibility:
03aa31ad82759363ba1a55589e517b16308ef635minfrin directive supersedes the functionality of the Port
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor <p>The <code class="directive">ServerName</code> directive sets the hostname and
69d4a64874fd7161f80bb0484341c60857b6fd6esf port that the server uses to identify itself. This is used when
03aa31ad82759363ba1a55589e517b16308ef635minfrin creating redirection URLs. For example, if the name of the
69d4a64874fd7161f80bb0484341c60857b6fd6esf machine hosting the webserver is <code>simple.example.com</code>,
69d4a64874fd7161f80bb0484341c60857b6fd6esf but the machine also has the DNS alias <code>www.example.com</code>
69d4a64874fd7161f80bb0484341c60857b6fd6esf and you wish the webserver to be so identified, the following
03aa31ad82759363ba1a55589e517b16308ef635minfrin directive should be used:</p>
69d4a64874fd7161f80bb0484341c60857b6fd6esf ServerName www.example.com:80
69d4a64874fd7161f80bb0484341c60857b6fd6esf <p>If no <code class="directive">ServerName</code> is specified, then the
69d4a64874fd7161f80bb0484341c60857b6fd6esf server attempts to deduce the hostname by performing a reverse
69d4a64874fd7161f80bb0484341c60857b6fd6esf lookup on the IP address. If no port is specified in the
69d4a64874fd7161f80bb0484341c60857b6fd6esf servername, then the server will use the port from the incoming
69d4a64874fd7161f80bb0484341c60857b6fd6esf request. For optimal reliability and predictability, you should
69d4a64874fd7161f80bb0484341c60857b6fd6esf specify an explicit hostname and port using the
69d4a64874fd7161f80bb0484341c60857b6fd6esf <p>If you are using <a href="/vhosts/name-based.html">name-based virtual hosts</a>,
69d4a64874fd7161f80bb0484341c60857b6fd6esf <code class="directive"><a href="#virtualhost"><VirtualHost></a></code>
69d4a64874fd7161f80bb0484341c60857b6fd6esf section specifies what hostname must appear in the request's
03aa31ad82759363ba1a55589e517b16308ef635minfrin <code>Host:</code> header to match this virtual host.</p>
69d4a64874fd7161f80bb0484341c60857b6fd6esf <p>See the description of the
03aa31ad82759363ba1a55589e517b16308ef635minfrin <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> directive for
03aa31ad82759363ba1a55589e517b16308ef635minfrin settings which determine whether self-referential URL's (e.g., by the
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> module) will refer to the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive specified port, or to the port number given in the client's request.
003f0c9fda6664daf5092a0e42f65ede20098153slive<h3>See also</h3><ul><li><a href="/dns-caveats.html">DNS Issues</a></li><li><a href="/vhosts/">Apache virtual host
fb77c505254b6e9c925e23e734463e87574f8f40kess documentation</a></li><li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li><li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Legacy URL pathname for a name-virtual host that
18b4b0fd6056093002ddef488636bf5ebe415ef0erikabeleis accessed by an incompatible browser</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
18b4b0fd6056093002ddef488636bf5ebe415ef0erikabele </a></th><td><code>ServerPath <var>URL-path</var></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive">ServerPath</code> directive sets the legacy
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive URL pathname for a host, for use with <a href="/vhosts/">name-based virtual hosts</a>.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><a href="/vhosts/">Apache Virtual Host documentation</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Base directory for the server installation</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess </a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess </a></th><td><code>ServerRoot /usr/local/apache</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>The <code class="directive">ServerRoot</code> directive sets the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directory in which the server lives. Typically it will contain the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive subdirectories <code>conf/</code> and <code>logs/</code>. Relative
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive paths for other configuration files are taken as relative to this
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directory.</p>
891df99fdfa41fc8a486568f4d31ddf4a571258adreid<h3>See also</h3><ul><li><a href="/invoking.html">the <code>-d</code>
59368b594c9b09b59ae58c7de26d2d5ce1c99a29takashi option to <code>httpd</code></a></li><li><a href="/misc/security_tips.html#serverroot">the
be192cefa381d5bae6868034687471754cb43175sf security tips</a> for information on how to properly set
891df99fdfa41fc8a486568f4d31ddf4a571258adreid permissions on the ServerRoot</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Configures the footer on server-generated documents</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>ServerSignature On|Off|EMail</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>ServerSignature Off</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>All</td></tr><tr><th><a href="directive-dict.html#Status">Status:
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick <p>The <code class="directive">ServerSignature</code> directive allows the
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick configuration of a trailing footer line under server-generated
9f38f3ec3e8087985d108a24ae796962fef83644takashi documents (error messages, mod_proxy ftp directory listings,
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick mod_info output, ...). The reason why you would want to enable
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick such a footer line is that in a chain of proxies, the user often
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick has no possibility to tell which of the chained servers actually
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor produced a returned error message.<br /> The <code>Off</code>
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen setting, which is the default, suppresses the error line (and is
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick therefore compatible with the behavior of Apache-1.2 and
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick below). The <code>On</code> setting simply adds a line with the
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen server version number and <code class="directive"><a href="#servername">ServerName</a></code> of the serving virtual host,
9f38f3ec3e8087985d108a24ae796962fef83644takashi and the <code>EMail</code> setting additionally creates a
9f38f3ec3e8087985d108a24ae796962fef83644takashi "mailto:" reference to the <code class="directive"><a href="#serveradmin">ServerAdmin</a></code> of the referenced
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick document.</p>
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick<h3>See also</h3><ul><li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick </a></th><td>Configures the Server HTTP response header</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick </a></th><td><code>ServerTokens Major|Minor|Minimal|ProductOnly|OS|Full</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick </a></th><td><code>ServerTokens Full</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick </a></th><td>server config</td></tr><tr><th><a href="directive-dict.html#Status">Status:
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
85349f40d98fb3fc7a18ef25dc40eaaae6eead1ctakashi <p>This directive controls whether <code>Server</code> response
ffec3e56ff5331a2d732ec07e9d107303fed43f4covener header field which is sent back to clients includes a
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick description of the generic OS-type of the server as well as
98f5034c8cbf2ef025b317b3e01acae82e143b11trawick information about compiled-in modules.</p>
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <dd>Server sends (<em>e.g.</em>): <code>Server: Apache/2.0.41
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <dt><code>ServerTokens Full</code> (or not specified)</dt>
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <dd>Server sends (<em>e.g.</em>): <code>Server: Apache/2.0.41
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>This setting applies to the entire server, and cannot be
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd enabled or disabled on a virtualhost-by-virtualhost basis.</p>
6c5c651b0b97607b8c8b4965c1385c67699f217fnd<h3>See also</h3><ul><li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>Forces all matching files to be processed by a
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cndhandler</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td><code>SetHandler <var>handler-name</var>|none</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
6c5c651b0b97607b8c8b4965c1385c67699f217fnd </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
750d12c59545dbbac70390988de94f7e901b08f2niq </a></th><td>core</td></tr><tr><th><a href="directive-dict.html#Compatibility">Compatibility:
4bb78e7cdd53f50240cff4ad7a97c7ed36483797slive </a></th><td>Moved into the core in Apache 2.0</td></tr></table>
4bb78e7cdd53f50240cff4ad7a97c7ed36483797slive <p>When placed into an <code>.htaccess</code> file or a
4bb78e7cdd53f50240cff4ad7a97c7ed36483797slive <code class="directive"><a href="#directory"><Directory></a></code> or
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd <code class="directive"><a href="#location"><Location></a></code>
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd section, this directive forces all matching files to be parsed
4bb78e7cdd53f50240cff4ad7a97c7ed36483797slive through the <a href="/handler.html">handler</a> given by
4bb78e7cdd53f50240cff4ad7a97c7ed36483797slive <var>handler-name</var>. For example, if you had a directory you
4bb78e7cdd53f50240cff4ad7a97c7ed36483797slive wanted to be parsed entirely as imagemap rule files, regardless
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd of extension, you might put the following into an
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd SetHandler imap-file
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd <p>Another example: if you wanted to have the server display a
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd status report whenever a URL of
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd <code>http://servername/status</code> was called, you might put
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd <Location /status><br />
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd SetHandler server-status<br />
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd </Location>
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd<h3>See also</h3><ul><li><code class="directive"><a href="/mod/mod_mime.html#addhandler">AddHandler</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Sets the filters that will process client requests and POST
2aa51ed61adb484602e94de3d2214ec267aecedbigalicinput</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
2aa51ed61adb484602e94de3d2214ec267aecedbigalic <p>The <code class="directive">SetInputFilter</code> directive sets the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive filter or filters which will process client requests and POST
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive input when they are received by the server. This is in addition to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive any filters defined elsewhere, including the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code class="directive"><a href="/mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directive.</p>
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <p>If more than one filter is specified, they must be separated
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd by semicolons in the order in which they should process the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive content.</p>
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisd<h3>See also</h3><ul><li><a href="/filter.html">Filters</a> documentation</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Sets the filters that will process responses from the
7245e9b991db85d9d9a587fe5f4051f642ebdc3cchrisdserver</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config, virtual host, directory, .htaccess</td></tr><tr><th><a href="directive-dict.html#Override">Override:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>FileInfo</td></tr><tr><th><a href="directive-dict.html#Status">Status:
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess <p>The <code class="directive">SetOutputFilter</code> directive sets the filters
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen which will process responses from the server before they are
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive sent to the client. This is in addition to any filters defined
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive elsewhere, including the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code class="directive"><a href="/mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directive.</p>
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen <p>For example, the following configuration will process all files
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen in the <code>/www/data/</code> directory for server-side
2aa51ed61adb484602e94de3d2214ec267aecedbigalic includes.</p>
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen SetOutputFilter INCLUDES<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </Directory>
03e0a375c2435102fb2b51e34cccff52acbfddcdnd <p>If more than one filter is specified, they must be separated
03e0a375c2435102fb2b51e34cccff52acbfddcdnd by semicolons in the order in which they should process the
03e0a375c2435102fb2b51e34cccff52acbfddcdnd content.</p>
03e0a375c2435102fb2b51e34cccff52acbfddcdnd<h3>See also</h3><ul><li><a href="/filter.html">Filters</a> documentation</li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
03e0a375c2435102fb2b51e34cccff52acbfddcdndcertain events before failing a request</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
03e0a375c2435102fb2b51e34cccff52acbfddcdnd </a></th><td><code>TimeOut <var>number</var></code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen </a></th><td><code>TimeOut 300</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
03e0a375c2435102fb2b51e34cccff52acbfddcdnd </a></th><td>server config</td></tr><tr><th><a href="directive-dict.html#Status">Status:
03e0a375c2435102fb2b51e34cccff52acbfddcdnd </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
03e0a375c2435102fb2b51e34cccff52acbfddcdnd <p>The <code class="directive">TimeOut</code> directive currently defines
88d86cfadffe2275a3dfb67a4d7bdc018630b661rbowen the amount of time Apache will wait for three things:</p>
03e0a375c2435102fb2b51e34cccff52acbfddcdnd <li>The total amount of time it takes to receive a GET
03e0a375c2435102fb2b51e34cccff52acbfddcdnd request.</li>
03e0a375c2435102fb2b51e34cccff52acbfddcdnd <li>The amount of time between receipt of TCP packets on a
03e0a375c2435102fb2b51e34cccff52acbfddcdnd POST or PUT request.</li>
03e0a375c2435102fb2b51e34cccff52acbfddcdnd <li>The amount of time between ACKs on transmissions of TCP
03e0a375c2435102fb2b51e34cccff52acbfddcdnd packets in responses.</li>
03e0a375c2435102fb2b51e34cccff52acbfddcdnd <p>We plan on making these separately configurable at some point
03e0a375c2435102fb2b51e34cccff52acbfddcdnd down the road. The timer used to default to 1200 before 1.2,
03e0a375c2435102fb2b51e34cccff52acbfddcdnd but has been lowered to 300 which is still far more than
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh necessary in most situations. It is not set any lower by
03e0a375c2435102fb2b51e34cccff52acbfddcdnd default because there may still be odd places in the code where
03e0a375c2435102fb2b51e34cccff52acbfddcdnd the timer is not reset when a packet is sent. </p>
03e0a375c2435102fb2b51e34cccff52acbfddcdnd</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Configures how the server determines its own name and
80c4526970a11f37c0f8e3b82afdf03902dac3f3sliveport</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>UseCanonicalName on|off|dns</code></td></tr><tr><th><a href="directive-dict.html#Default">Default:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td><code>UseCanonicalName on</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd </a></th><td>server config, virtual host, directory</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>In many situations Apache must construct a <em>self-referential</em>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive URL -- that is, a URL that refers back to the same server. With
003f0c9fda6664daf5092a0e42f65ede20098153slive <code>UseCanonicalName on</code> Apache will use the hostname and port
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive specified in the <code class="directive"><a href="#servername">ServerName</a></code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directive to construct the canonical name for the server. This name
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd is used in all self-referential URLs, and for the values of
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code>SERVER_NAME</code> and <code>SERVER_PORT</code> in CGIs.</p>
6fad623c3cc52b4a84d4d36538f6eed886f49f98covener <p>With <code>UseCanonicalName off</code> Apache will form
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive self-referential URLs using the hostname and port supplied by
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the client if any are supplied (otherwise it will use the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive canonical name, as defined above). These values are the same
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive that are used to implement <a href="/vhosts/name-based.html">name based virtual hosts</a>,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive and are available with the same clients. The CGI variables
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code>SERVER_NAME</code> and <code>SERVER_PORT</code> will be
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive constructed from the client supplied values as well.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>An example where this may be useful is on an intranet server
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess where you have users connecting to the machine using short
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess names such as <code>www</code>. You'll notice that if the users
fb77c505254b6e9c925e23e734463e87574f8f40kess type a shortname, and a URL which is a directory, such as
fb77c505254b6e9c925e23e734463e87574f8f40kess <code>http://www/splat</code>, <em>without the trailing
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive slash</em> then Apache will redirect them to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code>http://www.domain.com/splat/</code>. If you have
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive authentication enabled, this will cause the user to have to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive authenticate twice (once for <code>www</code> and once again
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive for <code>www.domain.com</code> -- see <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">the
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen FAQ on this subject for more information</a>). But if
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen <code class="directive">UseCanonicalName</code> is set off, then Apache will
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen <p>There is a third option, <code>UseCanonicalName DNS</code>,
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh which is intended for use with mass IP-based virtual hosting to
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor support ancient clients that do not provide a
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor <code>Host:</code> header. With this option Apache does a
6fad623c3cc52b4a84d4d36538f6eed886f49f98covener reverse DNS lookup on the server IP address that the client
6fad623c3cc52b4a84d4d36538f6eed886f49f98covener connected to in order to work out self-referential URLs.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>If CGIs make assumptions about the values of <code>SERVER_NAME</code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive they may be broken by this option. The client is essentially free
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive to give whatever value they want as a hostname. But if the CGI is
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive only using <code>SERVER_NAME</code> to construct self-referential URLs
313bb560bc5c323cfd40c9cad7335b4b8e060aedkess then it should be just fine.</p>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd<h3>See also</h3><ul><li><code class="directive"><a href="#servername">ServerName</a></code></li><li><code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div><div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a> <a name="virtualhost" id="virtualhost">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Contains directives that apply only to a specific
e0ef044feba0082771091af42798cada5bb1f4fcrbowenhostname or IP address</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]]
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd ...> ... </VirtualHost></code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>server config</td></tr><tr><th><a href="directive-dict.html#Status">Status:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </a></th><td>Core</td></tr><tr><th><a href="directive-dict.html#Module">Module:
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p><code class="directive"><VirtualHost></code> and
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code></VirtualHost></code> are used to enclose a group of
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directives that will apply only to a particular virtual host. Any
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive directive that is allowed in a virtual host context may be
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive used. When the server receives a request for a document on a
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive particular virtual host, it uses the configuration directives
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive enclosed in the <code class="directive"><VirtualHost></code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <li>A fully qualified domain name for the IP address of the
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive virtual host;</li>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <li>The character *, which is used only in combination with
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <code>NameVirtualHost *</code> to match all IP addresses; or</li>
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen <li>The string <code>_default_</code>, which is used only
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen with IP virtual hosting to catch unmatched IP addresses.</li>
2f505ba07f89ba6a175d6ceae67fb273c4eb0993covener <VirtualHost 10.1.2.3><br />
611f7fd8a0a5ee4a29eeed79dfd8bf6faaa3c613covener ServerAdmin webmaster@host.foo.com<br />
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive </VirtualHost>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>IPv6 addresses must be specified in square brackets because
ae134ecc8faf4e6a8eb68e1c3724506771442a46rbowen the optional port number could not be determined otherwise. An
ae134ecc8faf4e6a8eb68e1c3724506771442a46rbowen IPv6 example is shown below:</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <VirtualHost [fe80::a00:20ff:fea7:ccea]><br />
72580dbc2a55511f13f377063725b9f143b20826stoddard ServerAdmin webmaster@host.example.com<br />
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor </VirtualHost>
56d7eed7205462540aec7202cd82d9f5516fc537kess <p>Each Virtual Host must correspond to a different IP address,
72580dbc2a55511f13f377063725b9f143b20826stoddard different port number or a different host name for the server,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive in the former case the server machine must be configured to
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive accept IP packets for multiple addresses. (If the machine does
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive not have multiple network interfaces, then this can be
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen accomplished with the <code>ifconfig alias</code> command (if
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen your OS supports it).</p>
2e4a251ce928e74ed84fd089cdceaf5f6b5c53f2humbedooh <p>The use of <code class="directive"><VirtualHost></code> does
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen <strong>not</strong> affect what addresses Apache listens on. You
d3f27ec18dfa6283e852aa98253212edafaa0e2brbowen may need to ensure that Apache is listening on the correct addresses
0d5d5dc11ad29fca835d0967d2fb98ad3977d511sf using <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code>.</p>
031bbbc0d1189b07330e38d0c126820a9ab7795egryzor <p>When using IP-based virtual hosting, the special name
ffec3e56ff5331a2d732ec07e9d107303fed43f4covener which case this virtual host will match any IP address that is
611f7fd8a0a5ee4a29eeed79dfd8bf6faaa3c613covener not explicitly listed in another virtual host. In the absence
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive of any _default_ virtual host the "main" server config,
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive consisting of all those definitions outside any VirtualHost
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive section, is used when no IP-match occurs. (But note that any IP
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive address that matches a <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> directive will use neither
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive the "main" server config nor the _default_ virtual host. See the <a href="/vhosts/name-based.html">name-based virtual hosting</a>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive documentation for further details.)</p>
a7f40ca49262952d6dd69d021cf5b0c2b452ae4cnd <p>You can specify a <code>:port</code> to change the port that is
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive matched. If unspecified then it defaults to the same port as the
e0ef044feba0082771091af42798cada5bb1f4fcrbowen most recent <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive statement of the main server. You may also specify <code>:*</code>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive to match all ports on that address. (This is recommended when used
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive <p>See the <a href="/misc/security_tips.html">security tips</a>
4cc747f0aeda5b90c72e7e3ad22d5e58d6c48bc9rbowen document for details on why your security could be compromised if the
72580dbc2a55511f13f377063725b9f143b20826stoddard directory where logfiles are stored is writable by anyone other
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive than the user that starts the server.</p>
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive<h3>See also</h3><ul><li><a href="/vhosts/">Apache Virtual Host documentation</a></li><li><a href="/dns-caveats.html">Warnings about DNS and
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive which addresses and ports Apache uses</a></li><li><a href="/sections.html">How
fb77c505254b6e9c925e23e734463e87574f8f40kess Directory, Location and Files sections work</a> for an
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive explanation of how these different sections are combined when a
80c4526970a11f37c0f8e3b82afdf03902dac3f3slive request is received</li></ul></div></div><div id="footer"><p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p><p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div></body></html>