core.html.en revision 979d0b61c033b0e14157d025b71b0f12e06c89a9
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
f062ed7bd262a37a909dd77ce5fc23b446818823fielding XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
f062ed7bd262a37a909dd77ce5fc23b446818823fielding This file is generated from xml source: DO NOT EDIT
2d2eda71267231c2526be701fe655db125852c1ffielding XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2d2eda71267231c2526be701fe655db125852c1ffielding<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
2d2eda71267231c2526be701fe655db125852c1ffielding<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
2d2eda71267231c2526be701fe655db125852c1ffielding<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<script src="/style/scripts/prettify.js" type="text/javascript">
2d2eda71267231c2526be701fe655db125852c1ffielding<link href="/images/favicon.ico" rel="shortcut icon" /></head>
2d2eda71267231c2526be701fe655db125852c1ffielding<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<p class="apache">Apache HTTP Server Version 2.5</p>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<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.5</a> > <a href="./">Modules</a></div>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<p><span>Available Languages: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<a href="/en/mod/core.html" title="English"> en </a> |
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<a href="/es/mod/core.html" hreflang="es" rel="alternate" title="Espa�ol"> es </a> |
2d2eda71267231c2526be701fe655db125852c1ffielding<a href="/fr/mod/core.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<a href="/ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<a href="/tr/mod/core.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
2d2eda71267231c2526be701fe655db125852c1ffielding<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Core Apache HTTP Server features that are always
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Core</td></tr></table>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<div id="quickview"><h3 class="directives">Directives</h3>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#allowoverridelist">AllowOverrideList</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#defaultruntimedir">DefaultRuntimeDir</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#define">Define</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#directory"><Directory></a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#else"><Else></a></li>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<li><img alt="" src="/images/down.gif" /> <a href="#elseif"><ElseIf></a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#error">Error</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#errorlogformat">ErrorLogFormat</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#fileetag">FileETag</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#files"><Files></a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#forcetype">ForceType</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#gprofdir">GprofDir</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#if"><If></a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#include">Include</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#includeoptional">IncludeOptional</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
bd53cb2bf4d77574fd502e1c02d8c3c0d5431967stoddard<li><img alt="" src="/images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb<li><img alt="" src="/images/down.gif" /> <a href="#limit"><Limit></a></li>
b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb<li><img alt="" src="/images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
44c46ef733836b32585d135d2d90856e7cfd9929rbb<li><img alt="" src="/images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
14bea4ba98aabaf554e37165a07123bb05d6736bstoddard<li><img alt="" src="/images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#location"><Location></a></li>
9731f9232bddd7dbac757c780b2b1a2a6931dce7stoddard<li><img alt="" src="/images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#maxrangeoverlaps">MaxRangeOverlaps</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#maxrangereversals">MaxRangeReversals</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#maxranges">MaxRanges</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#mutex">Mutex</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#options">Options</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#protocol">Protocol</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<li><img alt="" src="/images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<li><img alt="" src="/images/down.gif" /> <a href="#servername">ServerName</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><img alt="" src="/images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#timeout">TimeOut</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#undefine">UnDefine</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures optimizations for a Protocol's Listener Sockets</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.1.5 and later.
2d2eda71267231c2526be701fe655db125852c1ffieldingOn Windows from Apache httpd 2.3.3 and later.</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>This directive enables operating system specific optimizations for a
2d2eda71267231c2526be701fe655db125852c1ffielding listening socket by the <code class="directive">Protocol</code>type.
2d2eda71267231c2526be701fe655db125852c1ffielding The basic premise is for the kernel to not send a socket to the server
2d2eda71267231c2526be701fe655db125852c1ffielding process until either data is received or an entire HTTP Request is buffered.
2d2eda71267231c2526be701fe655db125852c1ffielding Only <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&sektion=9">
2d2eda71267231c2526be701fe655db125852c1ffielding FreeBSD's Accept Filters</a>, Linux's more primitive
2d2eda71267231c2526be701fe655db125852c1ffielding <code>TCP_DEFER_ACCEPT</code>, and Windows' optimized AcceptEx()
2d2eda71267231c2526be701fe655db125852c1ffielding are currently supported.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Using <code>none</code> for an argument will disable any accept filters
2d2eda71267231c2526be701fe655db125852c1ffielding for that protocol. This is useful for protocols that require a server
2d2eda71267231c2526be701fe655db125852c1ffielding send data first, such as <code>ftp:</code> or <code>nntp</code>:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding AcceptFilter nntp none
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The default protocol names are <code>https</code> for port 443
2d2eda71267231c2526be701fe655db125852c1ffielding and <code>http</code> for all other ports. To specify another protocol
2d2eda71267231c2526be701fe655db125852c1ffielding is being used with a listening port, add the <var>protocol</var>
2d2eda71267231c2526be701fe655db125852c1ffielding argument to the <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code>
2d2eda71267231c2526be701fe655db125852c1ffielding directive.</p>
2d2eda71267231c2526be701fe655db125852c1ffieldingAcceptFilter http httpready
2d2eda71267231c2526be701fe655db125852c1ffieldingAcceptFilter https dataready
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The <code>httpready</code> accept filter buffers entire HTTP requests at
2d2eda71267231c2526be701fe655db125852c1ffielding the kernel level. Once an entire request is received, the kernel then
2d2eda71267231c2526be701fe655db125852c1ffielding sends it to the server. See the
2d2eda71267231c2526be701fe655db125852c1ffielding <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&sektion=9">
2d2eda71267231c2526be701fe655db125852c1ffielding accf_http(9)</a> man page for more details. Since HTTPS requests are
2d2eda71267231c2526be701fe655db125852c1ffielding encrypted only the <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&sektion=9">
2d2eda71267231c2526be701fe655db125852c1ffieldingAcceptFilter http data
2d2eda71267231c2526be701fe655db125852c1ffieldingAcceptFilter https data
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Linux's <code>TCP_DEFER_ACCEPT</code> does not support buffering http
2d2eda71267231c2526be701fe655db125852c1ffielding requests. Any value besides <code>none</code> will enable
2d2eda71267231c2526be701fe655db125852c1ffielding <code>TCP_DEFER_ACCEPT</code> on that listener. For more details
2d2eda71267231c2526be701fe655db125852c1ffielding see the Linux
2d2eda71267231c2526be701fe655db125852c1ffielding <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html">
2d2eda71267231c2526be701fe655db125852c1ffieldingAcceptFilter http data
2d2eda71267231c2526be701fe655db125852c1ffieldingAcceptFilter https data
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Window's mpm_winnt interprets the AcceptFilter to toggle the AcceptEx()
2d2eda71267231c2526be701fe655db125852c1ffielding API, and does not support http protocol buffering. There are two values
2d2eda71267231c2526be701fe655db125852c1ffielding which utilize the Windows AcceptEx() API and will recycle network
2d2eda71267231c2526be701fe655db125852c1ffielding sockets between connections. <code>data</code> waits until data has
2d2eda71267231c2526be701fe655db125852c1ffielding been transmitted as documented above, and the initial data buffer and
2d2eda71267231c2526be701fe655db125852c1ffielding network endpoint addresses are all retrieved from the single AcceptEx()
2d2eda71267231c2526be701fe655db125852c1ffielding invocation. <code>connect</code> will use the AcceptEx() API, also
2d2eda71267231c2526be701fe655db125852c1ffielding retrieve the network endpoint addresses, but like <code>none</code>
2d2eda71267231c2526be701fe655db125852c1ffielding the <code>connect</code> option does not wait for the initial data
2d2eda71267231c2526be701fe655db125852c1ffielding transmission.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>On Windows, <code>none</code> uses accept() rather than AcceptEx()
2e123e8beedc9f921448c113e2d6823a92fd5261fielding and will not recycle sockets between connections. This is useful for
2d2eda71267231c2526be701fe655db125852c1ffielding network adapters with broken driver support, as well as some virtual
2d2eda71267231c2526be701fe655db125852c1ffielding network providers such as vpn drivers, or spam, virus or spyware
2d2eda71267231c2526be701fe655db125852c1ffielding filters.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><code class="directive"><a href="#protocol">Protocol</a></code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Resources accept trailing pathname information</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.0.30 and later</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>This directive controls whether requests that contain trailing
2d2eda71267231c2526be701fe655db125852c1ffielding pathname information that follows an actual filename (or
2d2eda71267231c2526be701fe655db125852c1ffielding non-existent file in an existing directory) will be accepted or
2d2eda71267231c2526be701fe655db125852c1ffielding rejected. The trailing pathname information can be made
2d2eda71267231c2526be701fe655db125852c1ffielding available to scripts in the <code>PATH_INFO</code> environment
2d2eda71267231c2526be701fe655db125852c1ffielding variable.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>For example, assume the location <code>/test/</code> points to
2d2eda71267231c2526be701fe655db125852c1ffielding a directory that contains only the single file
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The three possible arguments for the
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive">AcceptPathInfo</code> directive are:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <dt><code>Off</code></dt><dd>A request will only be accepted if it
2d2eda71267231c2526be701fe655db125852c1ffielding maps to a literal path that exists. Therefore a request with
2d2eda71267231c2526be701fe655db125852c1ffielding trailing pathname information after the true filename such as
2d2eda71267231c2526be701fe655db125852c1ffielding <code>/test/here.html/more</code> in the above example will return
2d2eda71267231c2526be701fe655db125852c1ffielding a 404 NOT FOUND error.</dd>
2d2eda71267231c2526be701fe655db125852c1ffielding <dt><code>On</code></dt><dd>A request will be accepted if a
2d2eda71267231c2526be701fe655db125852c1ffielding leading path component maps to a file that exists. The above
2d2eda71267231c2526be701fe655db125852c1ffielding example <code>/test/here.html/more</code> will be accepted if
2d2eda71267231c2526be701fe655db125852c1ffielding <code>/test/here.html</code> maps to a valid file.</dd>
2efb935ae8fe12d5192a3bf2c52c28461b6c68afdgaudet <dt><code>Default</code></dt><dd>The treatment of requests with
2efb935ae8fe12d5192a3bf2c52c28461b6c68afdgaudet trailing pathname information is determined by the <a href="/handler.html">handler</a> responsible for the request.
2efb935ae8fe12d5192a3bf2c52c28461b6c68afdgaudet The core handler for normal files defaults to rejecting
2efb935ae8fe12d5192a3bf2c52c28461b6c68afdgaudet <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
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The primary purpose of the <code>AcceptPathInfo</code>
2d2eda71267231c2526be701fe655db125852c1ffielding directive is to allow you to override the handler's choice of
2d2eda71267231c2526be701fe655db125852c1ffielding accepting or rejecting <code>PATH_INFO</code>. This override is required,
2d2eda71267231c2526be701fe655db125852c1ffielding for example, when you use a <a href="/filter.html">filter</a>, such
2d2eda71267231c2526be701fe655db125852c1ffielding as <a href="mod_include.html">INCLUDES</a>, to generate content
2d2eda71267231c2526be701fe655db125852c1ffielding based on <code>PATH_INFO</code>. The core handler would usually reject
2d2eda71267231c2526be701fe655db125852c1ffielding the request, so you can use the following configuration to enable
2d2eda71267231c2526be701fe655db125852c1ffielding such a script:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<Files "mypaths.shtml">
2d2eda71267231c2526be701fe655db125852c1ffielding Options +Includes
2d2eda71267231c2526be701fe655db125852c1ffielding SetOutputFilter INCLUDES
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb AcceptPathInfo On
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb</Files>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a></h2>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the distributed configuration file</td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>While processing a request the server looks for
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb the first existing configuration file from this list of names in
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb every directory of the path to the document, if distributed
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb configuration files are <a href="#allowoverride">enabled for that
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <pre class="prettyprint lang-config">AccessFileName .acl</pre>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>before returning the document
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>/usr/local/web/index.html</code>, the server will read
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>/usr/local/.acl</code> and <code>/usr/local/web/.acl</code>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb for directives, unless they have been disabled with</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<Directory />
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb AllowOverride None
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb</Directory>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><a href="/configuring.html">Configuration Files</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a></h2>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default charset parameter to be added when a response
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbbcontent-type is <code>text/plain</code> or <code>text/html</code></td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>This directive specifies a default value for the media type
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb charset parameter (the name of a character encoding) to be added
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb to a response if and only if the response's content-type is either
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>text/plain</code> or <code>text/html</code>. This should override
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb any charset specified in the body of the response via a <code>META</code>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb element, though the exact behavior is often dependent on the user's client
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb configuration. A setting of <code>AddDefaultCharset Off</code>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb disables this functionality. <code>AddDefaultCharset On</code> enables
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb a default charset of <code>iso-8859-1</code>. Any other value is assumed
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb to be the <var>charset</var> to be used, which should be one of the
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <a href="http://www.iana.org/assignments/character-sets">IANA registered
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb charset values</a> for use in Internet media types (MIME types).
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb For example:</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <pre class="prettyprint lang-config">AddDefaultCharset utf-8</pre>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p><code class="directive">AddDefaultCharset</code> should only be used when all
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb of the text resources to which it applies are known to be in that
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb character encoding and it is too inconvenient to label their charset
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb individually. One such example is to add the charset parameter
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb to resources containing generated content, such as legacy CGI
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb scripts, that might be vulnerable to cross-site scripting attacks
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb due to user-provided data being included in the output. Note, however,
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb that a better solution is to just fix (or delete) those scripts, since
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb setting a default charset does not protect users that have enabled
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb the "auto-detect character encoding" feature on their browser.</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<li><code class="directive"><a href="/mod/mod_mime.html#addcharset">AddCharset</a></code></li>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a></h2>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether encoded path separators in URLs are allowed to
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off|NoDecode</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.0.46 and later.
2d2eda71267231c2526be701fe655db125852c1ffieldingNoDecode option available in 2.3.12 and later.</td></tr>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding <p>The <code class="directive">AllowEncodedSlashes</code> directive allows URLs
9625528fcf4fa27288f3be080a1979c8ef60d7dfrbb which contain encoded path separators (<code>%2F</code> for <code>/</code>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding and additionally <code>%5C</code> for <code>\</code> on according systems)
2e123e8beedc9f921448c113e2d6823a92fd5261fielding to be used in the path info.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>With the default value, <code>Off</code>, such URLs are refused
2d2eda71267231c2526be701fe655db125852c1ffielding with a 404 (Not found) error.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>With the value <code>On</code>, such URLs are accepted, and encoded
2d2eda71267231c2526be701fe655db125852c1ffielding slashes are decoded like all other encoded characters.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>With the value <code>NoDecode</code>, such URLs are accepted, but
2d2eda71267231c2526be701fe655db125852c1ffielding encoded slashes are not decoded but left in their encoded state.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Turning <code class="directive">AllowEncodedSlashes</code> <code>On</code> is
2d2eda71267231c2526be701fe655db125852c1ffielding mostly useful when used in conjunction with <code>PATH_INFO</code>.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>If encoded slashes are needed in path info, use of <code>NoDecode</code> is
2d2eda71267231c2526be701fe655db125852c1ffielding strongly recommended as a security measure. Allowing slashes
2d2eda71267231c2526be701fe655db125852c1ffielding to be decoded could potentially allow unsafe paths.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types of directives that are allowed in
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>directive-type</var>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowOverride None (2.3.9 and later), AllowOverride All (2.3.8 and earlier)</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>When the server finds an <code>.htaccess</code> file (as
2d2eda71267231c2526be701fe655db125852c1ffielding specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>)
2d2eda71267231c2526be701fe655db125852c1ffielding it needs to know which directives declared in that file can override
2d2eda71267231c2526be701fe655db125852c1ffielding earlier configuration directives.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <div class="note"><h3>Only available in <Directory> sections</h3>
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive">AllowOverride</code> is valid only in
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#directory"><Directory></a></code>
2d2eda71267231c2526be701fe655db125852c1ffielding 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
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#files"><Files></a></code> sections.
2d2eda71267231c2526be701fe655db125852c1ffielding <p>When this directive is set to <code>None</code> and <code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code> is set to
2d2eda71267231c2526be701fe655db125852c1ffielding <code>None</code> <a href="#accessfilename">.htaccess</a> files are
2d2eda71267231c2526be701fe655db125852c1ffielding completely ignored. In this case, the server will not even attempt
2d2eda71267231c2526be701fe655db125852c1ffielding to read <code>.htaccess</code> files in the filesystem.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>When this directive is set to <code>All</code>, then any
2d2eda71267231c2526be701fe655db125852c1ffielding directive which has the .htaccess <a href="directive-dict.html#Context">Context</a> is allowed in
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The <var>directive-type</var> can be one of the following
2d2eda71267231c2526be701fe655db125852c1ffielding groupings of directives.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding Allow use of the authorization directives (<code class="directive"><a href="/mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="/mod/mod_authn_core.html#authname">AuthName</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <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>
2d2eda71267231c2526be701fe655db125852c1ffielding Allow use of the directives controlling document types
2d2eda71267231c2526be701fe655db125852c1ffielding (<code class="directive"><a href="#errordocument">ErrorDocument</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#forcetype">ForceType</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="/mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#sethandler">SetHandler</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, and
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> Add* and Remove* directives),
2d2eda71267231c2526be701fe655db125852c1ffielding 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>),
2d2eda71267231c2526be701fe655db125852c1ffielding <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
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> from
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="module"><a href="/mod/mod_actions.html">mod_actions</a></code>.
2d2eda71267231c2526be701fe655db125852c1ffielding Allow use of the directives controlling directory indexing
2d2eda71267231c2526be701fe655db125852c1ffielding (<code class="directive"><a href="/mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <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>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="/mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <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>, <a href="mod_autoindex.html#indexoptions.fancyindexing"><code>FancyIndexing</code></a>, <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>,
2d2eda71267231c2526be701fe655db125852c1ffielding Allow use of the directives controlling host access (<code class="directive"><a href="/mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="/mod/mod_access_compat.html#deny">Deny</a></code> and <code class="directive"><a href="/mod/mod_access_compat.html#order">Order</a></code>).</dd>
2d2eda71267231c2526be701fe655db125852c1ffielding Allow use of AllowOverride option to treat syntax errors in
2d2eda71267231c2526be701fe655db125852c1ffielding .htaccess as non-fatal: instead of causing an Internal Server
2d2eda71267231c2526be701fe655db125852c1ffielding Error, disallowed or unrecognised directives will be ignored
2d2eda71267231c2526be701fe655db125852c1ffielding and a warning logged:
2d2eda71267231c2526be701fe655db125852c1ffielding <li><strong>Nonfatal=Override</strong> treats directives
2d2eda71267231c2526be701fe655db125852c1ffielding forbidden by AllowOverride as non-fatal.</li>
2d2eda71267231c2526be701fe655db125852c1ffielding <li><strong>Nonfatal=Unknown</strong> treats unknown directives
2d2eda71267231c2526be701fe655db125852c1ffielding as non-fatal. This covers typos and directives implemented
2d2eda71267231c2526be701fe655db125852c1ffielding by a module that's not present.</li>
2d2eda71267231c2526be701fe655db125852c1ffielding <li><strong>Nonfatal=All</strong> treats both the above as non-fatal.</li>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Note that a syntax error in a valid directive will still cause
2d2eda71267231c2526be701fe655db125852c1ffielding an internal server error.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding Nonfatal errors may have security implications for .htaccess users.
2d2eda71267231c2526be701fe655db125852c1ffielding For example, if AllowOverride disallows AuthConfig, users'
2d2eda71267231c2526be701fe655db125852c1ffielding configuration designed to restrict access to a site will be disabled.
2d2eda71267231c2526be701fe655db125852c1ffielding Allow use of the directives controlling specific directory
2d2eda71267231c2526be701fe655db125852c1ffielding features (<code class="directive"><a href="#options">Options</a></code> and
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="/mod/mod_include.html#xbithack">XBitHack</a></code>).
2d2eda71267231c2526be701fe655db125852c1ffielding An equal sign may be given followed by a comma (but no spaces)
2d2eda71267231c2526be701fe655db125852c1ffielding separated lists of options that may be set using the <code class="directive"><a href="#options">Options</a></code> command.
54e94821097724bf413d2d4cc70711760f7494e1trawick <div class="note"><h3>Implicit disabling of Options</h3>
54e94821097724bf413d2d4cc70711760f7494e1trawick <p>Even though the list of options that may be used in .htaccess files
2d2eda71267231c2526be701fe655db125852c1ffielding can be limited with this directive, as long as any <code class="directive"><a href="#options">Options</a></code> directive is allowed any
54e94821097724bf413d2d4cc70711760f7494e1trawick other inherited option can be disabled by using the non-relative
54e94821097724bf413d2d4cc70711760f7494e1trawick syntax. In other words, this mechanism cannot force a specific option
2d2eda71267231c2526be701fe655db125852c1ffielding to remain <em>set</em> while allowing any others to be set.
54e94821097724bf413d2d4cc70711760f7494e1trawick <pre class="prettyprint lang-config">AllowOverride AuthConfig Indexes</pre>
54e94821097724bf413d2d4cc70711760f7494e1trawick <p>In the example above all directives that are neither in the group
54e94821097724bf413d2d4cc70711760f7494e1trawick <code>AuthConfig</code> nor <code>Indexes</code> cause an internal
54e94821097724bf413d2d4cc70711760f7494e1trawick server error.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <div class="note"><p>For security and performance reasons, do not set
2d2eda71267231c2526be701fe655db125852c1ffielding <code>AllowOverride</code> to anything other than <code>None</code>
2d2eda71267231c2526be701fe655db125852c1ffielding in your <code><Directory /></code> block. Instead, find (or
2d2eda71267231c2526be701fe655db125852c1ffielding create) the <code><Directory></code> block that refers to the
2d2eda71267231c2526be701fe655db125852c1ffielding directory where you're actually planning to place a
2d2eda71267231c2526be701fe655db125852c1ffielding<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><a href="/configuring.html">Configuration Files</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="AllowOverrideList" id="AllowOverrideList">AllowOverrideList</a> <a name="allowoverridelist" id="allowoverridelist">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Individual directives that are allowed in
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverrideList None|<var>directive</var>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowOverrideList None</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>When the server finds an <code>.htaccess</code> file (as
2d2eda71267231c2526be701fe655db125852c1ffielding specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>)
2d2eda71267231c2526be701fe655db125852c1ffielding it needs to know which directives declared in that file can override
2d2eda71267231c2526be701fe655db125852c1ffielding earlier configuration directives.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <div class="note"><h3>Only available in <Directory> sections</h3>
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive">AllowOverrideList</code> is valid only in
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#directory"><Directory></a></code>
3887202241db08986e94b252fbd06a55e55d4b2dbhyde 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
3887202241db08986e94b252fbd06a55e55d4b2dbhyde <code class="directive"><a href="#files"><Files></a></code> sections.
3887202241db08986e94b252fbd06a55e55d4b2dbhyde <p>When this directive is set to <code>None</code> and <code class="directive"><a href="#allowoverride">AllowOverride</a></code> is set to <code>None</code>,
3887202241db08986e94b252fbd06a55e55d4b2dbhyde then <a href="#accessfilename">.htaccess</a> files are completely
3887202241db08986e94b252fbd06a55e55d4b2dbhyde ignored. In this case, the server will not even attempt to read
2d2eda71267231c2526be701fe655db125852c1ffieldingAllowOverride None
2d2eda71267231c2526be701fe655db125852c1ffieldingAllowOverrideList Redirect RedirectMatch
3887202241db08986e94b252fbd06a55e55d4b2dbhyde <p>In the example above only the <code>Redirect</code> and
3887202241db08986e94b252fbd06a55e55d4b2dbhyde <code>RedirectMatch</code> directives are allowed. All others will
3887202241db08986e94b252fbd06a55e55d4b2dbhyde cause an internal server error.</p>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbbAllowOverride AuthConfig
2d2eda71267231c2526be701fe655db125852c1ffieldingAllowOverrideList CookieTracking CookieName
2d2eda71267231c2526be701fe655db125852c1ffielding <p>In the example above <code class="directive"><a href="#allowoverride ">AllowOverride
2d2eda71267231c2526be701fe655db125852c1ffielding </a></code> grants permission to the <code>AuthConfig</code>
2d2eda71267231c2526be701fe655db125852c1ffielding directive grouping and <code class="directive">AllowOverrideList</code> grants
2d2eda71267231c2526be701fe655db125852c1ffielding permission to only two directves from the <code>FileInfo</code> directive
2d2eda71267231c2526be701fe655db125852c1ffielding grouping. All others will cause an internal server error.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><a href="/configuring.html">Configuration Files</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIMapExtension <var>cgi-path</var> <var>.extension</var></code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
6db54801798f6021bb464de7b3fdcc9dc3150f7bdgaudet<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>NetWare only</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>This directive is used to control how Apache httpd finds the
2d2eda71267231c2526be701fe655db125852c1ffielding interpreter used to run CGI scripts. For example, setting
2d2eda71267231c2526be701fe655db125852c1ffielding <code>CGIMapExtension sys:\foo.nlm .foo</code> will
2d2eda71267231c2526be701fe655db125852c1ffielding cause all CGI script files with a <code>.foo</code> extension to
2d2eda71267231c2526be701fe655db125852c1ffielding be passed to the FOO interpreter.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables the generation of <code>Content-MD5</code> HTTP Response
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ContentDigest On|Off</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ContentDigest Off</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Options</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>This directive enables the generation of
2d2eda71267231c2526be701fe655db125852c1ffielding <code>Content-MD5</code> headers as defined in RFC1864
2d2eda71267231c2526be701fe655db125852c1ffielding respectively RFC2616.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>MD5 is an algorithm for computing a "message digest"
2d2eda71267231c2526be701fe655db125852c1ffielding (sometimes called "fingerprint") of arbitrary-length data, with
2d2eda71267231c2526be701fe655db125852c1ffielding a high degree of confidence that any alterations in the data
2d2eda71267231c2526be701fe655db125852c1ffielding will be reflected in alterations in the message digest.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The <code>Content-MD5</code> header provides an end-to-end
2d2eda71267231c2526be701fe655db125852c1ffielding message integrity check (MIC) of the entity-body. A proxy or
2d2eda71267231c2526be701fe655db125852c1ffielding client may check this header for detecting accidental
2d2eda71267231c2526be701fe655db125852c1ffielding modification of the entity-body in transit. Example header:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Note that this can cause performance problems on your server
2d2eda71267231c2526be701fe655db125852c1ffielding since the message digest is computed on every request (the
2d2eda71267231c2526be701fe655db125852c1ffielding values are not cached).</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p><code>Content-MD5</code> is only sent for documents served
2d2eda71267231c2526be701fe655db125852c1ffielding by the <code class="module"><a href="/mod/core.html">core</a></code>, and not by any module. For example,
2d2eda71267231c2526be701fe655db125852c1ffielding SSI documents, output from CGI scripts, and byte range responses
2d2eda71267231c2526be701fe655db125852c1ffielding do not have this header.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="DefaultRuntimeDir" id="DefaultRuntimeDir">DefaultRuntimeDir</a> <a name="defaultruntimedir" id="defaultruntimedir">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server run-time files</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultRuntimeDir <var>directory-path</var></code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/)</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb <p>The <code class="directive">DefaultRuntimeDir</code> directive sets the
2d2eda71267231c2526be701fe655db125852c1ffielding directory in which the server will create various run-time files
2d2eda71267231c2526be701fe655db125852c1ffielding (shared memory, locks, etc.). If set as a relative path, the full path
2d2eda71267231c2526be701fe655db125852c1ffielding will be relative to <code class="directive">ServerRoot</code></p>
b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbbDefaultRuntimeDir scratch/
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The default location of <code class="directive">DefaultRuntimeDir</code> may be
2d2eda71267231c2526be701fe655db125852c1ffielding modified by changing the <code>DEFAULT_REL_RUNTIMEDIR</code> #define
2d2eda71267231c2526be701fe655db125852c1ffielding at build time.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Note: <code class="directive">ServerRoot</code> should be specified before this
2d2eda71267231c2526be701fe655db125852c1ffielding directive is used, otherwise the default value of <code class="directive">ServerRoot</code>
2d2eda71267231c2526be701fe655db125852c1ffielding would be used to set the base directory.</p>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<li><a href="/misc/security_tips.html#serverroot">the
2e123e8beedc9f921448c113e2d6823a92fd5261fielding security tips</a> for information on how to properly set
2e123e8beedc9f921448c113e2d6823a92fd5261fielding permissions on the <code class="directive">ServerRoot</code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>This directive has no effect other than to emit warnings
2d2eda71267231c2526be701fe655db125852c1ffieldingif the value is not <code>none</code>. In prior versions, DefaultType
2d2eda71267231c2526be701fe655db125852c1ffieldingwould specify a default media type to assign to response content for
2d2eda71267231c2526be701fe655db125852c1ffieldingwhich no other media type configuration could be found.
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>media-type|none</var></code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DefaultType none</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
d96aa158770d3f83cb59cf0f2f7402e175f7dfccrbb<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>The argument <code>none</code> is available in Apache httpd 2.2.7 and later. All other choices are DISABLED for 2.3.x and later.</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>This directive has been disabled. For backwards compatibility
2d2eda71267231c2526be701fe655db125852c1ffielding of configuration files, it may be specified with the value
2d2eda71267231c2526be701fe655db125852c1ffielding <code>none</code>, meaning no default media type. For example:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <pre class="prettyprint lang-config">DefaultType None</pre>
2d2eda71267231c2526be701fe655db125852c1ffielding <p><code>DefaultType None</code> is only available in
2d2eda71267231c2526be701fe655db125852c1ffielding httpd-2.2.7 and later.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="/mod/mod_mime.html#addtype">AddType</a></code> to configure media
2d2eda71267231c2526be701fe655db125852c1ffielding type assignments via file extensions, or the
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#forcetype">ForceType</a></code> directive to configure
2d2eda71267231c2526be701fe655db125852c1ffielding the media type for specific resources. Otherwise, the server will
2d2eda71267231c2526be701fe655db125852c1ffielding send the response without a Content-Type header field and the
2d2eda71267231c2526be701fe655db125852c1ffielding recipient may attempt to guess the media type.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a variable</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Define <var>parameter-name</var> [<var>parameter-value</var>]</code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>In its one parameter form, <code class="directive">Define</code> is equivalent
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb to passing the <code>-D</code> argument to <code class="program"><a href="/programs/httpd.html">httpd</a></code>. It
2d2eda71267231c2526be701fe655db125852c1ffielding can be used to toggle the use of
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sections
2d2eda71267231c2526be701fe655db125852c1ffielding without needing to alter <code>-D</code> arguments in any startup
2d2eda71267231c2526be701fe655db125852c1ffielding scripts.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>In addition to that, if the second parameter is given, a config variable
2d2eda71267231c2526be701fe655db125852c1ffielding is set to this value. The variable can be used in the configuration using
2d2eda71267231c2526be701fe655db125852c1ffielding the <code>${VAR}</code> syntax. The variable is always globally defined
2d2eda71267231c2526be701fe655db125852c1ffielding and not limited to the scope of the surrounding config section.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<IfDefine TEST>
2d2eda71267231c2526be701fe655db125852c1ffielding Define servername test.example.com
2d2eda71267231c2526be701fe655db125852c1ffielding</IfDefine>
2d2eda71267231c2526be701fe655db125852c1ffielding<IfDefine !TEST>
2d2eda71267231c2526be701fe655db125852c1ffielding Define servername www.example.com
2d2eda71267231c2526be701fe655db125852c1ffielding</IfDefine>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Variable names may not contain colon ":" characters, to avoid clashes
2d2eda71267231c2526be701fe655db125852c1ffielding with <code class="directive"><a href="/mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>'s syntax.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that apply only to the
2d2eda71267231c2526be701fe655db125852c1ffieldingnamed file-system directory, sub-directories, and their contents.</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Directory <var>directory-path</var>>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2e123e8beedc9f921448c113e2d6823a92fd5261fielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p><code class="directive"><Directory></code> and
2d2eda71267231c2526be701fe655db125852c1ffielding <code></Directory></code> are used to enclose a group of
2d2eda71267231c2526be701fe655db125852c1ffielding directives that will apply only to the named directory,
2d2eda71267231c2526be701fe655db125852c1ffielding sub-directories of that directory, and the files within the respective
2d2eda71267231c2526be701fe655db125852c1ffielding directories. Any directive that is allowed
2d2eda71267231c2526be701fe655db125852c1ffielding in a directory context may be used. <var>Directory-path</var> is
2d2eda71267231c2526be701fe655db125852c1ffielding either the full path to a directory, or a wild-card string using
2d2eda71267231c2526be701fe655db125852c1ffielding Unix shell-style matching. In a wild-card string, <code>?</code> matches
2d2eda71267231c2526be701fe655db125852c1ffielding any single character, and <code>*</code> matches any sequences of
2d2eda71267231c2526be701fe655db125852c1ffielding characters. You may also use <code>[]</code> character ranges. None
2d2eda71267231c2526be701fe655db125852c1ffielding of the wildcards match a `/' character, so <code><Directory
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb /*/public_html></code> will not match
2d2eda71267231c2526be701fe655db125852c1ffielding <code>/home/user/public_html</code>, but <code><Directory
2d2eda71267231c2526be701fe655db125852c1ffielding /home/*/public_html></code> will match. Example:</p>
3887202241db08986e94b252fbd06a55e55d4b2dbhyde Options Indexes FollowSymLinks
2d2eda71267231c2526be701fe655db125852c1ffielding</Directory>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Be careful with the <var>directory-path</var> arguments:
2d2eda71267231c2526be701fe655db125852c1ffielding They have to literally match the filesystem path which Apache httpd uses
2d2eda71267231c2526be701fe655db125852c1ffielding to access the files. Directives applied to a particular
2d2eda71267231c2526be701fe655db125852c1ffielding <code><Directory></code> will not apply to files accessed from
2d2eda71267231c2526be701fe655db125852c1ffielding that same directory via a different path, such as via different symbolic
2d2eda71267231c2526be701fe655db125852c1ffielding <p><a class="glossarylink" href="/glossary.html#regex" title="see glossary">Regular
2d2eda71267231c2526be701fe655db125852c1ffielding expressions</a> can also be used, with the addition of the
2d2eda71267231c2526be701fe655db125852c1ffielding<Directory ~ "^/www/.*/[0-9]{3}">
2d2eda71267231c2526be701fe655db125852c1ffielding</Directory>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>would match directories in <code>/www/</code> that consisted of
2d2eda71267231c2526be701fe655db125852c1ffielding three numbers.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>If multiple (non-regular expression) <code class="directive"><Directory></code> sections
2d2eda71267231c2526be701fe655db125852c1ffielding match the directory (or one of its parents) containing a document,
2d2eda71267231c2526be701fe655db125852c1ffielding then the directives are applied in the order of shortest match
2d2eda71267231c2526be701fe655db125852c1ffielding first, interspersed with the directives from the <a href="#accessfilename">.htaccess</a> files. For example,
2d2eda71267231c2526be701fe655db125852c1ffielding<Directory />
2d2eda71267231c2526be701fe655db125852c1ffielding AllowOverride None
2d2eda71267231c2526be701fe655db125852c1ffielding</Directory>
b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb<Directory "/home">
b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb AllowOverride FileInfo
2d2eda71267231c2526be701fe655db125852c1ffielding</Directory>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>for access to the document <code>/home/web/dir/doc.html</code>
2d2eda71267231c2526be701fe655db125852c1ffielding the steps are:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <li>Apply directive <code>AllowOverride None</code>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <li>Apply directive <code>AllowOverride FileInfo</code> (for
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> and
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>/home/web/dir/.htaccess</code> in that order.</li>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>Regular expressions are not considered until after all of the
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb normal sections have been applied. Then all of the regular
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb expressions are tested in the order they appeared in the
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb configuration file. For example, with</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<Directory ~ "abc$">
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb # ... directives here ...
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb</Directory>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>the regular expression section won't be considered until after
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb all normal <code class="directive"><Directory></code>s and
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>.htaccess</code> files have been applied. Then the regular
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb expression will match on <code>/home/abc/public_html/abc</code> and
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb the corresponding <code class="directive"><Directory></code> will
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb be applied.</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code><Directory /></code> is to permit all access.
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb This means that Apache httpd will serve any file mapped from an URL. It is
2d2eda71267231c2526be701fe655db125852c1ffielding recommended that you change this with a block such
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<Directory />
2d2eda71267231c2526be701fe655db125852c1ffielding Require all denied
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb</Directory>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <em>want</em> accessible. See the <a href="/misc/security_tips.html">Security Tips</a> page for more
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The directory sections occur in the <code>httpd.conf</code> file.
6db54801798f6021bb464de7b3fdcc9dc3150f7bdgaudet <code class="directive"><Directory></code> directives
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb 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>
2d2eda71267231c2526be701fe655db125852c1ffielding <Location> and <Files> sections work</a> for an
2d2eda71267231c2526be701fe655db125852c1ffielding explanation of how these different sections are combined when a
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb request is received</li>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">Directive</a></h2>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose directives that apply to
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbbthe contents of file-system directories matching a regular expression.</td></tr>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><DirectoryMatch <var>regex</var>>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb <p><code class="directive"><DirectoryMatch></code> and
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb <code></DirectoryMatch></code> are used to enclose a group
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb of directives which will apply only to the named directory (and the files within),
2d2eda71267231c2526be701fe655db125852c1ffielding the same as <code class="directive"><a href="#directory"><Directory></a></code>.
2d2eda71267231c2526be701fe655db125852c1ffielding However, it takes as an argument a
2d2eda71267231c2526be701fe655db125852c1ffielding <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular expression</a>. For example:</p>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<DirectoryMatch "^/www/(.+/)?[0-9]{3}">
2d2eda71267231c2526be701fe655db125852c1ffielding</DirectoryMatch>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb <p>would match directories in <code>/www/</code> that consisted of three
2d2eda71267231c2526be701fe655db125852c1ffielding numbers.</p>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb Prior to 2.3.9, this directive implicitly applied to sub-directories
2d2eda71267231c2526be701fe655db125852c1ffielding (like <code class="directive"><a href="#directory"><Directory></a></code>) and
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb could not match the end of line symbol ($). In 2.3.9 and later,
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb only directories that match the expression are affected by the enclosed
2d2eda71267231c2526be701fe655db125852c1ffielding directives.
ef7331e9f2c6fb4f671b13db21e0ac27a6dcf4f3dgaudet This directive applies to requests for directories that may or may
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb not end in a trailing slash, so expressions that are anchored to the
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb end of line ($) must be written with care.
44cc98a76a4aa7f141f449f58a3f624216869413bjh<li><code class="directive"><a href="#directory"><Directory></a></code> for
44cc98a76a4aa7f141f449f58a3f624216869413bjha description of how regular expressions are mixed in with normal
44cc98a76a4aa7f141f449f58a3f624216869413bjh<li><a href="/sections.html">How <Directory>, <Location> and
44cc98a76a4aa7f141f449f58a3f624216869413bjh<Files> sections work</a> for an explanation of how these different
44cc98a76a4aa7f141f449f58a3f624216869413bjhsections are combined when a request is received</li>
a82f3df0084c489a8ceb840c289fbad4e8fca106bjh<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a></h2>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory that forms the main document tree visible
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
ffba30a2a49b298bfa65151bdf61ce3e3d4636d1manoj<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>This directive sets the directory from which <code class="program"><a href="/programs/httpd.html">httpd</a></code>
2d2eda71267231c2526be701fe655db125852c1ffielding 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
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb path from the requested URL to the document root to make the
2d2eda71267231c2526be701fe655db125852c1ffielding path to the document. Example:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <pre class="prettyprint lang-config">DocumentRoot "/usr/web"</pre>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>then an access to
2d2eda71267231c2526be701fe655db125852c1ffielding <code>http://my.example.com/index.html</code> refers to
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb <code>/usr/web/index.html</code>. If the <var>directory-path</var> is
2d2eda71267231c2526be701fe655db125852c1ffielding not absolute then it is assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The <code class="directive">DocumentRoot</code> should be specified without
2d2eda71267231c2526be701fe655db125852c1ffielding a trailing slash.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><a href="/urlmapping.html#documentroot">Mapping URLs to Filesystem
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbb<div class="directive-section"><h2><a name="Else" id="Else"><Else></a> <a name="else" id="else">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if the condition of a
404e2e1f8ad30c2d996f5fb6b3a9a4a4a14a004brbbprevious <code class="directive"><a href="#if"><If></a></code> or
2d2eda71267231c2526be701fe655db125852c1ffielding<code class="directive"><a href="#elseif"><ElseIf></a></code> section is not
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Else> ... </Else></code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The <code class="directive"><Else></code> applies the enclosed
2d2eda71267231c2526be701fe655db125852c1ffielding directives if and only if the most recent
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><ElseIf></code> section
2d2eda71267231c2526be701fe655db125852c1ffielding in the same scope has not been applied.
2d2eda71267231c2526be701fe655db125852c1ffielding For example: In </p>
2d2eda71267231c2526be701fe655db125852c1ffielding<If "-z req('Host')">
2d2eda71267231c2526be701fe655db125852c1ffielding<Else>
50486fceda867c0bb0223d9548c7c1c9b194259dfielding</Else>
2d2eda71267231c2526be701fe655db125852c1ffielding <p> The <code class="directive"><If></code> would match HTTP/1.0
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><Else></code> would match requests
2d2eda71267231c2526be701fe655db125852c1ffielding<li><code class="directive"><a href="#if"><If></a></code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><code class="directive"><a href="#elseif"><ElseIf></a></code></li>
2d2eda71267231c2526be701fe655db125852c1ffielding<li><a href="/sections.html">How <Directory>, <Location>,
2d2eda71267231c2526be701fe655db125852c1ffielding <Files> sections work</a> for an explanation of how these
2d2eda71267231c2526be701fe655db125852c1ffielding different sections are combined when a request is received.
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><Else></code> are applied last.</li>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2d2eda71267231c2526be701fe655db125852c1ffielding<div class="directive-section"><h2><a name="ElseIf" id="ElseIf"><ElseIf></a> <a name="elseif" id="elseif">Directive</a></h2>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is satisfied
2d2eda71267231c2526be701fe655db125852c1ffieldingby a request at runtime while the condition of a previous
2d2eda71267231c2526be701fe655db125852c1ffielding<code class="directive"><a href="#if"><If></a></code> or
2d2eda71267231c2526be701fe655db125852c1ffielding<code class="directive"><ElseIf></code> section is not
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><ElseIf <var>expression</var>> ... </ElseIf></code></td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>The <code class="directive"><ElseIf></code> applies the enclosed
2d2eda71267231c2526be701fe655db125852c1ffielding directives if and only if both the given condition evaluates to true and
2d2eda71267231c2526be701fe655db125852c1ffielding the most recent <code class="directive"><If></code> or
2d2eda71267231c2526be701fe655db125852c1ffielding <code class="directive"><ElseIf></code> section in the same scope has
2d2eda71267231c2526be701fe655db125852c1ffielding not been applied. For example: In </p>
2d2eda71267231c2526be701fe655db125852c1ffielding<ElseIf "-R '10.0.0.0/8'">
0a09a4a642f7c0d367598394411dbdd4a6d8cd09fielding</ElseIf>
2d2eda71267231c2526be701fe655db125852c1ffielding<Else>
2d2eda71267231c2526be701fe655db125852c1ffielding</Else>
<div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use memory-mapping to read files during delivery</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableMMAP On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<p>This directive controls whether the <code class="program"><a href="/programs/httpd.html">httpd</a></code> may use
server-parsed file using <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> -- Apache httpd
<li>Deleting or truncating a file while <code class="program"><a href="/programs/httpd.html">httpd</a></code>
has it memory-mapped can cause <code class="program"><a href="/programs/httpd.html">httpd</a></code> to
<div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the kernel sendfile support to deliver files to the client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableSendfile Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in version 2.0.44 and later. Default changed to Off in
<p>This directive controls whether <code class="program"><a href="/programs/httpd.html">httpd</a></code> may use the
<li>With a network-mounted <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (e.g., NFS, SMB, CIFS, FUSE),
<div class="directive-section"><h2><a name="Error" id="Error">Error</a> <a name="error" id="error">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Abort configuration parsing with a custom error message</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Error <var>message</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.3.9 and later</td></tr>
<div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>What the server will return to the client
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>error-code</var> <var>document</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
ErrorDocument 500 http://foo.example.com/cgi-bin/tester
ErrorDocument 401 /subscription_info.html
Microsoft Knowledge Base article <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
<code class="directive"><a href="/mod/mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></code> so that you can provide
<div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location where the server will log errors</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLog <var>file-path</var>|syslog[:<var>facility</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a> <a name="errorlogformat" id="errorlogformat">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Format specification for error log entries</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLogFormat [connection|request] <var>format</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.3.9 and later</td></tr>
<code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code>, to allow to correlate access log entries
with error log lines. If <code class="module"><a href="/mod/mod_unique_id.html">mod_unique_id</a></code> is loaded, its
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
[Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico
#Example (similar to the 2.2.x format)
<div class="directive-section"><h2><a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keep track of extended status information for each
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ExtendedStatus On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ExtendedStatus Off[*]</code></td></tr>
<code class="module"><a href="/mod/mod_status.html">mod_status</a></code>. Note that other modules may
<p>Note that loading <code class="module"><a href="/mod/mod_status.html">mod_status</a></code> will change
The default is changed by <code class="module"><a href="/mod/mod_status.html">mod_status</a></code> beginning
<div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File attributes used to create the ETag
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FileETag <var>component</var> ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>FileETag 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>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>The default used to be "INode MTime Size" in 2.3.14 and
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>MTime Size</code>
An ETag is not generated for responses parsed by <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>,
<div class="directive-section"><h2><a name="Files" id="Files"><Files></a> <a name="files" id="files">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to matched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Files <var>filename</var>> ... </Files></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
<code>.htaccess</code> files are read, but before <code class="directive"><a href="#location"><Location></a></code> sections. Note
inside <code class="directive"><a href="#directory"><Directory></a></code> sections to restrict the
<Files "cat.html">
# Insert stuff that applies to cat.html here
<p>would match most common Internet graphics formats. <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> is preferred,
<p>Note that unlike <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#location"><Location></a></code> sections, <code class="directive"><Files></code> sections can be used inside
<div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a> <a name="filesmatch" id="filesmatch">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to regular-expression matched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
does. However, it accepts a <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular
<div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be served with the specified
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForceType <var>media-type</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Moved to the core in Apache httpd 2.0</td></tr>
associations defined in mime.types or via the
<div class="directive-section"><h2><a name="GprofDir" id="GprofDir">GprofDir</a> <a name="gprofdir" id="gprofdir">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory to write gmon.out profiling data to. </td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>GprofDir <var>/tmp/gprof/</var>|<var>/tmp/gprof/</var>%</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<p>This directive currently only works with the <code class="module"><a href="/mod/prefork.html">prefork</a></code>
<div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables DNS lookups on client IP addresses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>HostnameLookups Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<p>Regardless of the setting, when <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> is
amounts of time. The utility <code class="program"><a href="/programs/logresolve.html">logresolve</a></code>, compiled by
<div class="directive-section"><h2><a name="If" id="If"><If></a> <a name="if" id="if">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><If <var>expression</var>> ... </If></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<pre class="prettyprint lang-config"><If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"></pre>
<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>|<var>wildcard</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Wildcard matching available in 2.0.41 and later, directory
<code class="program"><a href="/programs/httpd.html">httpd</a></code> to fail. Instead, we encourage you to use the
<p>Or, providing paths relative to your <code class="directive"><a href="#serverroot">ServerRoot</a></code> directory:</p>
<div class="directive-section"><h2><a name="IncludeOptional" id="IncludeOptional">IncludeOptional</a> <a name="includeoptional" id="includeoptional">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>IncludeOptional <var>file-path</var>|<var>directory-path</var>|<var>wildcard</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in 2.3.6 and later</td></tr>
<div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables HTTP persistent connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAlive On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>KeepAlive On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
as a single "request" for the <code class="directive"><a href="/mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> directive, regardless
<div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for subsequent
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAliveTimeout <var>num</var>[ms]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Specifying a value in milliseconds is available in
<div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a> <a name="limit" id="limit">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict enclosed access controls to only certain HTTP
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Limit <var>method</var> [<var>method</var>] ... > ...
restrictions that are enclosed in the <code class="directive"><Limit></code> bracket <strong>will have no
<div class="warning">A <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section should always be
section when restricting access, since a <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section provides protection
<code class="directive"><Limit></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> directives must
the <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code> directive,
note that the first <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>
<code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code> directives.</div>
<div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a> <a name="limitexcept" id="limitexcept">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access controls to all HTTP methods
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LimitExcept <var>method</var> [<var>method</var>] ... > ...
i.e., it is the opposite of a <code class="directive"><a href="#limit"><Limit></a></code> section and can be used to control
documentation for <code class="directive"><a href="#limit"><Limit></a></code> for more details.</p>
<div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine maximum number of internal redirects and nested
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitInternalRecursion <var>number</var> [<var>number</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.0.47 and later</td></tr>
<p>An internal redirect happens, for example, when using the <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> directive, which internally
For example, <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> uses subrequests to look for the
files listed in the <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
<div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restricts the total size of the HTTP request body sent
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestBody 0</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
proxy requests, see the <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> documentation.</p>
<div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of HTTP request header fields that
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFields <var>number</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestFields 100</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of the HTTP request header allowed from the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFieldSize <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit the size of the HTTP request line that will be accepted
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of an XML-based request body</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitXMLRequestBody <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="Location" id="Location"><Location></a> <a name="location" id="location">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to matching
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<code></Location></code> directive. <code class="directive"><Location></code> sections are processed in the
order they appear in the configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
<code>.htaccess</code> files are read, and after the <code class="directive"><a href="#files"><Files></a></code> sections.</p>
content that lives in the filesystem, use <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#files"><Files></a></code>. An exception is
or <code>/special/data</code>. The directive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> behaves
identical to the regex version of <code class="directive"><Location></code>, and is preferred, for the
Require host example.com
directive and the regex version of <code class="directive"><Location></code> require you to explicitly specify multiple
//abc</code>. The (non-regex) <code class="directive"><Location></code> directive behaves similarly when used for
proxy requests. But when (non-regex) <code class="directive"><Location></code> is used for non-proxy requests it will
<div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a> <a name="locationmatch" id="locationmatch">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to regular-expression
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
it takes a <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular expression</a>
<div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the verbosity of the ErrorLog</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel [<var>module</var>:]<var>level</var>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LogLevel warn</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Per-module and per-directory configuration is available in
messages recorded in the error logs (see <code class="directive"><a href="#errorlog">ErrorLog</a></code> directive). The following
LogLevel info mod_ssl.c:warn
<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="MaxRangeOverlaps" id="MaxRangeOverlaps">MaxRangeOverlaps</a> <a name="maxrangeoverlaps" id="maxrangeoverlaps">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of overlapping ranges (eg: <code>100-200,150-300</code>) allowed before returning the complete
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxRangeOverlaps default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxRangeOverlaps 20</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>Available in Apache HTTP Server 2.3.15 and later</td></tr>
<div class="directive-section"><h2><a name="MaxRangeReversals" id="MaxRangeReversals">MaxRangeReversals</a> <a name="maxrangereversals" id="maxrangereversals">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of range reversals (eg: <code>100-200,50-70</code>) allowed before returning the complete
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxRangeReversals default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxRangeReversals 20</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>Available in Apache HTTP Server 2.3.15 and later</td></tr>
<div class="directive-section"><h2><a name="MaxRanges" id="MaxRanges">MaxRanges</a> <a name="maxranges" id="maxranges">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of ranges allowed before returning the complete
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxRanges default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxRanges 200</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>Available in Apache HTTP Server 2.3.15 and later</td></tr>
<div class="directive-section"><h2><a name="Mutex" id="Mutex">Mutex</a> <a name="mutex" id="mutex">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures mutex mechanism and lock file directory for all
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Mutex <var>mechanism</var> [default|<var>mutex-name</var>] ... [OmitPID]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Mutex default</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.3.4 and later</td></tr>
by <a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a> has a functional or performance
<a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a>. The default locking implementation can
be displayed by running <code class="program"><a href="/programs/httpd.html">httpd</a></code> with the
all CGIs, unless you use something like <code class="program"><a href="/programs/suexec.html">suexec</a></code>
underlying platform and <a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a> support it. Mechanisms
<td><code class="module"><a href="/mod/prefork.html">prefork</a></code> and <code class="module"><a href="/mod/worker.html">worker</a></code> MPMs</td>
<div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>DEPRECATED: 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 FollowSymlinks</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>The default was changed from All to FollowSymlinks in 2.3.11</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
anywhere other than <code class="directive"><a href="#directory"><Directory></a></code>, as <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code>
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="Protocol" id="Protocol">Protocol</a> <a name="protocol" id="protocol">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocol for a listening socket</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Protocol <var>protocol</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.1.5 and later.
<p>You only need to set the protocol if you are running on non-standard ports, otherwise <code>http</code> is assumed for port 80 and <code>https</code> for port 443.</p>
<p>For example, if you are running <code>https</code> on a non-standard port, specify the protocol explicitly:</p>
<p>You can also specify the protocol using the <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code> directive.</p>
<div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the CPU consumption of processes launched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the memory consumption of processes launched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of processes that can be launched by
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
Registry</code> with <code class="directive"><a href="/mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories, because
<div class="directive-section"><h2><a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine if mod_status displays the first 63 characters
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SeeRequestTail On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SeeRequestTail Off</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache httpd 2.2.7 and later.</td></tr>
<p>If Apache httpd is handling <code>GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1</code> mod_status displays as follows:
<div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Email address that the server includes in error
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAdmin <var>email-address</var>|<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate names for a host used when matching requests
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr>
alternate names for a host, for use with <a href="/vhosts/name-based.html">name-based virtual hosts</a>. The
ServerName server.example.com
ServerAlias server server2.example.com server2
ServerAlias *.example.com
<p>Name-based virtual hosts for the best-matching set of <code class="directive"><a href="#virtualhost"><virtualhost></a></code>s are processed
in the order they appear in the configuration. The first matching <code class="directive"><a href="#servername">ServerName</a></code> or <code class="directive"><a href="#serveralias">ServerAlias</a></code> is used, with no different precedence for wildcards
<div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Hostname and port that the server uses to identify
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerName [<var>scheme</var>://]<var>fully-qualified-domain-name</var>[:<var>port</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
identify a virtual host, when using <a href="/vhosts/name-based.html">name-based virtual hosts</a>.</p>
<code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> directives for
settings which determine whether self-referential URLs (e.g., by the
httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Legacy URL pathname for a name-based virtual host that
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr>
<div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server installation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
paths in other configuration directives (such as <code class="directive"><a href="#include">Include</a></code> or <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>, for example) are taken as
<div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the footer on server-generated documents</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerSignature Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
documents (error messages, <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> ftp directory
listings, <code class="module"><a href="/mod/mod_info.html">mod_info</a></code> output, ...). The reason why you
server version number and <code class="directive"><a href="#servername">ServerName</a></code> of the serving virtual host,
"mailto:" reference to the <code class="directive"><a href="#serveradmin">ServerAdmin</a></code> of the referenced
presented are controlled by the <code class="directive"><a href="#servertokens">ServerTokens</a></code> directive.</p>
<div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the <code>Server</code> HTTP response
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerTokens Full</code></td></tr>
information presented by the <code class="directive"><a href="#serversignature">ServerSignature</a></code> directive.</p>
<div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be processed by a
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetHandler <var>handler-name</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Moved into the core in Apache httpd 2.0</td></tr>
<div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process client requests and POST
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process responses from the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TimeOut <var>seconds</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TimeOut 60</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 behavior on <code>TRACE</code> requests</td></tr>
<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#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 HTTP Server 1.3.34, 2.0.55 and later</td></tr>
the core server and <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. The default
<code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> to return a <code>405</code> (Method not
<div class="directive-section"><h2><a name="UnDefine" id="UnDefine">UnDefine</a> <a name="undefine" id="undefine">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Undefine the existence of a variable</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UnDefine <var>parameter-name</var></code></td></tr>
of passing a <code>-D</code> argument to <code class="program"><a href="/programs/httpd.html">httpd</a></code>.</p>
<p>This directive can be used to toggle the use of <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sections without needing to alter
<div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own name and
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>UseCanonicalName Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
for <code>www.example.com</code> -- see <a href="http://wiki.apache.org/httpd/FAQ#Why_does_Apache_ask_for_my_password_twice_before_serving_a_file.3F">
<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 port</td></tr>
<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
ServerName host.example.com
ServerName host.example.com
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> |
</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/core.html';
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://c.apaste.info/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
<p class="apache">Copyright 2012 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--