core.html.en revision 8cc194918514dea341631244ef48442b44175bde
530eba85dbd41b8a0fa5255d3648d1440199a661slive<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
e942c741056732f50da2074b36fe59805d370650slive<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd This file is generated from xml source: DO NOT EDIT
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding<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>
083eacf86f9327835b824f9e6be987d56cd96e82slive<p><span>Available Languages: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
083eacf86f9327835b824f9e6be987d56cd96e82slive<a href="/en/mod/core.html" title="English"> en </a> |
083eacf86f9327835b824f9e6be987d56cd96e82slive<a href="/fr/mod/core.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<a href="/ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<a href="/tr/mod/core.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
083eacf86f9327835b824f9e6be987d56cd96e82slive<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Core Apache HTTP Server features that are always
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Core</td></tr></table>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div id="quickview"><h3 class="directives">Directives</h3>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<li><img alt="" src="/images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<li><img alt="" src="/images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#define">Define</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#directory"><Directory></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#fileetag">FileETag</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#files"><Files></a></li>
0625cd06f863f3c751b1e3853851424726c49e0anilgun<li><img alt="" src="/images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#forcetype">ForceType</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
0625cd06f863f3c751b1e3853851424726c49e0anilgun<li><img alt="" src="/images/down.gif" /> <a href="#if"><If></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#include">Include</a></li>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<li><img alt="" src="/images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd<li><img alt="" src="/images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd<li><img alt="" src="/images/down.gif" /> <a href="#limit"><Limit></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
5a72056ec99a47ca99cc57824103472ed7a91792pepper<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar<li><img alt="" src="/images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
3d348301759d78df6958c1d9e600255d139b97abrbowen<li><img alt="" src="/images/down.gif" /> <a href="#location"><Location></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#options">Options</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<li><img alt="" src="/images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<li><img alt="" src="/images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<li><img alt="" src="/images/down.gif" /> <a href="#servername">ServerName</a></li>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<li><img alt="" src="/images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<li><img alt="" src="/images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<li><img alt="" src="/images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<li><img alt="" src="/images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#timeout">TimeOut</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
530eba85dbd41b8a0fa5255d3648d1440199a661slive<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
530eba85dbd41b8a0fa5255d3648d1440199a661slive<div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a></h2>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures optimizations for a Protocol's Listener Sockets</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
530eba85dbd41b8a0fa5255d3648d1440199a661slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.1.5 and later.
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>This directive enables operating system specific optimizations for a
083eacf86f9327835b824f9e6be987d56cd96e82slive listening socket by the Protocol type. The basic premise is for the
530eba85dbd41b8a0fa5255d3648d1440199a661slive kernel to not send a socket to the server process until either data
083eacf86f9327835b824f9e6be987d56cd96e82slive is received or an entire HTTP Request is buffered. Only
083eacf86f9327835b824f9e6be987d56cd96e82slive <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&sektion=9">
530eba85dbd41b8a0fa5255d3648d1440199a661slive FreeBSD's Accept Filters</a>, Linux's more primitive
083eacf86f9327835b824f9e6be987d56cd96e82slive <code>TCP_DEFER_ACCEPT</code>, and Windows' optimized AcceptEx()
083eacf86f9327835b824f9e6be987d56cd96e82slive are currently supported.</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>Using <code>none</code> for an argument will disable any accept filters
083eacf86f9327835b824f9e6be987d56cd96e82slive for that protocol. This is useful for protocols that require a server
530eba85dbd41b8a0fa5255d3648d1440199a661slive send data first, such as <code>ftp:</code> or <code>nntp</code>:</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <div class="example"><p><code>AcceptFilter nntp none</code></p></div>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd AcceptFilter http httpready <br />
083eacf86f9327835b824f9e6be987d56cd96e82slive AcceptFilter https dataready
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>The <code>httpready</code> accept filter buffers entire HTTP requests at
439ebfd112c7216b5dbab8161a04fcf78a882e57nd the kernel level. Once an entire request is received, the kernel then
083eacf86f9327835b824f9e6be987d56cd96e82slive sends it to the server. See the
083eacf86f9327835b824f9e6be987d56cd96e82slive <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&sektion=9">
439ebfd112c7216b5dbab8161a04fcf78a882e57nd accf_http(9)</a> man page for more details. Since HTTPS requests are
439ebfd112c7216b5dbab8161a04fcf78a882e57nd encrypted only the <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&sektion=9">
083eacf86f9327835b824f9e6be987d56cd96e82slive AcceptFilter http data <br />
083eacf86f9327835b824f9e6be987d56cd96e82slive AcceptFilter https data
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>Linux's <code>TCP_DEFER_ACCEPT</code> does not support buffering http
439ebfd112c7216b5dbab8161a04fcf78a882e57nd requests. Any value besides <code>none</code> will enable
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code>TCP_DEFER_ACCEPT</code> on that listener. For more details
439ebfd112c7216b5dbab8161a04fcf78a882e57nd see the Linux
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html">
439ebfd112c7216b5dbab8161a04fcf78a882e57nd AcceptFilter http data <br />
439ebfd112c7216b5dbab8161a04fcf78a882e57nd AcceptFilter https data
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>Window's mpm_winnt interprets the AcceptFilter to toggle the AcceptEx()
439ebfd112c7216b5dbab8161a04fcf78a882e57nd API, and does not support http protocol buffering. There are two values
439ebfd112c7216b5dbab8161a04fcf78a882e57nd which utilize the Windows AcceptEx() API and will recycle network
439ebfd112c7216b5dbab8161a04fcf78a882e57nd sockets between connections. <code>data</code> waits until data has
439ebfd112c7216b5dbab8161a04fcf78a882e57nd been transmitted as documented above, and the initial data buffer and
439ebfd112c7216b5dbab8161a04fcf78a882e57nd network endpoint addresses are all retrieved from the single AcceptEx()
439ebfd112c7216b5dbab8161a04fcf78a882e57nd invocation. <code>connect</code> will use the AcceptEx() API, also
439ebfd112c7216b5dbab8161a04fcf78a882e57nd retrieve the network endpoint addresses, but like <code>none</code>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd the <code>connect</code> option does not wait for the initial data
439ebfd112c7216b5dbab8161a04fcf78a882e57nd transmission.</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>On Windows, <code>none</code> uses accept() rather than than AcceptEx()
439ebfd112c7216b5dbab8161a04fcf78a882e57nd and will not recycle sockets between connections. This is useful for
439ebfd112c7216b5dbab8161a04fcf78a882e57nd network adapters with broken driver support, as well as some virtual
439ebfd112c7216b5dbab8161a04fcf78a882e57nd network providers such as vpn drivers, or spam, virus or spyware
439ebfd112c7216b5dbab8161a04fcf78a882e57nd filters.</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a></h2>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Resources accept trailing pathname information</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.30 and later</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>This directive controls whether requests that contain trailing
083eacf86f9327835b824f9e6be987d56cd96e82slive pathname information that follows an actual filename (or
083eacf86f9327835b824f9e6be987d56cd96e82slive non-existent file in an existing directory) will be accepted or
083eacf86f9327835b824f9e6be987d56cd96e82slive rejected. The trailing pathname information can be made
083eacf86f9327835b824f9e6be987d56cd96e82slive available to scripts in the <code>PATH_INFO</code> environment
083eacf86f9327835b824f9e6be987d56cd96e82slive variable.</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>For example, assume the location <code>/test/</code> points to
083eacf86f9327835b824f9e6be987d56cd96e82slive a directory that contains only the single file
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>The three possible arguments for the
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <code class="directive">AcceptPathInfo</code> directive are:</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <dt><code>Off</code></dt><dd>A request will only be accepted if it
083eacf86f9327835b824f9e6be987d56cd96e82slive maps to a literal path that exists. Therefore a request with
083eacf86f9327835b824f9e6be987d56cd96e82slive trailing pathname information after the true filename such as
083eacf86f9327835b824f9e6be987d56cd96e82slive <code>/test/here.html/more</code> in the above example will return
083eacf86f9327835b824f9e6be987d56cd96e82slive a 404 NOT FOUND error.</dd>
083eacf86f9327835b824f9e6be987d56cd96e82slive <dt><code>On</code></dt><dd>A request will be accepted if a
083eacf86f9327835b824f9e6be987d56cd96e82slive leading path component maps to a file that exists. The above
439ebfd112c7216b5dbab8161a04fcf78a882e57nd example <code>/test/here.html/more</code> will be accepted if
083eacf86f9327835b824f9e6be987d56cd96e82slive <dt><code>Default</code></dt><dd>The treatment of requests with
083eacf86f9327835b824f9e6be987d56cd96e82slive trailing pathname information is determined by the <a href="/handler.html">handler</a> responsible for the request.
083eacf86f9327835b824f9e6be987d56cd96e82slive The core handler for normal files defaults to rejecting
083eacf86f9327835b824f9e6be987d56cd96e82slive <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
98dd94f575d903951ad09b81f8f6d529e4770f94nd <p>The primary purpose of the <code>AcceptPathInfo</code>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd directive is to allow you to override the handler's choice of
439ebfd112c7216b5dbab8161a04fcf78a882e57nd accepting or rejecting <code>PATH_INFO</code>. This override is required,
9f57d601ce42feab067a08a9827da30d39c1fd41nd for example, when you use a <a href="/filter.html">filter</a>, such
9f57d601ce42feab067a08a9827da30d39c1fd41nd as <a href="mod_include.html">INCLUDES</a>, to generate content
9f57d601ce42feab067a08a9827da30d39c1fd41nd based on <code>PATH_INFO</code>. The core handler would usually reject
083eacf86f9327835b824f9e6be987d56cd96e82slive the request, so you can use the following configuration to enable
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh such a script:</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive Options +Includes<br />
083eacf86f9327835b824f9e6be987d56cd96e82slive SetOutputFilter INCLUDES<br />
083eacf86f9327835b824f9e6be987d56cd96e82slive AcceptPathInfo On<br />
083eacf86f9327835b824f9e6be987d56cd96e82slive </Files>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a></h2>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the distributed configuration file</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
9f57d601ce42feab067a08a9827da30d39c1fd41nd <p>While processing a request the server looks for
9f57d601ce42feab067a08a9827da30d39c1fd41nd the first existing configuration file from this list of names in
083eacf86f9327835b824f9e6be987d56cd96e82slive every directory of the path to the document, if distributed
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh configuration files are <a href="#allowoverride">enabled for that
083eacf86f9327835b824f9e6be987d56cd96e82slive AccessFileName .acl
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>before returning the document
41821e8b989f24bed173216698f0c0c597f81afeyoshiki <code>/usr/local/web/index.html</code>, the server will read
083eacf86f9327835b824f9e6be987d56cd96e82slive <code>/usr/local/.acl</code> and <code>/usr/local/web/.acl</code>
083eacf86f9327835b824f9e6be987d56cd96e82slive for directives, unless they have been disabled with</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <Directory /><br />
083eacf86f9327835b824f9e6be987d56cd96e82slive AllowOverride None<br />
439ebfd112c7216b5dbab8161a04fcf78a882e57nd </Directory>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<li><a href="/configuring.html">Configuration Files</a></li>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a></h2>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default charset parameter to be added when a response
439ebfd112c7216b5dbab8161a04fcf78a882e57ndcontent-type is <code>text/plain</code> or <code>text/html</code></td></tr>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
751d950b189a39828f91fc0eefff4340f82d4010rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
751d950b189a39828f91fc0eefff4340f82d4010rbowen <p>This directive specifies a default value for the media type
751d950b189a39828f91fc0eefff4340f82d4010rbowen charset parameter (the name of a character encoding) to be added
751d950b189a39828f91fc0eefff4340f82d4010rbowen to a response if and only if the response's content-type is either
751d950b189a39828f91fc0eefff4340f82d4010rbowen <code>text/plain</code> or <code>text/html</code>. This should override
751d950b189a39828f91fc0eefff4340f82d4010rbowen any charset specified in the body of the response via a <code>META</code>
751d950b189a39828f91fc0eefff4340f82d4010rbowen element, though the exact behavior is often dependent on the user's client
751d950b189a39828f91fc0eefff4340f82d4010rbowen configuration. A setting of <code>AddDefaultCharset Off</code>
98dd94f575d903951ad09b81f8f6d529e4770f94nd disables this functionality. <code>AddDefaultCharset On</code> enables
439ebfd112c7216b5dbab8161a04fcf78a882e57nd a default charset of <code>iso-8859-1</code>. Any other value is assumed
439ebfd112c7216b5dbab8161a04fcf78a882e57nd to be the <var>charset</var> to be used, which should be one of the
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <a href="http://www.iana.org/assignments/character-sets">IANA registered
439ebfd112c7216b5dbab8161a04fcf78a882e57nd charset values</a> for use in Internet media types (MIME types).
439ebfd112c7216b5dbab8161a04fcf78a882e57nd For example:</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd AddDefaultCharset utf-8
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p><code class="directive">AddDefaultCharset</code> should only be used when all
0fdabb7c68f90ef30772c791d2f97ad9c8bb4701covener of the text resources to which it applies are known to be in that
0fdabb7c68f90ef30772c791d2f97ad9c8bb4701covener character encoding and it is too inconvenient to label their charset
0fdabb7c68f90ef30772c791d2f97ad9c8bb4701covener individually. One such example is to add the charset parameter
0fdabb7c68f90ef30772c791d2f97ad9c8bb4701covener to resources containing generated content, such as legacy CGI
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar scripts, that might be vulnerable to cross-site scripting attacks
0fdabb7c68f90ef30772c791d2f97ad9c8bb4701covener due to user-provided data being included in the output. Note, however,
0fdabb7c68f90ef30772c791d2f97ad9c8bb4701covener that a better solution is to just fix (or delete) those scripts, since
0fdabb7c68f90ef30772c791d2f97ad9c8bb4701covener setting a default charset does not protect users that have enabled
083eacf86f9327835b824f9e6be987d56cd96e82slive the "auto-detect character encoding" feature on their browser.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><code class="directive"><a href="/mod/mod_mime.html#addcharset">AddCharset</a></code></li>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directive</a></h2>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>assigns an output filter to a particular media-type</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilterByType <var>filter</var>[;<var>filter</var>...]
083eacf86f9327835b824f9e6be987d56cd96e82slive<var>media-type</var> [<var>media-type</var>] ...</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d0030b59f0da82db9a98be85f3946c4abe69d81rbowen<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.33 and later; deprecated in Apache 2.1 and later</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>This directive activates a particular output <a href="/filter.html">filter</a> for a request depending on the
439ebfd112c7216b5dbab8161a04fcf78a882e57nd response <a class="glossarylink" href="/glossary.html#media-type" title="see glossary">media-type</a>. Because of certain
439ebfd112c7216b5dbab8161a04fcf78a882e57nd problems discussed below, this directive is deprecated. The same
439ebfd112c7216b5dbab8161a04fcf78a882e57nd functionality is available using <code class="module"><a href="/mod/mod_filter.html">mod_filter</a></code>.</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>The following example uses the <code>DEFLATE</code> filter, which
439ebfd112c7216b5dbab8161a04fcf78a882e57nd is provided by <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code>. It will compress all
c5985d98499b4e398e8b666ecc570569c4f28173rbowen output (either static or dynamic) which is labeled as
c5985d98499b4e398e8b666ecc570569c4f28173rbowen <code>text/html</code> or <code>text/plain</code> before it is sent
c5985d98499b4e398e8b666ecc570569c4f28173rbowen to the client.</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh AddOutputFilterByType DEFLATE text/html text/plain
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>If you want the content to be processed by more than one filter, their
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh names have to be separated by semicolons. It's also possible to use one
0625cd06f863f3c751b1e3853851424726c49e0anilgun <code class="directive">AddOutputFilterByType</code> directive for each of
083eacf86f9327835b824f9e6be987d56cd96e82slive these filters.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>The configuration below causes all script output labeled as
083eacf86f9327835b824f9e6be987d56cd96e82slive <code>text/html</code> to be processed at first by the
083eacf86f9327835b824f9e6be987d56cd96e82slive <code>INCLUDES</code> filter and then by the <code>DEFLATE</code>
083eacf86f9327835b824f9e6be987d56cd96e82slive filter.</p>
0625cd06f863f3c751b1e3853851424726c49e0anilgun <Location /cgi-bin/><br />
6ff644bec71595a66d3515894b4ccfef25e492bfnd Options Includes<br />
083eacf86f9327835b824f9e6be987d56cd96e82slive </Location>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>Enabling filters with <code class="directive">AddOutputFilterByType</code>
083eacf86f9327835b824f9e6be987d56cd96e82slive may fail partially or completely in some cases. For example, no
98dd94f575d903951ad09b81f8f6d529e4770f94nd filters are applied if the <a class="glossarylink" href="/glossary.html#media-type" title="see glossary">media-type</a> could not
439ebfd112c7216b5dbab8161a04fcf78a882e57nd be determined. If you want to make sure that the filters will be
2d0030b59f0da82db9a98be85f3946c4abe69d81rbowen applied, assign the content type to a resource explicitly; for
439ebfd112c7216b5dbab8161a04fcf78a882e57nd example, with <code class="directive"><a href="/mod/mod_mime.html#addtype">AddType</a></code> or
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="directive"><a href="#forcetype">ForceType</a></code>. Setting the
083eacf86f9327835b824f9e6be987d56cd96e82slive content type within a (non-nph) CGI script is also safe.</p>
cfbc6b1bf12004f1b8c2f0fc016b1ec05630dc8brbowen<li><code class="directive"><a href="/mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a></h2>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether encoded path separators in URLs are allowed to
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.46 and later</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>The <code class="directive">AllowEncodedSlashes</code> directive allows URLs
439ebfd112c7216b5dbab8161a04fcf78a882e57nd which contain encoded path separators (<code>%2F</code> for <code>/</code>
98dd94f575d903951ad09b81f8f6d529e4770f94nd and additionally <code>%5C</code> for <code>\</code> on according systems)
439ebfd112c7216b5dbab8161a04fcf78a882e57nd to be used. Normally such URLs are refused with a 404 (Not found) error.</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>Turning <code class="directive">AllowEncodedSlashes</code> <code>On</code> is
439ebfd112c7216b5dbab8161a04fcf78a882e57nd mostly useful when used in conjunction with <code>PATH_INFO</code>.</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>Allowing encoded slashes does <em>not</em> imply <em>decoding</em>.
439ebfd112c7216b5dbab8161a04fcf78a882e57nd Occurrences of <code>%2F</code> or <code>%5C</code> (<em>only</em> on
083eacf86f9327835b824f9e6be987d56cd96e82slive according systems) will be left as such in the otherwise decoded URL
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a></h2>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types of directives that are allowed in
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>directive-type</var>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowOverride All</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d0030b59f0da82db9a98be85f3946c4abe69d81rbowen <p>When the server finds an <code>.htaccess</code> file (as
2d0030b59f0da82db9a98be85f3946c4abe69d81rbowen specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>)
439ebfd112c7216b5dbab8161a04fcf78a882e57nd it needs to know which directives declared in that file can override
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh earlier configuration directives.</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <div class="note"><h3>Only available in <Directory> sections</h3>
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="directive">AllowOverride</code> is valid only in
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="directive"><a href="#directory"><Directory></a></code>
083eacf86f9327835b824f9e6be987d56cd96e82slive 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
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="directive"><a href="#files"><Files></a></code> sections.
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>When this directive is set to <code>None</code>, then
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <a href="#accessfilename">.htaccess</a> files are completely ignored.
083eacf86f9327835b824f9e6be987d56cd96e82slive In this case, the server will not even attempt to read
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>When this directive is set to <code>All</code>, then any
083eacf86f9327835b824f9e6be987d56cd96e82slive directive which has the .htaccess <a href="directive-dict.html#Context">Context</a> is allowed in
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>The <var>directive-type</var> can be one of the following
439ebfd112c7216b5dbab8161a04fcf78a882e57nd groupings of directives.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive Allow use of the authorization directives (<code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="directive"><a href="/mod/mod_authn_core.html#authname">AuthName</a></code>,
37f0d5a24f4107130805cbe65cb798ce3946df7brbowen <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>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh Allow use of the directives controlling document types
0625cd06f863f3c751b1e3853851424726c49e0anilgun (<code class="directive"><a href="#errordocument">ErrorDocument</a></code>,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="directive"><a href="#forcetype">ForceType</a></code>,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="directive"><a href="/mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="directive"><a href="#sethandler">SetHandler</a></code>,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>,
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, and
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> Add* and Remove* directives),
439ebfd112c7216b5dbab8161a04fcf78a882e57nd 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>),
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <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
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> from
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <code class="module"><a href="/mod/mod_actions.html">mod_actions</a></code>.
9f57d601ce42feab067a08a9827da30d39c1fd41nd Allow use of the directives controlling directory indexing
9f57d601ce42feab067a08a9827da30d39c1fd41nd (<code class="directive"><a href="/mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
9f57d601ce42feab067a08a9827da30d39c1fd41nd <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>,
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="directive"><a href="/mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <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>,
083eacf86f9327835b824f9e6be987d56cd96e82slive 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>
083eacf86f9327835b824f9e6be987d56cd96e82slive Allow use of the directives controlling specific directory
083eacf86f9327835b824f9e6be987d56cd96e82slive features (<code class="directive"><a href="#options">Options</a></code> and
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="directive"><a href="/mod/mod_include.html#xbithack">XBitHack</a></code>).
083eacf86f9327835b824f9e6be987d56cd96e82slive An equal sign may be given followed by a comma (but no spaces)
0625cd06f863f3c751b1e3853851424726c49e0anilgun separated lists of options that may be set using the <code class="directive"><a href="#options">Options</a></code> command.</dd>
083eacf86f9327835b824f9e6be987d56cd96e82slive AllowOverride AuthConfig Indexes
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>In the example above all directives that are neither in the group
083eacf86f9327835b824f9e6be987d56cd96e82slive <code>AuthConfig</code> nor <code>Indexes</code> cause an internal
439ebfd112c7216b5dbab8161a04fcf78a882e57nd server error.</p>
2972c7cfbfad14dec221c6dd11c784f64f6eea26slive <div class="note"><p>For security and performance reasons, do not set
8dfd093f5df2436bd7a9f738832667f889e6d3b2jailletc <code>AllowOverride</code> to anything other than <code>None</code>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd in your <code><Directory /></code> block. Instead, find (or
439ebfd112c7216b5dbab8161a04fcf78a882e57nd create) the <code><Directory></code> block that refers to the
083eacf86f9327835b824f9e6be987d56cd96e82slive directory where you're actually planning to place a
c49c842267a87cac2bfaa124167d72cd14620729covener<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
c49c842267a87cac2bfaa124167d72cd14620729covener<li><a href="/configuring.html">Configuration Files</a></li>
c49c842267a87cac2bfaa124167d72cd14620729covener<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a></h2>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIMapExtension <var>cgi-path</var> <var>.extension</var></code></td></tr>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>NetWare only</td></tr>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener <p>This directive is used to control how Apache finds the
a38c7ee7f80149f0e0ee064f252e8efbaf3582b9nd interpreter used to run CGI scripts. For example, setting
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener cause all CGI script files with a <code>.foo</code> extension to
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener be passed to the FOO interpreter.</p>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<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>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim <p>This directive enables the generation of
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener <code>Content-MD5</code> headers as defined in RFC1864
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener respectively RFC2616.</p>
9e7c7a8fa19c33d1e90f8f7ffab69beacbe72566covener <p>MD5 is an algorithm for computing a "message digest"
083eacf86f9327835b824f9e6be987d56cd96e82slive (sometimes called "fingerprint") of arbitrary-length data, with
083eacf86f9327835b824f9e6be987d56cd96e82slive a high degree of confidence that any alterations in the data
0625cd06f863f3c751b1e3853851424726c49e0anilgun will be reflected in alterations in the message digest.</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>The <code>Content-MD5</code> header provides an end-to-end
439ebfd112c7216b5dbab8161a04fcf78a882e57nd message integrity check (MIC) of the entity-body. A proxy or
82361795d39893e6627e006b41ab5caa5c522d3frbowen client may check this header for detecting accidental
083eacf86f9327835b824f9e6be987d56cd96e82slive modification of the entity-body in transit. Example header:</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>Note that this can cause performance problems on your server
439ebfd112c7216b5dbab8161a04fcf78a882e57nd since the message digest is computed on every request (the
083eacf86f9327835b824f9e6be987d56cd96e82slive values are not cached).</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p><code>Content-MD5</code> is only sent for documents served
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen by the <code class="module"><a href="/mod/core.html">core</a></code>, and not by any module. For example,
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen SSI documents, output from CGI scripts, and byte range responses
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen do not have this header.</p>
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen<div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a></h2>
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>This directive has no effect other than to emit warnings
020366f830905b6b5dfccfa03373379ae6a13e7blgentisif the value is not <code>none</code>. In prior versions, DefaultType
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowenwould specify a default media type to assign to response content for
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowenwhich no other media type configuration could be found.
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>media-type|none</var></code></td></tr>
3a0ea65fa7273630004ec61af9eb036c64738380jim<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DefaultType none</code></td></tr>
3a0ea65fa7273630004ec61af9eb036c64738380jim<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
aa0c9ba3adef6e0e98c6f38d2bf690283b609aacrbowen<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
3a0ea65fa7273630004ec61af9eb036c64738380jim<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3a0ea65fa7273630004ec61af9eb036c64738380jim<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3a0ea65fa7273630004ec61af9eb036c64738380jim<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>The argument <code>none</code> is available in Apache 2.2.7 and later. All other choices are DISABLED for 2.3.x and later.</td></tr>
a492af8c8261d9c85cec48a2bd6cd42f488a0028poirier <p>This directive has been disabled. For backwards compatibility
a492af8c8261d9c85cec48a2bd6cd42f488a0028poirier of configuration files, it may be specified with the value
a492af8c8261d9c85cec48a2bd6cd42f488a0028poirier <code>none</code>, meaning no default media type. For example:</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh DefaultType None
0625cd06f863f3c751b1e3853851424726c49e0anilgun httpd-2.2.7 and later.</p>
61d29dac384de8b27485e54e53f1386549c578e1rbowen <code class="directive"><a href="/mod/mod_mime.html#addtype">AddType</a></code> to configure media
083eacf86f9327835b824f9e6be987d56cd96e82slive type assignments via file extensions, or the
083eacf86f9327835b824f9e6be987d56cd96e82slive <code class="directive"><a href="#forcetype">ForceType</a></code> directive to configure
083eacf86f9327835b824f9e6be987d56cd96e82slive the media type for specific resources. Otherwise, the server will
083eacf86f9327835b824f9e6be987d56cd96e82slive send the response without a Content-Type header field and the
083eacf86f9327835b824f9e6be987d56cd96e82slive recipient may attempt to guess the media type.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a></h2>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the existence of a variable</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Define <var>parameter-name</var></code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
10972f918d8060e3c6a90400a1d5befcea34368crbowen<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>Equivalent to passing the <code>-D</code> argument to <code class="program"><a href="/programs/httpd.html">httpd</a></code>.</p>
530eba85dbd41b8a0fa5255d3648d1440199a661slive <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
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">Directive</a></h2>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that apply only to the
61d29dac384de8b27485e54e53f1386549c578e1rbowennamed file-system directory and sub-directories</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Directory <var>directory-path</var>>
530eba85dbd41b8a0fa5255d3648d1440199a661slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p><code class="directive"><Directory></code> and
083eacf86f9327835b824f9e6be987d56cd96e82slive <code></Directory></code> are used to enclose a group of
083eacf86f9327835b824f9e6be987d56cd96e82slive directives that will apply only to the named directory and
083eacf86f9327835b824f9e6be987d56cd96e82slive sub-directories of that directory. Any directive that is allowed
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar in a directory context may be used. <var>Directory-path</var> is
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar either the full path to a directory, or a wild-card string using
10972f918d8060e3c6a90400a1d5befcea34368crbowen Unix shell-style matching. In a wild-card string, <code>?</code> matches
10972f918d8060e3c6a90400a1d5befcea34368crbowen any single character, and <code>*</code> matches any sequences of
10972f918d8060e3c6a90400a1d5befcea34368crbowen characters. You may also use <code>[]</code> character ranges. None
083eacf86f9327835b824f9e6be987d56cd96e82slive of the wildcards match a `/' character, so <code><Directory
98dd94f575d903951ad09b81f8f6d529e4770f94nd /*/public_html></code> will not match
61d29dac384de8b27485e54e53f1386549c578e1rbowen <code>/home/user/public_html</code>, but <code><Directory
083eacf86f9327835b824f9e6be987d56cd96e82slive /home/*/public_html></code> will match. Example:</p>
5ffbccf9c29985c1f9d249d1c1f658f661df752bsf Options Indexes FollowSymLinks<br />
98dd94f575d903951ad09b81f8f6d529e4770f94nd </Directory>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>Be careful with the <var>directory-path</var> arguments:
083eacf86f9327835b824f9e6be987d56cd96e82slive They have to literally match the filesystem path which Apache uses
98dd94f575d903951ad09b81f8f6d529e4770f94nd to access the files. Directives applied to a particular
98dd94f575d903951ad09b81f8f6d529e4770f94nd <code><Directory></code> will not apply to files accessed from
439ebfd112c7216b5dbab8161a04fcf78a882e57nd that same directory via a different path, such as via different symbolic
0625cd06f863f3c751b1e3853851424726c49e0anilgun <p><a class="glossarylink" href="/glossary.html#regex" title="see glossary">Regular
0625cd06f863f3c751b1e3853851424726c49e0anilgun expressions</a> can also be used, with the addition of the
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar <Directory ~ "^/www/.*/[0-9]{3}">
10972f918d8060e3c6a90400a1d5befcea34368crbowen <p>would match directories in <code>/www/</code> that consisted of
10972f918d8060e3c6a90400a1d5befcea34368crbowen three numbers.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>If multiple (non-regular expression) <code class="directive"><Directory></code> sections
98dd94f575d903951ad09b81f8f6d529e4770f94nd match the directory (or one of its parents) containing a document,
98dd94f575d903951ad09b81f8f6d529e4770f94nd then the directives are applied in the order of shortest match
439ebfd112c7216b5dbab8161a04fcf78a882e57nd first, interspersed with the directives from the <a href="#accessfilename">.htaccess</a> files. For example,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <Directory /><br />
083eacf86f9327835b824f9e6be987d56cd96e82slive AllowOverride None<br />
aa0c9ba3adef6e0e98c6f38d2bf690283b609aacrbowen </Directory><br />
083eacf86f9327835b824f9e6be987d56cd96e82slive <Directory /home/><br />
98dd94f575d903951ad09b81f8f6d529e4770f94nd AllowOverride FileInfo<br />
0625cd06f863f3c751b1e3853851424726c49e0anilgun </Directory>
0625cd06f863f3c751b1e3853851424726c49e0anilgun <p>for access to the document <code>/home/web/dir/doc.html</code>
0625cd06f863f3c751b1e3853851424726c49e0anilgun the steps are:</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <li>Apply directive <code>AllowOverride FileInfo</code> (for
98dd94f575d903951ad09b81f8f6d529e4770f94nd <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> and
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>Regular expressions are not considered until after all of the
439ebfd112c7216b5dbab8161a04fcf78a882e57nd normal sections have been applied. Then all of the regular
083eacf86f9327835b824f9e6be987d56cd96e82slive expressions are tested in the order they appeared in the
439ebfd112c7216b5dbab8161a04fcf78a882e57nd configuration file. For example, with</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <Directory ~ abc$><br />
439ebfd112c7216b5dbab8161a04fcf78a882e57nd # ... directives here ...<br />
439ebfd112c7216b5dbab8161a04fcf78a882e57nd </Directory>
98dd94f575d903951ad09b81f8f6d529e4770f94nd <p>the regular expression section won't be considered until after
98dd94f575d903951ad09b81f8f6d529e4770f94nd all normal <code class="directive"><Directory></code>s and
083eacf86f9327835b824f9e6be987d56cd96e82slive <code>.htaccess</code> files have been applied. Then the regular
439ebfd112c7216b5dbab8161a04fcf78a882e57nd expression will match on <code>/home/abc/public_html/abc</code> and
083eacf86f9327835b824f9e6be987d56cd96e82slive the corresponding <code class="directive"><Directory></code> will
439ebfd112c7216b5dbab8161a04fcf78a882e57nd be applied.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <code><Directory /></code> is <code>Allow from All</code>.
752ec04fdfa6e936047811b9e506cf829d7a69f7pquerna This means that Apache will serve any file mapped from an URL. It is
752ec04fdfa6e936047811b9e506cf829d7a69f7pquerna recommended that you change this with a block such
0625cd06f863f3c751b1e3853851424726c49e0anilgun <Directory /><br />
98dd94f575d903951ad09b81f8f6d529e4770f94nd Order Deny,Allow<br />
98dd94f575d903951ad09b81f8f6d529e4770f94nd Deny from All<br />
083eacf86f9327835b824f9e6be987d56cd96e82slive </Directory>
083eacf86f9327835b824f9e6be987d56cd96e82slive <em>want</em> accessible. See the <a href="/misc/security_tips.html">Security Tips</a> page for more
0625cd06f863f3c751b1e3853851424726c49e0anilgun <p>The directory sections occur in the <code>httpd.conf</code> file.
61d29dac384de8b27485e54e53f1386549c578e1rbowen <code class="directive"><Directory></code> directives
083eacf86f9327835b824f9e6be987d56cd96e82slive 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>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <Location> and <Files> sections work</a> for an
083eacf86f9327835b824f9e6be987d56cd96e82slive explanation of how these different sections are combined when a
083eacf86f9327835b824f9e6be987d56cd96e82slive request is received</li>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">Directive</a></h2>
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose directives that apply to
10972f918d8060e3c6a90400a1d5befcea34368crbowenfile-system directories matching a regular expression and their
10972f918d8060e3c6a90400a1d5befcea34368crbowen<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><DirectoryMatch <var>regex</var>>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p><code class="directive"><DirectoryMatch></code> and
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code></DirectoryMatch></code> are used to enclose a group
083eacf86f9327835b824f9e6be987d56cd96e82slive of directives which will apply only to the named directory and
083eacf86f9327835b824f9e6be987d56cd96e82slive sub-directories of that directory, the same as <code class="directive"><a href="#directory"><Directory></a></code>. However, it
439ebfd112c7216b5dbab8161a04fcf78a882e57nd takes as an argument a <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <DirectoryMatch "^/www/(.+/)?[0-9]{3}">
4c21c56ab34e9e74961a78539ce4760a5f0384cfrbowen <p>would match directories in <code>/www/</code> that consisted of three
4c21c56ab34e9e74961a78539ce4760a5f0384cfrbowen numbers.</p>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<li><code class="directive"><a href="#directory"><Directory></a></code> for
61d29dac384de8b27485e54e53f1386549c578e1rbowena description of how regular expressions are mixed in with normal
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<li><a href="/sections.html">How <Directory>, <Location> and
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<Files> sections work</a> for an explanation of how these different
439ebfd112c7216b5dbab8161a04fcf78a882e57ndsections are combined when a request is received</li>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
083eacf86f9327835b824f9e6be987d56cd96e82slive<div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a></h2>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory that forms the main document tree visible
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
10972f918d8060e3c6a90400a1d5befcea34368crbowen<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
10972f918d8060e3c6a90400a1d5befcea34368crbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
10972f918d8060e3c6a90400a1d5befcea34368crbowen <p>This directive sets the directory from which <code class="program"><a href="/programs/httpd.html">httpd</a></code>
10972f918d8060e3c6a90400a1d5befcea34368crbowen 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
083eacf86f9327835b824f9e6be987d56cd96e82slive path from the requested URL to the document root to make the
98dd94f575d903951ad09b81f8f6d529e4770f94nd path to the document. Example:</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>then an access to
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code>/usr/web/index.html</code>. If the <var>directory-path</var> is
10972f918d8060e3c6a90400a1d5befcea34368crbowen not absolute then it is assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
10972f918d8060e3c6a90400a1d5befcea34368crbowen <p>The <code class="directive">DocumentRoot</code> should be specified without
10972f918d8060e3c6a90400a1d5befcea34368crbowen a trailing slash.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><a href="/urlmapping.html#documentroot">Mapping URLs to Filesystem
10972f918d8060e3c6a90400a1d5befcea34368crbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar<div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a></h2>
10972f918d8060e3c6a90400a1d5befcea34368crbowen<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use memory-mapping to read files during delivery</td></tr>
10972f918d8060e3c6a90400a1d5befcea34368crbowen<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
10972f918d8060e3c6a90400a1d5befcea34368crbowen<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableMMAP On</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
98dd94f575d903951ad09b81f8f6d529e4770f94nd<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
61d29dac384de8b27485e54e53f1386549c578e1rbowen<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
0625cd06f863f3c751b1e3853851424726c49e0anilgun <p>This directive controls whether the <code class="program"><a href="/programs/httpd.html">httpd</a></code> may use
0625cd06f863f3c751b1e3853851424726c49e0anilgun memory-mapping if it needs to read the contents of a file during
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh delivery. By default, when the handling of a request requires
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh access to the data within a file -- for example, when delivering a
083eacf86f9327835b824f9e6be987d56cd96e82slive server-parsed file using <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> -- Apache
439ebfd112c7216b5dbab8161a04fcf78a882e57nd memory-maps the file if the OS supports it.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>This memory-mapping sometimes yields a performance improvement.
083eacf86f9327835b824f9e6be987d56cd96e82slive But in some environments, it is better to disable the memory-mapping
083eacf86f9327835b824f9e6be987d56cd96e82slive to prevent operational problems:</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <li>On some multiprocessor systems, memory-mapping can reduce the
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen performance of the <code class="program"><a href="/programs/httpd.html">httpd</a></code>.</li>
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen <li>Deleting or truncating a file while <code class="program"><a href="/programs/httpd.html">httpd</a></code>
aa0c9ba3adef6e0e98c6f38d2bf690283b609aacrbowen has it memory-mapped can cause <code class="program"><a href="/programs/httpd.html">httpd</a></code> to
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen crash with a segmentation fault.
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen <p>For server configurations that are vulnerable to these problems,
15a94ca0ea54ceb8979eead34bde3bc9410a03farbowen you should disable memory-mapping of delivered files by specifying:</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh EnableMMAP Off
98dd94f575d903951ad09b81f8f6d529e4770f94nd <p>For NFS mounted files, this feature may be disabled explicitly for
98dd94f575d903951ad09b81f8f6d529e4770f94nd the offending files by specifying:</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <Directory "/path-to-nfs-files">
439ebfd112c7216b5dbab8161a04fcf78a882e57nd EnableMMAP Off
439ebfd112c7216b5dbab8161a04fcf78a882e57nd </Directory>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a></h2>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<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>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableSendfile On</code></td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
083eacf86f9327835b824f9e6be987d56cd96e82slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in version 2.0.44 and later</td></tr>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>This directive controls whether <code class="program"><a href="/programs/httpd.html">httpd</a></code> may use the
439ebfd112c7216b5dbab8161a04fcf78a882e57nd sendfile support from the kernel to transmit file contents to the client.
439ebfd112c7216b5dbab8161a04fcf78a882e57nd By default, when the handling of a request requires no access
083eacf86f9327835b824f9e6be987d56cd96e82slive to the data within a file -- for example, when delivering a
4dd6ef6e77f6c1a873769eb851a535c312219c34nd static file -- Apache uses sendfile to deliver the file contents
4dd6ef6e77f6c1a873769eb851a535c312219c34nd without ever reading the file if the OS supports it.</p>
aa0c9ba3adef6e0e98c6f38d2bf690283b609aacrbowen <p>This sendfile mechanism avoids separate read and send operations,
4dd6ef6e77f6c1a873769eb851a535c312219c34nd and buffer allocations. But on some platforms or within some
4dd6ef6e77f6c1a873769eb851a535c312219c34nd filesystems, it is better to disable this feature to avoid
10972f918d8060e3c6a90400a1d5befcea34368crbowen operational problems:</p>
10972f918d8060e3c6a90400a1d5befcea34368crbowen <li>Some platforms may have broken sendfile support that the build
10972f918d8060e3c6a90400a1d5befcea34368crbowen system did not detect, especially if the binaries were built on
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen another box and moved to such a machine with broken sendfile
083eacf86f9327835b824f9e6be987d56cd96e82slive support.</li>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <li>On Linux the use of sendfile triggers TCP-checksum
10972f918d8060e3c6a90400a1d5befcea34368crbowen offloading bugs on certain networking cards when using IPv6.</li>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <li>On Linux on Itanium, sendfile may be unable to handle files
0625cd06f863f3c751b1e3853851424726c49e0anilgun over 2GB in size.</li>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <li>With a network-mounted <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (e.g., NFS or SMB),
439ebfd112c7216b5dbab8161a04fcf78a882e57nd the kernel may be unable to serve the network file through
439ebfd112c7216b5dbab8161a04fcf78a882e57nd its own cache.</li>
d88842a4a8ab8ea4580c32da7a962e6e4cf4d9farbowen <p>For server configurations that are vulnerable to these problems,
439ebfd112c7216b5dbab8161a04fcf78a882e57nd you should disable this feature by specifying:</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd EnableSendfile Off
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>For NFS or SMB mounted files, this feature may be disabled explicitly
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh for the offending files by specifying:</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <Directory "/path-to-nfs-files">
439ebfd112c7216b5dbab8161a04fcf78a882e57nd EnableSendfile Off
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh </Directory>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>Please note that the per-directory and .htaccess configuration
439ebfd112c7216b5dbab8161a04fcf78a882e57nd of <code class="directive">EnableSendfile</code> is not supported by
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <code class="module"><a href="/mod/mod_disk_cache.html">mod_disk_cache</a></code>.
439ebfd112c7216b5dbab8161a04fcf78a882e57nd Only global definition of <code class="directive">EnableSendfile</code>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd is taken into account by the module.
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a></h2>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>What the server will return to the client
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>error-code</var> <var>document</var></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>FileInfo</td></tr>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<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>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Quoting syntax for text messages is different in Apache
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>In the event of a problem or error, Apache can be configured
439ebfd112c7216b5dbab8161a04fcf78a882e57nd to do one of four things,</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <li>redirect to a local <var>URL-path</var> to handle the
083eacf86f9327835b824f9e6be987d56cd96e82slive <li>redirect to an external <var>URL</var> to handle the
439ebfd112c7216b5dbab8161a04fcf78a882e57nd <p>The first option is the default, while options 2-4 are
1b4a19b547a5fa7f991706a7f4702c58b9e632b7nd configured using the <code class="directive">ErrorDocument</code>
083eacf86f9327835b824f9e6be987d56cd96e82slive directive, which is followed by the HTTP response code and a URL
083eacf86f9327835b824f9e6be987d56cd96e82slive or a message. Apache will sometimes offer additional information
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>URLs can begin with a slash (/) for local web-paths (relative
083eacf86f9327835b824f9e6be987d56cd96e82slive to the <code class="directive"><a href="#documentroot">DocumentRoot</a></code>), or be a
083eacf86f9327835b824f9e6be987d56cd96e82slive full URL which the client can resolve. Alternatively, a message
98dd94f575d903951ad09b81f8f6d529e4770f94nd can be provided to be displayed by the browser. Examples:</p>
439ebfd112c7216b5dbab8161a04fcf78a882e57nd ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
083eacf86f9327835b824f9e6be987d56cd96e82slive ErrorDocument 403 "Sorry can't allow you access today"
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>Additionally, the special value <code>default</code> can be used
083eacf86f9327835b824f9e6be987d56cd96e82slive to specify Apache's simple hardcoded message. While not required
083eacf86f9327835b824f9e6be987d56cd96e82slive under normal circumstances, <code>default</code> will restore
083eacf86f9327835b824f9e6be987d56cd96e82slive Apache's simple hardcoded message for configurations that would
083eacf86f9327835b824f9e6be987d56cd96e82slive otherwise inherit an existing <code class="directive">ErrorDocument</code>.</p>
f6ece164c2e1055a3d02b10928e1623d18b1d625rbowen ErrorDocument 404 default<br />
f6ece164c2e1055a3d02b10928e1623d18b1d625rbowen </Directory>
e0be1183e544de306aa3cc887dc06522a23c3ed3dpejesh <p>Note that when you specify an <code class="directive">ErrorDocument</code>
7ed5992392d5babab20be4ce4029ad17ae062b5aianh that points to a remote URL (ie. anything with a method such as
7ed5992392d5babab20be4ce4029ad17ae062b5aianh <code>http</code> in front of it), Apache will send a redirect to the
e0be1183e544de306aa3cc887dc06522a23c3ed3dpejesh client to tell it where to find the document, even if the
e0be1183e544de306aa3cc887dc06522a23c3ed3dpejesh document ends up being on the same server. This has several
7ed5992392d5babab20be4ce4029ad17ae062b5aianh implications, the most important being that the client will not
7ed5992392d5babab20be4ce4029ad17ae062b5aianh receive the original error status code, but instead will
7ed5992392d5babab20be4ce4029ad17ae062b5aianh receive a redirect status code. This in turn can confuse web
7ed5992392d5babab20be4ce4029ad17ae062b5aianh robots and other clients which try to determine if a URL is
7ed5992392d5babab20be4ce4029ad17ae062b5aianh valid using the status code. In addition, if you use a remote
7ed5992392d5babab20be4ce4029ad17ae062b5aianh URL in an <code>ErrorDocument 401</code>, the client will not
e0be1183e544de306aa3cc887dc06522a23c3ed3dpejesh know to prompt the user for a password since it will not
e0be1183e544de306aa3cc887dc06522a23c3ed3dpejesh receive the 401 status code. Therefore, <strong>if you use an
7ed5992392d5babab20be4ce4029ad17ae062b5aianh <code>ErrorDocument 401</code> directive then it must refer to a local
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>Microsoft Internet Explorer (MSIE) will by default ignore
f8e0184c566c9a69a710e9c2f2e6a0392e383945rbowen server-generated error messages when they are "too small" and substitute
f8e0184c566c9a69a710e9c2f2e6a0392e383945rbowen its own "friendly" error messages. The size threshold varies depending on
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen the type of error, but in general, if you make your error document
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen greater than 512 bytes, then MSIE will show the server-generated
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen error rather than masking it. More information is available in
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen Microsoft Knowledge Base article <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
5d01f40ffd657dd2ac567aacd93cabd162ddfa79coar <p>Although most error messages can be overriden, there are certain
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen circumstances where the internal messages are used regardless of the
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen setting of <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. In
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen particular, if a malformed request is detected, normal request processing
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen will be immediately halted and the internal error message returned.
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen This is necessary to guard against security problems caused by
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen bad requests.</p>
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen <p>Prior to version 2.0, messages were indicated by prefixing
adaf7aabd73142c431c754a98b80ebcda749ffdcrbowen them with a single unmatched double quote character.</p>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq<div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a></h2>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location where the server will log errors</td></tr>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq<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>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq<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>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq <p>The <code class="directive">ErrorLog</code> directive sets the name of
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh the file to which the server will log any errors it encounters. If
fffe2d3830e52ed28703d042c5049b5e8fa047e2niq the <var>file-path</var> is not absolute then it is assumed to be
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
342e56f7247f87d5294fca662ba97efa2237ff35yoshiki begins with a pipe (|) then it is assumed to be a command to spawn
439ebfd112c7216b5dbab8161a04fcf78a882e57nd to handle the error log.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive <p>Using <code>syslog</code> instead of a filename enables logging
083eacf86f9327835b824f9e6be987d56cd96e82slive via syslogd(8) if the system supports it. The default is to use
083eacf86f9327835b824f9e6be987d56cd96e82slive syslog facility <code>local7</code>, but you can override this by
439ebfd112c7216b5dbab8161a04fcf78a882e57nd using the <code>syslog:<var>facility</var></code> syntax where
37f0d5a24f4107130805cbe65cb798ce3946df7brbowen <var>facility</var> can be one of the names usually documented in
61d29dac384de8b27485e54e53f1386549c578e1rbowen syslog(1).</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive ErrorLog syslog:user
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>SECURITY: See the <a href="/misc/security_tips.html#serverroot">security tips</a>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh document for details on why your security could be compromised
8842df23d0075c8139043c5fb8197058683fb183rbowen if the directory where log files are stored is writable by
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh anyone other than the user that starts the server.</p>
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh <p>When entering a file path on non-Unix platforms, care should be taken
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh to make sure that only forward slashed are used even though the platform
37f0d5a24f4107130805cbe65cb798ce3946df7brbowen may allow the use of back slashes. In general it is a good idea to always
439ebfd112c7216b5dbab8161a04fcf78a882e57nd use forward slashes throughout the configuration files.</p>
083eacf86f9327835b824f9e6be987d56cd96e82slive<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
<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>
<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 2.0</td></tr>
associations defined in mime.types or via the
<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>file-path</var>|<var>directory-path</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</td></tr>
files in a directory that can cause <code class="program"><a href="/programs/httpd.html">httpd</a></code> to
<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#maxrequestsperchild">MaxRequestsPerChild</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 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>
<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>
<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>
<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>level</var></code></td></tr>
<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</td></tr>
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="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="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>
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
<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 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 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="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 2009 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>