core.html.en revision 7d99d1b670fcd68eff2ec9016d003646214226a8
d24d4c5159bcb11c25bb294926cfe7105c789ea9slive<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
e942c741056732f50da2074b36fe59805d370650slive<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd This file is generated from xml source: DO NOT EDIT
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<link href="/images/favicon.ico" rel="shortcut icon" /></head>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<p><span>Available Languages: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
88f76f668542dcd72fc9d71577997967c6bf123bslive<a href="/en/mod/core.html" title="English"> en </a> |
88f76f668542dcd72fc9d71577997967c6bf123bslive<a href="/ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
88f76f668542dcd72fc9d71577997967c6bf123bslive<a href="/tr/mod/core.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
88f76f668542dcd72fc9d71577997967c6bf123bslive<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Core Apache HTTP Server features that are always
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Core</td></tr></table>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div id="quickview"><h3 class="directives">Directives</h3>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#define">Define</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#directory"><Directory></a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
ed213de6d7481be782a20ecc2675bc57fd4fac69slive<li><img alt="" src="/images/down.gif" /> <a href="#fileetag">FileETag</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#files"><Files></a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
38677582e6ddf26e810728a68cbe560345486e48slive<li><img alt="" src="/images/down.gif" /> <a href="#forcetype">ForceType</a></li>
38677582e6ddf26e810728a68cbe560345486e48slive<li><img alt="" src="/images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
38677582e6ddf26e810728a68cbe560345486e48slive<li><img alt="" src="/images/down.gif" /> <a href="#if"><If></a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#include">Include</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limit"><Limit></a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#location"><Location></a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#options">Options</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#servername">ServerName</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#timeout">TimeOut</a></li>
7647551a51db086eef1f5b651b2d6f174dffb8b3slive<li><img alt="" src="/images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a></h2>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures optimizations for a Protocol's Listener Sockets</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
67a715b4352c3e25bff32fccad48350180393f5end<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
67a715b4352c3e25bff32fccad48350180393f5end<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.1.5 and later</td></tr>
67a715b4352c3e25bff32fccad48350180393f5end <p>This directive enables operating system specific optimizations for a
67a715b4352c3e25bff32fccad48350180393f5end listening socket by the Protocol type. The basic premise is for the
67a715b4352c3e25bff32fccad48350180393f5end kernel to not send a socket to the server process until either data
88f76f668542dcd72fc9d71577997967c6bf123bslive is received or an entire HTTP Request is buffered. Only
88f76f668542dcd72fc9d71577997967c6bf123bslive <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&sektion=9">
88f76f668542dcd72fc9d71577997967c6bf123bslive FreeBSD's Accept Filters</a> and Linux's more primitive
88f76f668542dcd72fc9d71577997967c6bf123bslive <code>TCP_DEFER_ACCEPT</code> are currently supported.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive AcceptFilter http httpready <br />
88f76f668542dcd72fc9d71577997967c6bf123bslive AcceptFilter https dataready
0dd298aa254f43fc223b1cc41e79d4a1fec308bcnd <p>The <code>httpready</code> accept filter buffers entire HTTP requests at
0dd298aa254f43fc223b1cc41e79d4a1fec308bcnd the kernel level. Once an entire request is received, the kernel then
0dd298aa254f43fc223b1cc41e79d4a1fec308bcnd sends it to the server. See the
88f76f668542dcd72fc9d71577997967c6bf123bslive <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&sektion=9">
0dd298aa254f43fc223b1cc41e79d4a1fec308bcnd accf_http(9)</a> man page for more details. Since HTTPS requests are
88f76f668542dcd72fc9d71577997967c6bf123bslive encrypted only the <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&sektion=9">
52ebee778263c25c1b366f5e296d3f973fcb7aband AcceptFilter http data <br />
0287d5784a0533920978a7eb8f3cdeace17b467arbowen AcceptFilter https data
2348633f2de9e8a3228db792f189d8b6ffdfdafand <p>Linux's <code>TCP_DEFER_ACCEPT</code> does not support buffering http
2348633f2de9e8a3228db792f189d8b6ffdfdafand requests. Any value besides <code>none</code> will enable
2348633f2de9e8a3228db792f189d8b6ffdfdafand <code>TCP_DEFER_ACCEPT</code> on that listener. For more details
2348633f2de9e8a3228db792f189d8b6ffdfdafand see the Linux
2348633f2de9e8a3228db792f189d8b6ffdfdafand <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html">
0287d5784a0533920978a7eb8f3cdeace17b467arbowen <p>Using <code>none</code> for an argument will disable any accept filters
0287d5784a0533920978a7eb8f3cdeace17b467arbowen for that protocol. This is useful for protocols that require a server
88f76f668542dcd72fc9d71577997967c6bf123bslive <div class="example"><p><code>AcceptFilter nntp none</code></p></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a></h2>
67a715b4352c3e25bff32fccad48350180393f5end<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Resources accept trailing pathname information</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.30 and later</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>This directive controls whether requests that contain trailing
88f76f668542dcd72fc9d71577997967c6bf123bslive pathname information that follows an actual filename (or
88f76f668542dcd72fc9d71577997967c6bf123bslive non-existent file in an existing directory) will be accepted or
67a715b4352c3e25bff32fccad48350180393f5end rejected. The trailing pathname information can be made
67a715b4352c3e25bff32fccad48350180393f5end available to scripts in the <code>PATH_INFO</code> environment
67a715b4352c3e25bff32fccad48350180393f5end variable.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>For example, assume the location <code>/test/</code> points to
88f76f668542dcd72fc9d71577997967c6bf123bslive a directory that contains only the single file
67a715b4352c3e25bff32fccad48350180393f5end <p>The three possible arguments for the
67a715b4352c3e25bff32fccad48350180393f5end <code class="directive">AcceptPathInfo</code> directive are:</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <dt><code>Off</code></dt><dd>A request will only be accepted if it
88f76f668542dcd72fc9d71577997967c6bf123bslive maps to a literal path that exists. Therefore a request with
88f76f668542dcd72fc9d71577997967c6bf123bslive trailing pathname information after the true filename such as
88f76f668542dcd72fc9d71577997967c6bf123bslive <code>/test/here.html/more</code> in the above example will return
88f76f668542dcd72fc9d71577997967c6bf123bslive a 404 NOT FOUND error.</dd>
67a715b4352c3e25bff32fccad48350180393f5end <dt><code>On</code></dt><dd>A request will be accepted if a
88f76f668542dcd72fc9d71577997967c6bf123bslive leading path component maps to a file that exists. The above
88f76f668542dcd72fc9d71577997967c6bf123bslive example <code>/test/here.html/more</code> will be accepted if
67a715b4352c3e25bff32fccad48350180393f5end <dt><code>Default</code></dt><dd>The treatment of requests with
67a715b4352c3e25bff32fccad48350180393f5end trailing pathname information is determined by the <a href="/handler.html">handler</a> responsible for the request.
67a715b4352c3e25bff32fccad48350180393f5end The core handler for normal files defaults to rejecting
88f76f668542dcd72fc9d71577997967c6bf123bslive <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
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>The primary purpose of the <code>AcceptPathInfo</code>
88f76f668542dcd72fc9d71577997967c6bf123bslive directive is to allow you to override the handler's choice of
88f76f668542dcd72fc9d71577997967c6bf123bslive accepting or rejecting <code>PATH_INFO</code>. This override is required,
04c83c4f6de6e7b087addba0377d998d2394699arbowen for example, when you use a <a href="/filter.html">filter</a>, such
04c83c4f6de6e7b087addba0377d998d2394699arbowen as <a href="mod_include.html">INCLUDES</a>, to generate content
0dd298aa254f43fc223b1cc41e79d4a1fec308bcnd based on <code>PATH_INFO</code>. The core handler would usually reject
88f76f668542dcd72fc9d71577997967c6bf123bslive the request, so you can use the following configuration to enable
88f76f668542dcd72fc9d71577997967c6bf123bslive such a script:</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive Options +Includes<br />
88f76f668542dcd72fc9d71577997967c6bf123bslive SetOutputFilter INCLUDES<br />
88f76f668542dcd72fc9d71577997967c6bf123bslive AcceptPathInfo On<br />
88f76f668542dcd72fc9d71577997967c6bf123bslive </Files>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a></h2>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the distributed configuration file</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>While processing a request the server looks for
88f76f668542dcd72fc9d71577997967c6bf123bslive the first existing configuration file from this list of names in
67a715b4352c3e25bff32fccad48350180393f5end every directory of the path to the document, if distributed
88f76f668542dcd72fc9d71577997967c6bf123bslive configuration files are <a href="#allowoverride">enabled for that
67a715b4352c3e25bff32fccad48350180393f5end AccessFileName .acl
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>before returning the document
bd63a8c7b38d0af10e7c9d891a245913daabd352rbowen <code>/usr/local/web/index.html</code>, the server will read
67a715b4352c3e25bff32fccad48350180393f5end <code>/usr/local/.acl</code> and <code>/usr/local/web/.acl</code>
67a715b4352c3e25bff32fccad48350180393f5end for directives, unless they have been disabled with</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <Directory /><br />
88f76f668542dcd72fc9d71577997967c6bf123bslive AllowOverride None<br />
88f76f668542dcd72fc9d71577997967c6bf123bslive </Directory>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><a href="/configuring.html">Configuration Files</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a></h2>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default charset parameter to be added when a response
88f76f668542dcd72fc9d71577997967c6bf123bslivecontent-type is <code>text/plain</code> or <code>text/html</code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
67a715b4352c3e25bff32fccad48350180393f5end<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
67a715b4352c3e25bff32fccad48350180393f5end<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
67a715b4352c3e25bff32fccad48350180393f5end<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>This directive specifies a default value for the media type
88f76f668542dcd72fc9d71577997967c6bf123bslive charset parameter (the name of a character encoding) to be added
88f76f668542dcd72fc9d71577997967c6bf123bslive to a response if and only if the response's content-type is either
88f76f668542dcd72fc9d71577997967c6bf123bslive <code>text/plain</code> or <code>text/html</code>. This should override
88f76f668542dcd72fc9d71577997967c6bf123bslive any charset specified in the body of the response via a <code>META</code>
88f76f668542dcd72fc9d71577997967c6bf123bslive element, though the exact behavior is often dependent on the user's client
88f76f668542dcd72fc9d71577997967c6bf123bslive configuration. A setting of <code>AddDefaultCharset Off</code>
67a715b4352c3e25bff32fccad48350180393f5end disables this functionality. <code>AddDefaultCharset On</code> enables
88f76f668542dcd72fc9d71577997967c6bf123bslive a default charset of <code>iso-8859-1</code>. Any other value is assumed
88f76f668542dcd72fc9d71577997967c6bf123bslive to be the <var>charset</var> to be used, which should be one of the
88f76f668542dcd72fc9d71577997967c6bf123bslive <a href="http://www.iana.org/assignments/character-sets">IANA registered
88f76f668542dcd72fc9d71577997967c6bf123bslive charset values</a> for use in MIME media types.
88f76f668542dcd72fc9d71577997967c6bf123bslive For example:</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive AddDefaultCharset utf-8
88f76f668542dcd72fc9d71577997967c6bf123bslive <p><code class="directive">AddDefaultCharset</code> should only be used when all
88f76f668542dcd72fc9d71577997967c6bf123bslive of the text resources to which it applies are known to be in that
88f76f668542dcd72fc9d71577997967c6bf123bslive character encoding and it is too inconvenient to label their charset
88f76f668542dcd72fc9d71577997967c6bf123bslive individually. One such example is to add the charset parameter
88f76f668542dcd72fc9d71577997967c6bf123bslive to resources containing generated content, such as legacy CGI
67a715b4352c3e25bff32fccad48350180393f5end scripts, that might be vulnerable to cross-site scripting attacks
88f76f668542dcd72fc9d71577997967c6bf123bslive due to user-provided data being included in the output. Note, however,
88f76f668542dcd72fc9d71577997967c6bf123bslive that a better solution is to just fix (or delete) those scripts, since
88f76f668542dcd72fc9d71577997967c6bf123bslive setting a default charset does not protect users that have enabled
88f76f668542dcd72fc9d71577997967c6bf123bslive the "auto-detect character encoding" feature on their browser.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive<li><code class="directive"><a href="/mod/mod_mime.html#addcharset">AddCharset</a></code></li>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
88f76f668542dcd72fc9d71577997967c6bf123bslive<div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directive</a></h2>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>assigns an output filter to a particular MIME-type</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilterByType <var>filter</var>[;<var>filter</var>...]
67a715b4352c3e25bff32fccad48350180393f5end<var>MIME-type</var> [<var>MIME-type</var>] ...</code></td></tr>
67a715b4352c3e25bff32fccad48350180393f5end<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.33 and later; deprecated in Apache 2.1 and later</td></tr>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>This directive activates a particular output <a href="/filter.html">filter</a> for a request depending on the
88f76f668542dcd72fc9d71577997967c6bf123bslive response <a class="glossarylink" href="/glossary.html#mime-type" title="see glossary">MIME-type</a>. Because of certain
88f76f668542dcd72fc9d71577997967c6bf123bslive problems discussed below, this directive is deprecated. The same
88f76f668542dcd72fc9d71577997967c6bf123bslive functionality is available using <code class="module"><a href="/mod/mod_filter.html">mod_filter</a></code>.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>The following example uses the <code>DEFLATE</code> filter, which
88f76f668542dcd72fc9d71577997967c6bf123bslive is provided by <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code>. It will compress all
88f76f668542dcd72fc9d71577997967c6bf123bslive output (either static or dynamic) which is labeled as
67a715b4352c3e25bff32fccad48350180393f5end <code>text/html</code> or <code>text/plain</code> before it is sent
67a715b4352c3e25bff32fccad48350180393f5end to the client.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>If you want the content to be processed by more than one filter, their
88f76f668542dcd72fc9d71577997967c6bf123bslive names have to be separated by semicolons. It's also possible to use one
88f76f668542dcd72fc9d71577997967c6bf123bslive <code class="directive">AddOutputFilterByType</code> directive for each of
88f76f668542dcd72fc9d71577997967c6bf123bslive these filters.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>The configuration below causes all script output labeled as
67a715b4352c3e25bff32fccad48350180393f5end <code>INCLUDES</code> filter and then by the <code>DEFLATE</code>
88f76f668542dcd72fc9d71577997967c6bf123bslive filter.</p>
88f76f668542dcd72fc9d71577997967c6bf123bslive <Location /cgi-bin/><br />
88f76f668542dcd72fc9d71577997967c6bf123bslive Options Includes<br />
88f76f668542dcd72fc9d71577997967c6bf123bslive AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
88f76f668542dcd72fc9d71577997967c6bf123bslive </Location>
67a715b4352c3e25bff32fccad48350180393f5end <p>Enabling filters with <code class="directive">AddOutputFilterByType</code>
67a715b4352c3e25bff32fccad48350180393f5end may fail partially or completely in some cases. For example, no
67a715b4352c3e25bff32fccad48350180393f5end filters are applied if the <a class="glossarylink" href="/glossary.html#mime-type" title="see glossary">MIME-type</a> could not be determined and falls
67a715b4352c3e25bff32fccad48350180393f5end back to the <code class="directive"><a href="#defaulttype">DefaultType</a></code> setting,
88f76f668542dcd72fc9d71577997967c6bf123bslive even if the <code class="directive"><a href="#defaulttype">DefaultType</a></code> is the
88f76f668542dcd72fc9d71577997967c6bf123bslive <p>However, if you want to make sure, that the filters will be
88f76f668542dcd72fc9d71577997967c6bf123bslive applied, assign the content type to a resource explicitly, for
<li><code class="directive"><a href="/mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
<div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether encoded path separators in URLs are allowed to
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.46 and later</td></tr>
<div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types of directives that are allowed in
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>directive-type</var>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowOverride All</code></td></tr>
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
Allow use of the authorization directives (<code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
<code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
<code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
<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>
Allow use of the directives controlling document types (<code class="directive"><a href="#defaulttype">DefaultType</a></code>, <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="/mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
<code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, and
directives, <em>etc.</em>), 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>),
<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
(<code class="directive"><a href="/mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
<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>,
<code class="directive"><a href="/mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#fancyindexing">FancyIndexing</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#readmename">ReadmeName</a></code>,
Allow use of the directives controlling host access (<code class="directive"><a href="/mod/mod_authz_host.html#allow">Allow</a></code>, <code class="directive"><a href="/mod/mod_authz_host.html#deny">Deny</a></code> and <code class="directive"><a href="/mod/mod_authz_host.html#order">Order</a></code>).</dd>
separated lists of options that may be set using the <code class="directive"><a href="#options">Options</a></code> command.</dd>
<div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">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>CGIMapExtension <var>cgi-path</var> <var>.extension</var></code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>NetWare only</td></tr>
<div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables the generation of <code>Content-MD5</code> HTTP Response
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ContentDigest On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ContentDigest Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
by the <code class="module"><a href="/mod/core.html">core</a></code>, and not by any module. For example,
<div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>MIME content-type that will be sent if the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>MIME-type|none</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DefaultType text/plain</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 argument <code>none</code> is available in Apache 2.2.7 and later</td></tr>
document whose type cannot be determined by its <a class="glossarylink" href="/glossary.html#mime-type" title="see glossary">MIME types</a> mappings.</p>
the administrator (e.g. a proxy), it is preferable to omit the MIME
<p>Note that unlike <code class="directive"><a href="#forcetype">ForceType</a></code>, this directive only
<div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the existence of a variable</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Define <var>parameter-name</var></code></td></tr>
<p>Equivalent to passing the <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="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that apply only to the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Directory <var>directory-path</var>>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
first, interspersed with the directives from the <a href="#accessfilename">.htaccess</a> files. For example,
<em>want</em> accessible. See the <a href="/misc/security_tips.html">Security Tips</a> page for more
cannot nest, and cannot appear in a <code class="directive"><a href="#limit"><Limit></a></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section.</p>
<div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose directives that apply to
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><DirectoryMatch <var>regex</var>>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
sub-directories of that directory, the same as <code class="directive"><a href="#directory"><Directory></a></code>. However, it
takes as an argument a <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular
<div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory that forms the main document tree visible
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<p>This directive sets the directory from which <code class="program"><a href="/programs/httpd.html">httpd</a></code>
will serve files. Unless matched by a directive like <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code>, the server appends the
not absolute then it is assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
<div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use memory-mapping to read files during delivery</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableMMAP On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<p>This directive controls whether the <code class="program"><a href="/programs/httpd.html">httpd</a></code> may use
server-parsed file using <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> -- Apache
the <code class="program"><a href="/programs/httpd.html">httpd</a></code> may crash due to a segmentation fault if a file
is deleted or truncated while the <code class="program"><a href="/programs/httpd.html">httpd</a></code> has it
<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 On</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</td></tr>
<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 or SMB),
<div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>What the server will return to the client
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>error-code</var> <var>document</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Quoting syntax for text messages is different in Apache
Microsoft Knowledge Base article <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
<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="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File attributes used to create the ETag
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FileETag <var>component</var> ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
enabled and use <code class="module"><a href="/mod/mod_dav_fs.html">mod_dav_fs</a></code> as a storage provider.
<code class="module"><a href="/mod/mod_dav_fs.html">mod_dav_fs</a></code> uses <code>INode MTime Size</code>
<div class="directive-section"><h2><a name="Files" id="Files"><Files></a> <a name="files" id="files">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to matched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Files <var>filename</var>> ... </Files></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
<code>.htaccess</code> files are read, but before <code class="directive"><a href="#location"><Location></a></code> sections. Note
inside <code class="directive"><a href="#directory"><Directory></a></code> sections to restrict the
<p>would match most common Internet graphics formats. <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> is preferred,
<p>Note that unlike <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#location"><Location></a></code> sections, <code class="directive"><Files></code> sections can be used inside
<div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a> <a name="filesmatch" id="filesmatch">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to regular-expression matched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
does. However, it accepts a <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular
<div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be served with the specified
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForceType <var>MIME-type</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Moved to the core in Apache 2.0</td></tr>
<div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables DNS lookups on client IP addresses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>HostnameLookups Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<p>Regardless of the setting, when <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> is
amounts of time. The utility <code class="program"><a href="/programs/logresolve.html">logresolve</a></code>, compiled by
<div class="directive-section"><h2><a name="If" id="If"><If></a> <a name="if" id="if">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><If <var>expression</var>> ... </If></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a> <a name="ifdefine" id="ifdefine">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that will be processed only
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfDefine [!]<var>parameter-name</var>> ...
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<p>The <var>test</var> in the <code class="directive"><IfDefine></code> section directive can be one of two forms:</p>
<code class="program"><a href="/programs/httpd.html">httpd</a></code> command line via <code>-D<var>parameter</var>
</code> at the time the server was started or by the <code class="directive"><a href="#define">Define</a></code> directive.</p>
<div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a> <a name="ifmodule" id="ifmodule">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfModule [!]<var>module-file</var>|<var>module-identifier</var>> ...
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Module identifiers are available in version 2.1 and
a specific module. The directives within an <code class="directive"><IfModule></code> section are only processed if the <var>test</var>
<p>The <var>test</var> in the <code class="directive"><IfModule></code> section directive can be one of two forms:</p>
dynamically loaded using <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>. The second format reverses the test,
<div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Includes other configuration files from within
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Include <var>file-path</var>|<var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Wildcard matching available in 2.0.41 and later</td></tr>
files in a directory that can cause <code class="program"><a href="/programs/httpd.html">httpd</a></code> to
<p>Or, providing paths relative to your <code class="directive"><a href="#serverroot">ServerRoot</a></code> directory:</p>
<div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables HTTP persistent connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAlive On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>KeepAlive On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
as a single "request" for the <code class="directive"><a href="/mod/mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></code> directive, regardless
<div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for subsequent
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAliveTimeout <var>num</var>[ms]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Specifying a value in milliseconds is available in
defined virtual host (the default host) in a set of <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> will be used.
<div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a> <a name="limit" id="limit">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict enclosed access controls to only certain HTTP
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Limit <var>method</var> [<var>method</var>] ... > ...
restrictions that are enclosed in the <code class="directive"><Limit></code> bracket <strong>will have no
<div class="warning">A <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section should always be
section when restricting access, since a <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section provides protection
<code class="directive"><Limit></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> directives must
the <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code> directive,
note that the first <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>
<code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code> directives.</div>
<div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a> <a name="limitexcept" id="limitexcept">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access controls to all HTTP methods
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LimitExcept <var>method</var> [<var>method</var>] ... > ...
i.e., it is the opposite of a <code class="directive"><a href="#limit"><Limit></a></code> section and can be used to control
documentation for <code class="directive"><a href="#limit"><Limit></a></code> for more details.</p>
<div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine maximum number of internal redirects and nested
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitInternalRecursion <var>number</var> [<var>number</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.47 and later</td></tr>
<p>An internal redirect happens, for example, when using the <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> directive, which internally
For example, <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> uses subrequests to look for the
files listed in the <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
<div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restricts the total size of the HTTP request body sent
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestBody 0</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of HTTP request header fields that
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFields <var>number</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestFields 100</code></td></tr>
<div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of the HTTP request header allowed from the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFieldSize <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
<div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit the size of the HTTP request line that will be accepted
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
<div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of an XML-based request body</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitXMLRequestBody <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="Location" id="Location"><Location></a> <a name="location" id="location">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to matching
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<code></Location></code> directive. <code class="directive"><Location></code> sections are processed in the
order they appear in the configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
<code>.htaccess</code> files are read, and after the <code class="directive"><a href="#files"><Files></a></code> sections.</p>
content that lives in the filesystem, use <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#files"><Files></a></code>. An exception is
or <code>/special/data</code>. The directive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> behaves
directive and the regex version of <code class="directive"><Location></code> require you to explicitly specify multiple
//abc</code>. The (non-regex) <code class="directive"><Location></code> directive behaves similarly when used for
proxy requests. But when (non-regex) <code class="directive"><Location></code> is used for non-proxy requests it will
<div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a> <a name="locationmatch" id="locationmatch">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to regular-expression
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
it takes a <a class="glossarylink" href="/glossary.html#regex" title="see glossary">regular expression</a>
<div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the verbosity of the ErrorLog</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel <var>level</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LogLevel warn</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
messages recorded in the error logs (see <code class="directive"><a href="#errorlog">ErrorLog</a></code> directive). The following
<div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of requests allowed on a persistent
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxKeepAliveRequests <var>number</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Designates an IP address for name-virtual
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NameVirtualHost <var>addr</var>[:<var>port</var>]</code></td></tr>
<div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures what features are available in a particular
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Options All</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
change the pathname used to match against <code class="directive"><a href="#directory"><Directory></a></code> sections.</p>
Server-side includes provided by <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>
<code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> will return a formatted listing
others are ignored; the options are not merged. (See <a href="/sections.html#mergin">how sections are merged</a>.)
<div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the CPU consumption of processes launched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the memory consumption of processes launched
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of processes that can be launched by
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
Registry</code> with <code class="directive"><a href="/mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories, because
<div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Email address that the server includes in error
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAdmin <var>email-address</var>|<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate names for a host used when matching requests
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr>
alternate names for a host, for use with <a href="/vhosts/name-based.html">name-based virtual hosts</a>. The
<div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Hostname and port that the server uses to identify
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerName [<var>scheme</var>://]<var>fully-qualified-domain-name</var>[:<var>port</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
ServerName www.example.com:80
<code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> directives for
settings which determine whether self-referential URLs (e.g., by the
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Legacy URL pathname for a name-based virtual host that
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr>
<div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server installation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
paths in other configuration directives (such as <code class="directive"><a href="#include">Include</a></code> or <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>, for example) are taken as
<div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the footer on server-generated documents</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerSignature Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
documents (error messages, <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> ftp directory
listings, <code class="module"><a href="/mod/mod_info.html">mod_info</a></code> output, ...). The reason why you
server version number and <code class="directive"><a href="#servername">ServerName</a></code> of the serving virtual host,
"mailto:" reference to the <code class="directive"><a href="#serveradmin">ServerAdmin</a></code> of the referenced
presented are controlled by the <code class="directive"><a href="#servertokens">ServerTokens</a></code> directive.</p>
<div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the <code>Server</code> HTTP response
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerTokens Full</code></td></tr>
information presented by the <code class="directive"><a href="#serversignature">ServerSignature</a></code> directive.</p>
<div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be processed by a
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetHandler <var>handler-name</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Moved into the core in Apache 2.0</td></tr>
<div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process client requests and POST
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process responses from the
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TimeOut <var>seconds</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TimeOut 300</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<li>In <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>, the length of time to wait for
<li>In <code class="module"><a href="/mod/mod_ext_filter.html">mod_ext_filter</a></code>, the length of time to
<li>In <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, the default timeout value if
<div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the behaviour on <code>TRACE</code>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TraceEnable on</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 1.3.34, 2.0.55 and later</td></tr>
the core server and <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. The default
<code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> to return a <code>405</code> (Method not
<div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own name and
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>UseCanonicalName Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
for <code>www.domain.com</code> -- see <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">the
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own name and
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a> <a name="virtualhost" id="virtualhost">Directive</a></h2>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only to a specific
address that matches a <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> directive will use neither
specified inside each <code class="directive"><VirtualHost></code> block. If it is absent, the
<p><span>Available Languages: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div>