core.html.en revision c3e2e664a67b1adb9b6a6b91ff161f4f562cecf6
d24d4c5159bcb11c25bb294926cfe7105c789ea9slive<!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<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding<link href="/images/favicon.ico" rel="shortcut icon" /></head>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<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>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<p><span>Available Languages: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
88f76f668542dcd72fc9d71577997967c6bf123bslive<a href="/en/mod/core.html" title="English"> en </a> |
88f76f668542dcd72fc9d71577997967c6bf123bslive<a href="/fr/mod/core.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
88f76f668542dcd72fc9d71577997967c6bf123bslive<a href="/ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
88f76f668542dcd72fc9d71577997967c6bf123bslive<a href="/tr/mod/core.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
88f76f668542dcd72fc9d71577997967c6bf123bslive<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Core Apache HTTP Server features that are always
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Core</td></tr></table>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div id="quickview"><h3 class="directives">Directives</h3>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#define">Define</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#directory"><Directory></a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar<li><img alt="" src="/images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#errorlogformat">ErrorLogFormat</a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#fileetag">FileETag</a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#files"><Files></a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#forcetype">ForceType</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#gprofdir">GprofDir</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#if"><If></a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#include">Include</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
38677582e6ddf26e810728a68cbe560345486e48slive<li><img alt="" src="/images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
38677582e6ddf26e810728a68cbe560345486e48slive<li><img alt="" src="/images/down.gif" /> <a href="#limit"><Limit></a></li>
38677582e6ddf26e810728a68cbe560345486e48slive<li><img alt="" src="/images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
6e87cc731ab01e065173ae8cc7152751d0387122humbedooh<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#location"><Location></a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#mutex">Mutex</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#options">Options</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#servername">ServerName</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<li><img alt="" src="/images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
b475917ddf898282aa51ce31b3275c2c4783ce98coar<li><img alt="" src="/images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
b475917ddf898282aa51ce31b3275c2c4783ce98coar<li><img alt="" src="/images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<li><img alt="" src="/images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#timeout">TimeOut</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#undefine">UnDefine</a></li>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a></h2>
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures optimizations for a Protocol's Listener Sockets</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.1.5 and later.
88f76f668542dcd72fc9d71577997967c6bf123bsliveOn Windows from Apache httpd 2.3.3 and later.</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin <p>This directive enables operating system specific optimizations for a
67a715b4352c3e25bff32fccad48350180393f5end listening socket by the Protocol type. The basic premise is for the
88f76f668542dcd72fc9d71577997967c6bf123bslive kernel to not send a socket to the server process until either data
291eb44b3adaf8247425286615b4f4b69fbea274minfrin is received or an entire HTTP Request is buffered. Only
88f76f668542dcd72fc9d71577997967c6bf123bslive <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&sektion=9">
88f76f668542dcd72fc9d71577997967c6bf123bslive FreeBSD's Accept Filters</a>, Linux's more primitive
88f76f668542dcd72fc9d71577997967c6bf123bslive <code>TCP_DEFER_ACCEPT</code>, and Windows' optimized AcceptEx()
88f76f668542dcd72fc9d71577997967c6bf123bslive are currently supported.</p>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun <p>Using <code>none</code> for an argument will disable any accept filters
88f76f668542dcd72fc9d71577997967c6bf123bslive for that protocol. This is useful for protocols that require a server
bb5f801a009c899d5678dad7177aaac3a02349a5humbedooh send data first, such as <code>ftp:</code> or <code>nntp</code>:</p>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun <div class="example"><p><code>AcceptFilter nntp none</code></p></div>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh AcceptFilter http httpready <br />
b475917ddf898282aa51ce31b3275c2c4783ce98coar AcceptFilter https dataready
39b600973267f27982523479ea58fd57414acd1ecovener <p>The <code>httpready</code> accept filter buffers entire HTTP requests at
0222f4c188bbd414e293e0b78a8e350e3054322anilgun the kernel level. Once an entire request is received, the kernel then
0222f4c188bbd414e293e0b78a8e350e3054322anilgun sends it to the server. See the
39b600973267f27982523479ea58fd57414acd1ecovener <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&sektion=9">
0222f4c188bbd414e293e0b78a8e350e3054322anilgun accf_http(9)</a> man page for more details. Since HTTPS requests are
0222f4c188bbd414e293e0b78a8e350e3054322anilgun encrypted only the <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&sektion=9">
0222f4c188bbd414e293e0b78a8e350e3054322anilgun AcceptFilter http data <br />
2e539be4c778979088a05a6f164d47db200f73abnd AcceptFilter https data
0222f4c188bbd414e293e0b78a8e350e3054322anilgun <p>Linux's <code>TCP_DEFER_ACCEPT</code> does not support buffering http
7bd130b92562a79fa13eb163ce47d8a708c70425rbowen requests. Any value besides <code>none</code> will enable
7bd130b92562a79fa13eb163ce47d8a708c70425rbowen <code>TCP_DEFER_ACCEPT</code> on that listener. For more details
bb5f801a009c899d5678dad7177aaac3a02349a5humbedooh see the Linux
7bd130b92562a79fa13eb163ce47d8a708c70425rbowen <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html">
0dd298aa254f43fc223b1cc41e79d4a1fec308bcnd AcceptFilter http data <br />
88f76f668542dcd72fc9d71577997967c6bf123bslive AcceptFilter https data
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>Window's mpm_winnt interprets the AcceptFilter to toggle the AcceptEx()
88f76f668542dcd72fc9d71577997967c6bf123bslive API, and does not support http protocol buffering. There are two values
0287d5784a0533920978a7eb8f3cdeace17b467arbowen which utilize the Windows AcceptEx() API and will recycle network
0287d5784a0533920978a7eb8f3cdeace17b467arbowen sockets between connections. <code>data</code> waits until data has
52ebee778263c25c1b366f5e296d3f973fcb7aband been transmitted as documented above, and the initial data buffer and
0287d5784a0533920978a7eb8f3cdeace17b467arbowen network endpoint addresses are all retrieved from the single AcceptEx()
0287d5784a0533920978a7eb8f3cdeace17b467arbowen invocation. <code>connect</code> will use the AcceptEx() API, also
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh retrieve the network endpoint addresses, but like <code>none</code>
b475917ddf898282aa51ce31b3275c2c4783ce98coar the <code>connect</code> option does not wait for the initial data
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar transmission.</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>On Windows, <code>none</code> uses accept() rather than than AcceptEx()
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh and will not recycle sockets between connections. This is useful for
0287d5784a0533920978a7eb8f3cdeace17b467arbowen network adapters with broken driver support, as well as some virtual
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar network providers such as vpn drivers, or spam, virus or spyware
a502eaab6c03ce460caec304e249f013d6ed8a91covener filters.</p>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a></h2>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Resources accept trailing pathname information</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
b475917ddf898282aa51ce31b3275c2c4783ce98coar<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
b475917ddf898282aa51ce31b3275c2c4783ce98coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.0.30 and later</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>This directive controls whether requests that contain trailing
88f76f668542dcd72fc9d71577997967c6bf123bslive pathname information that follows an actual filename (or
88f76f668542dcd72fc9d71577997967c6bf123bslive non-existent file in an existing directory) will be accepted or
88f76f668542dcd72fc9d71577997967c6bf123bslive rejected. The trailing pathname information can be made
88f76f668542dcd72fc9d71577997967c6bf123bslive available to scripts in the <code>PATH_INFO</code> environment
0222f4c188bbd414e293e0b78a8e350e3054322anilgun variable.</p>
67a715b4352c3e25bff32fccad48350180393f5end <p>For example, assume the location <code>/test/</code> points to
67a715b4352c3e25bff32fccad48350180393f5end a directory that contains only the single file
0222f4c188bbd414e293e0b78a8e350e3054322anilgun <p>The three possible arguments for the
0222f4c188bbd414e293e0b78a8e350e3054322anilgun <code class="directive">AcceptPathInfo</code> directive are:</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <dt><code>Off</code></dt><dd>A request will only be accepted if it
88f76f668542dcd72fc9d71577997967c6bf123bslive maps to a literal path that exists. Therefore a request with
88f76f668542dcd72fc9d71577997967c6bf123bslive trailing pathname information after the true filename such as
88f76f668542dcd72fc9d71577997967c6bf123bslive <code>/test/here.html/more</code> in the above example will return
88f76f668542dcd72fc9d71577997967c6bf123bslive a 404 NOT FOUND error.</dd>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <dt><code>On</code></dt><dd>A request will be accepted if a
b475917ddf898282aa51ce31b3275c2c4783ce98coar leading path component maps to a file that exists. The above
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh example <code>/test/here.html/more</code> will be accepted if
aa997d6b651a6ac262d708b7f807a080d57c3844slive <code>/test/here.html</code> maps to a valid file.</dd>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <dt><code>Default</code></dt><dd>The treatment of requests with
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier trailing pathname information is determined by the <a href="/handler.html">handler</a> responsible for the request.
bb5f801a009c899d5678dad7177aaac3a02349a5humbedooh The core handler for normal files defaults to rejecting
aa997d6b651a6ac262d708b7f807a080d57c3844slive <code>PATH_INFO</code> requests. Handlers that serve scripts, such as <a href="mod_cgi.html">cgi-script</a> and <a href="mod_isapi.html">isapi-handler</a>, generally accept
aa997d6b651a6ac262d708b7f807a080d57c3844slive <p>The primary purpose of the <code>AcceptPathInfo</code>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier directive is to allow you to override the handler's choice of
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier accepting or rejecting <code>PATH_INFO</code>. This override is required,
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier for example, when you use a <a href="/filter.html">filter</a>, such
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier as <a href="mod_include.html">INCLUDES</a>, to generate content
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier based on <code>PATH_INFO</code>. The core handler would usually reject
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier the request, so you can use the following configuration to enable
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier such a script:</p>
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim Options +Includes<br />
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier SetOutputFilter INCLUDES<br />
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier AcceptPathInfo On<br />
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier </Files>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a></h2>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the distributed configuration file</td></tr>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>While processing a request the server looks for
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier the first existing configuration file from this list of names in
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier every directory of the path to the document, if distributed
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier configuration files are <a href="#allowoverride">enabled for that
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier AccessFileName .acl
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <p>before returning the document
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <code>/usr/local/web/index.html</code>, the server will read
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <code>/usr/local/.acl</code> and <code>/usr/local/web/.acl</code>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier for directives, unless they have been disabled with</p>
b475917ddf898282aa51ce31b3275c2c4783ce98coar <Directory /><br />
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier AllowOverride None<br />
4130ea2bd87f049953016c594cb11aea02b7f9bacovener </Directory>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><a href="/configuring.html">Configuration Files</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a></h2>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default charset parameter to be added when a response
88f76f668542dcd72fc9d71577997967c6bf123bslivecontent-type is <code>text/plain</code> or <code>text/html</code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
82fedb7a2164fa01fe2870f080aeac6344503148slive<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
82fedb7a2164fa01fe2870f080aeac6344503148slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
82fedb7a2164fa01fe2870f080aeac6344503148slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
e32abf00422bf50d92c28c448f60b951c8fa42earbowen <p>This directive specifies a default value for the media type
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim charset parameter (the name of a character encoding) to be added
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim to a response if and only if the response's content-type is either
e32abf00422bf50d92c28c448f60b951c8fa42earbowen <code>text/plain</code> or <code>text/html</code>. This should override
e32abf00422bf50d92c28c448f60b951c8fa42earbowen any charset specified in the body of the response via a <code>META</code>
aa997d6b651a6ac262d708b7f807a080d57c3844slive element, though the exact behavior is often dependent on the user's client
82fedb7a2164fa01fe2870f080aeac6344503148slive configuration. A setting of <code>AddDefaultCharset Off</code>
82fedb7a2164fa01fe2870f080aeac6344503148slive disables this functionality. <code>AddDefaultCharset On</code> enables
82fedb7a2164fa01fe2870f080aeac6344503148slive a default charset of <code>iso-8859-1</code>. Any other value is assumed
82fedb7a2164fa01fe2870f080aeac6344503148slive to be the <var>charset</var> to be used, which should be one of the
82fedb7a2164fa01fe2870f080aeac6344503148slive <a href="http://www.iana.org/assignments/character-sets">IANA registered
88f76f668542dcd72fc9d71577997967c6bf123bslive charset values</a> for use in Internet media types (MIME types).
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh For example:</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh AddDefaultCharset utf-8
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p><code class="directive">AddDefaultCharset</code> should only be used when all
88f76f668542dcd72fc9d71577997967c6bf123bslive of the text resources to which it applies are known to be in that
0222f4c188bbd414e293e0b78a8e350e3054322anilgun character encoding and it is too inconvenient to label their charset
0222f4c188bbd414e293e0b78a8e350e3054322anilgun individually. One such example is to add the charset parameter
0222f4c188bbd414e293e0b78a8e350e3054322anilgun to resources containing generated content, such as legacy CGI
b2bdfa03847b3d5edc094516de5d30189ab7667digalic scripts, that might be vulnerable to cross-site scripting attacks
b2bdfa03847b3d5edc094516de5d30189ab7667digalic due to user-provided data being included in the output. Note, however,
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim that a better solution is to just fix (or delete) those scripts, since
b2bdfa03847b3d5edc094516de5d30189ab7667digalic setting a default charset does not protect users that have enabled
b2bdfa03847b3d5edc094516de5d30189ab7667digalic the "auto-detect character encoding" feature on their browser.</p>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<li><code class="directive"><a href="/mod/mod_mime.html#addcharset">AddCharset</a></code></li>
1dc8b93510d9b89f686e98b98a18cc436cefa7f2slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1dc8b93510d9b89f686e98b98a18cc436cefa7f2slive<div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a></h2>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether encoded path separators in URLs are allowed to
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
67a715b4352c3e25bff32fccad48350180393f5end<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.0.46 and later</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>The <code class="directive">AllowEncodedSlashes</code> directive allows URLs
88f76f668542dcd72fc9d71577997967c6bf123bslive which contain encoded path separators (<code>%2F</code> for <code>/</code>
88f76f668542dcd72fc9d71577997967c6bf123bslive and additionally <code>%5C</code> for <code>\</code> on according systems)
88f76f668542dcd72fc9d71577997967c6bf123bslive to be used. Normally such URLs are refused with a 404 (Not found) error.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>Turning <code class="directive">AllowEncodedSlashes</code> <code>On</code> is
88f76f668542dcd72fc9d71577997967c6bf123bslive mostly useful when used in conjunction with <code>PATH_INFO</code>.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>Allowing encoded slashes does <em>not</em> imply <em>decoding</em>.
88f76f668542dcd72fc9d71577997967c6bf123bslive Occurrences of <code>%2F</code> or <code>%5C</code> (<em>only</em> on
88f76f668542dcd72fc9d71577997967c6bf123bslive according systems) will be left as such in the otherwise decoded URL
88f76f668542dcd72fc9d71577997967c6bf123bslive string.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a></h2>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types of directives that are allowed in
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>directive-type</var>
5244cea61e02ab62f43c36a30693a91844b77d2drbowen<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowOverride All</code></td></tr>
5244cea61e02ab62f43c36a30693a91844b77d2drbowen<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
f57336f481f784131918fbcab13d5e4d5f4a1be1rbowen<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
5244cea61e02ab62f43c36a30693a91844b77d2drbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
bd63a8c7b38d0af10e7c9d891a245913daabd352rbowen <p>When the server finds an <code>.htaccess</code> file (as
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>)
b475917ddf898282aa51ce31b3275c2c4783ce98coar it needs to know which directives declared in that file can override
b475917ddf898282aa51ce31b3275c2c4783ce98coar earlier configuration directives.</p>
bd63a8c7b38d0af10e7c9d891a245913daabd352rbowen <div class="note"><h3>Only available in <Directory> sections</h3>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin <code class="directive">AllowOverride</code> is valid only in
291eb44b3adaf8247425286615b4f4b69fbea274minfrin <code class="directive"><a href="#directory"><Directory></a></code>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin sections specified without regular expressions, not in <code class="directive"><a href="#location"><Location></a></code>, <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code> or
291eb44b3adaf8247425286615b4f4b69fbea274minfrin <code class="directive"><a href="#files"><Files></a></code> sections.
291eb44b3adaf8247425286615b4f4b69fbea274minfrin <p>When this directive is set to <code>None</code>, then
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <a href="#accessfilename">.htaccess</a> files are completely ignored.
b475917ddf898282aa51ce31b3275c2c4783ce98coar In this case, the server will not even attempt to read
b475917ddf898282aa51ce31b3275c2c4783ce98coar <p>When this directive is set to <code>All</code>, then any
291eb44b3adaf8247425286615b4f4b69fbea274minfrin directive which has the .htaccess <a href="directive-dict.html#Context">Context</a> is allowed in
291eb44b3adaf8247425286615b4f4b69fbea274minfrin <p>The <var>directive-type</var> can be one of the following
291eb44b3adaf8247425286615b4f4b69fbea274minfrin groupings of directives.</p>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun Allow use of the authorization directives (<code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
15ba1801088da1aad6d20609cf3f7b0b1eefce8aslive <code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
67a715b4352c3e25bff32fccad48350180393f5end <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
67a715b4352c3e25bff32fccad48350180393f5end <code class="directive"><a href="/mod/mod_authn_core.html#authname">AuthName</a></code>,
88f76f668542dcd72fc9d71577997967c6bf123bslive <code class="directive"><a href="/mod/mod_authn_core.html#authtype">AuthType</a></code>, <code class="directive"><a href="/mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>, <em>etc.</em>).</dd>
88f76f668542dcd72fc9d71577997967c6bf123bslive Allow use of the directives controlling document types
0222f4c188bbd414e293e0b78a8e350e3054322anilgun (<code class="directive"><a href="#errordocument">ErrorDocument</a></code>,
0222f4c188bbd414e293e0b78a8e350e3054322anilgun <code class="directive"><a href="#forcetype">ForceType</a></code>,
030108b1816bcda3d925df65357feabdce83bc94slive <code class="directive"><a href="/mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
88f76f668542dcd72fc9d71577997967c6bf123bslive <code class="directive"><a href="#sethandler">SetHandler</a></code>,
88f76f668542dcd72fc9d71577997967c6bf123bslive <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>,
88f76f668542dcd72fc9d71577997967c6bf123bslive <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, and
88f76f668542dcd72fc9d71577997967c6bf123bslive <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> Add* and Remove* directives),
88f76f668542dcd72fc9d71577997967c6bf123bslive document meta data (<code class="directive"><a href="/mod/mod_headers.html#header">Header</a></code>, <code class="directive"><a href="/mod/mod_headers.html#requestheader">RequestHeader</a></code>, <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, <code class="directive"><a href="/mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code>, <code class="directive"><a href="/mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, <code class="directive"><a href="/mod/mod_usertrack.html#cookieexpires">CookieExpires</a></code>, <code class="directive"><a href="/mod/mod_usertrack.html#cookiedomain">CookieDomain</a></code>, <code class="directive"><a href="/mod/mod_usertrack.html#cookiestyle">CookieStyle</a></code>, <code class="directive"><a href="/mod/mod_usertrack.html#cookietracking">CookieTracking</a></code>, <code class="directive"><a href="/mod/mod_usertrack.html#cookiename">CookieName</a></code>),
67a715b4352c3e25bff32fccad48350180393f5end <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> directives <code class="directive"><a href="/mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code>, <code class="directive"><a href="/mod/mod_rewrite.html#rewriteoptions">RewriteOptions</a></code>, <code class="directive"><a href="/mod/mod_rewrite.html#rewritebase">RewriteBase</a></code>, <code class="directive"><a href="/mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>) and
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> from
b475917ddf898282aa51ce31b3275c2c4783ce98coar <code class="module"><a href="/mod/mod_actions.html">mod_actions</a></code>.
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier Allow use of the directives controlling directory indexing
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier (<code class="directive"><a href="/mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <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>,
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <code class="directive"><a href="/mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <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>,
88f76f668542dcd72fc9d71577997967c6bf123bslive 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>
88f76f668542dcd72fc9d71577997967c6bf123bslive Allow use of the directives controlling specific directory
88f76f668542dcd72fc9d71577997967c6bf123bslive features (<code class="directive"><a href="#options">Options</a></code> and
88f76f668542dcd72fc9d71577997967c6bf123bslive <code class="directive"><a href="/mod/mod_include.html#xbithack">XBitHack</a></code>).
88f76f668542dcd72fc9d71577997967c6bf123bslive An equal sign may be given followed by a comma (but no spaces)
88f76f668542dcd72fc9d71577997967c6bf123bslive separated lists of options that may be set using the <code class="directive"><a href="#options">Options</a></code> command.</dd>
88f76f668542dcd72fc9d71577997967c6bf123bslive AllowOverride AuthConfig Indexes
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>In the example above all directives that are neither in the group
88f76f668542dcd72fc9d71577997967c6bf123bslive <code>AuthConfig</code> nor <code>Indexes</code> cause an internal
67a715b4352c3e25bff32fccad48350180393f5end server error.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <div class="note"><p>For security and performance reasons, do not set
88f76f668542dcd72fc9d71577997967c6bf123bslive <code>AllowOverride</code> to anything other than <code>None</code>
88f76f668542dcd72fc9d71577997967c6bf123bslive in your <code><Directory /></code> block. Instead, find (or
88f76f668542dcd72fc9d71577997967c6bf123bslive create) the <code><Directory></code> block that refers to the
88f76f668542dcd72fc9d71577997967c6bf123bslive directory where you're actually planning to place a
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><a href="/configuring.html">Configuration Files</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
67a715b4352c3e25bff32fccad48350180393f5end<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a></h2>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIMapExtension <var>cgi-path</var> <var>.extension</var></code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
aa997d6b651a6ac262d708b7f807a080d57c3844slive<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>NetWare only</td></tr>
aa997d6b651a6ac262d708b7f807a080d57c3844slive <p>This directive is used to control how Apache httpd finds the
88f76f668542dcd72fc9d71577997967c6bf123bslive interpreter used to run CGI scripts. For example, setting
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh cause all CGI script files with a <code>.foo</code> extension to
b475917ddf898282aa51ce31b3275c2c4783ce98coar be passed to the FOO interpreter.</p>
39b600973267f27982523479ea58fd57414acd1ecovener<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
aa997d6b651a6ac262d708b7f807a080d57c3844slive<div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">Directive</a></h2>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables the generation of <code>Content-MD5</code> HTTP Response
b475917ddf898282aa51ce31b3275c2c4783ce98coar<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ContentDigest On|Off</code></td></tr>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ContentDigest Off</code></td></tr>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Options</td></tr>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
aa997d6b651a6ac262d708b7f807a080d57c3844slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
e54ed2ca7730f513417f7ddbb2c85a49a8063cdbpctony <p>This directive enables the generation of
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh respectively RFC2616.</p>
b475917ddf898282aa51ce31b3275c2c4783ce98coar <p>MD5 is an algorithm for computing a "message digest"
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim (sometimes called "fingerprint") of arbitrary-length data, with
e54ed2ca7730f513417f7ddbb2c85a49a8063cdbpctony a high degree of confidence that any alterations in the data
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim will be reflected in alterations in the message digest.</p>
e54ed2ca7730f513417f7ddbb2c85a49a8063cdbpctony <p>The <code>Content-MD5</code> header provides an end-to-end
e54ed2ca7730f513417f7ddbb2c85a49a8063cdbpctony message integrity check (MIC) of the entity-body. A proxy or
48981ff8ae4c9f2d7ac18c320727de9c36480d0fslive client may check this header for detecting accidental
aa997d6b651a6ac262d708b7f807a080d57c3844slive modification of the entity-body in transit. Example header:</p>
aa997d6b651a6ac262d708b7f807a080d57c3844slive Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
aa997d6b651a6ac262d708b7f807a080d57c3844slive <p>Note that this can cause performance problems on your server
aa997d6b651a6ac262d708b7f807a080d57c3844slive since the message digest is computed on every request (the
aa997d6b651a6ac262d708b7f807a080d57c3844slive values are not cached).</p>
48981ff8ae4c9f2d7ac18c320727de9c36480d0fslive <p><code>Content-MD5</code> is only sent for documents served
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh by the <code class="module"><a href="/mod/core.html">core</a></code>, and not by any module. For example,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar SSI documents, output from CGI scripts, and byte range responses
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh do not have this header.</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
48981ff8ae4c9f2d7ac18c320727de9c36480d0fslive<div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a></h2>
48981ff8ae4c9f2d7ac18c320727de9c36480d0fslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>This directive has no effect other than to emit warnings
0222f4c188bbd414e293e0b78a8e350e3054322anilgunif the value is not <code>none</code>. In prior versions, DefaultType
48981ff8ae4c9f2d7ac18c320727de9c36480d0fslivewould specify a default media type to assign to response content for
aa997d6b651a6ac262d708b7f807a080d57c3844slivewhich no other media type configuration could be found.
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>media-type|none</var></code></td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DefaultType none</code></td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>The argument <code>none</code> is available in Apache httpd 2.2.7 and later. All other choices are DISABLED for 2.3.x and later.</td></tr>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin <p>This directive has been disabled. For backwards compatibility
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar of configuration files, it may be specified with the value
b475917ddf898282aa51ce31b3275c2c4783ce98coar <code>none</code>, meaning no default media type. For example:</p>
291eb44b3adaf8247425286615b4f4b69fbea274minfrin DefaultType None
88f76f668542dcd72fc9d71577997967c6bf123bslive httpd-2.2.7 and later.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <code class="directive"><a href="/mod/mod_mime.html#addtype">AddType</a></code> to configure media
88f76f668542dcd72fc9d71577997967c6bf123bslive type assignments via file extensions, or the
67a715b4352c3e25bff32fccad48350180393f5end <code class="directive"><a href="#forcetype">ForceType</a></code> directive to configure
67a715b4352c3e25bff32fccad48350180393f5end the media type for specific resources. Otherwise, the server will
88f76f668542dcd72fc9d71577997967c6bf123bslive send the response without a Content-Type header field and the
88f76f668542dcd72fc9d71577997967c6bf123bslive recipient may attempt to guess the media type.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
0222f4c188bbd414e293e0b78a8e350e3054322anilgun<div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a></h2>
030108b1816bcda3d925df65357feabdce83bc94slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the existence of a variable</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Define <var>parameter-name</var></code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
67a715b4352c3e25bff32fccad48350180393f5end <p>Equivalent to passing the <code>-D</code> argument to <code class="program"><a href="/programs/httpd.html">httpd</a></code>.</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>This directive can be used to toggle the use of <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sections without needing to alter
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">Directive</a></h2>
bb5f801a009c899d5678dad7177aaac3a02349a5humbedooh<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that apply only to the
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoiriernamed file-system directory and sub-directories</td></tr>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Directory <var>directory-path</var>>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <p><code class="directive"><Directory></code> and
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier <code></Directory></code> are used to enclose a group of
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier directives that will apply only to the named directory and
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier sub-directories of that directory. Any directive that is allowed
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier in a directory context may be used. <var>Directory-path</var> is
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier either the full path to a directory, or a wild-card string using
c700b3b19086d0d0d52e74fd51e54864e3a11bbbpoirier Unix shell-style matching. In a wild-card string, <code>?</code> matches
88f76f668542dcd72fc9d71577997967c6bf123bslive any single character, and <code>*</code> matches any sequences of
88f76f668542dcd72fc9d71577997967c6bf123bslive characters. You may also use <code>[]</code> character ranges. None
88f76f668542dcd72fc9d71577997967c6bf123bslive of the wildcards match a `/' character, so <code><Directory
88f76f668542dcd72fc9d71577997967c6bf123bslive /*/public_html></code> will not match
first, interspersed with the directives from the <a href="#accessfilename">.htaccess</a> files. For example,
<em>want</em> accessible. See the <a href="/misc/security_tips.html">Security Tips</a> page for more
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>
<div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose directives that apply to
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><DirectoryMatch <var>regex</var>>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular expression</a>. For example:</p>
<div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory that forms the main document tree visible
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<p>This directive sets the directory from which <code class="program"><a href="/programs/httpd.html">httpd</a></code>
will serve files. Unless matched by a directive like <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code>, the server appends the
not absolute then it is assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
<div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use memory-mapping to read files during delivery</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableMMAP On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<p>This directive controls whether the <code class="program"><a href="/programs/httpd.html">httpd</a></code> may use
server-parsed file using <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> -- Apache httpd
<li>Deleting or truncating a file while <code class="program"><a href="/programs/httpd.html">httpd</a></code>
has it memory-mapped can cause <code class="program"><a href="/programs/httpd.html">httpd</a></code> to
<div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</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:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableSendfile Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in version 2.0.44 and later. Default changed to Off in
<p>This directive controls whether <code class="program"><a href="/programs/httpd.html">httpd</a></code> may use the
<li>With a network-mounted <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (e.g., NFS, SMB, CIFS, FUSE),
<div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>What the server will return to the client
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>error-code</var> <var>document</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Quoting syntax for text messages is different in Apache HTTP Server
Microsoft Knowledge Base article <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
<code class="directive"><a href="/mod/mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></code> so that you can provide
<div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location where the server will log errors</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</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:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a> <a name="errorlogformat" id="errorlogformat">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Format specification for error log entries</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLog [connection|request] <var>format</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.3.9 and later</td></tr>
<code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code>, to allow to correlate access log entries
with error log lines. If <code class="module"><a href="/mod/mod_unique_id.html">mod_unique_id</a></code> is loaded, its
<div class="directive-section"><h2><a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keep track of extended status information for each
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ExtendedStatus On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ExtendedStatus Off[*]</code></td></tr>
<code class="module"><a href="/mod/mod_status.html">mod_status</a></code>. Note that other modules may
<p>Note that loading <code class="module"><a href="/mod/mod_status.html">mod_status</a></code> will change
The default is changed by <code class="module"><a href="/mod/mod_status.html">mod_status</a></code> beginning
<div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File attributes used to create the ETag
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FileETag <var>component</var> ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
enabled and use <code class="module"><a href="/mod/mod_dav_fs.html">mod_dav_fs</a></code> as a storage provider.
<code class="module"><a href="/mod/mod_dav_fs.html">mod_dav_fs</a></code> uses <code>INode MTime Size</code>
An ETag is not generated for responses parsed by <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>,
<div class="directive-section"><h2><a name="Files" id="Files"><Files></a> <a name="files" id="files">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to matched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Files <var>filename</var>> ... </Files></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
<code>.htaccess</code> files are read, but before <code class="directive"><a href="#location"><Location></a></code> sections. Note
inside <code class="directive"><a href="#directory"><Directory></a></code> sections to restrict the
<p>would match most common Internet graphics formats. <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> is preferred,
<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
<div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a> <a name="filesmatch" id="filesmatch">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to regular-expression matched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
does. However, it accepts a <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular
<div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be served with the specified
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForceType <var>media-type</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Moved to the core in Apache httpd 2.0</td></tr>
associations defined in mime.types or via the
<div class="directive-section"><h2><a name="GprofDir" id="GprofDir">GprofDir</a> <a name="gprofdir" id="gprofdir">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory to write gmon.out profiling data to. </td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>GprofDir <var>/tmp/gprof/</var>|<var>/tmp/gprof/</var>%</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<p>This directive currently only works with the <code class="module"><a href="/mod/prefork.html">prefork</a></code>
<div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables DNS lookups on client IP addresses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>HostnameLookups Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<p>Regardless of the setting, when <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> is
amounts of time. The utility <code class="program"><a href="/programs/logresolve.html">logresolve</a></code>, compiled by
<div class="directive-section"><h2><a name="If" id="If"><If></a> <a name="if" id="if">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><If <var>expression</var>> ... </If></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a> <a name="ifdefine" id="ifdefine">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that will be processed only
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfDefine [!]<var>parameter-name</var>> ...
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<p>The <var>test</var> in the <code class="directive"><IfDefine></code> section directive can be one of two forms:</p>
<code class="program"><a href="/programs/httpd.html">httpd</a></code> command line via <code>-D<var>parameter</var>
</code> at the time the server was started or by the <code class="directive"><a href="#define">Define</a></code> directive.</p>
<div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a> <a name="ifmodule" id="ifmodule">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfModule [!]<var>module-file</var>|<var>module-identifier</var>> ...
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Module identifiers are available in version 2.1 and
a specific module. The directives within an <code class="directive"><IfModule></code> section are only processed if the <var>test</var>
<p>The <var>test</var> in the <code class="directive"><IfModule></code> section directive can be one of two forms:</p>
dynamically loaded using <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>. The second format reverses the test,
<div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Includes other configuration files from within
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Include [<var>optional</var>|<var>strict</var>] <var>file-path</var>|<var>directory-path</var>|<var>wildcard</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Wildcard matching available in 2.0.41 and later, directory
<code class="program"><a href="/programs/httpd.html">httpd</a></code> to fail. Instead, we encourage you to use the
<p>Or, providing paths relative to your <code class="directive"><a href="#serverroot">ServerRoot</a></code> directory:</p>
<div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables HTTP persistent connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAlive On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>KeepAlive On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
as a single "request" for the <code class="directive"><a href="/mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> directive, regardless
<div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for subsequent
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAliveTimeout <var>num</var>[ms]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Specifying a value in milliseconds is available in
defined virtual host (the default host) in a set of <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> will be used.
<div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a> <a name="limit" id="limit">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict enclosed access controls to only certain HTTP
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Limit <var>method</var> [<var>method</var>] ... > ...
restrictions that are enclosed in the <code class="directive"><Limit></code> bracket <strong>will have no
<div class="warning">A <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section should always be
section when restricting access, since a <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section provides protection
<code class="directive"><Limit></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> directives must
the <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code> directive,
note that the first <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>
<code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code> directives.</div>
<div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a> <a name="limitexcept" id="limitexcept">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access controls to all HTTP methods
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LimitExcept <var>method</var> [<var>method</var>] ... > ...
i.e., it is the opposite of a <code class="directive"><a href="#limit"><Limit></a></code> section and can be used to control
documentation for <code class="directive"><a href="#limit"><Limit></a></code> for more details.</p>
<div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine maximum number of internal redirects and nested
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitInternalRecursion <var>number</var> [<var>number</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.0.47 and later</td></tr>
<p>An internal redirect happens, for example, when using the <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> directive, which internally
For example, <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> uses subrequests to look for the
files listed in the <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
<div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restricts the total size of the HTTP request body sent
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestBody 0</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of HTTP request header fields that
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFields <var>number</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestFields 100</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of the HTTP request header allowed from the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFieldSize <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit the size of the HTTP request line that will be accepted
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of an XML-based request body</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitXMLRequestBody <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="Location" id="Location"><Location></a> <a name="location" id="location">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to matching
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<code></Location></code> directive. <code class="directive"><Location></code> sections are processed in the
order they appear in the configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
<code>.htaccess</code> files are read, and after the <code class="directive"><a href="#files"><Files></a></code> sections.</p>
content that lives in the filesystem, use <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#files"><Files></a></code>. An exception is
or <code>/special/data</code>. The directive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> behaves
identical to the regex version of <code class="directive"><Location></code>, and is preferred, for the
directive and the regex version of <code class="directive"><Location></code> require you to explicitly specify multiple
//abc</code>. The (non-regex) <code class="directive"><Location></code> directive behaves similarly when used for
proxy requests. But when (non-regex) <code class="directive"><Location></code> is used for non-proxy requests it will
<div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a> <a name="locationmatch" id="locationmatch">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to regular-expression
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
it takes a <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular expression</a>
<div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the verbosity of the ErrorLog</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel [<var>module</var>:]<var>level</var>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LogLevel warn</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Per-module and per-directory configuration is available in
messages recorded in the error logs (see <code class="directive"><a href="#errorlog">ErrorLog</a></code> directive). The following
<div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of requests allowed on a persistent
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxKeepAliveRequests <var>number</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="Mutex" id="Mutex">Mutex</a> <a name="mutex" id="mutex">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures mutex mechanism and lock file directory for all
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Mutex <var>mechanism</var> [default|<var>mutex-name</var>] ... [OmitPID]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Mutex default</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.3.4 and later</td></tr>
by <a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a> has a functional or performance
<a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a>. The default locking implementation can
be displayed by running <code class="program"><a href="/programs/httpd.html">httpd</a></code> with the
all CGIs, unless you use something like <code class="program"><a href="/programs/suexec.html">suexec</a></code>
underlying platform and <a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a> support it. Mechanisms
<td><code class="module"><a href="/mod/prefork.html">prefork</a></code> and <code class="module"><a href="/mod/worker.html">worker</a></code> MPMs</td>
<div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Designates an IP address for name-virtual
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NameVirtualHost <var>addr</var>[:<var>port</var>]</code></td></tr>
<div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures what features are available in a particular
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Options All</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
change the pathname used to match against <code class="directive"><a href="#directory"><Directory></a></code> sections.</p>
Server-side includes provided by <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>
<code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> will return a formatted listing
others are ignored; the options are not merged. (See <a href="/sections.html#mergin">how sections are merged</a>.)
<div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the CPU consumption of processes launched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the memory consumption of processes launched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of processes that can be launched by
<tr><th><a href="directive-dict.html#Syntax">Syntax:</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:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
Registry</code> with <code class="directive"><a href="/mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories, because
<div class="directive-section"><h2><a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine if mod_status displays the first 63 characters
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SeeRequestTail On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SeeRequestTail Off</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.2.7 and later.</td></tr>
<p>If Apache httpd is handling <code>GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1</code> mod_status displays as follows:
<div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Email address that the server includes in error
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAdmin <var>email-address</var>|<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate names for a host used when matching requests
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr>
alternate names for a host, for use with <a href="/vhosts/name-based.html">name-based virtual hosts</a>. The
<div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Hostname and port that the server uses to identify
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerName [<var>scheme</var>://]<var>fully-qualified-domain-name</var>[:<var>port</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
identify a virtual host, when using <a href="/vhosts/name-based.html">name-based virtual hosts</a>.</p>
ServerName www.example.com:80
<code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> directives for
settings which determine whether self-referential URLs (e.g., by the
httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Legacy URL pathname for a name-based virtual host that
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr>
<div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server installation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
paths in other configuration directives (such as <code class="directive"><a href="#include">Include</a></code> or <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>, for example) are taken as
<div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the footer on server-generated documents</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerSignature Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
documents (error messages, <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> ftp directory
listings, <code class="module"><a href="/mod/mod_info.html">mod_info</a></code> output, ...). The reason why you
server version number and <code class="directive"><a href="#servername">ServerName</a></code> of the serving virtual host,
"mailto:" reference to the <code class="directive"><a href="#serveradmin">ServerAdmin</a></code> of the referenced
presented are controlled by the <code class="directive"><a href="#servertokens">ServerTokens</a></code> directive.</p>
<div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the <code>Server</code> HTTP response
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerTokens Full</code></td></tr>
information presented by the <code class="directive"><a href="#serversignature">ServerSignature</a></code> directive.</p>
<div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be processed by a
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetHandler <var>handler-name</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Moved into the core in Apache httpd 2.0</td></tr>
<div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process client requests and POST
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process responses from the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TimeOut <var>seconds</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TimeOut 300</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<li>In <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>, the length of time to wait for
<li>In <code class="module"><a href="/mod/mod_ext_filter.html">mod_ext_filter</a></code>, the length of time to
<li>In <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, the default timeout value if
<div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the behaviour on <code>TRACE</code>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TraceEnable on</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 1.3.34, 2.0.55 and later</td></tr>
the core server and <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. The default
<code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> to return a <code>405</code> (Method not
<div class="directive-section"><h2><a name="UnDefine" id="UnDefine">UnDefine</a> <a name="undefine" id="undefine">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Undefine the existence of a variable</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UnDefine <var>parameter-name</var></code></td></tr>
of passing a <code>-D</code> argument to <code class="program"><a href="/programs/httpd.html">httpd</a></code>.</p>
<p>This directive can be used to toggle the use of <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sections without needing to alter
<div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own name and
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>UseCanonicalName Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
for <code>www.domain.com</code> -- see <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">the
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own name and
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a> <a name="virtualhost" id="virtualhost">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only to a specific
specified inside each <code class="directive"><VirtualHost></code> block. If it is absent, the
<p><span>Available Languages: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<p class="apache">Copyright 2010 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</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>