<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="vhosts/">Virtual Hosts</a></li><li><a href="dns-caveats.html">DNS Issues</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="overview" id="overview">Overview</a> <a title="Permanent link" href="#overview" class="permalink">¶</a></h2>
+<h2
id="overview">Overview <a title="Permanent link" href="#overview" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="reload" id="reload">Changing Listen configuration on restart</a> <a title="Permanent link" href="#reload" class="permalink">¶</a></h2>
+<h2
id="reload">Changing Listen configuration on restart <a title="Permanent link" href="#reload" class="permalink">¶</a></h2>
<p>When httpd is restarted, special consideration must be made for
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ipv6" id="ipv6">Special IPv6 Considerations</a> <a title="Permanent link" href="#ipv6" class="permalink">¶</a></h2>
+<h2
id="ipv6">Special IPv6 Considerations <a title="Permanent link" href="#ipv6" class="permalink">¶</a></h2>
<p>A growing number of platforms implement IPv6, and
default on FreeBSD, NetBSD, and OpenBSD.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="protocol" id="protocol">Specifying the protocol with Listen</a> <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
+<h2
id="protocol">Specifying the protocol with Listen <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
<p>The optional second <var>protocol</var> argument of
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="virtualhost" id="virtualhost">How This Works With Virtual Hosts</a> <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
+<h2
id="virtualhost">How This Works With Virtual Hosts <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
<p> The <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> directive does not implement
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
+<h2
id="introduction">Introduction <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
<p>The Apache HTTP server offers a range of caching features that
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="http-caching" id="http-caching">Three-state RFC2616 HTTP caching</a> <a title="Permanent link" href="#http-caching" class="permalink">¶</a></h2>
+<h2
id="http-caching">Three-state RFC2616 HTTP caching <a title="Permanent link" href="#http-caching" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Cache Setup Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Cache Setup Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code></li><li><code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code></li><li><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="./mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code></li></ul></td></tr></table>
- <h3><a name="disk" id="disk">Caching to Disk</a></h3>
+ <h3 id="disk">Caching to Disk</h3>
<p>The <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> module relies on specific backend store
leave enough "grow room" following a clean.</p>
- <h3><a name="memcache" id="memcache">Caching to memcached</a></h3>
+ <h3 id="memcache">Caching to memcached</h3>
<p>Using the <code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code> module, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="socache-caching" id="socache-caching">General Two-state Key/Value Shared Object Caching</a> <a title="Permanent link" href="#socache-caching" class="permalink">¶</a></h2>
+<h2
id="socache-caching">General Two-state Key/Value Shared Object Caching <a title="Permanent link" href="#socache-caching" class="permalink">¶</a></h2>
<dd>Shared memory based shared object cache.</dd>
</dl>
- <h3><a name="mod_authn_socache-caching" id="mod_authn_socache-caching">Caching Authentication Credentials</a></h3>
+ <h3 id="mod_authn_socache-caching">Caching Authentication Credentials</h3>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code></li></ul></td></tr></table>
- <h3><a name="mod_ssl-caching" id="mod_ssl-caching">Caching SSL Sessions</a></h3>
+ <h3 id="mod_ssl-caching">Caching SSL Sessions</h3>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="file-caching" id="file-caching">Specialized File Caching</a> <a title="Permanent link" href="#file-caching" class="permalink">¶</a></h2>
+<h2
id="file-caching">Specialized File Caching <a title="Permanent link" href="#file-caching" class="permalink">¶</a></h2>
options can help on systems where access to static files is
slow.</p>
- <h3><a name="filehandle" id="filehandle">File-Handle Caching</a></h3>
+ <h3 id="filehandle">File-Handle Caching</h3>
<p>The act of opening a file can itself be a source of delay, particularly
- <h3><a name="inmemory" id="inmemory">In-Memory Caching</a></h3>
+ <h3 id="inmemory">In-Memory Caching</h3>
<p>Serving directly from system memory is universally the fastest method
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Considerations</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Considerations <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<h3>Authorization and Access Control</h3>
<a href="./tr/caching.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="filter.html">Filters</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="intro" id="intro">Enforcing HTTP Protocol Compliance in Apache 2</a> <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
+<h2
id="intro">Enforcing HTTP Protocol Compliance in Apache 2 <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policyconditional">PolicyConditional</a></code></li><li><code class="directive"><a href="./mod/mod_policy.html#policylength">PolicyLength</a></code></li><li><code class="directive"><a href="./mod/mod_policy.html#policykeepalive">PolicyKeepalive</a></code></li><li><code class="directive"><a href="./mod/mod_policy.html#policytype">PolicyType</a></code></li><li><code class="directive"><a href="./mod/mod_policy.html#policyvary">PolicyVary</a></code></li><li><code class="directive"><a href="./mod/mod_policy.html#policyvalidation">PolicyValidation</a></code></li><li><code class="directive"><a href="./mod/mod_policy.html#policynocache">PolicyNocache</a></code></li><li><code class="directive"><a href="./mod/mod_policy.html#policymaxage">PolicyMaxage</a></code></li><li><code class="directive"><a href="./mod/mod_policy.html#policyversion">PolicyVersion</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policyconditional" id="policyconditional">Conditional Request Policy</a> <a title="Permanent link" href="#policyconditional" class="permalink">¶</a></h2>
+<h2
id="policyconditional">Conditional Request Policy <a title="Permanent link" href="#policyconditional" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policyconditional">PolicyConditional</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policylength" id="policylength">Content-Length Policy</a> <a title="Permanent link" href="#policylength" class="permalink">¶</a></h2>
+<h2
id="policylength">Content-Length Policy <a title="Permanent link" href="#policylength" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policylength">PolicyLength</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policytype" id="policytype">Content-Type Policy</a> <a title="Permanent link" href="#policytype" class="permalink">¶</a></h2>
+<h2
id="policytype">Content-Type Policy <a title="Permanent link" href="#policytype" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policytype">PolicyType</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policykeepalive" id="policykeepalive">Keepalive Policy</a> <a title="Permanent link" href="#policykeepalive" class="permalink">¶</a></h2>
+<h2
id="policykeepalive">Keepalive Policy <a title="Permanent link" href="#policykeepalive" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policykeepalive">PolicyKeepalive</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policymaxage" id="policymaxage">Freshness Lifetime / Maxage Policy</a> <a title="Permanent link" href="#policymaxage" class="permalink">¶</a></h2>
+<h2
id="policymaxage">Freshness Lifetime / Maxage Policy <a title="Permanent link" href="#policymaxage" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policymaxage">PolicyMaxage</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policynocache" id="policynocache">No Cache Policy</a> <a title="Permanent link" href="#policynocache" class="permalink">¶</a></h2>
+<h2
id="policynocache">No Cache Policy <a title="Permanent link" href="#policynocache" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policynocache">PolicyNocache</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policyvalidation" id="policyvalidation">Validation Policy</a> <a title="Permanent link" href="#policyvalidation" class="permalink">¶</a></h2>
+<h2
id="policyvalidation">Validation Policy <a title="Permanent link" href="#policyvalidation" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policyvalidation">PolicyValidation</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policyvary" id="policyvary">Vary Header Policy</a> <a title="Permanent link" href="#policyvary" class="permalink">¶</a></h2>
+<h2
id="policyvary">Vary Header Policy <a title="Permanent link" href="#policyvary" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policyvary">PolicyVary</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="policyversion" id="policyversion">Protocol Version Policy</a> <a title="Permanent link" href="#policyversion" class="permalink">¶</a></h2>
+<h2
id="policyversion">Protocol Version Policy <a title="Permanent link" href="#policyversion" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_policy.html#policyversion">PolicyVersion</a></code></li></ul></td></tr></table>
<a href="./fr/compliance.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="main" id="main">Main Configuration Files</a> <a title="Permanent link" href="#main" class="permalink">¶</a></h2>
+<h2
id="main">Main Configuration Files <a title="Permanent link" href="#main" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
and is <code>mime.types</code> by default.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="syntax" id="syntax">Syntax of the Configuration Files</a> <a title="Permanent link" href="#syntax" class="permalink">¶</a></h2>
+<h2
id="syntax">Syntax of the Configuration Files <a title="Permanent link" href="#syntax" class="permalink">¶</a></h2>
<p>httpd configuration files contain one directive per line.
argument contains spaces, you must enclose that argument in
quotes.</p>
- <h3><a name="quotes" id="quotes">Quoting and Escaping</a></h3>
+ <h3 id="quotes">Quoting and Escaping</h3>
<p>Either double quotes (<code>"</code>) or single quotes
(<code>'</code>) can be used to enclose an argument that contains
that may happen for repeated directives.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="modules" id="modules">Modules</a> <a title="Permanent link" href="#modules" class="permalink">¶</a></h2>
+<h2
id="modules">Modules <a title="Permanent link" href="#modules" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
command line option.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="scope" id="scope">Scope of Directives</a> <a title="Permanent link" href="#scope" class="permalink">¶</a></h2>
+<h2
id="scope">Scope of Directives <a title="Permanent link" href="#scope" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td></td><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
work</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="htaccess" id="htaccess">.htaccess Files</a> <a title="Permanent link" href="#htaccess" class="permalink">¶</a></h2>
+<h2
id="htaccess">.htaccess Files <a title="Permanent link" href="#htaccess" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td></td><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="about" id="about">About Content Negotiation</a> <a title="Permanent link" href="#about" class="permalink">¶</a></h2>
+<h2
id="about">About Content Negotiation <a title="Permanent link" href="#about" class="permalink">¶</a></h2>
<p>A resource may be available in several different
representations. For example, it might be available in
the <strong>dimensions</strong> of negotiation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="negotiation" id="negotiation">Negotiation in httpd</a> <a title="Permanent link" href="#negotiation" class="permalink">¶</a></h2>
+<h2
id="negotiation">Negotiation in httpd <a title="Permanent link" href="#negotiation" class="permalink">¶</a></h2>
<p>In order to negotiate a resource, the server needs to be
given information about each of the variants. This is done in
results.</li>
</ul>
- <h3><a name="type-map" id="type-map">Using a type-map file</a></h3>
+ <h3 id="type-map">Using a type-map file</h3>
<p>A type map is a document which is associated with the handler
named <code>type-map</code> (or, for backwards-compatibility with
typemap</a> documentation.</p>
-<h3><a name="multiviews" id="multiviews">Multiviews</a></h3>
+<h3 id="multiviews">Multiviews</h3>
<p><code>MultiViews</code> is a per-directory option, meaning it
can be set with an <code class="directive"><a href="./mod/core.html#options">Options</a></code>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="methods" id="methods">The Negotiation Methods</a> <a title="Permanent link" href="#methods" class="permalink">¶</a></h2>
+<h2
id="methods">The Negotiation Methods <a title="Permanent link" href="#methods" class="permalink">¶</a></h2>
<p>After httpd has obtained a list of the variants for a given
resource, either from a type-map file or from the filenames in
variant selection algorithm' defined in RFC 2296.</li>
</ol>
-<h3><a name="dimensions" id="dimensions">Dimensions of Negotiation</a></h3>
+<h3 id="dimensions">Dimensions of Negotiation</h3>
<table>
</table>
-<h3><a name="algorithm" id="algorithm">httpd Negotiation Algorithm</a></h3>
+<h3 id="algorithm">httpd Negotiation Algorithm</h3>
<p>httpd can use the following algorithm to select the 'best'
variant (if any) to return to the browser. This algorithm is
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2><a name="better" id="better">Fiddling with Quality
- Values
</a> <a title="Permanent link" href="#better" class="permalink">¶</a></h2>
+<h2 id="better">Fiddling with Quality
+ Values <a title="Permanent link" href="#better" class="permalink">¶</a></h2>
<p>httpd sometimes changes the quality values from what would
be expected by a strict interpretation of the httpd
browser sends full and correct information these fiddles will not
be applied.</p>
-<h3><a name="wildcards" id="wildcards">Media Types and Wildcards</a></h3>
+<h3 id="wildcards">Media Types and Wildcards</h3>
<p>The <code>Accept:</code> request header indicates preferences
for media types. It can also include 'wildcard' media types, such
send the explicit information to start with work as expected.</p>
-<h3><a name="exceptions" id="exceptions">Language Negotiation Exceptions</a></h3>
+<h3 id="exceptions">Language Negotiation Exceptions</h3>
<p>New in httpd 2.0, some exceptions have been added to the
negotiation algorithm to allow graceful fallback when language
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2><a name="extensions" id="extensions">Extensions to Transparent Content
-Negotiation
</a> <a title="Permanent link" href="#extensions" class="permalink">¶</a></h2>
+<h2 id="extensions">Extensions to Transparent Content
+Negotiation <a title="Permanent link" href="#extensions" class="permalink">¶</a></h2>
<p>httpd extends the transparent content negotiation protocol (RFC
2295) as follows. A new <code>{encoding ..}</code> element is used in
factors to 5 decimal places before choosing the best variant.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="naming" id="naming">Note on hyperlinks and naming conventions</a> <a title="Permanent link" href="#naming" class="permalink">¶</a></h2>
+<h2
id="naming">Note on hyperlinks and naming conventions <a title="Permanent link" href="#naming" class="permalink">¶</a></h2>
<p>If you are using language negotiation you can choose between
different naming conventions, because files can have more than
(<em>e.g.</em>, <code>foo.html.en</code>).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="caching" id="caching">Note on Caching</a> <a title="Permanent link" href="#caching" class="permalink">¶</a></h2>
+<h2
id="caching">Note on Caching <a title="Permanent link" href="#caching" class="permalink">¶</a></h2>
<p>When a cache stores a representation, it associates it with
the request URL. The next time that URL is requested, the cache
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configuration" id="configuration">Configuration</a> <a title="Permanent link" href="#configuration" class="permalink">¶</a></h2>
+<h2
id="configuration">Configuration <a title="Permanent link" href="#configuration" class="permalink">¶</a></h2>
<p>Custom error documents are configured using the <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> directive,
which may be used in global,
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="variables" id="variables">Available Variables</a> <a title="Permanent link" href="#variables" class="permalink">¶</a></h2>
+<h2
id="variables">Available Variables <a title="Permanent link" href="#variables" class="permalink">¶</a></h2>
<p>Redirecting to another URL can be useful, but only if some
information can be passed which can then be used to explain or log
as the server).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="custom" id="custom">Customizing Error Responses</a> <a title="Permanent link" href="#custom" class="permalink">¶</a></h2>
+<h2
id="custom">Customizing Error Responses <a title="Permanent link" href="#custom" class="permalink">¶</a></h2>
<p>If you point your <code>ErrorDocument</code> to some variety of
dynamic handler such as a server-side include document, CGI
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="multi-lang" id="multi-lang">Multi Language Custom Error Documents</a> <a title="Permanent link" href="#multi-lang" class="permalink">¶</a></h2>
+<h2
id="multi-lang">Multi Language Custom Error Documents <a title="Permanent link" href="#multi-lang" class="permalink">¶</a></h2>
<p>Provided with your installation of the Apache HTTP Server is a
directory of custom error documents translated into 16 different
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basics" id="basics">Basic concepts</a> <a title="Permanent link" href="#basics" class="permalink">¶</a></h2>
+<h2
id="basics">Basic concepts <a title="Permanent link" href="#basics" class="permalink">¶</a></h2>
<p>We begin with an overview of the basic concepts behind the API, and how
they are manifested in the code.</p>
- <h3><a name="HMR" id="HMR">Handlers, Modules, and Requests</a></h3>
+ <h3 id="HMR">Handlers, Modules, and Requests</h3>
<p>Apache breaks down request handling into a series of steps, more or
less the same way the Netscape server API does (although this API has a
few more stages than NetSite does, as hooks for stuff I thought might be
as above.</p>
- <h3><a name="moduletour" id="moduletour">A brief tour of a module</a></h3>
+ <h3 id="moduletour">A brief tour of a module</h3>
<p>At this point, we need to explain the structure of a module. Our
candidate will be one of the messier ones, the CGI module -- this handles
both CGI scripts and the <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> config file command. It's actually a great deal
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="handlers" id="handlers">How handlers work</a> <a title="Permanent link" href="#handlers" class="permalink">¶</a></h2>
+<h2
id="handlers">How handlers work <a title="Permanent link" href="#handlers" class="permalink">¶</a></h2>
<p>The sole argument to handlers is a <code>request_rec</code> structure.
This structure describes a particular request which has been made to the
server, on behalf of a client. In most cases, each connection to the
client generates only one <code>request_rec</code> structure.</p>
- <h3><a name="req_tour" id="req_tour">A brief tour of the request_rec</a></h3>
+ <h3 id="req_tour">A brief tour of the request_rec</h3>
<p>The <code>request_rec</code> contains pointers to a resource pool
which will be cleared when the server is finished handling the request;
to structures containing per-server and per-connection information, and
</code></p></div>
- <h3><a name="req_orig" id="req_orig">Where request_rec structures come from</a></h3>
+ <h3 id="req_orig">Where request_rec structures come from</h3>
<p>Most <code>request_rec</code> structures are built by reading an HTTP
request from a client, and filling in the fields. However, there are a
few exceptions:</p>
</ul>
- <h3><a name="req_return" id="req_return">Handling requests, declining, and returning
- error codes</a></h3>
+ <h3 id="req_return">Handling requests, declining, and returning
+ error codes</h3>
<p>As discussed above, each handler, when invoked to handle a particular
<code>request_rec</code>, has to return an <code>int</code> to indicate
what happened. That can either be</p>
redirected <em>to</em>.</p>
- <h3><a name="resp_handlers" id="resp_handlers">Special considerations for response
- handlers</a></h3>
+ <h3 id="resp_handlers">Special considerations for response
+ handlers</h3>
<p>Handlers for most phases do their work by simply setting a few fields
in the <code>request_rec</code> structure (or, in the case of access
checkers, simply by returning the correct error code). However, response
<em>not</em> response handlers will lead to serious confusion).</p>
- <h3><a name="auth_handlers" id="auth_handlers">Special considerations for authentication
- handlers</a></h3>
+ <h3 id="auth_handlers">Special considerations for authentication
+ handlers</h3>
<p>Stuff that should be discussed here in detail:</p>
<ul>
</ul>
- <h3><a name="log_handlers" id="log_handlers">Special considerations for logging
- handlers</a></h3>
+ <h3 id="log_handlers">Special considerations for logging
+ handlers</h3>
<p>When a request has internally redirected, there is the question of
what to log. Apache handles this by bundling the entire chain of redirects
into a list of <code>request_rec</code> structures which are threaded
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="pools" id="pools">Resource allocation and resource pools</a> <a title="Permanent link" href="#pools" class="permalink">¶</a></h2>
+<h2
id="pools">Resource allocation and resource pools <a title="Permanent link" href="#pools" class="permalink">¶</a></h2>
<p>One of the problems of writing and designing a server-pool server is
that of preventing leakage, that is, allocating resources (memory, open
files, <em>etc.</em>), without subsequently releasing them. The resource
<code>"foo/bar"</code>.</p>
- <h3><a name="pools-used" id="pools-used">Commonly-used pools in the Apache Web
- server</a></h3>
+ <h3 id="pools-used">Commonly-used pools in the Apache Web
+ server</h3>
<p>A pool is really defined by its lifetime more than anything else.
There are some static pools in http_main which are passed to various
non-http_main functions as arguments at opportune times. Here they
output has been sent to the client and logging has happened.</p>
- <h3><a name="pool-files" id="pool-files">Tracking open files, etc.</a></h3>
+ <h3 id="pool-files">Tracking open files, etc.</h3>
<p>As indicated above, resource pools are also used to track other sorts
of resources besides memory. The most common are open files. The routine
which is typically used for this is <code>ap_pfopen</code>, which takes a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="config" id="config">Configuration, commands and the like</a> <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
+<h2
id="config">Configuration, commands and the like <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
<p>One of the design goals for this server was to maintain external
compatibility with the NCSA 1.3 server --- that is, to read the same
configuration files, to process all the directives therein correctly, and
similar problems come up, by tying those structures to the per-transaction
resource pool.</p>
- <h3><a name="per-dir" id="per-dir">Per-directory configuration structures</a></h3>
+ <h3 id="per-dir">Per-directory configuration structures</h3>
<p>Let's look out how all of this plays out in <code>mod_mime.c</code>,
which defines the file typing handler which emulates the NCSA server's
behavior of determining file types from suffixes. What we'll be looking
structure slot in the module itself <code>NULL</code>.</p>
- <h3><a name="commands" id="commands">Command handling</a></h3>
+ <h3 id="commands">Command handling</h3>
<p>Now that we have these structures, we need to be able to figure out how
to fill them. That involves processing the actual <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> and <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code> commands. To find commands, the server looks in
the module's command table. That table contains information on how many
</code></p></div>
- <h3><a name="servconf" id="servconf">Side notes -- per-server configuration,
- virtual servers, <em>etc</em>.</a></h3>
+ <h3 id="servconf">Side notes -- per-server configuration,
+ virtual servers, <em>etc</em>.</h3>
<p>The basic ideas behind per-server module configuration are basically
the same as those for per-directory configuration; there is a creation
function and a merge function, the latter being invoked where a virtual
<p><span>Available Languages: </span><a href="../en/developer/API.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<p><span>Available Languages: </span><a href="../en/developer/debugging.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="brief" id="brief">Brief Description</a> <a title="Permanent link" href="#brief" class="permalink">¶</a></h2>
+<h2
id="brief">Brief Description <a title="Permanent link" href="#brief" class="permalink">¶</a></h2>
<p>To start a documentation block, use <code>/**</code><br>
To end a documentation block, use <code>*/</code></p>
<a href="../zh-cn/developer/documenting.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="types" id="types">Filter Types</a> <a title="Permanent link" href="#types" class="permalink">¶</a></h2>
+<h2
id="types">Filter Types <a title="Permanent link" href="#types" class="permalink">¶</a></h2>
<p>There are three basic filter types (each of these is actually broken
down into two categories, but that comes later).</p>
only have one filter type, but that should change.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="howinserted" id="howinserted">How are filters inserted?</a> <a title="Permanent link" href="#howinserted" class="permalink">¶</a></h2>
+<h2
id="howinserted">How are filters inserted? <a title="Permanent link" href="#howinserted" class="permalink">¶</a></h2>
<p>This is actually rather simple in theory, but the code is
complex. First of all, it is important that everybody realize that
there are three filter lists for each request, but they are all
me.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="asis" id="asis">Asis</a> <a title="Permanent link" href="#asis" class="permalink">¶</a></h2>
+<h2
id="asis">Asis <a title="Permanent link" href="#asis" class="permalink">¶</a></h2>
<p>The final topic. :-) Mod_Asis is a bit of a hack, but the
handler needs to remove all filters except for connection filters, and
send the data. If you are using <code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code>, all other
bets are off.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="conclusion" id="conclusion">Explanations</a> <a title="Permanent link" href="#conclusion" class="permalink">¶</a></h2>
+<h2
id="conclusion">Explanations <a title="Permanent link" href="#conclusion" class="permalink">¶</a></h2>
<p>The absolutely last point is that the reason this code was so hard to
get right, was because we had hacked so much to force it to work. I
wrote most of the hacks originally, so I am very much to blame.
<p><span>Available Languages: </span><a href="../en/developer/filters.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="corehooks" id="corehooks">Core Hooks</a> <a title="Permanent link" href="#corehooks" class="permalink">¶</a></h2>
+<h2
id="corehooks">Core Hooks <a title="Permanent link" href="#corehooks" class="permalink">¶</a></h2>
<p>The httpd's core modules offer a predefinined list of hooks
used during the standard <a href="./request.html">request processing</a>
phase. Creating a new hook will expose a function that
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="create" id="create">Creating a hook function</a> <a title="Permanent link" href="#create" class="permalink">¶</a></h2>
+<h2
id="create">Creating a hook function <a title="Permanent link" href="#create" class="permalink">¶</a></h2>
<p>In order to create a new hook, four things need to be
done:</p>
- <h3><a name="create-declare" id="create-declare">Declare the hook function</a></h3>
+ <h3 id="create-declare">Declare the hook function</h3>
<p>Use the <code>AP_DECLARE_HOOK</code> macro, which needs to be given
the return type of the hook function, the name of the hook, and the
arguments. For example, if the hook returns an <code>int</code> and
they want to use the hook.</p>
- <h3><a name="create-create" id="create-create">Create the hook structure</a></h3>
+ <h3 id="create-create">Create the hook structure</h3>
<p>Each source file that exports a hook has a private structure
which is used to record the module functions that use the hook.
This is declared as follows:</p>
- <h3><a name="create-implement" id="create-implement">Implement the hook caller</a></h3>
+ <h3 id="create-implement">Implement the hook caller</h3>
<p>The source file that exports the hook has to implement a
function that will call the hook. There are currently three
possible ways to do this. In all cases, the calling function is
- <h3><a name="create-call" id="create-call">Call the hook callers</a></h3>
+ <h3 id="create-call">Call the hook callers</h3>
<p>At appropriate moments in the code, call the hook caller,
like so:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="hooking" id="hooking">Hooking the hook</a> <a title="Permanent link" href="#hooking" class="permalink">¶</a></h2>
+<h2
id="hooking">Hooking the hook <a title="Permanent link" href="#hooking" class="permalink">¶</a></h2>
<p>A module that wants a hook to be called needs to do two
things.</p>
- <h3><a name="hooking-implement" id="hooking-implement">Implement the hook function</a></h3>
+ <h3 id="hooking-implement">Implement the hook function</h3>
<p>Include the appropriate header, and define a static function
of the correct type:</p>
- <h3><a name="hooking-add" id="hooking-add">Add a hook registering function</a></h3>
+ <h3 id="hooking-add">Add a hook registering function</h3>
<p>During initialization, the server will call each modules hook
registering function, which is included in the module
structure:</p>
- <h3><a name="hooking-order" id="hooking-order">Controlling hook calling order</a></h3>
+ <h3 id="hooking-order">Controlling hook calling order</h3>
<p>In the example above, we didn't use the three arguments in
the hook registration function that control calling order of
all the functions registered within the hook.
<p><span>Available Languages: </span><a href="../en/developer/hooks.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="developing" id="developing">2.4 development documents</a> <a title="Permanent link" href="#developing" class="permalink">¶</a></h2>
+<h2
id="developing">2.4 development documents <a title="Permanent link" href="#developing" class="permalink">¶</a></h2>
<ul>
<li><a href="modguide.html">Developing modules for the Apache HTTP Server 2.4</a></li>
<li><a href="hooks.html">Hook Functions in 2.4</a></li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="upgrading" id="upgrading">Upgrading to 2.4</a> <a title="Permanent link" href="#upgrading" class="permalink">¶</a></h2>
+<h2
id="upgrading">Upgrading to 2.4 <a title="Permanent link" href="#upgrading" class="permalink">¶</a></h2>
<ul>
<li><a href="new_api_2_4.html">API changes in 2.3/2.4</a></li>
<li><a href="modules.html">Converting Modules from 1.3 to 2.x</a></li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="external" id="external">Other Resources</a> <a title="Permanent link" href="#external" class="permalink">¶</a></h2>
+<h2
id="external">Other Resources <a title="Permanent link" href="#external" class="permalink">¶</a></h2>
<ul>
<li>Developer articles at <a href="http://www.apachetutor.org/">apachetutor</a> include:
<ul>
<a href="../zh-cn/developer/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_lua.html">mod_lua</a></li><li><a href="modguide.html">Developing modules for Apache 2.4</a></li><li><a href="request.html">Request Processing in Apache 2.4</a></li><li><a href="hooks.html">Apache 2.x Hook Functions</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
-<h3><a name="what" id="what">What is mod_lua</a></h3>
+<h2
id="introduction">Introduction <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
+<h3 id="what">What is mod_lua</h3>
<p>
Stuff about what <code class="module"><a href="../mod/mod_lua.html">mod_lua</a></code> is goes here.
</p>
-<h3><a name="contents" id="contents">What we will be discussing in this document</a></h3>
+<h3 id="contents">What we will be discussing in this document</h3>
<p>
This document will discuss several cases where <code class="module"><a href="../mod/mod_lua.html">mod_lua</a></code> can be used
to either ease up a phase of the request processing or create more transparency in
-<h3><a name="prerequisites" id="prerequisites">Prerequisites</a></h3>
+<h3 id="prerequisites">Prerequisites</h3>
<p>
First and foremost, you are expected to have a basic knowledge of how the Lua
programming language works. In most cases, we will try to be as pedagogical
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="enabling" id="enabling">Optimizing mod_lua for production servers</a> <a title="Permanent link" href="#enabling" class="permalink">¶</a></h2>
+<h2
id="enabling">Optimizing mod_lua for production servers <a title="Permanent link" href="#enabling" class="permalink">¶</a></h2>
<h3>Setting a scope for Lua states</h3>
<p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basic_remap" id="basic_remap">Example 1: A basic remapping module</a> <a title="Permanent link" href="#basic_remap" class="permalink">¶</a></h2>
+<h2
id="basic_remap">Example 1: A basic remapping module <a title="Permanent link" href="#basic_remap" class="permalink">¶</a></h2>
<p>
These first examples show how mod_lua can be used to rewrite URIs in the same
way that one could do using <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> or
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="mass_vhost" id="mass_vhost">Example 2: Mass virtual hosting</a> <a title="Permanent link" href="#mass_vhost" class="permalink">¶</a></h2>
+<h2
id="mass_vhost">Example 2: Mass virtual hosting <a title="Permanent link" href="#mass_vhost" class="permalink">¶</a></h2>
<p>
As with simple and advanced rewriting, you can use mod_lua for dynamically
assigning a hostname to a specific document root, much like
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basic_auth" id="basic_auth">Example 3: A basic authorization hook</a> <a title="Permanent link" href="#basic_auth" class="permalink">¶</a></h2>
+<h2
id="basic_auth">Example 3: A basic authorization hook <a title="Permanent link" href="#basic_auth" class="permalink">¶</a></h2>
<p>
With the authorization hooks, you can add custom auth phases to your request
processing, allowing you to either add new requirements that were not previously
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="authz" id="authz">Example 4: Authorization using LuaAuthzProvider</a> <a title="Permanent link" href="#authz" class="permalink">¶</a></h2>
+<h2
id="authz">Example 4: Authorization using LuaAuthzProvider <a title="Permanent link" href="#authz" class="permalink">¶</a></h2>
<p>
If you require even more advanced control over your authorization phases,
you can add custom authz providers to help you manage your server. The
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="loadbalancing" id="loadbalancing">Example 5: A rudimentary load balancer</a> <a title="Permanent link" href="#loadbalancing" class="permalink">¶</a></h2>
+<h2
id="loadbalancing">Example 5: A rudimentary load balancer <a title="Permanent link" href="#loadbalancing" class="permalink">¶</a></h2>
<p>
This is an example of how you can create a load balancing mechanism.
In this example, we will be setting/getting the number of requests served
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="map_handler" id="map_handler">Example 6: Overlays using LuaMapHandler</a> <a title="Permanent link" href="#map_handler" class="permalink">¶</a></h2>
+<h2
id="map_handler">Example 6: Overlays using LuaMapHandler <a title="Permanent link" href="#map_handler" class="permalink">¶</a></h2>
<p>
Coming soon!
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="mod_status_lua" id="mod_status_lua">Example 6: Basic Lua scripts</a> <a title="Permanent link" href="#mod_status_lua" class="permalink">¶</a></h2>
+<h2
id="mod_status_lua">Example 6: Basic Lua scripts <a title="Permanent link" href="#mod_status_lua" class="permalink">¶</a></h2>
<p>
Also coming soon
</p>
<p><span>Available Languages: </span><a href="../en/developer/lua.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="request.html">Request Processing in Apache 2.4</a></li><li><a href="hooks.html">Apache 2.x Hook Functions</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
-<h3><a name="what" id="what">What we will be discussing in this document</a></h3>
+<h2
id="introduction">Introduction <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
+<h3 id="what">What we will be discussing in this document</h3>
<p>
This document will discuss how you can create modules for the Apache
HTTP Server 2.4, by exploring an example module called
</p>
-<h3><a name="prerequisites" id="prerequisites">Prerequisites</a></h3>
+<h3 id="prerequisites">Prerequisites</h3>
<p>
First and foremost, you are expected to have a basic knowledge of how the C
programming language works. In most cases, we will try to be as pedagogical
new modules.
</p>
-<h3><a name="compiling" id="compiling">Compiling your module</a></h3>
+<h3 id="compiling">Compiling your module</h3>
<p>
To compile the source code we are building in this document, we will be
using <a href="../programs/apxs.html">APXS</a>. Assuming your source file
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basics" id="basics">Defining a module</a> <a title="Permanent link" href="#basics" class="permalink">¶</a></h2>
+<h2
id="basics">Defining a module <a title="Permanent link" href="#basics" class="permalink">¶</a></h2>
<p>
<img src="../images/build_a_mod_3.png" alt="Module name tags"><br>
Every module starts with the same declaration, or name tag if you will,
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="hooking" id="hooking">Getting started: Hooking into the server</a> <a title="Permanent link" href="#hooking" class="permalink">¶</a></h2>
-<h3><a name="hook_intro" id="hook_intro">An introduction to hooks</a></h3>
+<h2
id="hooking">Getting started: Hooking into the server <a title="Permanent link" href="#hooking" class="permalink">¶</a></h2>
+<h3 id="hook_intro">An introduction to hooks</h3>
<p>
When handling requests in Apache HTTP Server 2.4, the first thing you will need to do is
create a hook into the request handling process. A hook is essentially a
the server based on the value of this tag.
</p>
-<h3><a name="hook_declaration" id="hook_declaration">Hooking into httpd</a></h3>
+<h3 id="hook_declaration">Hooking into httpd</h3>
<p>
To begin with, we only want to create a simple handler that replies to the
client browser when a specific URL is requested, so we won't bother setting
the request. We will discuss how to create a handler in the next chapter.
</p>
-<h3><a name="hook_others" id="hook_others">Other useful hooks</a></h3>
+<h3 id="hook_others">Other useful hooks</h3>
<p>
Hooking into the request handling phase is but one of many hooks that you
can create. Some other ways of hooking are:
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="handling" id="handling">Building a handler</a> <a title="Permanent link" href="#handling" class="permalink">¶</a></h2>
+<h2
id="handling">Building a handler <a title="Permanent link" href="#handling" class="permalink">¶</a></h2>
<p>
A handler is essentially a function that receives a callback when a request
to the server is made. It is passed a record of the current request (how it was
request and so on), and is put in charge of either telling the server that it's
not interested in the request or handle the request with the tools provided.
</p>
-<h3><a name="simple_handler" id="simple_handler">A simple "Hello, world!"
-handler</a></h3>
+<h3 id="simple_handler">A simple "Hello, world!"
+handler</h3>
<p>Let's start off by making a very simple request handler
that does the following:
</p>
<a href="#functions">"Some useful functions you should know"</a>.
</p>
-<h3><a name="request_rec" id="request_rec">The request_rec structure</a></h3>
+<h3 id="request_rec">The request_rec structure</h3>
<p>The most essential part of any request is the <em>request record
</em>. In a call to a handler function, this is represented by the <code>
request_rec* </code> structure passed along with every call that is made.
-<h3><a name="return_value" id="return_value">Return values</a></h3>
+<h3 id="return_value">Return values</h3>
<p>
Apache relies on return values from handlers to signify whether a request
was handled or not, and if so, whether the request went well or not. If a
</ul>
-<h3><a name="functions" id="functions">Some useful functions you should know</a></h3>
+<h3 id="functions">Some useful functions you should know</h3>
<ul>
<li>
</ul>
-<h3><a name="memory" id="memory">Memory management</a></h3>
+<h3 id="memory">Memory management</h3>
<p>
Managing your resources in Apache HTTP Server 2.4 is quite easy, thanks to the memory pool
system. In essence, each server, connection and request have their own
</p>
-<h3><a name="parsing" id="parsing">Parsing request data</a></h3>
+<h3 id="parsing">Parsing request data</h3>
<p>
In our example module, we would like to add a feature, that checks which
type of digest, MD5 or SHA1 the client would like to see. This could be
</p>
-<h3><a name="advanced_handler" id="advanced_handler">Making an advanced handler</a></h3>
+<h3 id="advanced_handler">Making an advanced handler</h3>
<p>
Now that we have learned how to parse form data and manage our resources,
we can move on to creating an advanced version of our module, that spits
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configuration" id="configuration">Adding configuration options</a> <a title="Permanent link" href="#configuration" class="permalink">¶</a></h2>
+<h2
id="configuration">Adding configuration options <a title="Permanent link" href="#configuration" class="permalink">¶</a></h2>
<p>
In this next segment of this document, we will turn our eyes away from the
digest module and create a new example module, whose only function is to
advanced configurations
for your modules.
</p>
-<h3><a name="config_intro" id="config_intro">An introduction to configuration
-directives</a></h3>
+<h3 id="config_intro">An introduction to configuration
+directives</h3>
<p>
If you are reading this, then you probably already know
what a configuration directive is. Simply put, a directive is a way of
that parses the parameters given and sets up a configuration accordingly.
</p>
-<h3><a name="config_simple" id="config_simple">Making an example configuration</a></h3>
+<h3 id="config_simple">Making an example configuration</h3>
<p>To begin with, we'll create a basic configuration in C-space:</p>
</p>
-<h3><a name="register_directive" id="register_directive">Registering directives with the server</a></h3>
+<h3 id="register_directive">Registering directives with the server</h3>
<p>
What if we want to change our configuration, not by hard-coding new values
into the module, but by using either the httpd.conf file or possibly a
set them.</em>)
</p>
-<h3><a name="directive_handler" id="directive_handler">The directive handler function</a></h3>
+<h3 id="directive_handler">The directive handler function</h3>
<p>
Now that we have told the server to expect some directives for our module, it's
time to make a few functions for handling these. What the server reads in the
-<h3><a name="directive_complete" id="directive_complete">Putting it all together</a></h3>
+<h3 id="directive_complete">Putting it all together</h3>
<p>
Now that we have our directives set up, and handlers configured for them,
we can assemble our module into one big file:
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="context" id="context">Context aware configurations</a> <a title="Permanent link" href="#context" class="permalink">¶</a></h2>
-<h3><a name="context_intro" id="context_intro">Introduction to context aware configurations</a></h3>
+<h2
id="context">Context aware configurations <a title="Permanent link" href="#context" class="permalink">¶</a></h2>
+<h3 id="context_intro">Introduction to context aware configurations</h3>
<p>
In Apache HTTP Server 2.4, different URLs, virtual hosts, directories etc can have very
different meanings to the user of the server, and thus different contexts
</p>
-<h3><a name="context_base" id="context_base">Our basic configuration setup</a></h3>
+<h3 id="context_base">Our basic configuration setup</h3>
<p>In this chapter, we will be working with a slightly modified version of
our previous context structure. We will set a <code>context</code>
variable that we can use to track which context configuration is being
-<h3><a name="context_which" id="context_which">Choosing a context</a></h3>
+<h3 id="context_which">Choosing a context</h3>
<p>
Before we can start making our module context aware, we must first define,
which contexts we will accept. As we saw in the previous chapter, defining
</ul>
-<h3><a name="context_pool" id="context_pool">Using the server to allocate configuration slots</a></h3>
+<h3 id="context_pool">Using the server to allocate configuration slots</h3>
<p> A much smarter way to manage your configurations is by letting the server
help you create them. To do so, we must first start off by changing our
<em>name tag</em> to let the server know, that it should assist us in creating
-<h3><a name="context_new" id="context_new">Creating new context configurations</a></h3>
+<h3 id="context_new">Creating new context configurations</h3>
<p>
Now that we have told the server to help us create and manage configurations,
our first step is to make a function for creating new, blank
-<h3><a name="context_merge" id="context_merge">Merging configurations</a></h3>
+<h3 id="context_merge">Merging configurations</h3>
<p>
Our next step in creating a context aware configuration is merging
configurations. This part of the process particularly applies to scenarios
-<h3><a name="context_example" id="context_example">Trying out our new context aware configurations</a></h3>
+<h3 id="context_example">Trying out our new context aware configurations</h3>
<p>
Now, let's try putting it all together to create a new module that is
context aware. First off, we'll create a configuration that lets us test
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="summary" id="summary">Summing up</a> <a title="Permanent link" href="#summary" class="permalink">¶</a></h2>
+<h2
id="summary">Summing up <a title="Permanent link" href="#summary" class="permalink">¶</a></h2>
<p>
We have now looked at how to create simple modules for Apache HTTP Server 2.4 and
configuring them. What you do next is entirely up to you, but it is my
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="snippets" id="snippets">Some useful snippets of code</a> <a title="Permanent link" href="#snippets" class="permalink">¶</a></h2>
+<h2
id="snippets">Some useful snippets of code <a title="Permanent link" href="#snippets" class="permalink">¶</a></h2>
-<h3><a name="get_post" id="get_post">Retrieve variables from POST form data</a></h3>
+<h3 id="get_post">Retrieve variables from POST form data</h3>
- <h3><a name="headers_out" id="headers_out">Printing out every HTTP header received</a></h3>
+ <h3 id="headers_out">Printing out every HTTP header received</h3>
- <h3><a name="request_body" id="request_body">Reading the request body into memory</a></h3>
+ <h3 id="request_body">Reading the request body into memory</h3>
<p><span>Available Languages: </span><a href="../en/developer/modguide.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="easy" id="easy">The easier changes ...</a> <a title="Permanent link" href="#easy" class="permalink">¶</a></h2>
+<h2
id="easy">The easier changes ... <a title="Permanent link" href="#easy" class="permalink">¶</a></h2>
- <h3><a name="cleanup" id="cleanup">Cleanup Routines</a></h3>
+ <h3 id="cleanup">Cleanup Routines</h3>
<p>These now need to be of type <code>apr_status_t</code> and return a
value of that type. Normally the return value will be
<code>APR_SUCCESS</code> unless there is some need to signal an error in
yet checks and acts upon the error.</p>
- <h3><a name="init" id="init">Initialization Routines</a></h3>
+ <h3 id="init">Initialization Routines</h3>
<p>These should now be renamed to better signify where they sit
in the overall process. So the name gets a small change from
<code>mmap_init</code> to <code>mmap_post_config</code>. The arguments
</ul>
- <h3><a name="datatypes" id="datatypes">Data Types</a></h3>
+ <h3 id="datatypes">Data Types</h3>
<p>A lot of the data types have been moved into the <a href="http://apr.apache.org/">APR</a>. This means that some have had
a name change, such as the one shown above. The following is a brief
list of some of the changes that you are likely to have to make.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="messy" id="messy">The messier changes...</a> <a title="Permanent link" href="#messy" class="permalink">¶</a></h2>
+<h2
id="messy">The messier changes... <a title="Permanent link" href="#messy" class="permalink">¶</a></h2>
- <h3><a name="register-hooks" id="register-hooks">Register Hooks</a></h3>
+ <h3 id="register-hooks">Register Hooks</h3>
<p>The new architecture uses a series of hooks to provide for
calling your functions. These you'll need to add to your module
by way of a new function, <code>static void register_hooks(void)</code>.
position <code>HOOK_LAST</code>.</p>
- <h3><a name="moddef" id="moddef">Module Definition</a></h3>
+ <h3 id="moddef">Module Definition</h3>
<p>There are now a lot fewer stages to worry about when
creating your module definition. The old definition looked
like</p>
<a href="../ja/developer/modules.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="api_changes" id="api_changes">Changed APIs</a> <a title="Permanent link" href="#api_changes" class="permalink">¶</a></h2>
+<h2
id="api_changes">Changed APIs <a title="Permanent link" href="#api_changes" class="permalink">¶</a></h2>
- <h3><a name="ap_expr" id="ap_expr">ap_expr (NEW!)</a></h3>
+ <h3 id="ap_expr">ap_expr (NEW!)</h3>
<p>Introduces a new API to parse and evaluate boolean and algebraic
expressions, including provision for a standard syntax and
customized variants.</p>
- <h3><a name="ap_listen" id="ap_listen">ap_listen (changed; backwards-compatible)</a></h3>
+ <h3 id="ap_listen">ap_listen (changed; backwards-compatible)</h3>
<p>Introduces a new API to enable httpd child processes to serve
different purposes.</p>
- <h3><a name="ap_mpm" id="ap_mpm">ap_mpm (changed)</a></h3>
+ <h3 id="ap_mpm">ap_mpm (changed)</h3>
<p><code>ap_mpm_run</code> is replaced by a new <code>mpm</code> hook.
Also <code>ap_graceful_stop_signalled</code> is lost, and
<code>ap_mpm_register_timed_callback</code> is new.</p>
- <h3><a name="ap_regex" id="ap_regex">ap_regex (changed)</a></h3>
+ <h3 id="ap_regex">ap_regex (changed)</h3>
<p>In addition to the existing regexp wrapper, a new higher-level API
<code>ap_rxplus</code> is now provided. This provides the capability to
backreferences is also added.</p>
- <h3><a name="ap_slotmem" id="ap_slotmem">ap_slotmem (NEW!)</a></h3>
+ <h3 id="ap_slotmem">ap_slotmem (NEW!)</h3>
<p>Introduces an API for modules to allocate and manage memory slots,
most commonly for shared memory.</p>
- <h3><a name="ap_socache" id="ap_socache">ap_socache (NEW!)</a></h3>
+ <h3 id="ap_socache">ap_socache (NEW!)</h3>
<p>API to manage a shared object cache.</p>
- <h3><a name="heartbeat" id="heartbeat">heartbeat (NEW!)</a></h3>
+ <h3 id="heartbeat">heartbeat (NEW!)</h3>
<p>common structures for heartbeat modules</p>
- <h3><a name="ap_parse_htaccess" id="ap_parse_htaccess">ap_parse_htaccess (changed)</a></h3>
+ <h3 id="ap_parse_htaccess">ap_parse_htaccess (changed)</h3>
<p>The function signature for <code>ap_parse_htaccess</code> has been
changed. A <code>apr_table_t</code> of individual directives allowed
for override must now be passed (override remains).</p>
- <h3><a name="http_config" id="http_config">http_config (changed)</a></h3>
+ <h3 id="http_config">http_config (changed)</h3>
<ul>
<li>Introduces per-module, per-directory loglevels, including macro wrappers.</li>
</ul>
- <h3><a name="http_core" id="http_core">http_core (changed)</a></h3>
+ <h3 id="http_core">http_core (changed)</h3>
<ul>
<li>REMOVED <code>ap_default_type</code>, <code>ap_requires</code>, all
</ul>
- <h3><a name="httpd" id="httpd">httpd (changed)</a></h3>
+ <h3 id="httpd">httpd (changed)</h3>
<ul>
<li>Introduce per-directory, per-module loglevel</li>
</ul>
- <h3><a name="http_log" id="http_log">http_log (changed)</a></h3>
+ <h3 id="http_log">http_log (changed)</h3>
<ul>
<li>Introduce per-directory, per-module loglevel</li>
</ul>
- <h3><a name="http_request" id="http_request">http_request (changed)</a></h3>
+ <h3 id="http_request">http_request (changed)</h3>
<ul>
<li>New auth_internal API and auth_provider API</li>
<code>AP_AUTH_INTERNAL_PER_URI</code>.</p>
- <h3><a name="mod_auth" id="mod_auth">mod_auth (NEW!)</a></h3>
+ <h3 id="mod_auth">mod_auth (NEW!)</h3>
<p>Introduces the new provider framework for authn and authz</p>
- <h3><a name="mod_cache" id="mod_cache">mod_cache (changed)</a></h3>
+ <h3 id="mod_cache">mod_cache (changed)</h3>
<p>Introduces a <code>commit_entity()</code> function to the cache provider
interface, allowing atomic writes to cache. Add a <code>cache_status()</code>
removed.</p>
- <h3><a name="mod_core" id="mod_core">mod_core (NEW!)</a></h3>
+ <h3 id="mod_core">mod_core (NEW!)</h3>
<p>This introduces low-level APIs to send arbitrary headers,
and exposes functions to handle HTTP OPTIONS and TRACE.</p>
- <h3><a name="mod_cache_disk" id="mod_cache_disk">mod_cache_disk (changed)</a></h3>
+ <h3 id="mod_cache_disk">mod_cache_disk (changed)</h3>
<p>Changes the disk format of the disk cache to support atomic cache
updates without locking. The device/inode pair of the body file is
and body belong to one another.</p>
- <h3><a name="mod_disk_cache" id="mod_disk_cache">mod_disk_cache (renamed)</a></h3>
+ <h3 id="mod_disk_cache">mod_disk_cache (renamed)</h3>
<p>The mod_disk_cache module has been renamed to mod_cache_disk in
order to be consistent with the naming of other modules within the
server.</p>
- <h3><a name="mod_request" id="mod_request">mod_request (NEW!)</a></h3>
+ <h3 id="mod_request">mod_request (NEW!)</h3>
<p>The API for <code class="module"><a href="../mod/mod_request.html">mod_request</a></code>, to make input data
available to multiple application/handler modules where required,
and to parse HTML form data.</p>
- <h3><a name="mpm_common" id="mpm_common">mpm_common (changed)</a></h3>
+ <h3 id="mpm_common">mpm_common (changed)</h3>
<ul>
<li>REMOVES: <code>accept</code>, <code>lockfile</code>, <code>lock_mech</code>,
</ul>
- <h3><a name="scoreboard" id="scoreboard">scoreboard (changed)</a></h3>
+ <h3 id="scoreboard">scoreboard (changed)</h3>
<p><code>ap_get_scoreboard_worker</code> is made non-backwards-compatible
as an alternative version is introduced. Additional proxy_balancer
support. Child status stuff revamped.</p>
- <h3><a name="util_cookies" id="util_cookies">util_cookies (NEW!)</a></h3>
+ <h3 id="util_cookies">util_cookies (NEW!)</h3>
<p>Introduces a new API for managing HTTP Cookies.</p>
- <h3><a name="util_ldap" id="util_ldap">util_ldap (changed)</a></h3>
+ <h3 id="util_ldap">util_ldap (changed)</h3>
<p><em>no description available</em></p>
- <h3><a name="util_mutex" id="util_mutex">util_mutex (NEW!)</a></h3>
+ <h3 id="util_mutex">util_mutex (NEW!)</h3>
<p>A wrapper for APR proc and global mutexes in httpd, providing
common configuration for the underlying mechanism and location
of lock files.</p>
- <h3><a name="util_script" id="util_script">util_script (changed)</a></h3>
+ <h3 id="util_script">util_script (changed)</h3>
<p>NEW: <code>ap_args_to_table</code></p>
- <h3><a name="util_time" id="util_time">util_time (changed)</a></h3>
+ <h3 id="util_time">util_time (changed)</h3>
<p>NEW: <code>ap_recent_ctime_ex</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="upgrading" id="upgrading">Specific information on upgrading modules from 2.2</a> <a title="Permanent link" href="#upgrading" class="permalink">¶</a></h2>
+<h2
id="upgrading">Specific information on upgrading modules from 2.2 <a title="Permanent link" href="#upgrading" class="permalink">¶</a></h2>
- <h3><a name="upgrading_logging" id="upgrading_logging">Logging</a></h3>
+ <h3 id="upgrading_logging">Logging</h3>
<p>In order to take advantage of per-module loglevel configuration, any
source file that calls the <code>ap_log_*</code> functions should declare
instructed to add it back if necessary for problem diagnosis.)</p>
- <h3><a name="upgrading_byfunction" id="upgrading_byfunction">If your module uses these existing APIs...</a></h3>
+ <h3 id="upgrading_byfunction">If your module uses these existing APIs...</h3>
<dl>
</dl>
- <h3><a name="upgrading_byfeature" id="upgrading_byfeature">If your module interfaces with this feature...</a></h3>
+ <h3 id="upgrading_byfeature">If your module interfaces with this feature...</h3>
<dl>
<dt>suEXEC</dt>
</dl>
- <h3><a name="upgrading_newfeatures" id="upgrading_newfeatures">Does your module...</a></h3>
+ <h3 id="upgrading_newfeatures">Does your module...</h3>
<dl>
<dt>Parse query args</dt>
<p><span>Available Languages: </span><a href="../en/developer/new_api_2_4.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="api_changes" id="api_changes">Changed APIs</a> <a title="Permanent link" href="#api_changes" class="permalink">¶</a></h2>
+<h2
id="api_changes">Changed APIs <a title="Permanent link" href="#api_changes" class="permalink">¶</a></h2>
- <h3><a name="ap_fill_me_in" id="ap_fill_me_in">ap_fill_me_in (NEW!)</a></h3>
+ <h3 id="ap_fill_me_in">ap_fill_me_in (NEW!)</h3>
<p>Introduces a new API to fill me in.</p>
- <h3><a name="http_request" id="http_request">http_request (changed)</a></h3>
+ <h3 id="http_request">http_request (changed)</h3>
<ul>
<li>New autht_provider API</li>
</ul>
- <h3><a name="mod_auth" id="mod_auth">mod_auth (changed)</a></h3>
+ <h3 id="mod_auth">mod_auth (changed)</h3>
<p>Adds an additional provider framework for autht - token authentication.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="upgrading" id="upgrading">Specific information on upgrading modules from 2.4</a> <a title="Permanent link" href="#upgrading" class="permalink">¶</a></h2>
+<h2
id="upgrading">Specific information on upgrading modules from 2.4 <a title="Permanent link" href="#upgrading" class="permalink">¶</a></h2>
- <h3><a name="upgrading_fillmein" id="upgrading_fillmein">Fill me in</a></h3>
+ <h3 id="upgrading_fillmein">Fill me in</h3>
<p>In order to take advantage of fill me in.</p>
- <h3><a name="upgrading_byfunction" id="upgrading_byfunction">If your module uses these existing APIs...</a></h3>
+ <h3 id="upgrading_byfunction">If your module uses these existing APIs...</h3>
<dl>
</dl>
- <h3><a name="upgrading_byfeature" id="upgrading_byfeature">If your module interfaces with this feature...</a></h3>
+ <h3 id="upgrading_byfeature">If your module interfaces with this feature...</h3>
<dl>
<dt>fillmin</dt>
</dl>
- <h3><a name="upgrading_newfeatures" id="upgrading_newfeatures">Does your module...</a></h3>
+ <h3 id="upgrading_newfeatures">Does your module...</h3>
<dl>
<dt>Fill me in</dt>
<p><span>Available Languages: </span><a href="../en/developer/new_api_2_6.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basics" id="basics">Filters and bucket brigades</a> <a title="Permanent link" href="#basics" class="permalink">¶</a></h2>
+<h2
id="basics">Filters and bucket brigades <a title="Permanent link" href="#basics" class="permalink">¶</a></h2>
<p>Each time a filter is invoked, it is passed a <em>bucket
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="invocation" id="invocation">Filter invocation</a> <a title="Permanent link" href="#invocation" class="permalink">¶</a></h2>
+<h2
id="invocation">Filter invocation <a title="Permanent link" href="#invocation" class="permalink">¶</a></h2>
<p>For any given request, an output filter might be invoked only
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="brigade" id="brigade">Brigade structure</a> <a title="Permanent link" href="#brigade" class="permalink">¶</a></h2>
+<h2
id="brigade">Brigade structure <a title="Permanent link" href="#brigade" class="permalink">¶</a></h2>
<p>A bucket brigade is a doubly-linked list of buckets. The list
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="buckets" id="buckets">Processing buckets</a> <a title="Permanent link" href="#buckets" class="permalink">¶</a></h2>
+<h2
id="buckets">Processing buckets <a title="Permanent link" href="#buckets" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="filtering" id="filtering">Filtering brigades</a> <a title="Permanent link" href="#filtering" class="permalink">¶</a></h2>
+<h2
id="filtering">Filtering brigades <a title="Permanent link" href="#filtering" class="permalink">¶</a></h2>
<p>The basic function of any output filter will be to iterate
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="state" id="state">Maintaining state</a> <a title="Permanent link" href="#state" class="permalink">¶</a></h2>
+<h2
id="state">Maintaining state <a title="Permanent link" href="#state" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="buffer" id="buffer">Buffering buckets</a> <a title="Permanent link" href="#buffer" class="permalink">¶</a></h2>
+<h2
id="buffer">Buffering buckets <a title="Permanent link" href="#buffer" class="permalink">¶</a></h2>
<p>If a filter decides to store buckets beyond the duration of a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="nonblock" id="nonblock">Non-blocking bucket reads</a> <a title="Permanent link" href="#nonblock" class="permalink">¶</a></h2>
+<h2
id="nonblock">Non-blocking bucket reads <a title="Permanent link" href="#nonblock" class="permalink">¶</a></h2>
<p>The <code>apr_bucket_read</code> function takes an
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rules" id="rules">Ten rules for output filters</a> <a title="Permanent link" href="#rules" class="permalink">¶</a></h2>
+<h2
id="rules">Ten rules for output filters <a title="Permanent link" href="#rules" class="permalink">¶</a></h2>
<p>In summary, here is a set of rules for all output filters to
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usecase1" id="usecase1">Use case: buffering in mod_ratelimit</a> <a title="Permanent link" href="#usecase1" class="permalink">¶</a></h2>
+<h2
id="usecase1">Use case: buffering in mod_ratelimit <a title="Permanent link" href="#usecase1" class="permalink">¶</a></h2>
<p>The <a href="http://svn.apache.org/r1833875">r1833875</a> change is a good
example to show what buffering and keeping state means in the context of an
<p><span>Available Languages: </span><a href="../en/developer/output-filters.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="overview" id="overview">Hook Overview</a> <a title="Permanent link" href="#overview" class="permalink">¶</a></h2>
+<h2
id="overview">Hook Overview <a title="Permanent link" href="#overview" class="permalink">¶</a></h2>
<p>The complete request processing cycle involves the following hooks,
listed in execution order. Hooks marked with <em>(request.c)</em> are
implemented in <code>server/request.c</code>; others are declared
override <code>apr_stat()</code> calls.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="parsing" id="parsing">The Request Parsing Phase</a> <a title="Permanent link" href="#parsing" class="permalink">¶</a></h2>
+<h2
id="parsing">The Request Parsing Phase <a title="Permanent link" href="#parsing" class="permalink">¶</a></h2>
<p>Before hooks run, the server performs URL normalization:</p>
- <h3><a name="unescape" id="unescape">Unescapes the URL</a></h3>
+ <h3 id="unescape">Unescapes the URL</h3>
<p>The request's <code>parsed_uri</code> path is unescaped, once and only
once, at the beginning of internal request processing.</p>
repercussions.</p>
- <h3><a name="strip" id="strip">Strips Parent and This Elements from the
- URI</a></h3>
+ <h3 id="strip">Strips Parent and This Elements from the
+ URI</h3>
<p>All <code>/../</code> and <code>/./</code> elements are
removed by <code>ap_getparents()</code>, as well as any trailing
<code>/.</code> or <code>/..</code> element. This helps to ensure
<p>This step cannot be bypassed.</p>
- <h3><a name="initial-location-walk" id="initial-location-walk">Initial URI Location Walk</a></h3>
+ <h3 id="initial-location-walk">Initial URI Location Walk</h3>
<p>Every request is subject to an
<code>ap_location_walk()</code> call. This ensures that
<code class="directive"><a href="../mod/core.html#location"><Location></a></code> sections
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="quick_handler" id="quick_handler">Hook: quick_handler</a> <a title="Permanent link" href="#quick_handler" class="permalink">¶</a></h2>
+<h2
id="quick_handler">Hook: quick_handler <a title="Permanent link" href="#quick_handler" class="permalink">¶</a></h2>
<p>The <code>quick_handler</code> hook runs <em>before</em> any other
request processing hooks — before location walks, directory walks,
access checking, and authentication. It provides a fast path for
Return <code>DECLINED</code> to fall through to normal processing.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="create_request" id="create_request">Hook: create_request</a> <a title="Permanent link" href="#create_request" class="permalink">¶</a></h2>
+<h2
id="create_request">Hook: create_request <a title="Permanent link" href="#create_request" class="permalink">¶</a></h2>
<p>Called when a new <code>request_rec</code> is created (for main
requests, subrequests, and internal redirects). Modules use this hook
to initialize per-request module state and set up private data
<code class="module"><a href="../mod/mod_firehose.html">mod_firehose</a></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="translation" id="translation">The Translation Phase</a> <a title="Permanent link" href="#translation" class="permalink">¶</a></h2>
+<h2
id="translation">The Translation Phase <a title="Permanent link" href="#translation" class="permalink">¶</a></h2>
- <h3><a name="pre_translate_name" id="pre_translate_name">Hook: pre_translate_name</a></h3>
+ <h3 id="pre_translate_name">Hook: pre_translate_name</h3>
<p>Runs before URL decoding happens. Modules can manipulate the
raw URI before it is translated to a filesystem path. This is
useful for modules that need to operate on the URI before
<p>Used by: <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></p>
- <h3><a name="translate_name" id="translate_name">Hook: translate_name</a></h3>
+ <h3 id="translate_name">Hook: translate_name</h3>
<p>Modules can determine the file name, or alter the given URI
in this step. For example, <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> will
translate the URI's path into the configured virtual host,
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="map_to_storage" id="map_to_storage">Hook: map_to_storage</a> <a title="Permanent link" href="#map_to_storage" class="permalink">¶</a></h2>
+<h2
id="map_to_storage">Hook: map_to_storage <a title="Permanent link" href="#map_to_storage" class="permalink">¶</a></h2>
<p>After the file or correct URI was determined, the
appropriate per-dir configurations are merged together. For
example, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> compares and merges the appropriate
to the translated URI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="post_perdir_config" id="post_perdir_config">Hook: post_perdir_config</a> <a title="Permanent link" href="#post_perdir_config" class="permalink">¶</a></h2>
+<h2
id="post_perdir_config">Hook: post_perdir_config <a title="Permanent link" href="#post_perdir_config" class="permalink">¶</a></h2>
<p>This hook fires immediately after per-directory configuration has been
merged (after both <code>map_to_storage</code> and the second location
walk). Modules can use it to act on the fully-merged per-directory
error status code to abort.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="header_parser" id="header_parser">Hook: header_parser</a> <a title="Permanent link" href="#header_parser" class="permalink">¶</a></h2>
+<h2
id="header_parser">Hook: header_parser <a title="Permanent link" href="#header_parser" class="permalink">¶</a></h2>
<p>The main request then parses the client's headers. This
prepares the remaining request processing steps to better serve
the client's request. This hook only runs for the initial
request (not subrequests).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">The Security Phase</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">The Security Phase <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>The security phase in 2.4+ uses the "new" provider-based
authentication/authorization architecture managed by
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>,
<p>The hooks execute in this order:</p>
- <h3><a name="token_checker" id="token_checker">Hook: token_checker</a></h3>
+ <h3 id="token_checker">Hook: token_checker</h3>
<p>Parses any tokens in the request (e.g. bearer tokens, API keys)
that contain metadata such as user identities or IP addresses
relevant to the request. Runs before the access checker.</p>
at the time of writing).</p></div>
- <h3><a name="access_checker" id="access_checker">Hook: access_checker</a></h3>
+ <h3 id="access_checker">Hook: access_checker</h3>
<p>Applies additional access control to the resource. This hook runs
<em>before</em> a user is authenticated, so it is for restrictions
independent of user identity (e.g. IP-based access, time-of-day
Return <code>OK</code> to allow, or an HTTP error status to deny.</p>
- <h3><a name="access_checker_ex" id="access_checker_ex">Hook: access_checker_ex</a></h3>
+ <h3 id="access_checker_ex">Hook: access_checker_ex</h3>
<p>Extended access control that runs after <code>access_checker</code>
but before user authentication. This hook can also <em>bypass</em>
authentication entirely by returning <code>OK</code> — used by
require authentication, or an HTTP error status to deny.</p>
- <h3><a name="force_authn" id="force_authn">Hook: force_authn</a></h3>
+ <h3 id="force_authn">Hook: force_authn</h3>
<p>Allows a module to force authentication to be required even when
<code>access_checker_ex</code> has already granted access. This is
useful when a module needs the authenticated user identity for
<code>DECLINED</code> to let later modules decide.</p>
- <h3><a name="check_user_id" id="check_user_id">Hook: check_user_id (authn)</a></h3>
+ <h3 id="check_user_id">Hook: check_user_id (authn)</h3>
<p>Authenticates the user — analyzes the request headers, validates
credentials, and sets <code>r->user</code> and
<code>r->ap_auth_type</code>. This hook only runs when Apache
rather than hooking <code>check_user_id</code> directly.</p>
- <h3><a name="auth_checker" id="auth_checker">Hook: auth_checker (authz)</a></h3>
+ <h3 id="auth_checker">Hook: auth_checker (authz)</h3>
<p>Checks whether the authenticated user (<code>r->user</code>)
is authorized to access this resource. Runs after
<code>check_user_id</code>, and only when a <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive is
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="preparation" id="preparation">The Preparation Phase</a> <a title="Permanent link" href="#preparation" class="permalink">¶</a></h2>
- <h3><a name="type_checker" id="type_checker">Hook: type_checker</a></h3>
+<h2
id="preparation">The Preparation Phase <a title="Permanent link" href="#preparation" class="permalink">¶</a></h2>
+ <h3 id="type_checker">Hook: type_checker</h3>
<p>The modules have an opportunity to test the URI or filename
against the target resource, and set mime information for the
request. Both <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> and
automatically.</p>
- <h3><a name="fixups" id="fixups">Hook: fixups</a></h3>
+ <h3 id="fixups">Hook: fixups</h3>
<p>Many modules are "trounced" by some phase above. The fixups
phase is used by modules to reassert their ownership or force
the request's fields to their appropriate values. It is the last
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="handler" id="handler">The Handler Phase</a> <a title="Permanent link" href="#handler" class="permalink">¶</a></h2>
+<h2
id="handler">The Handler Phase <a title="Permanent link" href="#handler" class="permalink">¶</a></h2>
<p>This phase is <strong>not</strong> part of the processing in
<code>ap_process_request_internal()</code>. After the core or a module
calls <code>ap_process_request_internal()</code>, it then calls
<code>ap_invoke_handler()</code> to generate the request.</p>
- <h3><a name="insert_filter" id="insert_filter">Hook: insert_filter</a></h3>
+ <h3 id="insert_filter">Hook: insert_filter</h3>
<p>Modules that transform the content in some way can insert
their values and override existing filters, such that if the
user configured a more advanced filter out-of-order, then the
themselves into the output filter chain.</p>
- <h3><a name="hook_handler" id="hook_handler">Hook: handler</a></h3>
+ <h3 id="hook_handler">Hook: handler</h3>
<p>The module finally has a chance to serve the request in its
handler hook. Note that not every prepared request is sent to
the handler hook. Many modules, such as <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>,
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logging" id="logging">The Logging Phase</a> <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
- <h3><a name="log_transaction" id="log_transaction">Hook: log_transaction</a></h3>
+<h2
id="logging">The Logging Phase <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
+ <h3 id="log_transaction">Hook: log_transaction</h3>
<p>After the response has been sent to the client, modules can
perform logging activities. This hook is declared in
<code>http_protocol.h</code> and runs outside of
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dirwalk_stat" id="dirwalk_stat">Hook: dirwalk_stat</a> <a title="Permanent link" href="#dirwalk_stat" class="permalink">¶</a></h2>
+<h2
id="dirwalk_stat">Hook: dirwalk_stat <a title="Permanent link" href="#dirwalk_stat" class="permalink">¶</a></h2>
<p>This hook is called during directory walks to allow modules to
handle or emulate the <code>apr_stat()</code> calls needed to
traverse the filesystem. This enables modules to serve content
<code>apr_stat()</code> call) decide.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="hookorder" id="hookorder">Hook Types and Ordering</a> <a title="Permanent link" href="#hookorder" class="permalink">¶</a></h2>
+<h2
id="hookorder">Hook Types and Ordering <a title="Permanent link" href="#hookorder" class="permalink">¶</a></h2>
<p>Each hook uses one of the following execution strategies:</p>
<dl>
<p><span>Available Languages: </span><a href="../en/developer/request.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="variables" id="variables">Global and static variables</a> <a title="Permanent link" href="#variables" class="permalink">¶</a></h2>
+<h2
id="variables">Global and static variables <a title="Permanent link" href="#variables" class="permalink">¶</a></h2>
<p>When writing your module or when trying to determine if a module or
3rd party library is thread safe there are some common things to keep in
mind.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="errno" id="errno">errno</a> <a title="Permanent link" href="#errno" class="permalink">¶</a></h2>
+<h2
id="errno">errno <a title="Permanent link" href="#errno" class="permalink">¶</a></h2>
<p>This is a common global variable that holds the error number of the
last error that occurred. If one thread calls a low-level function that
sets errno and then another thread checks it, we are bleeding error
<code>_SVID_SOURCE</code>, and <code>_BSD_SOURCE</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="functions" id="functions">Common standard troublesome functions</a> <a title="Permanent link" href="#functions" class="permalink">¶</a></h2>
+<h2
id="functions">Common standard troublesome functions <a title="Permanent link" href="#functions" class="permalink">¶</a></h2>
<p>Not only do things have to be thread safe, but they also have to be
reentrant. <code>strtok()</code> is an obvious one. You call it the first
time with your delimiter which it then remembers and on each subsequent
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="commonlibs" id="commonlibs">Common 3rd Party Libraries</a> <a title="Permanent link" href="#commonlibs" class="permalink">¶</a></h2>
+<h2
id="commonlibs">Common 3rd Party Libraries <a title="Permanent link" href="#commonlibs" class="permalink">¶</a></h2>
<p>The following is a list of common libraries that are used by 3rd party
Apache modules. You can check to see if your module is using a potentially
unsafe library by using tools such as <code>ldd(1)</code> and
to look for individual symbols in the module.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="liblist" id="liblist">Library List</a> <a title="Permanent link" href="#liblist" class="permalink">¶</a></h2>
+<h2
id="liblist">Library List <a title="Permanent link" href="#liblist" class="permalink">¶</a></h2>
<p>Please drop a note to <a href="http://httpd.apache.org/lists.html#http-dev">dev@httpd.apache.org</a>
if you have additions or corrections to this list.</p>
<p><span>Available Languages: </span><a href="../en/developer/thread_safety.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="example" id="example">A Simple Example</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<h2
id="example">A Simple Example <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<pre class="prettyprint lang-config"># This is a misconfiguration example, do not use on your server
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="denial" id="denial">Denial of Service</a> <a title="Permanent link" href="#denial" class="permalink">¶</a></h2>
+<h2
id="denial">Denial of Service <a title="Permanent link" href="#denial" class="permalink">¶</a></h2>
<p>Consider this configuration snippet:</p>
serve it. A rough document describing this <a href="vhosts/details.html">is available</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="main" id="main">The "main server" Address</a> <a title="Permanent link" href="#main" class="permalink">¶</a></h2>
+<h2
id="main">The "main server" Address <a title="Permanent link" href="#main" class="permalink">¶</a></h2>
<p><a href="vhosts/name-based.html">Name-based
to consult the man pages or FAQs for your OS.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="tips" id="tips">Tips to Avoid These Problems</a> <a title="Permanent link" href="#tips" class="permalink">¶</a></h2>
+<h2
id="tips">Tips to Avoid These Problems <a title="Permanent link" href="#tips" class="permalink">¶</a></h2>
<ul>
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="implementation" id="implementation">Implementation</a> <a title="Permanent link" href="#implementation" class="permalink">¶</a></h2>
+<h2
id="implementation">Implementation <a title="Permanent link" href="#implementation" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
support.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usage" id="usage">Usage Summary</a> <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
+<h2
id="usage">Usage Summary <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
<p>To give you an overview of the DSO features of Apache HTTP Server 2.x,
here is a short and concise summary:</p>
<p>See the <a href="programs/apxs.html">apxs documentation</a> for more details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="background" id="background">Background</a> <a title="Permanent link" href="#background" class="permalink">¶</a></h2>
+<h2
id="background">Background <a title="Permanent link" href="#background" class="permalink">¶</a></h2>
<p>On modern Unix derivatives there exists a mechanism
called dynamic linking/loading of <em>Dynamic Shared
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="advantages" id="advantages">Advantages and Disadvantages</a> <a title="Permanent link" href="#advantages" class="permalink">¶</a></h2>
+<h2
id="advantages">Advantages and Disadvantages <a title="Permanent link" href="#advantages" class="permalink">¶</a></h2>
<p>The above DSO based features have the following
advantages:</p>
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="setting" id="setting">Setting Environment Variables</a> <a title="Permanent link" href="#setting" class="permalink">¶</a></h2>
+<h2
id="setting">Setting Environment Variables <a title="Permanent link" href="#setting" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
- <h3><a name="basic-manipulation" id="basic-manipulation">Basic Environment Manipulation</a></h3>
+ <h3 id="basic-manipulation">Basic Environment Manipulation</h3>
<p>The most basic way to set an environment variable in Apache
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> directive.</p>
- <h3><a name="conditional" id="conditional">Conditional Per-Request Settings</a></h3>
+ <h3 id="conditional">Conditional Per-Request Settings</h3>
<p>For additional flexibility, the directives provided by
<code>[E=...]</code> option to set environment variables.</p>
- <h3><a name="unique-identifiers" id="unique-identifiers">Unique Identifiers</a></h3>
+ <h3 id="unique-identifiers">Unique Identifiers</h3>
<p>Finally, <code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> sets the environment
specific conditions.</p>
- <h3><a name="standard-cgi" id="standard-cgi">Standard CGI Variables</a></h3>
+ <h3 id="standard-cgi">Standard CGI Variables</h3>
<p>In addition to all environment variables set within the
the CGI specification (<a href="https://www.rfc-editor.org/rfc/rfc3875">RFC 3875</a>).</p>
- <h3><a name="caveats" id="caveats">Some Caveats</a></h3>
+ <h3 id="caveats">Some Caveats</h3>
<ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="using" id="using">Using Environment Variables</a> <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
+<h2
id="using">Using Environment Variables <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
<a href="expr.html#vars">variables</a>.</p>
</div>
- <h3><a name="cgi-scripts" id="cgi-scripts">CGI Scripts</a></h3>
+ <h3 id="cgi-scripts">CGI Scripts</h3>
<p>One of the primary uses of environment variables is to
<a href="howto/cgi.html">CGI tutorial</a>.</p>
- <h3><a name="ssi-pages" id="ssi-pages">SSI Pages</a></h3>
+ <h3 id="ssi-pages">SSI Pages</h3>
<p>Server-parsed (SSI) documents processed by
as discussed above. For more details, see the <a href="howto/ssi.html">SSI tutorial</a>.</p>
- <h3><a name="access-control" id="access-control">Access Control</a></h3>
+ <h3 id="access-control">Access Control</h3>
<p>Access to the server can be controlled based on
</p>
- <h3><a name="logging" id="logging">Conditional Logging</a></h3>
+ <h3 id="logging">Conditional Logging</h3>
<p>Environment variables can be logged in the access log using
subnet.</p>
- <h3><a name="response-headers" id="response-headers">Conditional Response Headers</a></h3>
+ <h3 id="response-headers">Conditional Response Headers</h3>
<p>The <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
- <h3><a name="external-filter" id="external-filter">External Filter Activation</a></h3>
+ <h3 id="external-filter">External Filter Activation</h3>
<p>External filters configured by <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>
<code>disableenv=</code> and <code>enableenv=</code> options.</p>
- <h3><a name="url-rewriting" id="url-rewriting">URL Rewriting</a></h3>
+ <h3 id="url-rewriting">URL Rewriting</h3>
<p>The <code>%{ENV:<em>variable</em>}</code> form of
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cgi" id="cgi">CGI environment variables</a> <a title="Permanent link" href="#cgi" class="permalink">¶</a></h2>
+<h2
id="cgi">CGI environment variables <a title="Permanent link" href="#cgi" class="permalink">¶</a></h2>
<p>The CGI specification (<a href="https://www.rfc-editor.org/rfc/rfc3875#section-4.1">RFC 3875</a>) defines a number of environment
<p>Refer to the CGI spec for further details of the standard
CGI meta-variables.</p>
- <h3><a name="query-string" id="query-string">QUERY_STRING</a></h3>
+ <h3 id="query-string">QUERY_STRING</h3>
<p>The <code>QUERY_STRING</code> variable is set to
anything that appears after a question mark (?) at the
- <h3><a name="path-info" id="path-info">PATH_INFO</a></h3>
+ <h3 id="path-info">PATH_INFO</h3>
<p>The variable <a class="glossarylink" href="./glossary.html#pathinfo" title="see glossary">PATH_INFO</a> is set to
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="special" id="special">Special Purpose Environment Variables</a> <a title="Permanent link" href="#special" class="permalink">¶</a></h2>
+<h2
id="special">Special Purpose Environment Variables <a title="Permanent link" href="#special" class="permalink">¶</a></h2>
<p>Interoperability problems have led to the introduction of
possible, they are invoked by defining environment variables,
typically with <code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, though <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> and <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> could also be used, for example.</p>
- <h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
+ <h3 id="downgrade">downgrade-1.0</h3>
<p>This forces the request to be treated as a HTTP/1.0 request
even if it was in a later dialect.</p>
- <h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
+ <h3 id="force-gzip">force-gzip</h3>
<p>If you have the <code>DEFLATE</code> filter activated, this
environment variable will ignore the accept-encoding setting of
your browser and will send compressed output unconditionally.</p>
- <h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
+ <h3 id="force-no-vary">force-no-vary</h3>
<p>This causes any <code>Vary</code> fields to be removed from
also implies <strong>force-response-1.0</strong>.</p>
- <h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
+ <h3 id="force-response">force-response-1.0</h3>
<p>This forces an HTTP/1.0 response to clients making an HTTP/1.0
- <h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
+ <h3 id="gzip-only-text-html">gzip-only-text/html</h3>
<p>When set to a value of "1", this variable disables the
encodings that differ from "identity").</p>
- <h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
+ <h3 id="no-gzip">no-gzip</h3>
<p>When set, the <code>DEFLATE</code> filter of
<code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> will be turned off and
- <h3><a name="no-cache" id="no-cache">no-cache</a></h3>
+ <h3 id="no-cache">no-cache</h3>
<p><em>Available in versions 2.2.12 and later</em></p>
<p>When set, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will not save an otherwise
- <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
+ <h3 id="nokeepalive">nokeepalive</h3>
<p>This disables <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
- <h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
+ <h3 id="prefer-language">prefer-language</h3>
<p>This influences <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>'s behavior. If
it contains a language tag (such as <code>en</code>, <code>ja</code>
- <h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
+ <h3 id="redirect-carefully">redirect-carefully</h3>
<p>This forces the server to be more careful when sending a redirect
- <h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
+ <h3 id="suppress-error-charset">suppress-error-charset</h3>
<p>When Apache issues a redirect in response to a client request,
- <h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked,
- proxy-sendcl, proxy-chain-auth, proxy-interim-response, proxy-initial-not-pooled</a></h3>
+ <h3 id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked,
+ proxy-sendcl, proxy-chain-auth, proxy-interim-response, proxy-initial-not-pooled</h3>
<p>These directives alter the protocol behavior of
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>. See the <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> and <code class="module"><a href="./mod/mod_proxy_http.html">mod_proxy_http</a></code>
documentation for more details.</p>
- <h3><a name="cgilike" id="cgilike">ap_trust_cgilike_cl</a></h3>
+ <h3 id="cgilike">ap_trust_cgilike_cl</h3>
<p><em>Available in 2.4.59 and later</em></p>
<p> This variable allows a script running in CGI-like module to supply its
own Content-Length HTTP response header. It should
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="redirect-vars" id="redirect-vars">REDIRECT_ variables</a> <a title="Permanent link" href="#redirect-vars" class="permalink">¶</a></h2>
+<h2
id="redirect-vars">REDIRECT_ variables <a title="Permanent link" href="#redirect-vars" class="permalink">¶</a></h2>
<p>When an internal redirect occurs — whether from an
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>,
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
- <h3><a name="fixheader" id="fixheader">Passing broken headers to CGI scripts</a></h3>
+ <h3 id="fixheader">Passing broken headers to CGI scripts</h3>
<p>Starting with version 2.4, Apache is more strict about how HTTP
- <h3><a name="misbehaving" id="misbehaving">Changing protocol behavior with misbehaving clients</a></h3>
+ <h3 id="misbehaving">Changing protocol behavior with misbehaving clients</h3>
<p>Earlier versions recommended that the following lines be included in
- <h3><a name="no-img-log" id="no-img-log">Do not log requests for images in the access log</a></h3>
+ <h3 id="no-img-log">Do not log requests for images in the access log</h3>
<p>This example keeps requests for images from appearing in the
- <h3><a name="image-theft" id="image-theft">Prevent "Image Theft"</a></h3>
+ <h3 id="image-theft">Prevent "Image Theft"</h3>
<p>This example shows how to keep people not on your server
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="directive"><a href="./mod/core.html#if"><If></a></code></li><li><code class="directive"><a href="./mod/core.html#elseif"><ElseIf></a></code></li><li><code class="directive"><a href="./mod/core.html#else"><Else></a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_auth_basic.html#authbasicfake">AuthBasicFake</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformlogoutlocation">AuthFormLogoutLocation</a></code></li><li><code class="directive"><a href="./mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifexpr">SetEnvIfExpr</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#requestheader">RequestHeader</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><code class="directive"><a href="./mod/mod_crypto.html#cryptokey">CryptoKey</a></code></li><li><code class="directive"><a href="./mod/mod_crypto.html#cryptoiv">CryptoIV</a></code></li><li><a href="mod/mod_authz_core.html#reqexpr">Require expr</a></li><li><a href="mod/mod_authnz_ldap.html#requser">Require ldap-user</a></li><li><a href="mod/mod_authnz_ldap.html#reqgroup">Require ldap-group</a></li><li><a href="mod/mod_authnz_ldap.html#reqdn">Require ldap-dn</a></li><li><a href="mod/mod_authnz_ldap.html#reqattribute">Require ldap-attribute</a></li><li><a href="mod/mod_authnz_ldap.html#reqfilter">Require ldap-filter</a></li><li><a href="mod/mod_authnz_ldap.html#reqsearch">Require ldap-search</a></li><li><a href="mod/mod_authz_dbd.html#reqgroup">Require dbd-group</a></li><li><a href="mod/mod_authz_dbm.html#reqgroup">Require dbm-group</a></li><li><a href="mod/mod_authz_groupfile.html#reqgroup">Require group</a></li><li><a href="mod/mod_authz_host.html#reqhost">Require host</a></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code></li><li><code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><a href="env.html">Environment Variables in Apache httpd</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="grammar" id="grammar">Grammar in Backus-Naur Form notation</a> <a title="Permanent link" href="#grammar" class="permalink">¶</a></h2>
+<h2
id="grammar">Grammar in Backus-Naur Form notation <a title="Permanent link" href="#grammar" class="permalink">¶</a></h2>
<p><a href="http://en.wikipedia.org/wiki/Backus%E2%80%93Naur_Form">Backus-Naur
Form</a> (BNF) is a notation technique for context-free grammars,
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="vars" id="vars">Variables</a> <a title="Permanent link" href="#vars" class="permalink">¶</a></h2>
+<h2
id="vars">Variables <a title="Permanent link" href="#vars" class="permalink">¶</a></h2>
<p>The expression parser provides a number of variables of the form
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="binop" id="binop">Binary operators</a> <a title="Permanent link" href="#binop" class="permalink">¶</a></h2>
+<h2
id="binop">Binary operators <a title="Permanent link" href="#binop" class="permalink">¶</a></h2>
<p>With the exception of some built-in comparison operators, binary
minus and at least two characters. The name is not case sensitive.
Modules may register additional binary operators.</p>
- <h3><a name="comp" id="comp">Comparison operators</a></h3>
+ <h3 id="comp">Comparison operators</h3>
<table class="bordered"><tr class="header"><th>Name</th><th>Alternative</th> <th>Description</th></tr>
</table>
- <h3><a name="binaryother" id="binaryother">Other binary operators</a></h3>
+ <h3 id="binaryother">Other binary operators</h3>
<table class="bordered"><tr class="header"><th>Name</th><th>Description</th></tr>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="unnop" id="unnop">Unary operators</a> <a title="Permanent link" href="#unnop" class="permalink">¶</a></h2>
+<h2
id="unnop">Unary operators <a title="Permanent link" href="#unnop" class="permalink">¶</a></h2>
<p>Unary operators take one argument and have the form
like <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="functions" id="functions">Functions</a> <a title="Permanent link" href="#functions" class="permalink">¶</a></h2>
+<h2
id="functions">Functions <a title="Permanent link" href="#functions" class="permalink">¶</a></h2>
<p>Normal string-valued functions take one string as argument and return
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="other" id="other">Other</a> <a title="Permanent link" href="#other" class="permalink">¶</a></h2>
+<h2
id="other">Other <a title="Permanent link" href="#other" class="permalink">¶</a></h2>
<table class="bordered"><tr class="header"><th>Name</th><th>Alternative</th> <th>Description</th></tr>
<td>Regular expression backreferences</td></tr>
</table>
- <h3><a name="rebackref" id="rebackref">Regular expression backreferences</a></h3>
+ <h3 id="rebackref">Regular expression backreferences</h3>
<p>The strings <code>$0</code> ... <code>$9</code> allow to reference
the capture groups from a previously executed, successfully
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="sslrequire" id="sslrequire">Comparison with SSLRequire</a> <a title="Permanent link" href="#sslrequire" class="permalink">¶</a></h2>
+<h2
id="sslrequire">Comparison with SSLRequire <a title="Permanent link" href="#sslrequire" class="permalink">¶</a></h2>
<p>The <em>ap_expr</em> syntax is mostly a superset of the syntax of the
deprecated <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> directive.
The differences are described in <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>'s documentation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="compatibility" id="compatibility">Version History</a> <a title="Permanent link" href="#compatibility" class="permalink">¶</a></h2>
+<h2
id="compatibility">Version History <a title="Permanent link" href="#compatibility" class="permalink">¶</a></h2>
<p>The <code>req_novary</code> <a href="#functions">function</a>
is available for versions 2.4.4 and later.</p>
are available for versions 2.5.0 and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Example expressions</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Example expressions <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>The following examples show how expressions might be used to
<a href="./fr/expr.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="intro" id="intro">Filtering in Apache 2</a> <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
+<h2
id="intro">Filtering in Apache 2 <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code></li><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></li><li><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code></li><li><code class="module"><a href="./mod/mod_buffer.html">mod_buffer</a></code></li><li><code class="module"><a href="./mod/mod_data.html">mod_data</a></code></li><li><code class="module"><a href="./mod/mod_ratelimit.html">mod_ratelimit</a></code></li><li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code></li><li><code class="module"><a href="./mod/mod_request.html">mod_request</a></code></li><li><code class="module"><a href="./mod/mod_sed.html">mod_sed</a></code></li><li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code></li><li><code class="module"><a href="./mod/mod_xml2enc.html">mod_xml2enc</a></code></li><li><code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code></li><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprotocol">FilterProtocol</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_reflector.html#reflectorheader">ReflectorHeader</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="smart" id="smart">Smart Filtering</a> <a title="Permanent link" href="#smart" class="permalink">¶</a></h2>
+<h2
id="smart">Smart Filtering <a title="Permanent link" href="#smart" class="permalink">¶</a></h2>
<p class="figure">
<img src="images/mod_filter_new.png" width="423" height="331" alt="Smart filtering applies different filter providers according to the state of request processing">
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="service" id="service">Exposing Filters as an HTTP Service</a> <a title="Permanent link" href="#service" class="permalink">¶</a></h2>
+<h2
id="service">Exposing Filters as an HTTP Service <a title="Permanent link" href="#service" class="permalink">¶</a></h2>
<p>Filters can be used to process content originating from the client in
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="using" id="using">Using Filters</a> <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
+<h2
id="using">Using Filters <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
<p>There are two ways to use filtering: Simple and Dynamic.
In general, you should use one or the other; mixing them can
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="clientserver" id="clientserver">Clients, Servers, and URLs</a> <a title="Permanent link" href="#clientserver" class="permalink">¶</a></h2>
+<h2
id="clientserver">Clients, Servers, and URLs <a title="Permanent link" href="#clientserver" class="permalink">¶</a></h2>
<p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dns" id="dns">Hostnames and DNS</a> <a title="Permanent link" href="#dns" class="permalink">¶</a></h2>
+<h2
id="dns">Hostnames and DNS <a title="Permanent link" href="#dns" class="permalink">¶</a></h2>
<p>In order to connect to a server, the client will first have to resolve
more about DNS at <a href="http://en.wikipedia.org/wiki/Domain_Name_System">Wikipedia.org/wiki/Domain_Name_System</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configuration" id="configuration">Configuration Files and Directives</a> <a title="Permanent link" href="#configuration" class="permalink">¶</a></h2>
+<h2
id="configuration">Configuration Files and Directives <a title="Permanent link" href="#configuration" class="permalink">¶</a></h2>
<p>The Apache HTTP Server is configured via simple text files.
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="content" id="content">Web Site Content</a> <a title="Permanent link" href="#content" class="permalink">¶</a></h2>
+<h2
id="content">Web Site Content <a title="Permanent link" href="#content" class="permalink">¶</a></h2>
<p>Web site content can take many different forms, but may be broadly
about them.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logs" id="logs">Log Files and Troubleshooting</a> <a title="Permanent link" href="#logs" class="permalink">¶</a></h2>
+<h2
id="logs">Log Files and Troubleshooting <a title="Permanent link" href="#logs" class="permalink">¶</a></h2>
<p>As an Apache HTTP Server administrator, your most valuable assets are
the log files, and, in particular, the error log. Troubleshooting any
documentation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="other" id="other">What's next?</a> <a title="Permanent link" href="#other" class="permalink">¶</a></h2>
+<h2
id="other">What's next? <a title="Permanent link" href="#other" class="permalink">¶</a></h2>
<p>Once you have the prerequisites under your belt, it's time to move
<a href="./ru/getting-started.html" hreflang="ru" rel="alternate" title="Russian"> ru </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="definitions" id="definitions">Definitions</a> <a title="Permanent link" href="#definitions" class="permalink">¶</a></h2>
+<h2
id="definitions">Definitions <a title="Permanent link" href="#definitions" class="permalink">¶</a></h2>
<dl>
<dt><a name="accesscontrol" id="accesscontrol">Access Control</a></dt>
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="definition" id="definition">What is a Handler</a> <a title="Permanent link" href="#definition" class="permalink">¶</a></h2>
+<h2
id="definition">What is a Handler <a title="Permanent link" href="#definition" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code></li><li><code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code></li><li><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></li><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li><li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></li><li><code class="module"><a href="./mod/mod_status.html">mod_status</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removehandler">RemoveHandler</a></code></li><li><code class="directive"><a href="./mod/core.html#sethandler">SetHandler</a></code></li></ul></td></tr></table>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
- <h3><a name="example1" id="example1">Modifying static content using a CGI script</a></h3>
+ <h3 id="example1">Modifying static content using a CGI script</h3>
<p>The following directives will cause requests for files with
whatever modifications or additions are desired.</p>
- <h3><a name="example2" id="example2">Files with HTTP headers</a></h3>
+ <h3 id="example2">Files with HTTP headers</h3>
<p>The following directives will enable the
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="programmer" id="programmer">Programmer's Note</a> <a title="Permanent link" href="#programmer" class="permalink">¶</a></h2>
+<h2
id="programmer">Programmer's Note <a title="Permanent link" href="#programmer" class="permalink">¶</a></h2>
<p>In order to implement the handler features, an addition has
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="related" id="related">Related Modules and Directives</a> <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
+<h2
id="related">Related Modules and Directives <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
<p>Access control can be done by several different modules. The most
important of these are <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> and
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="host" id="host">Access control by host</a> <a title="Permanent link" href="#host" class="permalink">¶</a></h2>
+<h2
id="host">Access control by host <a title="Permanent link" href="#host" class="permalink">¶</a></h2>
<p>
If you wish to restrict access to portions of your site based on the
host address of your visitors, this is most easily done using
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="env" id="env">Access control by arbitrary variables</a> <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
+<h2
id="env">Access control by arbitrary variables <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
<p>Using the <code class="directive"><a href="../mod/core.html#if"><If></a></code>,
you can allow or deny access based on arbitrary environment
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rewrite" id="rewrite">Access control with mod_rewrite</a> <a title="Permanent link" href="#rewrite" class="permalink">¶</a></h2>
+<h2
id="rewrite">Access control with mod_rewrite <a title="Permanent link" href="#rewrite" class="permalink">¶</a></h2>
<p>The <code>[F]</code> <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> flag causes a 403 Forbidden
response to be sent. Using this, you can deny access to a resource based
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="moreinformation" id="moreinformation">More information</a> <a title="Permanent link" href="#moreinformation" class="permalink">¶</a></h2>
+<h2
id="moreinformation">More information <a title="Permanent link" href="#moreinformation" class="permalink">¶</a></h2>
<p>The <a href="../expr.html">expression engine</a> gives you a
great deal of power to do a variety of things based on arbitrary
<a href="../fr/howto/access.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="related" id="related">Related Modules and Directives</a> <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
+<h2
id="related">Related Modules and Directives <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
<p>There are three types of modules involved in the authentication and
authorization process. You will usually need to choose at least one
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
+<h2
id="introduction">Introduction <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
<p>If you have information on your web site that is sensitive
or intended for only a small group of people, the techniques in
this article will help you make sure that the people that see
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="theprerequisites" id="theprerequisites">The Prerequisites</a> <a title="Permanent link" href="#theprerequisites" class="permalink">¶</a></h2>
+<h2
id="theprerequisites">The Prerequisites <a title="Permanent link" href="#theprerequisites" class="permalink">¶</a></h2>
<p>The directives discussed in this article will need to go
either in your main server configuration file (typically in a
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> section), or
and use of authentication and authorization in the web server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="gettingitworking" id="gettingitworking">Getting it working</a> <a title="Permanent link" href="#gettingitworking" class="permalink">¶</a></h2>
+<h2
id="gettingitworking">Getting it working <a title="Permanent link" href="#gettingitworking" class="permalink">¶</a></h2>
<p>Here's the basics of password protecting a directory on your
server.</p>
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="lettingmorethanonepersonin" id="lettingmorethanonepersonin">Letting more than one
-person in
</a> <a title="Permanent link" href="#lettingmorethanonepersonin" class="permalink">¶</a></h2>
+<h2 id="lettingmorethanonepersonin">Letting more than one
+person in <a title="Permanent link" href="#lettingmorethanonepersonin" class="permalink">¶</a></h2>
<p>The directives above only let one person (specifically
someone with a username of <code>rbowen</code>) into the
directory. In most cases, you'll want to let more than one
<code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="possibleproblems" id="possibleproblems">Possible problems</a> <a title="Permanent link" href="#possibleproblems" class="permalink">¶</a></h2>
+<h2
id="possibleproblems">Possible problems <a title="Permanent link" href="#possibleproblems" class="permalink">¶</a></h2>
<p>Because of the way that Basic authentication is specified,
your username and password must be verified every time you
request a document from the server. This is even if you're
different authentication method at that time.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dbmdbd" id="dbmdbd">Alternate password storage</a> <a title="Permanent link" href="#dbmdbd" class="permalink">¶</a></h2>
+<h2
id="dbmdbd">Alternate password storage <a title="Permanent link" href="#dbmdbd" class="permalink">¶</a></h2>
<p>Because storing passwords in plain text files has the above
problems, you may wish to store your passwords somewhere else, such
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> documentation for more details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="multprovider" id="multprovider">Using multiple providers</a> <a title="Permanent link" href="#multprovider" class="permalink">¶</a></h2>
+<h2
id="multprovider">Using multiple providers <a title="Permanent link" href="#multprovider" class="permalink">¶</a></h2>
<p>With the introduction of the new provider based authentication and
authorization architecture, you are no longer locked into a single
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="beyond" id="beyond">Beyond just authorization</a> <a title="Permanent link" href="#beyond" class="permalink">¶</a></h2>
+<h2
id="beyond">Beyond just authorization <a title="Permanent link" href="#beyond" class="permalink">¶</a></h2>
<p>The way that authorization can be applied is now much more flexible
than just a single check against a single data store. Ordering, logic
and choosing how authorization will be done is now possible.</p>
- <h3><a name="authandororder" id="authandororder">Applying logic and ordering</a></h3>
+ <h3 id="authandororder">Applying logic and ordering</h3>
<p>Controlling how and in what order authorization will be applied
has been a bit of a mystery in the past. In Apache 2.2 a provider-based
authentication mechanism was introduced to decouple the actual
- <h3><a name="reqaccessctrl" id="reqaccessctrl">Using authorization providers for access control</a></h3>
+ <h3 id="reqaccessctrl">Using authorization providers for access control</h3>
<p>Authentication by username and password is only part of the
story. Frequently you want to let people in based on something
other than who they are. Something such as where they are
- <h3><a name="filesystem" id="filesystem">Access Control backwards compatibility</a></h3>
+ <h3 id="filesystem">Access Control backwards compatibility</h3>
<p>One of the side effects of adopting a provider based mechanism for
authorization is that the previous access control directives
<code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>,
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="socache" id="socache">Authentication Caching</a> <a title="Permanent link" href="#socache" class="permalink">¶</a></h2>
+<h2
id="socache">Authentication Caching <a title="Permanent link" href="#socache" class="permalink">¶</a></h2>
<p>There may be times when authentication puts an unacceptable load
on a provider or on your network. This is most likely to affect users
of <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> (or third-party/custom providers).
<p>This may offer a substantial performance boost to some users.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="moreinformation" id="moreinformation">More information</a> <a title="Permanent link" href="#moreinformation" class="permalink">¶</a></h2>
+<h2
id="moreinformation">More information <a title="Permanent link" href="#moreinformation" class="permalink">¶</a></h2>
<p>You should also read the documentation for
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> and <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>
which contain some more information about how this all works. The
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="intro" id="intro">Introduction</a> <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
+<h2
id="intro">Introduction <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table>
CGI programs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configuring" id="configuring">Configuring httpd to permit CGI</a> <a title="Permanent link" href="#configuring" class="permalink">¶</a></h2>
+<h2
id="configuring">Configuring httpd to permit CGI <a title="Permanent link" href="#configuring" class="permalink">¶</a></h2>
<p>In order to get your CGI programs to work properly, you'll
</div>
- <h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3>
+ <h3 id="scriptalias">ScriptAlias</h3>
<p>The
way, or httpd will return an error message.</p>
- <h3><a name="nonscriptalias" id="nonscriptalias">CGI outside of ScriptAlias directories</a></h3>
+ <h3 id="nonscriptalias">CGI outside of ScriptAlias directories</h3>
<p>CGI programs are often restricted to <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories for security reasons.
<code>ExecCGI</code> must be specified in the <code class="directive"><a href="../mod/core.html#options">Options</a></code> directive.</p>
- <h3><a name="options" id="options">Explicitly using Options to permit CGI execution</a></h3>
+ <h3 id="options">Explicitly using Options to permit CGI execution</h3>
<p>You could explicitly use the <code class="directive"><a href="../mod/core.html#options">Options</a></code> directive, inside your main server configuration
- <h3><a name="htaccess" id="htaccess">.htaccess files</a></h3>
+ <h3 id="htaccess">.htaccess files</h3>
<p>The <a href="htaccess.html"><code>.htaccess</code> tutorial</a>
access to <code>httpd.conf</code>.</p>
- <h3><a name="userdir" id="userdir">User Directories</a></h3>
+ <h3 id="userdir">User Directories</h3>
<p>To allow CGI program execution for any file ending in
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="writing" id="writing">Writing a CGI program</a> <a title="Permanent link" href="#writing" class="permalink">¶</a></h2>
+<h2
id="writing">Writing a CGI program <a title="Permanent link" href="#writing" class="permalink">¶</a></h2>
<p>There are two main differences between ``regular''
<p>Apart from those two things, writing a CGI program will look
a lot like any other program that you might write.</p>
- <h3><a name="firstcgi" id="firstcgi">Your first CGI program</a></h3>
+ <h3 id="firstcgi">Your first CGI program</h3>
<p>The following is an example CGI program that prints one
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="troubleshoot" id="troubleshoot">But it's still not working!</a> <a title="Permanent link" href="#troubleshoot" class="permalink">¶</a></h2>
+<h2
id="troubleshoot">But it's still not working! <a title="Permanent link" href="#troubleshoot" class="permalink">¶</a></h2>
<p>There are four basic things that you may see in your browser
headers.</dd>
</dl>
- <h3><a name="permissions" id="permissions">File permissions</a></h3>
+ <h3 id="permissions">File permissions</h3>
<p>Remember that the server does not run as you. That is,
- <h3><a name="pathinformation" id="pathinformation">Path information and environment</a></h3>
+ <h3 id="pathinformation">Path information and environment</h3>
<p>When you run a program from your command line, you have
</div>
- <h3><a name="missingenv" id="missingenv">Missing environment variables</a></h3>
+ <h3 id="missingenv">Missing environment variables</h3>
<p>If your CGI program depends on non-standard <a href="#env">environment variables</a>, you will need to
- <h3><a name="syntaxerrors" id="syntaxerrors">Program errors</a></h3>
+ <h3 id="syntaxerrors">Program errors</h3>
<p>Most of the time when a CGI program fails, it's because of
details.</p>
- <h3><a name="errorlogs" id="errorlogs">Error logs</a></h3>
+ <h3 id="errorlogs">Error logs</h3>
<p>The error logs are your friend. Anything that goes wrong
are quickly identified, and quickly solved.</p>
- <h3><a name="suexec" id="suexec">Suexec</a></h3>
+ <h3 id="suexec">Suexec</h3>
<p>The <a href="../suexec.html">suexec</a> support program
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="behindscenes" id="behindscenes">What's going on behind the scenes?</a> <a title="Permanent link" href="#behindscenes" class="permalink">¶</a></h2>
+<h2
id="behindscenes">What's going on behind the scenes? <a title="Permanent link" href="#behindscenes" class="permalink">¶</a></h2>
<p>As you become more advanced in CGI programming, it will
well to write a program that prints "Hello, World.", it's not
particularly useful.</p>
- <h3><a name="env" id="env">Environment variables</a></h3>
+ <h3 id="env">Environment variables</h3>
<p>Environment variables are values that float around you as
- <h3><a name="stdin" id="stdin">STDIN and STDOUT</a></h3>
+ <h3 id="stdin">STDIN and STDOUT</h3>
<p>Other communication between the server and the client
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="libraries" id="libraries">CGI modules/libraries</a> <a title="Permanent link" href="#libraries" class="permalink">¶</a></h2>
+<h2
id="libraries">CGI modules/libraries <a title="Permanent link" href="#libraries" class="permalink">¶</a></h2>
<p>When you write CGI programs, you should consider using a
<a href="https://web.mit.edu/wwwdev/www/cgic.html">https://web.mit.edu/wwwdev/www/cgic.html</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="moreinfo" id="moreinfo">For more information</a> <a title="Permanent link" href="#moreinfo" class="permalink">¶</a></h2>
+<h2
id="moreinfo">For more information <a title="Permanent link" href="#moreinfo" class="permalink">¶</a></h2>
<p>The current CGI specification is available in the
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../ssl/ssl_howto.html">SSL How-To</a></li><li><a href="../mod/mod_ssl.html">mod_ssl</a></li><li><a href="../mod/mod_md.html">mod_md</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="protocol" id="protocol">A short Introduction Certificates, e.g. Internet Passports</a> <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
+<h2
id="protocol">A short Introduction Certificates, e.g. Internet Passports <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
<p>
The TLS protocol (formerly known as SSL) is a way a client and a server
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="buycert" id="buycert">Buy a Certificate</a> <a title="Permanent link" href="#buycert" class="permalink">¶</a></h2>
+<h2
id="buycert">Buy a Certificate <a title="Permanent link" href="#buycert" class="permalink">¶</a></h2>
<p>
Well, you can buy one. There are a lot of companies selling Internet Passports as a service. In
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="freecert" id="freecert">Get a Free Certificate</a> <a title="Permanent link" href="#freecert" class="permalink">¶</a></h2>
+<h2
id="freecert">Get a Free Certificate <a title="Permanent link" href="#freecert" class="permalink">¶</a></h2>
<p>
There are also companies that offer certificates for web servers free of charge. The pioneer
<a href="../fr/howto/encrypt.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="related" id="related">.htaccess files</a> <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
+<h2
id="related">.htaccess files <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li><li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverridelist">AllowOverrideList</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="what" id="what">What they are/How to use them</a> <a title="Permanent link" href="#what" class="permalink">¶</a></h2>
+<h2
id="what">What they are/How to use them <a title="Permanent link" href="#what" class="permalink">¶</a></h2>
<p><code>.htaccess</code> files (or "distributed configuration files")
honored in <code>.htaccess</code> files.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="when" id="when">When (not) to use .htaccess files</a> <a title="Permanent link" href="#when" class="permalink">¶</a></h2>
+<h2
id="when">When (not) to use .htaccess files <a title="Permanent link" href="#when" class="permalink">¶</a></h2>
<p>If you have access to the main server configuration file, you
should put all of your configuration there instead of in
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="how" id="how">How directives are applied</a> <a title="Permanent link" href="#how" class="permalink">¶</a></h2>
+<h2
id="how">How directives are applied <a title="Permanent link" href="#how" class="permalink">¶</a></h2>
<p>The configuration directives found in a <code>.htaccess</code> file
are applied to the directory in which the <code>.htaccess</code> file
completely overrides any earlier setting that may have been in
place.</p>
- <h3><a name="merge" id="merge">Merging of .htaccess with the main
- configuration files</a></h3>
+ <h3 id="merge">Merging of .htaccess with the main
+ configuration files</h3>
<p>As discussed in the documentation on <a href="../sections.html">Configuration Sections</a>,
<code>.htaccess</code> files can override the <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections for
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="auth" id="auth">Authentication example</a> <a title="Permanent link" href="#auth" class="permalink">¶</a></h2>
+<h2
id="auth">Authentication example <a title="Permanent link" href="#auth" class="permalink">¶</a></h2>
<p>As with any <code>.htaccess</code> use, placing these directives in
a <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> block is
more complete discussion of authentication and authorization.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ssi" id="ssi">Server Side Includes example</a> <a title="Permanent link" href="#ssi" class="permalink">¶</a></h2>
+<h2
id="ssi">Server Side Includes example <a title="Permanent link" href="#ssi" class="permalink">¶</a></h2>
<p>Another use of <code>.htaccess</code> files is to enable Server Side
Includes for a particular directory. This may be done with the following
complete discussion of server-side includes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rewrite" id="rewrite">Rewrite Rules in .htaccess files</a> <a title="Permanent link" href="#rewrite" class="permalink">¶</a></h2>
+<h2
id="rewrite">Rewrite Rules in .htaccess files <a title="Permanent link" href="#rewrite" class="permalink">¶</a></h2>
<p>When using <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> in
<code>.htaccess</code> files, be aware that the per-directory context
changes things a bit. In particular, rules are taken to be relative to
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cgi" id="cgi">CGI example</a> <a title="Permanent link" href="#cgi" class="permalink">¶</a></h2>
+<h2
id="cgi">CGI example <a title="Permanent link" href="#cgi" class="permalink">¶</a></h2>
<div class="note">CGI scripts are a legacy mechanism for dynamic content. For new
deployments, consider using <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> with a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="troubleshoot" id="troubleshoot">Troubleshooting</a> <a title="Permanent link" href="#troubleshoot" class="permalink">¶</a></h2>
+<h2
id="troubleshoot">Troubleshooting <a title="Permanent link" href="#troubleshoot" class="permalink">¶</a></h2>
<p>When you put configuration directives in a <code>.htaccess</code>
file, and you don't get the desired effect, there are a number of
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="protocol" id="protocol">The HTTP/2 protocol</a> <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
+<h2
id="protocol">The HTTP/2 protocol <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
<p>HTTP/2 is the evolution of the world's most successful application layer protocol, HTTP.
It focuses on making more efficient use of network resources. It does not change the fundamentals
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="implementation" id="implementation">HTTP/2 in Apache httpd</a> <a title="Permanent link" href="#implementation" class="permalink">¶</a></h2>
+<h2
id="implementation">HTTP/2 in Apache httpd <a title="Permanent link" href="#implementation" class="permalink">¶</a></h2>
<p>The HTTP/2 protocol is implemented by its own httpd module, aptly named
<code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code>. It implements the complete set
can make use of it.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="building" id="building">Build httpd with HTTP/2 support</a> <a title="Permanent link" href="#building" class="permalink">¶</a></h2>
+<h2
id="building">Build httpd with HTTP/2 support <a title="Permanent link" href="#building" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> uses the library of <a href="https://nghttp2.org">nghttp2</a>
as its implementation base. In order to build <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> you need at least version 1.2.1 of
at least version 1.0.2.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basic-config" id="basic-config">Basic Configuration</a> <a title="Permanent link" href="#basic-config" class="permalink">¶</a></h2>
+<h2
id="basic-config">Basic Configuration <a title="Permanent link" href="#basic-config" class="permalink">¶</a></h2>
<p>When you have a <code>httpd</code> built with <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> you need some
how to manage multiple hosts with the same certificate</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="mpm-config" id="mpm-config">MPM Configuration</a> <a title="Permanent link" href="#mpm-config" class="permalink">¶</a></h2>
+<h2
id="mpm-config">MPM Configuration <a title="Permanent link" href="#mpm-config" class="permalink">¶</a></h2>
<p>HTTP/2 is supported in all multi-processing modules that come with httpd. However, if
that possible. If it breaks, however, you own both parts.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="clients" id="clients">Clients</a> <a title="Permanent link" href="#clients" class="permalink">¶</a></h2>
+<h2
id="clients">Clients <a title="Permanent link" href="#clients" class="permalink">¶</a></h2>
<p>Almost all modern browsers support HTTP/2, but only over SSL connections: Firefox (v43),
Chrome (v45), Safari (since v9), iOS Safari (v9), Opera (v35), Chrome for Android (v49)
most versatile being <a href="https://curl.haxx.se">curl</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="tools" id="tools">Useful tools to debug HTTP/2</a> <a title="Permanent link" href="#tools" class="permalink">¶</a></h2>
+<h2
id="tools">Useful tools to debug HTTP/2 <a title="Permanent link" href="#tools" class="permalink">¶</a></h2>
<p>The first tool to mention is of course <a href="https://curl.haxx.se">curl</a>. Please make sure that
your version supports HTTP/2 checking its <code>Features</code>:</p>
to visualize when your browser is using HTTP/2.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="push" id="push">Server Push</a> <a title="Permanent link" href="#push" class="permalink">¶</a></h2>
+<h2
id="push">Server Push <a title="Permanent link" href="#push" class="permalink">¶</a></h2>
<p>The HTTP/2 protocol allows the server to PUSH responses to a client it never
asked for. The tone of the conversation is: "here is a request that you
not expose cookie where they might ordinarily not be visible.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="earlyhints" id="earlyhints">Early Hints</a> <a title="Permanent link" href="#earlyhints" class="permalink">¶</a></h2>
+<h2
id="earlyhints">Early Hints <a title="Permanent link" href="#earlyhints" class="permalink">¶</a></h2>
<p>An alternative to PUSHing resources is to send <code>Link</code> headers to the
client before the response is even ready. This uses the HTTP feature called "Early Hints" and
<a href="../fr/howto/http2.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="howto" id="howto">How-To / Tutorials</a> <a title="Permanent link" href="#howto" class="permalink">¶</a></h2>
+<h2
id="howto">How-To / Tutorials <a title="Permanent link" href="#howto" class="permalink">¶</a></h2>
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../urlmapping.html">Mapping URLs to the Filesystem</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="related" id="related">Per-user web directories</a> <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
+<h2
id="related">Per-user web directories <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="userdir" id="userdir">Setting the file path with UserDir</a> <a title="Permanent link" href="#userdir" class="permalink">¶</a></h2>
+<h2
id="userdir">Setting the file path with UserDir <a title="Permanent link" href="#userdir" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="redirect" id="redirect">Redirecting to external URLs</a> <a title="Permanent link" href="#redirect" class="permalink">¶</a></h2>
+<h2
id="redirect">Redirecting to external URLs <a title="Permanent link" href="#redirect" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive can be
used to redirect user directory requests to external URLs.</p>
<code>http://example.org/users/bob/abc.html</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="enable" id="enable">Restricting what users are permitted to use this
- feature
</a> <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
+<h2 id="enable">Restricting what users are permitted to use this
+ feature <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
<p>Using the syntax shown in the UserDir documentation, you can restrict
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cgi" id="cgi">Enabling a cgi directory for each user</a> <a title="Permanent link" href="#cgi" class="permalink">¶</a></h2>
+<h2
id="cgi">Enabling a cgi directory for each user <a title="Permanent link" href="#cgi" class="permalink">¶</a></h2>
<p>In order to give each user their own cgi-bin directory, you can use
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="htaccess" id="htaccess">Allowing users to alter configuration</a> <a title="Permanent link" href="#htaccess" class="permalink">¶</a></h2>
+<h2
id="htaccess">Allowing users to alter configuration <a title="Permanent link" href="#htaccess" class="permalink">¶</a></h2>
<p>If you want to allows users to modify the server configuration in
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="related" id="related">Reverse Proxy</a> <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
+<h2
id="related">Reverse Proxy <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li><li><code class="module"><a href="../mod/mod_proxy_hcheck.html">mod_proxy_hcheck</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="simple" id="simple">Simple reverse proxying</a> <a title="Permanent link" href="#simple" class="permalink">¶</a></h2>
+<h2
id="simple">Simple reverse proxying <a title="Permanent link" href="#simple" class="permalink">¶</a></h2>
<p>
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cluster" id="cluster">Clusters and Balancers</a> <a title="Permanent link" href="#cluster" class="permalink">¶</a></h2>
+<h2
id="cluster">Clusters and Balancers <a title="Permanent link" href="#cluster" class="permalink">¶</a></h2>
<p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="config" id="config">Balancer and BalancerMember configuration</a> <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
+<h2
id="config">Balancer and BalancerMember configuration <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
<p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="failover" id="failover">Failover</a> <a title="Permanent link" href="#failover" class="permalink">¶</a></h2>
+<h2
id="failover">Failover <a title="Permanent link" href="#failover" class="permalink">¶</a></h2>
<p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="manager" id="manager">Balancer Manager</a> <a title="Permanent link" href="#manager" class="permalink">¶</a></h2>
+<h2
id="manager">Balancer Manager <a title="Permanent link" href="#manager" class="permalink">¶</a></h2>
<p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="health-check" id="health-check">Dynamic Health Checks</a> <a title="Permanent link" href="#health-check" class="permalink">¶</a></h2>
+<h2
id="health-check">Dynamic Health Checks <a title="Permanent link" href="#health-check" class="permalink">¶</a></h2>
<p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="status" id="status">BalancerMember status flags</a> <a title="Permanent link" href="#status" class="permalink">¶</a></h2>
+<h2
id="status">BalancerMember status flags <a title="Permanent link" href="#status" class="permalink">¶</a></h2>
<p>
<a href="../fr/howto/reverse_proxy.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="related" id="related">Introduction</a> <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
+<h2
id="related">Introduction <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code></li><li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li><li><code class="directive"><a href="../mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li></ul></td></tr></table>
<p>This article deals with Server Side Includes, usually called
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="what" id="what">What are SSI?</a> <a title="Permanent link" href="#what" class="permalink">¶</a></h2>
+<h2
id="what">What are SSI? <a title="Permanent link" href="#what" class="permalink">¶</a></h2>
<p>SSI (Server Side Includes) are directives that are placed in
HTML pages, and evaluated on the server while the pages are
that it is served, you need to look for some other solution.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configuring" id="configuring">Configuring your server to permit SSI</a> <a title="Permanent link" href="#configuring" class="permalink">¶</a></h2>
+<h2
id="configuring">Configuring your server to permit SSI <a title="Permanent link" href="#configuring" class="permalink">¶</a></h2>
<p>To permit SSI on your server, you must have the following
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basic" id="basic">Basic SSI directives</a> <a title="Permanent link" href="#basic" class="permalink">¶</a></h2>
+<h2
id="basic">Basic SSI directives <a title="Permanent link" href="#basic" class="permalink">¶</a></h2>
<p>SSI directives have the following syntax:</p>
<div class="example"><p><code>
series. For now, here are some examples of what you can do with
SSI</p>
-<h3><a name="todaysdate" id="todaysdate">Today's date</a></h3>
+<h3 id="todaysdate">Today's date</h3>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
-<h3><a name="lastmodified" id="lastmodified">Modification date of the file</a></h3>
+<h3 id="lastmodified">Modification date of the file</h3>
<div class="example"><p><code>
This document last modified <!--#flastmod file="index.html" -->
configurations.</p>
-<h3><a name="cgi" id="cgi">Including the results of a CGI program</a></h3>
+<h3 id="cgi">Including the results of a CGI program</h3>
<p>This is one of the more common uses of SSI - to output the
results of a CGI program, such as everybody's favorite, a ``hit
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="additionalexamples" id="additionalexamples">Additional examples</a> <a title="Permanent link" href="#additionalexamples" class="permalink">¶</a></h2>
+<h2
id="additionalexamples">Additional examples <a title="Permanent link" href="#additionalexamples" class="permalink">¶</a></h2>
<p>Following are some specific examples of things you can do in
your HTML documents with SSI.</p>
-<h3><a name="docmodified" id="docmodified">When was this document
-modified?</a></h3>
+<h3 id="docmodified">When was this document
+modified?</h3>
<p>Earlier, we mentioned that you could use SSI to inform the
user when the document was most recently modified. However, the
syntax is the same.</p>
-<h3><a name="standard-footer" id="standard-footer">Including a standard footer</a></h3>
+<h3 id="standard-footer">Including a standard footer</h3>
<p>If you are managing any site that is more than a few pages,
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="config" id="config">What else can I config?</a> <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
+<h2
id="config">What else can I config? <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
<p>In addition to being able to <code>config</code> the time
appropriate.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="exec" id="exec">Executing commands</a> <a title="Permanent link" href="#exec" class="permalink">¶</a></h2>
+<h2
id="exec">Executing commands <a title="Permanent link" href="#exec" class="permalink">¶</a></h2>
<p>Here's something else that you can do with the <code>exec</code>
argument to the <code>Options</code> directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="advanced" id="advanced">Advanced SSI techniques</a> <a title="Permanent link" href="#advanced" class="permalink">¶</a></h2>
+<h2
id="advanced">Advanced SSI techniques <a title="Permanent link" href="#advanced" class="permalink">¶</a></h2>
<p>In addition to spitting out content, Apache SSI gives you
the option of setting variables, and using those variables in
comparisons and conditionals.</p>
-<h3><a name="variables" id="variables">Setting variables</a></h3>
+<h3 id="variables">Setting variables</h3>
<p>Using the <code>set</code> directive, you can set variables
for later use. We'll need this later in the discussion, so
</code></p></div>
-<h3><a name="conditional" id="conditional">Conditional expressions</a></h3>
+<h3 id="conditional">Conditional expressions</h3>
<p>Now that we have variables, and are able to set and compare
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="conclusion" id="conclusion">Conclusion</a> <a title="Permanent link" href="#conclusion" class="permalink">¶</a></h2>
+<h2
id="conclusion">Conclusion <a title="Permanent link" href="#conclusion" class="permalink">¶</a></h2>
<p>SSI is certainly not a replacement for CGI, or other
technologies used for generating dynamic web pages. But it is a
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="programs/configure.html">Configure the source tree</a></li><li><a href="invoking.html">Starting Apache httpd</a></li><li><a href="stopping.html">Stopping and Restarting</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2><a name="overview" id="overview">Overview for the
- impatient
</a> <a title="Permanent link" href="#overview" class="permalink">¶</a></h2>
+<h2 id="overview">Overview for the
+ impatient <a title="Permanent link" href="#overview" class="permalink">¶</a></h2>
<dl>
<dt>Installing on Fedora/CentOS/Red Hat Enterprise Linux</dt>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requirements" id="requirements">Requirements</a> <a title="Permanent link" href="#requirements" class="permalink">¶</a></h2>
+<h2
id="requirements">Requirements <a title="Permanent link" href="#requirements" class="permalink">¶</a></h2>
<p>The following requirements exist for building and running Apache httpd:</p>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="download" id="download">Download</a> <a title="Permanent link" href="#download" class="permalink">¶</a></h2>
+<h2
id="download">Download <a title="Permanent link" href="#download" class="permalink">¶</a></h2>
<p>If you wish to build from source, start by downloading
the source tarball from the <a href="https://httpd.apache.org/download.cgi">Apache HTTP Server
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="extract" id="extract">Extract</a> <a title="Permanent link" href="#extract" class="permalink">¶</a></h2>
+<h2
id="extract">Extract <a title="Permanent link" href="#extract" class="permalink">¶</a></h2>
<p>Extract the source from the Apache HTTP Server tarball:</p>
compiling the server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configure" id="configure">Configuring the source tree</a> <a title="Permanent link" href="#configure" class="permalink">¶</a></h2>
+<h2
id="configure">Configuring the source tree <a title="Permanent link" href="#configure" class="permalink">¶</a></h2>
<p>The next step is to configure the Apache source tree for your
particular platform and personal requirements. This is done using
available on the <code class="program"><a href="./programs/configure.html">configure</a></code> manual page.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="compile" id="compile">Build</a> <a title="Permanent link" href="#compile" class="permalink">¶</a></h2>
+<h2
id="compile">Build <a title="Permanent link" href="#compile" class="permalink">¶</a></h2>
<p>Now you can build the various parts which form the Apache
package by running:</p>
have enabled.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="install" id="install">Install</a> <a title="Permanent link" href="#install" class="permalink">¶</a></h2>
+<h2
id="install">Install <a title="Permanent link" href="#install" class="permalink">¶</a></h2>
<p>Now it's time to install the package under the configured
installation <em>PREFIX</em> (see <code>--prefix</code> option
your configuration files or documents.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="customize" id="customize">Customize</a> <a title="Permanent link" href="#customize" class="permalink">¶</a></h2>
+<h2
id="customize">Customize <a title="Permanent link" href="#customize" class="permalink">¶</a></h2>
<p>Next, you can customize your Apache HTTP server by editing
the <a href="configuring.html">configuration files</a> under
version of this manual and a complete reference of available <a href="mod/directives.html">configuration directives</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="test" id="test">Test</a> <a title="Permanent link" href="#test" class="permalink">¶</a></h2>
+<h2
id="test">Test <a title="Permanent link" href="#test" class="permalink">¶</a></h2>
<p>Now you can <a href="invoking.html">start</a> your Apache
HTTP server by immediately running:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="upgrading" id="upgrading">Upgrading</a> <a title="Permanent link" href="#upgrading" class="permalink">¶</a></h2>
+<h2
id="upgrading">Upgrading <a title="Permanent link" href="#upgrading" class="permalink">¶</a></h2>
<p>The first step in upgrading is to read the release announcement
and the file <code>CHANGES</code> in the source distribution to
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="thirdp" id="thirdp">Third-party packages</a> <a title="Permanent link" href="#thirdp" class="permalink">¶</a></h2>
+<h2
id="thirdp">Third-party packages <a title="Permanent link" href="#thirdp" class="permalink">¶</a></h2>
<p>A large number of third parties provide their own packaged
distributions of the Apache HTTP Server for installation on
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="stopping.html">Stopping and Restarting</a></li><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="startup" id="startup">How Apache Starts</a> <a title="Permanent link" href="#startup" class="permalink">¶</a></h2>
+<h2
id="startup">How Apache Starts <a title="Permanent link" href="#startup" class="permalink">¶</a></h2>
<p>If the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
specified in the configuration file is default of 80 (or any other
the test page in the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> directory.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="errors" id="errors">Errors During Start-up</a> <a title="Permanent link" href="#errors" class="permalink">¶</a></h2>
+<h2
id="errors">Errors During Start-up <a title="Permanent link" href="#errors" class="permalink">¶</a></h2>
<p>If Apache suffers a fatal problem during startup, it will
write a message describing the problem either to the console or
Apache <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="boot" id="boot">Starting at Boot-Time</a> <a title="Permanent link" href="#boot" class="permalink">¶</a></h2>
+<h2
id="boot">Starting at Boot-Time <a title="Permanent link" href="#boot" class="permalink">¶</a></h2>
<p>If you want your server to continue running after a system
reboot, you should add a call to <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> to your
sure to check the exact requirements of your system.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="info" id="info">Additional Information</a> <a title="Permanent link" href="#info" class="permalink">¶</a></h2>
+<h2
id="info">Additional Information <a title="Permanent link" href="#info" class="permalink">¶</a></h2>
<p>Additional information about the command-line options of <code class="program"><a href="./programs/httpd.html">httpd</a></code> and <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> as well as other support
programs included with the server is available on the
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
<p><span>Available Languages: </span><a href="./en/license.html" title="English"> en </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="overview" id="overview">Overview</a> <a title="Permanent link" href="#overview" class="permalink">¶</a></h2>
+<h2
id="overview">Overview <a title="Permanent link" href="#overview" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Warning</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Warning <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>Anyone who can write to the directory where Apache httpd is
logs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="errorlog" id="errorlog">Error Log</a> <a title="Permanent link" href="#errorlog" class="permalink">¶</a></h2>
+<h2
id="errorlog">Error Log <a title="Permanent link" href="#errorlog" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="permodule" id="permodule">Per-module logging</a> <a title="Permanent link" href="#permodule" class="permalink">¶</a></h2>
+<h2
id="permodule">Per-module logging <a title="Permanent link" href="#permodule" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> directive
the server.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="accesslog" id="accesslog">Access Log</a> <a title="Permanent link" href="#accesslog" class="permalink">¶</a></h2>
+<h2
id="accesslog">Access Log <a title="Permanent link" href="#accesslog" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
sections. For a complete list of the possible contents of the
format string, see the <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code> <a href="mod/mod_log_config.html#formats">format strings</a>.</p>
- <h3><a name="common" id="common">Common Log Format</a></h3>
+ <h3 id="common">Common Log Format</h3>
<p>A typical configuration for the access log might look as
</dl>
- <h3><a name="combined" id="combined">Combined Log Format</a></h3>
+ <h3 id="combined">Combined Log Format</h3>
<p>Another commonly used format string is called the Combined
</dl>
- <h3><a name="multiple" id="multiple">Multiple Access Logs</a></h3>
+ <h3 id="multiple">Multiple Access Logs</h3>
<p>Multiple access logs can be created simply by specifying
the log format can be specified directly in the <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> directive.</p>
- <h3><a name="conditional" id="conditional">Conditional Logs</a></h3>
+ <h3 id="conditional">Conditional Logs</h3>
<p>There are times when it is convenient to exclude certain
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rotation" id="rotation">Log Rotation</a> <a title="Permanent link" href="#rotation" class="permalink">¶</a></h2>
+<h2
id="rotation">Log Rotation <a title="Permanent link" href="#rotation" class="permalink">¶</a></h2>
<p>On even a moderately busy server, the quantity of
section.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="piped" id="piped">Piped Logs</a> <a title="Permanent link" href="#piped" class="permalink">¶</a></h2>
+<h2
id="piped">Piped Logs <a title="Permanent link" href="#piped" class="permalink">¶</a></h2>
<p>Apache httpd is capable of writing error and access log
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="virtualhost" id="virtualhost">Virtual Hosts</a> <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
+<h2
id="virtualhost">Virtual Hosts <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
<p>When running a server with many <a href="vhosts/">virtual
per virtual host.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="other" id="other">Other Log Files</a> <a title="Permanent link" href="#other" class="permalink">¶</a></h2>
+<h2
id="other">Other Log Files <a title="Permanent link" href="#other" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_debug.html">mod_log_debug</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#bufferedlogs">BufferedLogs</a></code></li><li><code class="directive"><a href="./mod/mod_log_forensic.html#forensiclog">ForensicLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
It can be an invaluable debugging and security tool.</p>
- <h3><a name="pidfile" id="pidfile">PID File</a></h3>
+ <h3 id="pidfile">PID File</h3>
<p>On startup, Apache httpd saves the process id of the parent
and Restarting</a> page.</p>
- <h3><a name="scriptlog" id="scriptlog">Script Log</a></h3>
+ <h3 id="scriptlog">Script Log</h3>
<p>In order to aid in debugging, the
More information is available in the <a href="mod/mod_cgi.html">mod_cgi</a> documentation.</p>
- <h3><a name="debug" id="debug">Configurable debug logging</a></h3>
+ <h3 id="debug">Configurable debug logging</h3>
<p>The <code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code>
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../zh-cn/misc/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basic" id="basic">Basic Authentication</a> <a title="Permanent link" href="#basic" class="permalink">¶</a></h2>
+<h2
id="basic">Basic Authentication <a title="Permanent link" href="#basic" class="permalink">¶</a></h2>
<p>There are five formats that Apache recognizes for basic-authentication
passwords. Note that not all formats work on every platform:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="digest" id="digest">Digest Authentication</a> <a title="Permanent link" href="#digest" class="permalink">¶</a></h2>
+<h2
id="digest">Digest Authentication <a title="Permanent link" href="#digest" class="permalink">¶</a></h2>
<p>Apache recognizes one format for
digest-authentication passwords - the MD5 hash of the string
<code>user:realm:password</code> as a 32-character string of hexadecimal
<a href="../fr/misc/password_encryptions.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="what-will-and-will-not-be-discussed" id="what-will-and-will-not-be-discussed">What Will and Will Not Be Discussed
-
</a> <a title="Permanent link" href="#what-will-and-will-not-be-discussed" class="permalink">¶</a></h2>
+<h2 id="what-will-and-will-not-be-discussed">What Will and Will Not Be Discussed
+ <a title="Permanent link" href="#what-will-and-will-not-be-discussed" class="permalink">¶</a></h2>
<p>The session will focus on easily accessible configuration and tuning
options for Apache httpd 2.2 and 2.4 as well as monitoring tools.
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="monitoring-your-server" id="monitoring-your-server">Monitoring Your Server
-
</a> <a title="Permanent link" href="#monitoring-your-server" class="permalink">¶</a></h2>
+<h2 id="monitoring-your-server">Monitoring Your Server
+ <a title="Permanent link" href="#monitoring-your-server" class="permalink">¶</a></h2>
<p>The first task when sizing or performance-tuning your server is to
find out how your system is currently performing. By monitoring
</p>
- <h3><a name="monitoring-tools" id="monitoring-tools">Monitoring Tools
- </a></h3>
+ <h3 id="monitoring-tools">Monitoring Tools
+ </h3>
- <h3><a name="web-server-log-files" id="web-server-log-files">Web Server Log Files
- </a></h3>
+ <h3 id="web-server-log-files">Web Server Log Files
+ </h3>
<p>Monitoring and analyzing the log files httpd writes is one of
the most effective ways to keep track of your server health and
- <h3><a name="generating-a-test-load" id="generating-a-test-load">Generating A Test Load
- </a></h3>
+ <h3 id="generating-a-test-load">Generating A Test Load
+ </h3>
<p>It is useful to generate a test load to monitor system
performance under realistic operating circumstances. Besides
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="configuring-for-performance" id="configuring-for-performance">Configuring for Performance
-
</a> <a title="Permanent link" href="#configuring-for-performance" class="permalink">¶</a></h2>
+<h2 id="configuring-for-performance">Configuring for Performance
+ <a title="Permanent link" href="#configuring-for-performance" class="permalink">¶</a></h2>
- <h3><a name="apache-configuration" id="apache-configuration">Httpd Configuration
- </a></h3>
+ <h3 id="apache-configuration">Httpd Configuration
+ </h3>
<p>The httpd 2.2 server is by default a pre-forking web server.
When the server starts, the parent process spawns a number of
- <h3><a name="tuning-the-operating-system" id="tuning-the-operating-system">Tuning the Operating System
- </a></h3>
+ <h3 id="tuning-the-operating-system">Tuning the Operating System
+ </h3>
<p>People often look for the 'magic tune-up' that will
make their system perform four times as fast by tweaking just
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="caching-content" id="caching-content">Caching Content
-
</a> <a title="Permanent link" href="#caching-content" class="permalink">¶</a></h2>
+<h2 id="caching-content">Caching Content
+ <a title="Permanent link" href="#caching-content" class="permalink">¶</a></h2>
<p>Requests for dynamically generated content usually take
significantly more resources than requests for static content.
</p>
- <h3><a name="making-popular-pages-static" id="making-popular-pages-static">Making Popular Pages Static
- </a></h3>
+ <h3 id="making-popular-pages-static">Making Popular Pages Static
+ </h3>
<p>By pre-rendering the response pages for the most popular queries
in your application, you can gain a significant performance
- <h3><a name="caching-content-with-mod_cache" id="caching-content-with-mod_cache">Caching Content With mod_cache
- </a></h3>
+ <h3 id="caching-content-with-mod_cache">Caching Content With mod_cache
+ </h3>
<p>The mod_cache module provides intelligent caching of HTTP
responses: it is aware of the expiration timing and content
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="further-considerations" id="further-considerations">Further Considerations
-
</a> <a title="Permanent link" href="#further-considerations" class="permalink">¶</a></h2>
+<h2 id="further-considerations">Further Considerations
+ <a title="Permanent link" href="#further-considerations" class="permalink">¶</a></h2>
<p>Armed with the knowledge of how to tune a system to deliver the
desired the performance, we will soon discover that <em>one</em>
<a href="../fr/misc/perf-scaling.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="hardware" id="hardware">Hardware and Operating System Issues</a> <a title="Permanent link" href="#hardware" class="permalink">¶</a></h2>
+<h2
id="hardware">Hardware and Operating System Issues <a title="Permanent link" href="#hardware" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="runtime" id="runtime">Run-Time Configuration Issues</a> <a title="Permanent link" href="#runtime" class="permalink">¶</a></h2>
+<h2
id="runtime">Run-Time Configuration Issues <a title="Permanent link" href="#runtime" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code></li><li><code class="module"><a href="../mod/mpm_common.html">mpm_common</a></code></li><li><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code></li><li><code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code></li><li><code class="directive"><a href="../mod/core.html#enablemmap">EnableMMAP</a></code></li><li><code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code></li><li><code class="directive"><a href="../mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code></li><li><code class="directive"><a href="../mod/prefork.html#maxspareservers">MaxSpareServers</a></code></li><li><code class="directive"><a href="../mod/prefork.html#minspareservers">MinSpareServers</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mpm_common.html#startservers">StartServers</a></code></li></ul></td></tr></table>
- <h3><a name="dns" id="dns">HostnameLookups and other DNS considerations</a></h3>
+ <h3 id="dns">HostnameLookups and other DNS considerations</h3>
- <h3><a name="symlinks" id="symlinks">FollowSymLinks and SymLinksIfOwnerMatch</a></h3>
+ <h3 id="symlinks">FollowSymLinks and SymLinksIfOwnerMatch</h3>
- <h3><a name="htaccess" id="htaccess">AllowOverride</a></h3>
+ <h3 id="htaccess">AllowOverride</h3>
- <h3><a name="negotiation" id="negotiation">Negotiation</a></h3>
+ <h3 id="negotiation">Negotiation</h3>
- <h3><a name="process" id="process">Recycle child processes</a></h3>
+ <h3 id="process">Recycle child processes</h3>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="compiletime" id="compiletime">Compile-Time Configuration Issues</a> <a title="Permanent link" href="#compiletime" class="permalink">¶</a></h2>
+<h2
id="compiletime">Compile-Time Configuration Issues <a title="Permanent link" href="#compiletime" class="permalink">¶</a></h2>
- <h3><a name="modules" id="modules">Modules</a></h3>
+ <h3 id="modules">Modules</h3>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="trace" id="trace">Appendix: Detailed Analysis of a Trace</a> <a title="Permanent link" href="#trace" class="permalink">¶</a></h2>
+<h2
id="trace">Appendix: Detailed Analysis of a Trace <a title="Permanent link" href="#trace" class="permalink">¶</a></h2>
<a href="../tr/misc/perf-tuning.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="http_recommendations" id="http_recommendations">HTTP Recommendations</a> <a title="Permanent link" href="#http_recommendations" class="permalink">¶</a></h2>
+<h2
id="http_recommendations">HTTP Recommendations <a title="Permanent link" href="#http_recommendations" class="permalink">¶</a></h2>
<p>Regardless of what modules are compiled and used, Apache as a
basic web server complies with the following IETF recommendations:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="html_recommendations" id="html_recommendations">HTML Recommendations</a> <a title="Permanent link" href="#html_recommendations" class="permalink">¶</a></h2>
+<h2
id="html_recommendations">HTML Recommendations <a title="Permanent link" href="#html_recommendations" class="permalink">¶</a></h2>
<p>Regarding the Hypertext Markup Language, Apache complies with
the following IETF and W3C recommendations:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="authentication" id="authentication">Authentication</a> <a title="Permanent link" href="#authentication" class="permalink">¶</a></h2>
+<h2
id="authentication">Authentication <a title="Permanent link" href="#authentication" class="permalink">¶</a></h2>
<p>Concerning the different methods of authentication, Apache
follows the following IETF recommendations:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="language_country_codes" id="language_country_codes">Language/Country Codes</a> <a title="Permanent link" href="#language_country_codes" class="permalink">¶</a></h2>
+<h2
id="language_country_codes">Language/Country Codes <a title="Permanent link" href="#language_country_codes" class="permalink">¶</a></h2>
<p>The following links document ISO and other language and country
code information:</p>
<a href="../ko/misc/relevant_standards.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="uptodate" id="uptodate">Keep up to Date</a> <a title="Permanent link" href="#uptodate" class="permalink">¶</a></h2>
+<h2
id="uptodate">Keep up to Date <a title="Permanent link" href="#uptodate" class="permalink">¶</a></h2>
<p>The Apache HTTP Server has a good record for security and a
developer community highly concerned about security issues. But
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dos" id="dos">Denial of Service (DoS) attacks</a> <a title="Permanent link" href="#dos" class="permalink">¶</a></h2>
+<h2
id="dos">Denial of Service (DoS) attacks <a title="Permanent link" href="#dos" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="serverroot" id="serverroot">Permissions on ServerRoot Directories</a> <a title="Permanent link" href="#serverroot" class="permalink">¶</a></h2>
+<h2
id="serverroot">Permissions on ServerRoot Directories <a title="Permanent link" href="#serverroot" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ssi" id="ssi">Server Side Includes</a> <a title="Permanent link" href="#ssi" class="permalink">¶</a></h2>
+<h2
id="ssi">Server Side Includes <a title="Permanent link" href="#ssi" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cgi" id="cgi">CGI in General</a> <a title="Permanent link" href="#cgi" class="permalink">¶</a></h2>
+<h2
id="cgi">CGI in General <a title="Permanent link" href="#cgi" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="nsaliasedcgi" id="nsaliasedcgi">Non Script Aliased CGI</a> <a title="Permanent link" href="#nsaliasedcgi" class="permalink">¶</a></h2>
+<h2
id="nsaliasedcgi">Non Script Aliased CGI <a title="Permanent link" href="#nsaliasedcgi" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="saliasedcgi" id="saliasedcgi">Script Aliased CGI</a> <a title="Permanent link" href="#saliasedcgi" class="permalink">¶</a></h2>
+<h2
id="saliasedcgi">Script Aliased CGI <a title="Permanent link" href="#saliasedcgi" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dynamic" id="dynamic">Other sources of dynamic content</a> <a title="Permanent link" href="#dynamic" class="permalink">¶</a></h2>
+<h2
id="dynamic">Other sources of dynamic content <a title="Permanent link" href="#dynamic" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dynamicsec" id="dynamicsec">Dynamic content security</a> <a title="Permanent link" href="#dynamicsec" class="permalink">¶</a></h2>
+<h2
id="dynamicsec">Dynamic content security <a title="Permanent link" href="#dynamicsec" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="systemsettings" id="systemsettings">Protecting System Settings</a> <a title="Permanent link" href="#systemsettings" class="permalink">¶</a></h2>
+<h2
id="systemsettings">Protecting System Settings <a title="Permanent link" href="#systemsettings" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="protectserverfiles" id="protectserverfiles">Protect Server Files by Default</a> <a title="Permanent link" href="#protectserverfiles" class="permalink">¶</a></h2>
+<h2
id="protectserverfiles">Protect Server Files by Default <a title="Permanent link" href="#protectserverfiles" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="watchyourlogs" id="watchyourlogs">Watching Your Logs</a> <a title="Permanent link" href="#watchyourlogs" class="permalink">¶</a></h2>
+<h2
id="watchyourlogs">Watching Your Logs <a title="Permanent link" href="#watchyourlogs" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="merging" id="merging">Merging of configuration sections</a> <a title="Permanent link" href="#merging" class="permalink">¶</a></h2>
+<h2
id="merging">Merging of configuration sections <a title="Permanent link" href="#merging" class="permalink">¶</a></h2>
<a href="../tr/misc/security_tips.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=core">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=core">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a> <a title="Permanent link" href="#acceptfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="acceptfilter"><span id="AcceptFilter">AcceptFilter</span> Directive <a title="Permanent link" href="#acceptfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures optimizations for a Protocol's Listener Sockets</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a> <a title="Permanent link" href="#acceptpathinfo" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="acceptpathinfo"><span id="AcceptPathInfo">AcceptPathInfo</span> Directive <a title="Permanent link" href="#acceptpathinfo" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Resources accept trailing pathname information</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a> <a title="Permanent link" href="#accessfilename" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="accessfilename"><span id="AccessFileName">AccessFileName</span> Directive <a title="Permanent link" href="#accessfilename" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the distributed configuration file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a> <a title="Permanent link" href="#adddefaultcharset" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="adddefaultcharset"><span id="AddDefaultCharset">AddDefaultCharset</span> Directive <a title="Permanent link" href="#adddefaultcharset" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default charset parameter to be added when a response
content-type is <code>text/plain</code> or <code>text/html</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a> <a title="Permanent link" href="#allowencodedslashes" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="allowencodedslashes"><span id="AllowEncodedSlashes">AllowEncodedSlashes</span> Directive <a title="Permanent link" href="#allowencodedslashes" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether encoded path separators in URLs are allowed to
be passed through</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a> <a title="Permanent link" href="#allowoverride" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="allowoverride"><span id="AllowOverride">AllowOverride</span> Directive <a title="Permanent link" href="#allowoverride" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types of directives that are allowed in
<code>.htaccess</code> files</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AllowOverrideList" id="AllowOverrideList">AllowOverrideList</a> <a name="allowoverridelist" id="allowoverridelist">Directive</a> <a title="Permanent link" href="#allowoverridelist" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="allowoverridelist"><span id="AllowOverrideList">AllowOverrideList</span> Directive <a title="Permanent link" href="#allowoverridelist" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Individual directives that are allowed in
<code>.htaccess</code> files</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AsyncFilter" id="AsyncFilter">AsyncFilter</a> <a name="asyncfilter" id="asyncfilter">Directive</a> <a title="Permanent link" href="#asyncfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="asyncfilter"><span id="AsyncFilter">AsyncFilter</span> Directive <a title="Permanent link" href="#asyncfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the minimum filter type eligible for asynchronous handling</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AsyncFilter request|connection|network</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a> <a title="Permanent link" href="#cgimapextension" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cgimapextension"><span id="CGIMapExtension">CGIMapExtension</span> Directive <a title="Permanent link" href="#cgimapextension" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
scripts</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CGIPassAuth" id="CGIPassAuth">CGIPassAuth</a> <a name="cgipassauth" id="cgipassauth">Directive</a> <a title="Permanent link" href="#cgipassauth" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cgipassauth"><span id="CGIPassAuth">CGIPassAuth</span> Directive <a title="Permanent link" href="#cgipassauth" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables passing HTTP authorization headers to scripts as CGI
variables</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CGIVar" id="CGIVar">CGIVar</a> <a name="cgivar" id="cgivar">Directive</a> <a title="Permanent link" href="#cgivar" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cgivar"><span id="CGIVar">CGIVar</span> Directive <a title="Permanent link" href="#cgivar" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls how some CGI variables are set</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIVar <var>variable</var> <var>rule</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DefaultRuntimeDir" id="DefaultRuntimeDir">DefaultRuntimeDir</a> <a name="defaultruntimedir" id="defaultruntimedir">Directive</a> <a title="Permanent link" href="#defaultruntimedir" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="defaultruntimedir"><span id="DefaultRuntimeDir">DefaultRuntimeDir</span> Directive <a title="Permanent link" href="#defaultruntimedir" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server run-time files</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultRuntimeDir <var>directory-path</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DefaultStateDir" id="DefaultStateDir">DefaultStateDir</a> <a name="defaultstatedir" id="defaultstatedir">Directive</a> <a title="Permanent link" href="#defaultstatedir" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="defaultstatedir"><span id="DefaultStateDir">DefaultStateDir</span> Directive <a title="Permanent link" href="#defaultstatedir" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the persistent state files</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultStateDir <var>directory-path</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a> <a title="Permanent link" href="#defaulttype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="defaulttype"><span id="DefaultType">DefaultType</span> Directive <a title="Permanent link" href="#defaulttype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>This directive has no effect other than to emit warnings
if the value is not <code>none</code>. In prior versions, DefaultType
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a> <a title="Permanent link" href="#define" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="define"><span id="Define">Define</span> Directive <a title="Permanent link" href="#define" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a variable</td></tr>
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">Directive</a> <a title="Permanent link" href="#directory" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="directory"><span id="Directory"><Directory></span> Directive <a title="Permanent link" href="#directory" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that apply only to the
named file-system directory, sub-directories, and their contents.</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">Directive</a> <a title="Permanent link" href="#directorymatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="directorymatch"><span id="DirectoryMatch"><DirectoryMatch></span> Directive <a title="Permanent link" href="#directorymatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose directives that apply to
the contents of file-system directories matching a regular expression.</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a> <a title="Permanent link" href="#documentroot" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="documentroot"><span id="DocumentRoot">DocumentRoot</span> Directive <a title="Permanent link" href="#documentroot" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory that forms the main document tree visible
from the web</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Else" id="Else"><Else></a> <a name="else" id="else">Directive</a> <a title="Permanent link" href="#else" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="else"><span id="Else"><Else></span> Directive <a title="Permanent link" href="#else" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if the condition of a
previous <code class="directive"><a href="#if"><If></a></code> or
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ElseIf" id="ElseIf"><ElseIf></a> <a name="elseif" id="elseif">Directive</a> <a title="Permanent link" href="#elseif" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="elseif"><span id="ElseIf"><ElseIf></span> Directive <a title="Permanent link" href="#elseif" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a> <a title="Permanent link" href="#enablemmap" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="enablemmap"><span id="EnableMMAP">EnableMMAP</span> Directive <a title="Permanent link" href="#enablemmap" class="permalink">¶</a></h2>
<table class="directive">
<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>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a> <a title="Permanent link" href="#enablesendfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="enablesendfile"><span id="EnableSendfile">EnableSendfile</span> Directive <a title="Permanent link" href="#enablesendfile" class="permalink">¶</a></h2>
<table class="directive">
<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>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Error" id="Error">Error</a> <a name="error" id="error">Directive</a> <a title="Permanent link" href="#error" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="error"><span id="Error">Error</span> Directive <a title="Permanent link" href="#error" class="permalink">¶</a></h2>
<table class="directive">
<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>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a> <a title="Permanent link" href="#errordocument" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="errordocument"><span id="ErrorDocument">ErrorDocument</span> Directive <a title="Permanent link" href="#errordocument" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>What the server will return to the client
in case of an error</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a> <a title="Permanent link" href="#errorlog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="errorlog"><span id="ErrorLog">ErrorLog</span> Directive <a title="Permanent link" href="#errorlog" class="permalink">¶</a></h2>
<table class="directive">
<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>][:<var>tag</var>]]</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a> <a name="errorlogformat" id="errorlogformat">Directive</a> <a title="Permanent link" href="#errorlogformat" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="errorlogformat"><span id="ErrorLogFormat">ErrorLogFormat</span> Directive <a title="Permanent link" href="#errorlogformat" class="permalink">¶</a></h2>
<table class="directive">
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">Directive</a> <a title="Permanent link" href="#extendedstatus" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="extendedstatus"><span id="ExtendedStatus">ExtendedStatus</span> Directive <a title="Permanent link" href="#extendedstatus" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keep track of extended status information for each
request</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a> <a title="Permanent link" href="#fileetag" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="fileetag"><span id="FileETag">FileETag</span> Directive <a title="Permanent link" href="#fileetag" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File attributes used to create the ETag
HTTP response header for static files</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Files" id="Files"><Files></a> <a name="files" id="files">Directive</a> <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="files"><span id="Files"><Files></span> Directive <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to matched
filenames</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FilesMatch" id="FilesMatch"><FilesMatch></a> <a name="filesmatch" id="filesmatch">Directive</a> <a title="Permanent link" href="#filesmatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="filesmatch"><span id="FilesMatch"><FilesMatch></span> Directive <a title="Permanent link" href="#filesmatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to regular-expression matched
filenames</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FlushMaxPipelined" id="FlushMaxPipelined">FlushMaxPipelined</a> <a name="flushmaxpipelined" id="flushmaxpipelined">Directive</a> <a title="Permanent link" href="#flushmaxpipelined" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="flushmaxpipelined"><span id="FlushMaxPipelined">FlushMaxPipelined</span> Directive <a title="Permanent link" href="#flushmaxpipelined" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of pipelined responses above which they are flushed
to the network</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FlushMaxThreshold" id="FlushMaxThreshold">FlushMaxThreshold</a> <a name="flushmaxthreshold" id="flushmaxthreshold">Directive</a> <a title="Permanent link" href="#flushmaxthreshold" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="flushmaxthreshold"><span id="FlushMaxThreshold">FlushMaxThreshold</span> Directive <a title="Permanent link" href="#flushmaxthreshold" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Threshold above which pending data are flushed to the
network</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a> <a title="Permanent link" href="#forcetype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="forcetype"><span id="ForceType">ForceType</span> Directive <a title="Permanent link" href="#forcetype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be served with the specified
media type in the HTTP Content-Type header field</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="GprofDir" id="GprofDir">GprofDir</a> <a name="gprofdir" id="gprofdir">Directive</a> <a title="Permanent link" href="#gprofdir" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="gprofdir"><span id="GprofDir">GprofDir</span> Directive <a title="Permanent link" href="#gprofdir" class="permalink">¶</a></h2>
<table class="directive">
<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>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a> <a title="Permanent link" href="#hostnamelookups" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="hostnamelookups"><span id="HostnameLookups">HostnameLookups</span> Directive <a title="Permanent link" href="#hostnamelookups" class="permalink">¶</a></h2>
<table class="directive">
<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>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="HttpProtocolOptions" id="HttpProtocolOptions">HttpProtocolOptions</a> <a name="httpprotocoloptions" id="httpprotocoloptions">Directive</a> <a title="Permanent link" href="#httpprotocoloptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="httpprotocoloptions"><span id="HttpProtocolOptions">HttpProtocolOptions</span> Directive <a title="Permanent link" href="#httpprotocoloptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modify restrictions on HTTP Request Messages</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="If" id="If"><If></a> <a name="if" id="if">Directive</a> <a title="Permanent link" href="#if" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="if"><span id="If"><If></span> Directive <a title="Permanent link" href="#if" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is
satisfied by a request at runtime</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IfDefine" id="IfDefine"><IfDefine></a> <a name="ifdefine" id="ifdefine">Directive</a> <a title="Permanent link" href="#ifdefine" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ifdefine"><span id="IfDefine"><IfDefine></span> Directive <a title="Permanent link" href="#ifdefine" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that will be processed only
if a test is true at startup</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IfDirective" id="IfDirective"><IfDirective></a> <a name="ifdirective" id="ifdirective">Directive</a> <a title="Permanent link" href="#ifdirective" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ifdirective"><span id="IfDirective"><IfDirective></span> Directive <a title="Permanent link" href="#ifdirective" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the
presence or absence of a specific directive</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IfFile" id="IfFile"><IfFile></a> <a name="iffile" id="iffile">Directive</a> <a title="Permanent link" href="#iffile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="iffile"><span id="IfFile"><IfFile></span> Directive <a title="Permanent link" href="#iffile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that will be processed only
if file exists at startup</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IfModule" id="IfModule"><IfModule></a> <a name="ifmodule" id="ifmodule">Directive</a> <a title="Permanent link" href="#ifmodule" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ifmodule"><span id="IfModule"><IfModule></span> Directive <a title="Permanent link" href="#ifmodule" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the
presence or absence of a specific module</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IfSection" id="IfSection"><IfSection></a> <a name="ifsection" id="ifsection">Directive</a> <a title="Permanent link" href="#ifsection" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ifsection"><span id="IfSection"><IfSection></span> Directive <a title="Permanent link" href="#ifsection" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the
presence or absence of a specific section directive</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a> <a title="Permanent link" href="#include" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="include"><span id="Include">Include</span> Directive <a title="Permanent link" href="#include" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Includes other configuration files from within
the server configuration files</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IncludeOptional" id="IncludeOptional">IncludeOptional</a> <a name="includeoptional" id="includeoptional">Directive</a> <a title="Permanent link" href="#includeoptional" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="includeoptional"><span id="IncludeOptional">IncludeOptional</span> Directive <a title="Permanent link" href="#includeoptional" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Includes other configuration files from within
the server configuration files</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a> <a title="Permanent link" href="#keepalive" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="keepalive"><span id="KeepAlive">KeepAlive</span> Directive <a title="Permanent link" href="#keepalive" class="permalink">¶</a></h2>
<table class="directive">
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a> <a title="Permanent link" href="#keepalivetimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="keepalivetimeout"><span id="KeepAliveTimeout">KeepAliveTimeout</span> Directive <a title="Permanent link" href="#keepalivetimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for subsequent
requests on a persistent connection</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Limit" id="Limit"><Limit></a> <a name="limit" id="limit">Directive</a> <a title="Permanent link" href="#limit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="limit"><span id="Limit"><Limit></span> Directive <a title="Permanent link" href="#limit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict enclosed access controls to only certain HTTP
methods</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LimitExcept" id="LimitExcept"><LimitExcept></a> <a name="limitexcept" id="limitexcept">Directive</a> <a title="Permanent link" href="#limitexcept" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="limitexcept"><span id="LimitExcept"><LimitExcept></span> Directive <a title="Permanent link" href="#limitexcept" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access controls to all HTTP methods
except the named ones</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a> <a title="Permanent link" href="#limitinternalrecursion" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="limitinternalrecursion"><span id="LimitInternalRecursion">LimitInternalRecursion</span> Directive <a title="Permanent link" href="#limitinternalrecursion" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine maximum number of internal redirects and nested
subrequests</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a> <a title="Permanent link" href="#limitrequestbody" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="limitrequestbody"><span id="LimitRequestBody">LimitRequestBody</span> Directive <a title="Permanent link" href="#limitrequestbody" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restricts the total size of the HTTP request body sent
from the client</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a> <a title="Permanent link" href="#limitrequestfields" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="limitrequestfields"><span id="LimitRequestFields">LimitRequestFields</span> Directive <a title="Permanent link" href="#limitrequestfields" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of HTTP request header fields that
will be accepted from the client</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a> <a title="Permanent link" href="#limitrequestfieldsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="limitrequestfieldsize"><span id="LimitRequestFieldSize">LimitRequestFieldSize</span> Directive <a title="Permanent link" href="#limitrequestfieldsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of the HTTP request header allowed from the
client</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a> <a title="Permanent link" href="#limitrequestline" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="limitrequestline"><span id="LimitRequestLine">LimitRequestLine</span> Directive <a title="Permanent link" href="#limitrequestline" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit the size of the HTTP request line that will be accepted
from the client</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a> <a title="Permanent link" href="#limitxmlrequestbody" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="limitxmlrequestbody"><span id="LimitXMLRequestBody">LimitXMLRequestBody</span> Directive <a title="Permanent link" href="#limitxmlrequestbody" class="permalink">¶</a></h2>
<table class="directive">
<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>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Location" id="Location"><Location></a> <a name="location" id="location">Directive</a> <a title="Permanent link" href="#location" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="location"><span id="Location"><Location></span> Directive <a title="Permanent link" href="#location" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to matching
URLs</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LocationMatch" id="LocationMatch"><LocationMatch></a> <a name="locationmatch" id="locationmatch">Directive</a> <a title="Permanent link" href="#locationmatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="locationmatch"><span id="LocationMatch"><LocationMatch></span> Directive <a title="Permanent link" href="#locationmatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to regular-expression
matching URLs</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a> <a title="Permanent link" href="#loglevel" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="loglevel"><span id="LogLevel">LogLevel</span> Directive <a title="Permanent link" href="#loglevel" class="permalink">¶</a></h2>
<table class="directive">
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LogLevelOverride" id="LogLevelOverride">LogLevelOverride</a> <a name="logleveloverride" id="logleveloverride">Directive</a> <a title="Permanent link" href="#logleveloverride" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="logleveloverride"><span id="LogLevelOverride">LogLevelOverride</span> Directive <a title="Permanent link" href="#logleveloverride" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override the verbosity of the ErrorLog for certain clients</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel <var>ipaddress</var>[/<var>prefixlen</var>]
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a> <a title="Permanent link" href="#maxkeepaliverequests" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxkeepaliverequests"><span id="MaxKeepAliveRequests">MaxKeepAliveRequests</span> Directive <a title="Permanent link" href="#maxkeepaliverequests" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of requests allowed on a persistent
connection</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxRangeOverlaps" id="MaxRangeOverlaps">MaxRangeOverlaps</a> <a name="maxrangeoverlaps" id="maxrangeoverlaps">Directive</a> <a title="Permanent link" href="#maxrangeoverlaps" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxrangeoverlaps"><span id="MaxRangeOverlaps">MaxRangeOverlaps</span> Directive <a title="Permanent link" href="#maxrangeoverlaps" class="permalink">¶</a></h2>
<table class="directive">
<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
resource </td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxRangeReversals" id="MaxRangeReversals">MaxRangeReversals</a> <a name="maxrangereversals" id="maxrangereversals">Directive</a> <a title="Permanent link" href="#maxrangereversals" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxrangereversals"><span id="MaxRangeReversals">MaxRangeReversals</span> Directive <a title="Permanent link" href="#maxrangereversals" class="permalink">¶</a></h2>
<table class="directive">
<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
resource </td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxRanges" id="MaxRanges">MaxRanges</a> <a name="maxranges" id="maxranges">Directive</a> <a title="Permanent link" href="#maxranges" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxranges"><span id="MaxRanges">MaxRanges</span> Directive <a title="Permanent link" href="#maxranges" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of ranges allowed before returning the complete
resource </td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MergeSlashes" id="MergeSlashes">MergeSlashes</a> <a name="mergeslashes" id="mergeslashes">Directive</a> <a title="Permanent link" href="#mergeslashes" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mergeslashes"><span id="MergeSlashes">MergeSlashes</span> Directive <a title="Permanent link" href="#mergeslashes" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether the server merges consecutive slashes in URLs.
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MergeTrailers" id="MergeTrailers">MergeTrailers</a> <a name="mergetrailers" id="mergetrailers">Directive</a> <a title="Permanent link" href="#mergetrailers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mergetrailers"><span id="MergeTrailers">MergeTrailers</span> Directive <a title="Permanent link" href="#mergetrailers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether trailers are merged into headers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MergeTrailers [on|off]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Mutex" id="Mutex">Mutex</a> <a name="mutex" id="mutex">Directive</a> <a title="Permanent link" href="#mutex" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mutex"><span id="Mutex">Mutex</span> Directive <a title="Permanent link" href="#mutex" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures mutex mechanism and lock file directory for all
or specified mutexes</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a> <a title="Permanent link" href="#namevirtualhost" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="namevirtualhost"><span id="NameVirtualHost">NameVirtualHost</span> Directive <a title="Permanent link" href="#namevirtualhost" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>DEPRECATED: Designates an IP address for name-virtual
hosting</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Options" id="Options">Options</a> <a name="options" id="options">Directive</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="options"><span id="Options">Options</span> Directive <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures what features are available in a particular
directory</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Protocol" id="Protocol">Protocol</a> <a name="protocol" id="protocol">Directive</a> <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="protocol"><span id="Protocol">Protocol</span> Directive <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
<table class="directive">
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Protocols" id="Protocols">Protocols</a> <a name="protocols" id="protocols">Directive</a> <a title="Permanent link" href="#protocols" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="protocols"><span id="Protocols">Protocols</span> Directive <a title="Permanent link" href="#protocols" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocols available for a server/virtual host</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Protocols <var>protocol</var> ...</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProtocolsHonorOrder" id="ProtocolsHonorOrder">ProtocolsHonorOrder</a> <a name="protocolshonororder" id="protocolshonororder">Directive</a> <a title="Permanent link" href="#protocolshonororder" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="protocolshonororder"><span id="ProtocolsHonorOrder">ProtocolsHonorOrder</span> Directive <a title="Permanent link" href="#protocolshonororder" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines if order of Protocols determines precedence during negotiation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProtocolsHonorOrder On|Off</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="QualifyRedirectURL" id="QualifyRedirectURL">QualifyRedirectURL</a> <a name="qualifyredirecturl" id="qualifyredirecturl">Directive</a> <a title="Permanent link" href="#qualifyredirecturl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="qualifyredirecturl"><span id="QualifyRedirectURL">QualifyRedirectURL</span> Directive <a title="Permanent link" href="#qualifyredirecturl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether the REDIRECT_URL environment variable is
fully qualified</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ReadBufferSize" id="ReadBufferSize">ReadBufferSize</a> <a name="readbuffersize" id="readbuffersize">Directive</a> <a title="Permanent link" href="#readbuffersize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="readbuffersize"><span id="ReadBufferSize">ReadBufferSize</span> Directive <a title="Permanent link" href="#readbuffersize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size of the buffers used to read data</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ReadBufferSize <var>bytes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RegexDefaultOptions" id="RegexDefaultOptions">RegexDefaultOptions</a> <a name="regexdefaultoptions" id="regexdefaultoptions">Directive</a> <a title="Permanent link" href="#regexdefaultoptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="regexdefaultoptions"><span id="RegexDefaultOptions">RegexDefaultOptions</span> Directive <a title="Permanent link" href="#regexdefaultoptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow to configure global/default options for regexes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RegexDefaultOptions [none] [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RegisterHttpMethod" id="RegisterHttpMethod">RegisterHttpMethod</a> <a name="registerhttpmethod" id="registerhttpmethod">Directive</a> <a title="Permanent link" href="#registerhttpmethod" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="registerhttpmethod"><span id="RegisterHttpMethod">RegisterHttpMethod</span> Directive <a title="Permanent link" href="#registerhttpmethod" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Register non-standard HTTP methods</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RegisterHttpMethod <var>method</var> [<var>method</var> [...]]</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a> <a title="Permanent link" href="#rlimitcpu" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rlimitcpu"><span id="RLimitCPU">RLimitCPU</span> Directive <a title="Permanent link" href="#rlimitcpu" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the CPU consumption of processes launched
by Apache httpd children</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a> <a title="Permanent link" href="#rlimitmem" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rlimitmem"><span id="RLimitMEM">RLimitMEM</span> Directive <a title="Permanent link" href="#rlimitmem" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the memory consumption of processes launched
by Apache httpd children</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a> <a title="Permanent link" href="#rlimitnproc" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rlimitnproc"><span id="RLimitNPROC">RLimitNPROC</span> Directive <a title="Permanent link" href="#rlimitnproc" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of processes that can be launched by
processes launched by Apache httpd children</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a> <a title="Permanent link" href="#scriptinterpretersource" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="scriptinterpretersource"><span id="ScriptInterpreterSource">ScriptInterpreterSource</span> Directive <a title="Permanent link" href="#scriptinterpretersource" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
scripts</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">Directive</a> <a title="Permanent link" href="#seerequesttail" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="seerequesttail"><span id="SeeRequestTail">SeeRequestTail</span> Directive <a title="Permanent link" href="#seerequesttail" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine if mod_status displays the first 63 characters
of a request or the last 63, assuming the request itself is greater than
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a> <a title="Permanent link" href="#serveradmin" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="serveradmin"><span id="ServerAdmin">ServerAdmin</span> Directive <a title="Permanent link" href="#serveradmin" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Email address that the server includes in error
messages sent to the client</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a> <a title="Permanent link" href="#serveralias" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="serveralias"><span id="ServerAlias">ServerAlias</span> Directive <a title="Permanent link" href="#serveralias" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate names for a host used when matching requests
to name-virtual hosts</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a> <a title="Permanent link" href="#servername" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="servername"><span id="ServerName">ServerName</span> Directive <a title="Permanent link" href="#servername" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Hostname and port that the server uses to identify
itself</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a> <a title="Permanent link" href="#serverpath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="serverpath"><span id="ServerPath">ServerPath</span> Directive <a title="Permanent link" href="#serverpath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Legacy URL pathname for a name-based virtual host that
is accessed by an incompatible browser</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a> <a title="Permanent link" href="#serverroot" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="serverroot"><span id="ServerRoot">ServerRoot</span> Directive <a title="Permanent link" href="#serverroot" class="permalink">¶</a></h2>
<table class="directive">
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a> <a title="Permanent link" href="#serversignature" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="serversignature"><span id="ServerSignature">ServerSignature</span> Directive <a title="Permanent link" href="#serversignature" class="permalink">¶</a></h2>
<table class="directive">
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a> <a title="Permanent link" href="#servertokens" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="servertokens"><span id="ServerTokens">ServerTokens</span> Directive <a title="Permanent link" href="#servertokens" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the <code>Server</code> HTTP response
header</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a> <a title="Permanent link" href="#sethandler" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sethandler"><span id="SetHandler">SetHandler</span> Directive <a title="Permanent link" href="#sethandler" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be processed by a
handler</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a> <a title="Permanent link" href="#setinputfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="setinputfilter"><span id="SetInputFilter">SetInputFilter</span> Directive <a title="Permanent link" href="#setinputfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process client requests and POST
input</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a> <a title="Permanent link" href="#setoutputfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="setoutputfilter"><span id="SetOutputFilter">SetOutputFilter</span> Directive <a title="Permanent link" href="#setoutputfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process responses from the
server</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="StrictHostCheck" id="StrictHostCheck">StrictHostCheck</a> <a name="stricthostcheck" id="stricthostcheck">Directive</a> <a title="Permanent link" href="#stricthostcheck" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="stricthostcheck"><span id="StrictHostCheck">StrictHostCheck</span> Directive <a title="Permanent link" href="#stricthostcheck" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether the server requires the requested hostname be
listed enumerated in the virtual host handling the request
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a> <a title="Permanent link" href="#timeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="timeout"><span id="TimeOut">TimeOut</span> Directive <a title="Permanent link" href="#timeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for
certain events before failing a request</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">Directive</a> <a title="Permanent link" href="#traceenable" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="traceenable"><span id="TraceEnable">TraceEnable</span> Directive <a title="Permanent link" href="#traceenable" class="permalink">¶</a></h2>
<table class="directive">
<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>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="UNCList" id="UNCList">UNCList</a> <a name="unclist" id="unclist">Directive</a> <a title="Permanent link" href="#unclist" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="unclist"><span id="UNCList">UNCList</span> Directive <a title="Permanent link" href="#unclist" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls what UNC host names can be accessed by the server
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="UnDefine" id="UnDefine">UnDefine</a> <a name="undefine" id="undefine">Directive</a> <a title="Permanent link" href="#undefine" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="undefine"><span id="UnDefine">UnDefine</span> Directive <a title="Permanent link" href="#undefine" class="permalink">¶</a></h2>
<table class="directive">
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a> <a title="Permanent link" href="#usecanonicalname" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="usecanonicalname"><span id="UseCanonicalName">UseCanonicalName</span> Directive <a title="Permanent link" href="#usecanonicalname" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own name and
port</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a> <a title="Permanent link" href="#usecanonicalphysicalport" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="usecanonicalphysicalport"><span id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</span> Directive <a title="Permanent link" href="#usecanonicalphysicalport" class="permalink">¶</a></h2>
<table class="directive">
<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>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VirtualHost" id="VirtualHost"><VirtualHost></a> <a name="virtualhost" id="virtualhost">Directive</a> <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="virtualhost"><span id="VirtualHost"><VirtualHost></span> Directive <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only to a specific
hostname or IP address</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Warning" id="Warning">Warning</a> <a name="warning" id="warning">Directive</a> <a title="Permanent link" href="#warning" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="warning"><span id="Warning">Warning</span> Directive <a title="Permanent link" href="#warning" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Warn from configuration parsing with a custom message</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Warning <var>message</var></code></td></tr>
<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../configuring.html">Configuration files</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Description" id="Description">Description</a> <a title="Permanent link" href="#Description" class="permalink">¶</a></h2>
+<h2
id="Description">Description <a title="Permanent link" href="#Description" class="permalink">¶</a></h2>
<p>A brief description of the purpose of the directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Syntax" id="Syntax">Syntax</a> <a title="Permanent link" href="#Syntax" class="permalink">¶</a></h2>
+<h2
id="Syntax">Syntax <a title="Permanent link" href="#Syntax" class="permalink">¶</a></h2>
<p>This indicates the format of the directive as it would
appear in a configuration file. This syntax is extremely
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Default" id="Default">Default</a> <a title="Permanent link" href="#Default" class="permalink">¶</a></h2>
+<h2
id="Default">Default <a title="Permanent link" href="#Default" class="permalink">¶</a></h2>
<p>If the directive has a default value (<em>i.e.</em>, if you
omit it from your configuration entirely, the Apache Web server
the default httpd.conf distributed with the server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Context" id="Context">Context</a> <a title="Permanent link" href="#Context" class="permalink">¶</a></h2>
+<h2
id="Context">Context <a title="Permanent link" href="#Context" class="permalink">¶</a></h2>
<p>This indicates where in the server's configuration files the
directive is legal. It's a comma-separated list of one or more
containers.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Override" id="Override">Override</a> <a title="Permanent link" href="#Override" class="permalink">¶</a></h2>
+<h2
id="Override">Override <a title="Permanent link" href="#Override" class="permalink">¶</a></h2>
<p>This directive attribute indicates which configuration
override must be active in order for the directive to be
possible override names available.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Status" id="Status">Status</a> <a title="Permanent link" href="#Status" class="permalink">¶</a></h2>
+<h2
id="Status">Status <a title="Permanent link" href="#Status" class="permalink">¶</a></h2>
<p>This indicates how tightly bound into the Apache Web server
the directive is; in other words, you may need to recompile the
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Module" id="Module">Module</a> <a title="Permanent link" href="#Module" class="permalink">¶</a></h2>
+<h2
id="Module">Module <a title="Permanent link" href="#Module" class="permalink">¶</a></h2>
<p>This quite simply lists the name of the source module which
defines the directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Compatibility" id="Compatibility">Compatibility</a> <a title="Permanent link" href="#Compatibility" class="permalink">¶</a></h2>
+<h2
id="Compatibility">Compatibility <a title="Permanent link" href="#Compatibility" class="permalink">¶</a></h2>
<p>If the directive wasn't part of the original Apache version
2 distribution, the version in which it was introduced should
<a href="../tr/mod/directive-dict.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../zh-cn/mod/directives.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="event-worker-relationship" id="event-worker-relationship">Relationship with the Worker MPM</a> <a title="Permanent link" href="#event-worker-relationship" class="permalink">¶</a></h2>
+<h2
id="event-worker-relationship">Relationship with the Worker MPM <a title="Permanent link" href="#event-worker-relationship" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/event.html">event</a></code> is based on the <code class="module"><a href="../mod/worker.html">worker</a></code> MPM, which implements a hybrid
multi-process multi-threaded server. A single control process (the parent) is responsible for launching
child processes. Each child process creates a fixed number of server
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="how-it-works" id="how-it-works">How it Works</a> <a title="Permanent link" href="#how-it-works" class="permalink">¶</a></h2>
+<h2
id="how-it-works">How it Works <a title="Permanent link" href="#how-it-works" class="permalink">¶</a></h2>
<p>The original goal of this MPM was to fix the 'keep alive problem' in HTTP. After a client
completes the first request, it can keep the connection
open, sending further requests using the same socket and saving
<p>The total amount of connections that a single process/threads block can handle is regulated
by the <code class="directive">AsyncRequestWorkerFactor</code> directive.</p>
- <h3><a name="async-connections" id="async-connections">Async connections</a></h3>
+ <h3 id="async-connections">Async connections</h3>
<p>Async connections would need a fixed dedicated worker thread with the previous MPMs but not with event.
The status page of <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> shows new columns under the Async connections section:</p>
<dl>
- <h3><a name="graceful-close" id="graceful-close">Graceful process termination and Scoreboard usage</a></h3>
+ <h3 id="graceful-close">Graceful process termination and Scoreboard usage</h3>
<p>This mpm showed some scalability bottlenecks in the past, leading to the following
error: "<strong>scoreboard is full, not at MaxRequestWorkers</strong>".
<code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>
indicates a process still running after a graceful restart.</p>
- <h3><a name="limitations" id="limitations">Limitations</a></h3>
+ <h3 id="limitations">Limitations</h3>
<p>The improved connection handling may not work for certain connection
filters that have declared themselves as incompatible with event. In these
cases, this MPM will fall back to the behavior of the
- <h3><a name="background" id="background">Background material</a></h3>
+ <h3 id="background">Background material</h3>
<p>The event model was made possible by the introduction of new APIs into the supported operating systems:</p>
<ul>
<li>epoll (Linux) </li>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requirements" id="requirements">Requirements</a> <a title="Permanent link" href="#requirements" class="permalink">¶</a></h2>
+<h2
id="requirements">Requirements <a title="Permanent link" href="#requirements" class="permalink">¶</a></h2>
<p>This MPM depends on <a class="glossarylink" href="../glossary.html#apr" title="see glossary">APR</a>'s atomic
compare-and-swap operations for thread synchronization. If you are
compiling for an x86 target and you don't need to support 386s, or
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AsyncRequestWorkerFactor" id="AsyncRequestWorkerFactor">AsyncRequestWorkerFactor</a> <a name="asyncrequestworkerfactor" id="asyncrequestworkerfactor">Directive</a> <a title="Permanent link" href="#asyncrequestworkerfactor" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="asyncrequestworkerfactor"><span id="AsyncRequestWorkerFactor">AsyncRequestWorkerFactor</span> Directive <a title="Permanent link" href="#asyncrequestworkerfactor" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit concurrent connections per process</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AsyncRequestWorkerFactor <var>factor</var></code></td></tr>
<a href="../fr/mod/event.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../zh-cn/mod/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Allow" id="Allow">Allow</a> <a name="allow" id="allow">Directive</a> <a title="Permanent link" href="#allow" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="allow"><span id="Allow">Allow</span> Directive <a title="Permanent link" href="#allow" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls which hosts can access an area of the
server</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Deny" id="Deny">Deny</a> <a name="deny" id="deny">Directive</a> <a title="Permanent link" href="#deny" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deny"><span id="Deny">Deny</span> Directive <a title="Permanent link" href="#deny" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls which hosts are denied access to the
server</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Order" id="Order">Order</a> <a name="order" id="order">Directive</a> <a title="Permanent link" href="#order" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="order"><span id="Order">Order</span> Directive <a title="Permanent link" href="#order" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the default access state and the order in which
<code class="directive">Allow</code> and <code class="directive">Deny</code> are
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Satisfy" id="Satisfy">Satisfy</a> <a name="satisfy" id="satisfy">Directive</a> <a title="Permanent link" href="#satisfy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="satisfy"><span id="Satisfy">Satisfy</span> Directive <a title="Permanent link" href="#satisfy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interaction between host-level access control and
user authentication</td></tr>
<a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Action" id="Action">Action</a> <a name="action" id="action">Directive</a> <a title="Permanent link" href="#action" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="action"><span id="Action">Action</span> Directive <a title="Permanent link" href="#action" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activates a CGI script for a particular handler or
content-type</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Script" id="Script">Script</a> <a name="script" id="script">Directive</a> <a title="Permanent link" href="#script" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="script"><span id="Script">Script</span> Directive <a title="Permanent link" href="#script" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activates a CGI script for a particular request
method.</td></tr>
<a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="order" id="order">Order of Processing</a> <a title="Permanent link" href="#order" class="permalink">¶</a></h2>
+<h2
id="order">Order of Processing <a title="Permanent link" href="#order" class="permalink">¶</a></h2>
<p>Aliases and Redirects occurring in different contexts are processed
like other directives according to standard <a href="../sections.html#merging">merging rules</a>. But when multiple
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Alias" id="Alias">Alias</a> <a name="alias" id="alias">Directive</a> <a title="Permanent link" href="#alias" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="alias"><span id="Alias">Alias</span> Directive <a title="Permanent link" href="#alias" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps URLs to filesystem locations</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Alias [<var>URL-path</var>]
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AliasMatch" id="AliasMatch">AliasMatch</a> <a name="aliasmatch" id="aliasmatch">Directive</a> <a title="Permanent link" href="#aliasmatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="aliasmatch"><span id="AliasMatch">AliasMatch</span> Directive <a title="Permanent link" href="#aliasmatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps URLs to filesystem locations using regular
expressions</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AliasPreservePath" id="AliasPreservePath">AliasPreservePath</a> <a name="aliaspreservepath" id="aliaspreservepath">Directive</a> <a title="Permanent link" href="#aliaspreservepath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="aliaspreservepath"><span id="AliasPreservePath">AliasPreservePath</span> Directive <a title="Permanent link" href="#aliaspreservepath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Map the full path after the alias in a location.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AliasPreservePath OFF|ON</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Redirect" id="Redirect">Redirect</a> <a name="redirect" id="redirect">Directive</a> <a title="Permanent link" href="#redirect" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="redirect"><span id="Redirect">Redirect</span> Directive <a title="Permanent link" href="#redirect" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external redirect asking the client to fetch
a different URL</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RedirectMatch" id="RedirectMatch">RedirectMatch</a> <a name="redirectmatch" id="redirectmatch">Directive</a> <a title="Permanent link" href="#redirectmatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="redirectmatch"><span id="RedirectMatch">RedirectMatch</span> Directive <a title="Permanent link" href="#redirectmatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external redirect based on a regular expression match
of the current URL</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RedirectPermanent" id="RedirectPermanent">RedirectPermanent</a> <a name="redirectpermanent" id="redirectpermanent">Directive</a> <a title="Permanent link" href="#redirectpermanent" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="redirectpermanent"><span id="RedirectPermanent">RedirectPermanent</span> Directive <a title="Permanent link" href="#redirectpermanent" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external permanent redirect asking the client to fetch
a different URL</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RedirectRelative" id="RedirectRelative">RedirectRelative</a> <a name="redirectrelative" id="redirectrelative">Directive</a> <a title="Permanent link" href="#redirectrelative" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="redirectrelative"><span id="RedirectRelative">RedirectRelative</span> Directive <a title="Permanent link" href="#redirectrelative" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allows relative redirect targets.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RedirectRelative On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RedirectTemp" id="RedirectTemp">RedirectTemp</a> <a name="redirecttemp" id="redirecttemp">Directive</a> <a title="Permanent link" href="#redirecttemp" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="redirecttemp"><span id="RedirectTemp">RedirectTemp</span> Directive <a title="Permanent link" href="#redirecttemp" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external temporary redirect asking the client to fetch
a different URL</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ScriptAlias" id="ScriptAlias">ScriptAlias</a> <a name="scriptalias" id="scriptalias">Directive</a> <a title="Permanent link" href="#scriptalias" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="scriptalias"><span id="ScriptAlias">ScriptAlias</span> Directive <a title="Permanent link" href="#scriptalias" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps a URL to a filesystem location and designates the
target as a CGI script</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ScriptAliasMatch" id="ScriptAliasMatch">ScriptAliasMatch</a> <a name="scriptaliasmatch" id="scriptaliasmatch">Directive</a> <a title="Permanent link" href="#scriptaliasmatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="scriptaliasmatch"><span id="ScriptAliasMatch">ScriptAliasMatch</span> Directive <a title="Permanent link" href="#scriptaliasmatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps a URL to a filesystem location using a regular expression
and designates the target as a CGI script</td></tr>
<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AllowHandlers" id="AllowHandlers">AllowHandlers</a> <a name="allowhandlers" id="allowhandlers">Directive</a> <a title="Permanent link" href="#allowhandlers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="allowhandlers"><span id="AllowHandlers">AllowHandlers</span> Directive <a title="Permanent link" href="#allowhandlers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access to the listed handlers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowHandlers [not] none|<em>handler-name</em>
<a href="../fr/mod/mod_allowhandlers.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_allowmethods">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_allowmethods">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AllowMethods" id="AllowMethods">AllowMethods</a> <a name="allowmethods" id="allowmethods">Directive</a> <a title="Permanent link" href="#allowmethods" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="allowmethods"><span id="AllowMethods">AllowMethods</span> Directive <a title="Permanent link" href="#allowmethods" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access to the listed HTTP methods</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowMethods reset | [+|-]<var>HTTP-method</var>
<a href="../fr/mod/mod_allowmethods.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usage" id="usage">Usage</a> <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
+<h2
id="usage">Usage <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
<p>In the server configuration file, associate files with the
<code>send-as-is</code> handler <em>e.g.</em></p>
<a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthBasicAuthoritative" id="AuthBasicAuthoritative">AuthBasicAuthoritative</a> <a name="authbasicauthoritative" id="authbasicauthoritative">Directive</a> <a title="Permanent link" href="#authbasicauthoritative" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authbasicauthoritative"><span id="AuthBasicAuthoritative">AuthBasicAuthoritative</span> Directive <a title="Permanent link" href="#authbasicauthoritative" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether authorization and authentication are passed to
lower level modules</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthBasicFake" id="AuthBasicFake">AuthBasicFake</a> <a name="authbasicfake" id="authbasicfake">Directive</a> <a title="Permanent link" href="#authbasicfake" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authbasicfake"><span id="AuthBasicFake">AuthBasicFake</span> Directive <a title="Permanent link" href="#authbasicfake" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fake basic authentication using the given expressions for
username and password</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthBasicProvider" id="AuthBasicProvider">AuthBasicProvider</a> <a name="authbasicprovider" id="authbasicprovider">Directive</a> <a title="Permanent link" href="#authbasicprovider" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authbasicprovider"><span id="AuthBasicProvider">AuthBasicProvider</span> Directive <a title="Permanent link" href="#authbasicprovider" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the authentication provider(s) for this location</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthBasicProvider <var>provider-name</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthBasicUseDigestAlgorithm" id="AuthBasicUseDigestAlgorithm">AuthBasicUseDigestAlgorithm</a> <a name="authbasicusedigestalgorithm" id="authbasicusedigestalgorithm">Directive</a> <a title="Permanent link" href="#authbasicusedigestalgorithm" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authbasicusedigestalgorithm"><span id="AuthBasicUseDigestAlgorithm">AuthBasicUseDigestAlgorithm</span> Directive <a title="Permanent link" href="#authbasicusedigestalgorithm" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Check passwords against the authentication providers as if
Digest Authentication was in force instead of Basic Authentication.
<a href="../ko/mod/mod_auth_basic.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthBearerAuthoritative" id="AuthBearerAuthoritative">AuthBearerAuthoritative</a> <a name="authbearerauthoritative" id="authbearerauthoritative">Directive</a> <a title="Permanent link" href="#authbearerauthoritative" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authbearerauthoritative"><span id="AuthBearerAuthoritative">AuthBearerAuthoritative</span> Directive <a title="Permanent link" href="#authbearerauthoritative" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether token verification is passed to lower level
modules</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthBearerProvider" id="AuthBearerProvider">AuthBearerProvider</a> <a name="authbearerprovider" id="authbearerprovider">Directive</a> <a title="Permanent link" href="#authbearerprovider" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authbearerprovider"><span id="AuthBearerProvider">AuthBearerProvider</span> Directive <a title="Permanent link" href="#authbearerprovider" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the authentication provider(s) for this location</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthBearerProvider <var>provider-name</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthBearerProxy" id="AuthBearerProxy">AuthBearerProxy</a> <a name="authbearerproxy" id="authbearerproxy">Directive</a> <a title="Permanent link" href="#authbearerproxy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authbearerproxy"><span id="AuthBearerProxy">AuthBearerProxy</span> Directive <a title="Permanent link" href="#authbearerproxy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pass a bearer authentication token over a proxy connection
generated using the given expression</td></tr>
<a href="../fr/mod/mod_auth_bearer.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="using" id="using">Using Digest Authentication</a> <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
+<h2
id="using">Using Digest Authentication <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
<p>To use MD5 Digest authentication, configure the location to be
protected as shown in the below example:</p>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDigestAlgorithm" id="AuthDigestAlgorithm">AuthDigestAlgorithm</a> <a name="authdigestalgorithm" id="authdigestalgorithm">Directive</a> <a title="Permanent link" href="#authdigestalgorithm" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdigestalgorithm"><span id="AuthDigestAlgorithm">AuthDigestAlgorithm</span> Directive <a title="Permanent link" href="#authdigestalgorithm" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Selects the algorithm used to calculate the challenge and
response hashes in digest authentication</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDigestDomain" id="AuthDigestDomain">AuthDigestDomain</a> <a name="authdigestdomain" id="authdigestdomain">Directive</a> <a title="Permanent link" href="#authdigestdomain" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdigestdomain"><span id="AuthDigestDomain">AuthDigestDomain</span> Directive <a title="Permanent link" href="#authdigestdomain" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URIs that are in the same protection space for digest
authentication</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDigestNcCheck" id="AuthDigestNcCheck">AuthDigestNcCheck</a> <a name="authdigestnccheck" id="authdigestnccheck">Directive</a> <a title="Permanent link" href="#authdigestnccheck" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdigestnccheck"><span id="AuthDigestNcCheck">AuthDigestNcCheck</span> Directive <a title="Permanent link" href="#authdigestnccheck" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables or disables checking of the nonce-count sent by the
client</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDigestNonceLifetime" id="AuthDigestNonceLifetime">AuthDigestNonceLifetime</a> <a name="authdigestnoncelifetime" id="authdigestnoncelifetime">Directive</a> <a title="Permanent link" href="#authdigestnoncelifetime" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdigestnoncelifetime"><span id="AuthDigestNonceLifetime">AuthDigestNonceLifetime</span> Directive <a title="Permanent link" href="#authdigestnoncelifetime" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How long the server nonce is valid</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDigestNonceLifetime <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDigestProvider" id="AuthDigestProvider">AuthDigestProvider</a> <a name="authdigestprovider" id="authdigestprovider">Directive</a> <a title="Permanent link" href="#authdigestprovider" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdigestprovider"><span id="AuthDigestProvider">AuthDigestProvider</span> Directive <a title="Permanent link" href="#authdigestprovider" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the authentication provider(s) for this location</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDigestProvider <var>provider-name</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDigestQop" id="AuthDigestQop">AuthDigestQop</a> <a name="authdigestqop" id="authdigestqop">Directive</a> <a title="Permanent link" href="#authdigestqop" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdigestqop"><span id="AuthDigestQop">AuthDigestQop</span> Directive <a title="Permanent link" href="#authdigestqop" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the quality-of-protection to use in digest
authentication</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDigestShmemSize" id="AuthDigestShmemSize">AuthDigestShmemSize</a> <a name="authdigestshmemsize" id="authdigestshmemsize">Directive</a> <a title="Permanent link" href="#authdigestshmemsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdigestshmemsize"><span id="AuthDigestShmemSize">AuthDigestShmemSize</span> Directive <a title="Permanent link" href="#authdigestshmemsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The amount of shared memory to allocate for keeping track
of clients</td></tr>
<a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basicconfig" id="basicconfig">Basic Configuration</a> <a title="Permanent link" href="#basicconfig" class="permalink">¶</a></h2>
+<h2
id="basicconfig">Basic Configuration <a title="Permanent link" href="#basicconfig" class="permalink">¶</a></h2>
<p>To protect a particular URL with <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, you need to
decide where you will store your <var>session</var>, and you will need to
page inline.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="standalone" id="standalone">Standalone Login</a> <a title="Permanent link" href="#standalone" class="permalink">¶</a></h2>
+<h2
id="standalone">Standalone Login <a title="Permanent link" href="#standalone" class="permalink">¶</a></h2>
<p>The login form can be hosted as a standalone page, or can be provided inline on
the same page.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="inline" id="inline">Inline Login</a> <a title="Permanent link" href="#inline" class="permalink">¶</a></h2>
+<h2
id="inline">Inline Login <a title="Permanent link" href="#inline" class="permalink">¶</a></h2>
<div class="warning"><h3>Warning</h3>
<p>A risk exists that under certain circumstances, the login form configured
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="inlinepreservebody" id="inlinepreservebody">Inline Login with Body Preservation</a> <a title="Permanent link" href="#inlinepreservebody" class="permalink">¶</a></h2>
+<h2
id="inlinepreservebody">Inline Login with Body Preservation <a title="Permanent link" href="#inlinepreservebody" class="permalink">¶</a></h2>
<p>A limitation of the inline login technique described above is that should an
HTML form POST have resulted in the request to authenticate or
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="loggingout" id="loggingout">Logging Out</a> <a title="Permanent link" href="#loggingout" class="permalink">¶</a></h2>
+<h2
id="loggingout">Logging Out <a title="Permanent link" href="#loggingout" class="permalink">¶</a></h2>
<p>To enable a user to log out of a particular session, configure a page to
be handled by the <var>form-logout-handler</var>. Any attempt to access this
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="urlencoding" id="urlencoding">Usernames and Passwords</a> <a title="Permanent link" href="#urlencoding" class="permalink">¶</a></h2>
+<h2
id="urlencoding">Usernames and Passwords <a title="Permanent link" href="#urlencoding" class="permalink">¶</a></h2>
<p>Note that form submission involves URLEncoding the form data:
in this case the username and password. You should therefore
pick usernames and passwords that avoid characters that are
URLencoded in form submission, or you may get unexpected results.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormAuthoritative" id="AuthFormAuthoritative">AuthFormAuthoritative</a> <a name="authformauthoritative" id="authformauthoritative">Directive</a> <a title="Permanent link" href="#authformauthoritative" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformauthoritative"><span id="AuthFormAuthoritative">AuthFormAuthoritative</span> Directive <a title="Permanent link" href="#authformauthoritative" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether authorization and authentication are passed to
lower level modules</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormBody" id="AuthFormBody">AuthFormBody</a> <a name="authformbody" id="authformbody">Directive</a> <a title="Permanent link" href="#authformbody" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformbody"><span id="AuthFormBody">AuthFormBody</span> Directive <a title="Permanent link" href="#authformbody" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the body of the request to attempt on successful login</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormBody <var>fieldname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormDisableNoStore" id="AuthFormDisableNoStore">AuthFormDisableNoStore</a> <a name="authformdisablenostore" id="authformdisablenostore">Directive</a> <a title="Permanent link" href="#authformdisablenostore" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformdisablenostore"><span id="AuthFormDisableNoStore">AuthFormDisableNoStore</span> Directive <a title="Permanent link" href="#authformdisablenostore" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disable the CacheControl no-store header on the login page</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormDisableNoStore On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormFakeBasicAuth" id="AuthFormFakeBasicAuth">AuthFormFakeBasicAuth</a> <a name="authformfakebasicauth" id="authformfakebasicauth">Directive</a> <a title="Permanent link" href="#authformfakebasicauth" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformfakebasicauth"><span id="AuthFormFakeBasicAuth">AuthFormFakeBasicAuth</span> Directive <a title="Permanent link" href="#authformfakebasicauth" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fake a Basic Authentication header</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormFakeBasicAuth On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormLocation" id="AuthFormLocation">AuthFormLocation</a> <a name="authformlocation" id="authformlocation">Directive</a> <a title="Permanent link" href="#authformlocation" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformlocation"><span id="AuthFormLocation">AuthFormLocation</span> Directive <a title="Permanent link" href="#authformlocation" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying a URL to redirect to on successful login</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormLocation <var>fieldname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormLoginRequiredLocation" id="AuthFormLoginRequiredLocation">AuthFormLoginRequiredLocation</a> <a name="authformloginrequiredlocation" id="authformloginrequiredlocation">Directive</a> <a title="Permanent link" href="#authformloginrequiredlocation" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformloginrequiredlocation"><span id="AuthFormLoginRequiredLocation">AuthFormLoginRequiredLocation</span> Directive <a title="Permanent link" href="#authformloginrequiredlocation" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The URL of the page to be redirected to should login be required</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormLoginRequiredLocation <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormLoginSuccessLocation" id="AuthFormLoginSuccessLocation">AuthFormLoginSuccessLocation</a> <a name="authformloginsuccesslocation" id="authformloginsuccesslocation">Directive</a> <a title="Permanent link" href="#authformloginsuccesslocation" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformloginsuccesslocation"><span id="AuthFormLoginSuccessLocation">AuthFormLoginSuccessLocation</span> Directive <a title="Permanent link" href="#authformloginsuccesslocation" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The URL of the page to be redirected to should login be successful</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormLoginSuccessLocation <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormLogoutLocation" id="AuthFormLogoutLocation">AuthFormLogoutLocation</a> <a name="authformlogoutlocation" id="authformlogoutlocation">Directive</a> <a title="Permanent link" href="#authformlogoutlocation" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformlogoutlocation"><span id="AuthFormLogoutLocation">AuthFormLogoutLocation</span> Directive <a title="Permanent link" href="#authformlogoutlocation" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The URL to redirect to after a user has logged out</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormLogoutLocation <var>uri</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormMethod" id="AuthFormMethod">AuthFormMethod</a> <a name="authformmethod" id="authformmethod">Directive</a> <a title="Permanent link" href="#authformmethod" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformmethod"><span id="AuthFormMethod">AuthFormMethod</span> Directive <a title="Permanent link" href="#authformmethod" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the method of the request to attempt on successful login</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormMethod <var>fieldname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormMimetype" id="AuthFormMimetype">AuthFormMimetype</a> <a name="authformmimetype" id="authformmimetype">Directive</a> <a title="Permanent link" href="#authformmimetype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformmimetype"><span id="AuthFormMimetype">AuthFormMimetype</span> Directive <a title="Permanent link" href="#authformmimetype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the mimetype of the body of the request to attempt on successful login</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormMimetype <var>fieldname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormPassword" id="AuthFormPassword">AuthFormPassword</a> <a name="authformpassword" id="authformpassword">Directive</a> <a title="Permanent link" href="#authformpassword" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformpassword"><span id="AuthFormPassword">AuthFormPassword</span> Directive <a title="Permanent link" href="#authformpassword" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the login password</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormPassword <var>fieldname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormProvider" id="AuthFormProvider">AuthFormProvider</a> <a name="authformprovider" id="authformprovider">Directive</a> <a title="Permanent link" href="#authformprovider" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformprovider"><span id="AuthFormProvider">AuthFormProvider</span> Directive <a title="Permanent link" href="#authformprovider" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the authentication provider(s) for this location</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormProvider <var>provider-name</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormSitePassphrase" id="AuthFormSitePassphrase">AuthFormSitePassphrase</a> <a name="authformsitepassphrase" id="authformsitepassphrase">Directive</a> <a title="Permanent link" href="#authformsitepassphrase" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformsitepassphrase"><span id="AuthFormSitePassphrase">AuthFormSitePassphrase</span> Directive <a title="Permanent link" href="#authformsitepassphrase" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Bypass authentication checks for high traffic sites</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormSitePassphrase <var>secret</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormSize" id="AuthFormSize">AuthFormSize</a> <a name="authformsize" id="authformsize">Directive</a> <a title="Permanent link" href="#authformsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformsize"><span id="AuthFormSize">AuthFormSize</span> Directive <a title="Permanent link" href="#authformsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The largest size of the form in bytes that will be parsed for the login details</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormSize <var>size</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthFormUsername" id="AuthFormUsername">AuthFormUsername</a> <a name="authformusername" id="authformusername">Directive</a> <a title="Permanent link" href="#authformusername" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authformusername"><span id="AuthFormUsername">AuthFormUsername</span> Directive <a title="Permanent link" href="#authformusername" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the login username</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthFormUsername <var>fieldname</var></code></td></tr>
<a href="../fr/mod/mod_auth_form.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_authn_anon">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_authn_anon">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="example" id="example">Example</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<h2
id="example">Example <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<p>The example below is combined with "normal" htpasswd-file based
authentication and allows users in additionally as 'guests' with the
following properties:</p>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Anonymous" id="Anonymous">Anonymous</a> <a name="anonymous" id="anonymous">Directive</a> <a title="Permanent link" href="#anonymous" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="anonymous"><span id="Anonymous">Anonymous</span> Directive <a title="Permanent link" href="#anonymous" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies userIDs that are allowed access without
password verification</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Anonymous_LogEmail" id="Anonymous_LogEmail">Anonymous_LogEmail</a> <a name="anonymous_logemail" id="anonymous_logemail">Directive</a> <a title="Permanent link" href="#anonymous_logemail" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="anonymous_logemail"><span id="Anonymous_LogEmail">Anonymous_LogEmail</span> Directive <a title="Permanent link" href="#anonymous_logemail" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether the password entered will be logged in the
error log</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Anonymous_MustGiveEmail" id="Anonymous_MustGiveEmail">Anonymous_MustGiveEmail</a> <a name="anonymous_mustgiveemail" id="anonymous_mustgiveemail">Directive</a> <a title="Permanent link" href="#anonymous_mustgiveemail" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="anonymous_mustgiveemail"><span id="Anonymous_MustGiveEmail">Anonymous_MustGiveEmail</span> Directive <a title="Permanent link" href="#anonymous_mustgiveemail" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies whether blank passwords are allowed</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Anonymous_MustGiveEmail On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Anonymous_NoUserID" id="Anonymous_NoUserID">Anonymous_NoUserID</a> <a name="anonymous_nouserid" id="anonymous_nouserid">Directive</a> <a title="Permanent link" href="#anonymous_nouserid" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="anonymous_nouserid"><span id="Anonymous_NoUserID">Anonymous_NoUserID</span> Directive <a title="Permanent link" href="#anonymous_nouserid" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether the userID field may be empty</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Anonymous_NoUserID On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Anonymous_VerifyEmail" id="Anonymous_VerifyEmail">Anonymous_VerifyEmail</a> <a name="anonymous_verifyemail" id="anonymous_verifyemail">Directive</a> <a title="Permanent link" href="#anonymous_verifyemail" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="anonymous_verifyemail"><span id="Anonymous_VerifyEmail">Anonymous_VerifyEmail</span> Directive <a title="Permanent link" href="#anonymous_verifyemail" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether to check the password field for a correctly
formatted email address</td></tr>
<a href="../ko/mod/mod_authn_anon.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_authn_core">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_authn_core">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="authnalias" id="authnalias">Creating Authentication Provider Aliases</a> <a title="Permanent link" href="#authnalias" class="permalink">¶</a></h2>
+<h2
id="authnalias">Creating Authentication Provider Aliases <a title="Permanent link" href="#authnalias" class="permalink">¶</a></h2>
<p>Extended authentication providers can be created
within the configuration file and assigned an alias name. The alias
extended authentication provider to be reference by multiple
locations.</p>
- <h3><a name="example" id="example">Examples</a></h3>
+ <h3 id="example">Examples</h3>
<p>This example checks for passwords in two different text
files.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthName" id="AuthName">AuthName</a> <a name="authname" id="authname">Directive</a> <a title="Permanent link" href="#authname" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authname"><span id="AuthName">AuthName</span> Directive <a title="Permanent link" href="#authname" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Authorization realm for use in HTTP
authentication</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthnProviderAlias" id="AuthnProviderAlias"><AuthnProviderAlias></a> <a name="authnprovideralias" id="authnprovideralias">Directive</a> <a title="Permanent link" href="#authnprovideralias" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authnprovideralias"><span id="AuthnProviderAlias"><AuthnProviderAlias></span> Directive <a title="Permanent link" href="#authnprovideralias" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that represent an
extension of a base authentication provider and referenced by
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthType" id="AuthType">AuthType</a> <a name="authtype" id="authtype">Directive</a> <a title="Permanent link" href="#authtype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authtype"><span id="AuthType">AuthType</span> Directive <a title="Permanent link" href="#authtype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of user authentication</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthType None|Basic|Digest|Form</code></td></tr>
<a href="../fr/mod/mod_authn_core.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="socache" id="socache">Performance and Caching</a> <a title="Permanent link" href="#socache" class="permalink">¶</a></h2>
+<h2
id="socache">Performance and Caching <a title="Permanent link" href="#socache" class="permalink">¶</a></h2>
<p>Some users of DBD authentication in HTTPD 2.2/2.4 have reported that it
imposes a problematic load on the database. This is most likely where
to cache credentials and take most of the load off the database.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="example" id="example">Configuration Example</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<h2
id="example">Configuration Example <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<p>This simple example shows use of this module in the context of
the Authentication and DBD frameworks.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="exposed" id="exposed">Exposing Login Information</a> <a title="Permanent link" href="#exposed" class="permalink">¶</a></h2>
+<h2
id="exposed">Exposing Login Information <a title="Permanent link" href="#exposed" class="permalink">¶</a></h2>
<p>
Whenever a query is made to the database server, all
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Preventing SQL injections</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Preventing SQL injections <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>Whether you need to care about SQL security depends on what DBD driver
and backend you use. With most drivers you don't have to do anything :
about security on this scope.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDBDUserPWQuery" id="AuthDBDUserPWQuery">AuthDBDUserPWQuery</a> <a name="authdbduserpwquery" id="authdbduserpwquery">Directive</a> <a title="Permanent link" href="#authdbduserpwquery" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdbduserpwquery"><span id="AuthDBDUserPWQuery">AuthDBDUserPWQuery</span> Directive <a title="Permanent link" href="#authdbduserpwquery" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SQL query to look up a password for a user</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDBDUserPWQuery <var>query</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDBDUserRealmQuery" id="AuthDBDUserRealmQuery">AuthDBDUserRealmQuery</a> <a name="authdbduserrealmquery" id="authdbduserrealmquery">Directive</a> <a title="Permanent link" href="#authdbduserrealmquery" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdbduserrealmquery"><span id="AuthDBDUserRealmQuery">AuthDBDUserRealmQuery</span> Directive <a title="Permanent link" href="#authdbduserrealmquery" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SQL query to look up a password hash for a user and realm.
</td></tr>
<a href="../fr/mod/mod_authn_dbd.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDBMType" id="AuthDBMType">AuthDBMType</a> <a name="authdbmtype" id="authdbmtype">Directive</a> <a title="Permanent link" href="#authdbmtype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdbmtype"><span id="AuthDBMType">AuthDBMType</span> Directive <a title="Permanent link" href="#authdbmtype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the type of database file that is used to
store passwords</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDBMUserFile" id="AuthDBMUserFile">AuthDBMUserFile</a> <a name="authdbmuserfile" id="authdbmuserfile">Directive</a> <a title="Permanent link" href="#authdbmuserfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdbmuserfile"><span id="AuthDBMUserFile">AuthDBMUserFile</span> Directive <a title="Permanent link" href="#authdbmuserfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of a database file containing the list of users and
passwords for authentication</td></tr>
<a href="../ko/mod/mod_authn_dbm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthUserFile" id="AuthUserFile">AuthUserFile</a> <a name="authuserfile" id="authuserfile">Directive</a> <a title="Permanent link" href="#authuserfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authuserfile"><span id="AuthUserFile">AuthUserFile</span> Directive <a title="Permanent link" href="#authuserfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of a text file containing the list of users and
passwords for authentication</td></tr>
<a href="../ko/mod/mod_authn_file.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_authn_socache">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_authn_socache">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="intro" id="intro">Authentication Caching</a> <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
+<h2
id="intro">Authentication Caching <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
<p>Some users of more heavyweight authentication such as SQL database
lookups (<code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>) have reported it putting an
unacceptable load on their authentication provider. A typical case
maintaining a cache of authentication credentials.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usage" id="usage">Usage</a> <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
+<h2
id="usage">Usage <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
<p>The authentication cache should be used where authentication
lookups impose a significant load on the server, or a backend or
network. Authentication by file (<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>)
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dev" id="dev">Caching with custom modules</a> <a title="Permanent link" href="#dev" class="permalink">¶</a></h2>
+<h2
id="dev">Caching with custom modules <a title="Permanent link" href="#dev" class="permalink">¶</a></h2>
<p>Module developers should note that their modules must be enabled
for caching with <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>. A single optional API function
<var>ap_authn_cache_store</var> is provided to cache credentials
available in <a href="http://svn.eu.apache.org/viewvc?view=revision&revision=957072">r957072</a>, in which three authn providers are enabled for caching.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthnCacheContext" id="AuthnCacheContext">AuthnCacheContext</a> <a name="authncachecontext" id="authncachecontext">Directive</a> <a title="Permanent link" href="#authncachecontext" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authncachecontext"><span id="AuthnCacheContext">AuthnCacheContext</span> Directive <a title="Permanent link" href="#authncachecontext" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a context string for use in the cache key</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthnCacheContext directory|server|<var>custom-string</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthnCacheEnable" id="AuthnCacheEnable">AuthnCacheEnable</a> <a name="authncacheenable" id="authncacheenable">Directive</a> <a title="Permanent link" href="#authncacheenable" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authncacheenable"><span id="AuthnCacheEnable">AuthnCacheEnable</span> Directive <a title="Permanent link" href="#authncacheenable" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable Authn caching configured anywhere</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthnCacheEnable</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthnCacheProvideFor" id="AuthnCacheProvideFor">AuthnCacheProvideFor</a> <a name="authncacheprovidefor" id="authncacheprovidefor">Directive</a> <a title="Permanent link" href="#authncacheprovidefor" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authncacheprovidefor"><span id="AuthnCacheProvideFor">AuthnCacheProvideFor</span> Directive <a title="Permanent link" href="#authncacheprovidefor" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify which authn provider(s) to cache for</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthnCacheProvideFor <var>authn-provider</var> [...]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthnCacheSOCache" id="AuthnCacheSOCache">AuthnCacheSOCache</a> <a name="authncachesocache" id="authncachesocache">Directive</a> <a title="Permanent link" href="#authncachesocache" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authncachesocache"><span id="AuthnCacheSOCache">AuthnCacheSOCache</span> Directive <a title="Permanent link" href="#authncachesocache" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Select socache backend provider to use</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthnCacheSOCache <var>provider-name[:provider-args]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthnCacheTimeout" id="AuthnCacheTimeout">AuthnCacheTimeout</a> <a name="authncachetimeout" id="authncachetimeout">Directive</a> <a title="Permanent link" href="#authncachetimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authncachetimeout"><span id="AuthnCacheTimeout">AuthnCacheTimeout</span> Directive <a title="Permanent link" href="#authncachetimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set a timeout for cache entries</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthnCacheTimeout <var>timeout</var> (seconds)</code></td></tr>
<a href="../fr/mod/mod_authn_socache.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="invocations" id="invocations">Invocation modes</a> <a title="Permanent link" href="#invocations" class="permalink">¶</a></h2>
+<h2
id="invocations">Invocation modes <a title="Permanent link" href="#invocations" class="permalink">¶</a></h2>
<p>The invocation modes for FastCGI authorizers supported by this
module are distinguished by two characteristics, <em>type</em> and
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Additional examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Additional examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<ol>
<li>If your application supports the separate authentication and
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="limitations" id="limitations">Limitations</a> <a title="Permanent link" href="#limitations" class="permalink">¶</a></h2>
+<h2
id="limitations">Limitations <a title="Permanent link" href="#limitations" class="permalink">¶</a></h2>
<p>The following are potential features which are not currently
implemented:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logging" id="logging">Logging</a> <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
+<h2
id="logging">Logging <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
<ol>
<li>Processing errors are logged at log level <code>error</code>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthnzFcgiCheckAuthnProvider" id="AuthnzFcgiCheckAuthnProvider">AuthnzFcgiCheckAuthnProvider</a> <a name="authnzfcgicheckauthnprovider" id="authnzfcgicheckauthnprovider">Directive</a> <a title="Permanent link" href="#authnzfcgicheckauthnprovider" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authnzfcgicheckauthnprovider"><span id="AuthnzFcgiCheckAuthnProvider">AuthnzFcgiCheckAuthnProvider</span> Directive <a title="Permanent link" href="#authnzfcgicheckauthnprovider" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables a FastCGI application to handle the check_authn
authentication hook.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthnzFcgiDefineProvider" id="AuthnzFcgiDefineProvider">AuthnzFcgiDefineProvider</a> <a name="authnzfcgidefineprovider" id="authnzfcgidefineprovider">Directive</a> <a title="Permanent link" href="#authnzfcgidefineprovider" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authnzfcgidefineprovider"><span id="AuthnzFcgiDefineProvider">AuthnzFcgiDefineProvider</span> Directive <a title="Permanent link" href="#authnzfcgidefineprovider" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a FastCGI application as a provider for
authentication and/or authorization</td></tr>
<a href="../fr/mod/mod_authnz_fcgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="contents" id="contents">Contents</a> <a title="Permanent link" href="#contents" class="permalink">¶</a></h2>
+<h2
id="contents">Contents <a title="Permanent link" href="#contents" class="permalink">¶</a></h2>
<ul>
<li> <a href="#gcaveats">General caveats</a> </li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="gcaveats" id="gcaveats">General caveats</a> <a title="Permanent link" href="#gcaveats" class="permalink">¶</a></h2>
+<h2
id="gcaveats">General caveats <a title="Permanent link" href="#gcaveats" class="permalink">¶</a></h2>
<p> This module caches authentication and authorization results based
on the configuration of <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>. Changes
made to the backing LDAP server will not be immediately reflected on the
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="operation" id="operation">Operation</a> <a title="Permanent link" href="#operation" class="permalink">¶</a></h2>
+<h2
id="operation">Operation <a title="Permanent link" href="#operation" class="permalink">¶</a></h2>
<p>There are two phases in granting access to a user. The first
phase is authentication, in which the <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>
by adding <code>ldap-user</code>, <code>ldap-dn</code> and <code>ldap-group</code>
values.</p>
-<h3><a name="authenphase" id="authenphase">The Authentication
- Phase</a></h3>
+<h3 id="authenphase">The Authentication
+ Phase</h3>
<p>During the authentication phase, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>
searches for an entry in the directory that matches the username
</table>
-<h3><a name="authorphase" id="authorphase">The Authorization Phase</a></h3>
+<h3 id="authorphase">The Authorization Phase</h3>
<p>During the authorization phase, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>
attempts to determine if the user is authorized to access the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requiredirectives" id="requiredirectives">The Require Directives</a> <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
+<h2
id="requiredirectives">The Require Directives <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
<p>Apache's <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
directives are used during the authorization phase to ensure that
<p>Since v2.4.8, <a href="../expr.html">expressions</a> are supported
within the LDAP require directives.</p>
-<h3><a name="requser" id="requser">Require ldap-user</a></h3>
+<h3 id="requser">Require ldap-user</h3>
<p>The <code>Require ldap-user</code> directive specifies what
usernames can access the resource. Once
-<h3><a name="reqgroup" id="reqgroup">Require ldap-group</a></h3>
+<h3 id="reqgroup">Require ldap-group</h3>
<p>This directive specifies an LDAP group whose members are
allowed access. It takes the distinguished name of the LDAP
directives.</p>
-<h3><a name="reqdn" id="reqdn">Require ldap-dn</a></h3>
+<h3 id="reqdn">Require ldap-dn</h3>
<p>The <code>Require ldap-dn</code> directive allows the administrator
to grant access based on distinguished names. It specifies a DN
directive.</p>
-<h3><a name="reqattribute" id="reqattribute">Require ldap-attribute</a></h3>
+<h3 id="reqattribute">Require ldap-attribute</h3>
<p>The <code>Require ldap-attribute</code> directive allows the
administrator to grant access based on attributes of the authenticated
-<h3><a name="reqfilter" id="reqfilter">Require ldap-filter</a></h3>
+<h3 id="reqfilter">Require ldap-filter</h3>
<p>The <code>Require ldap-filter</code> directive allows the
administrator to grant access based on a complex LDAP search filter.
-<h3><a name="reqsearch" id="reqsearch">Require ldap-search</a></h3>
+<h3 id="reqsearch">Require ldap-search</h3>
<p>The <code>Require ldap-search</code> directive allows the
administrator to grant access based on a generic LDAP search filter using an
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<ul>
<li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usingtls" id="usingtls">Using TLS</a> <a title="Permanent link" href="#usingtls" class="permalink">¶</a></h2>
+<h2
id="usingtls">Using TLS <a title="Permanent link" href="#usingtls" class="permalink">¶</a></h2>
<p>To use TLS, see the <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> directives <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code>, <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedglobalcert">LDAPTrustedGlobalCert</a></code> and <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></code>.</p>
to be upgraded to a secure connection on the same port.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usingssl" id="usingssl">Using SSL</a> <a title="Permanent link" href="#usingssl" class="permalink">¶</a></h2>
+<h2
id="usingssl">Using SSL <a title="Permanent link" href="#usingssl" class="permalink">¶</a></h2>
<p>To use SSL, see the <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> directives <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code>, <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedglobalcert">LDAPTrustedGlobalCert</a></code> and <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></code>.</p>
directive, instead of <code>ldap://</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="exposed" id="exposed">Exposing Login Information</a> <a title="Permanent link" href="#exposed" class="permalink">¶</a></h2>
+<h2
id="exposed">Exposing Login Information <a title="Permanent link" href="#exposed" class="permalink">¶</a></h2>
<p>when this module performs <em>authentication</em>, ldap attributes specified
in the <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="activedirectory" id="activedirectory">Using Active Directory</a> <a title="Permanent link" href="#activedirectory" class="permalink">¶</a></h2>
+<h2
id="activedirectory">Using Active Directory <a title="Permanent link" href="#activedirectory" class="permalink">¶</a></h2>
<p>An Active Directory installation may support multiple domains at the
same time. To distinguish users between domains, an identifier called
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="frontpage" id="frontpage">Using Microsoft
- FrontPage with mod_authnz_ldap
</a> <a title="Permanent link" href="#frontpage" class="permalink">¶</a></h2>
+<h2 id="frontpage">Using Microsoft
+ FrontPage with mod_authnz_ldap <a title="Permanent link" href="#frontpage" class="permalink">¶</a></h2>
<p>Normally, FrontPage uses FrontPage-web-specific user/group
files (i.e., the <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> and
Require group "mygroupfile"</pre>
-<h3><a name="howitworks" id="howitworks">How It Works</a></h3>
+<h3 id="howitworks">How It Works</h3>
<p>FrontPage restricts access to a web by adding the <code>Require
valid-user</code> directive to the <code>.htaccess</code>
operations from the FrontPage client.</p>
-<h3><a name="fpcaveats" id="fpcaveats">Caveats</a></h3>
+<h3 id="fpcaveats">Caveats</h3>
<ul>
<li>When choosing the LDAP URL, the attribute to use for
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPAuthorizePrefix" id="AuthLDAPAuthorizePrefix">AuthLDAPAuthorizePrefix</a> <a name="authldapauthorizeprefix" id="authldapauthorizeprefix">Directive</a> <a title="Permanent link" href="#authldapauthorizeprefix" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapauthorizeprefix"><span id="AuthLDAPAuthorizePrefix">AuthLDAPAuthorizePrefix</span> Directive <a title="Permanent link" href="#authldapauthorizeprefix" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the prefix for environment variables set during
authorization</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPBindAuthoritative" id="AuthLDAPBindAuthoritative">AuthLDAPBindAuthoritative</a> <a name="authldapbindauthoritative" id="authldapbindauthoritative">Directive</a> <a title="Permanent link" href="#authldapbindauthoritative" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapbindauthoritative"><span id="AuthLDAPBindAuthoritative">AuthLDAPBindAuthoritative</span> Directive <a title="Permanent link" href="#authldapbindauthoritative" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPBindAuthoritative off|on</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPBindDN" id="AuthLDAPBindDN">AuthLDAPBindDN</a> <a name="authldapbinddn" id="authldapbinddn">Directive</a> <a title="Permanent link" href="#authldapbinddn" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapbinddn"><span id="AuthLDAPBindDN">AuthLDAPBindDN</span> Directive <a title="Permanent link" href="#authldapbinddn" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Optional DN to use in binding to the LDAP server</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPBindDN <var>distinguished-name</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPBindPassword" id="AuthLDAPBindPassword">AuthLDAPBindPassword</a> <a name="authldapbindpassword" id="authldapbindpassword">Directive</a> <a title="Permanent link" href="#authldapbindpassword" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapbindpassword"><span id="AuthLDAPBindPassword">AuthLDAPBindPassword</span> Directive <a title="Permanent link" href="#authldapbindpassword" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Password used in conjunction with the bind DN</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPBindPassword <var>password</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPCharsetConfig" id="AuthLDAPCharsetConfig">AuthLDAPCharsetConfig</a> <a name="authldapcharsetconfig" id="authldapcharsetconfig">Directive</a> <a title="Permanent link" href="#authldapcharsetconfig" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapcharsetconfig"><span id="AuthLDAPCharsetConfig">AuthLDAPCharsetConfig</span> Directive <a title="Permanent link" href="#authldapcharsetconfig" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Language to charset conversion configuration file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPCharsetConfig <var>file-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPCompareAsUser" id="AuthLDAPCompareAsUser">AuthLDAPCompareAsUser</a> <a name="authldapcompareasuser" id="authldapcompareasuser">Directive</a> <a title="Permanent link" href="#authldapcompareasuser" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapcompareasuser"><span id="AuthLDAPCompareAsUser">AuthLDAPCompareAsUser</span> Directive <a title="Permanent link" href="#authldapcompareasuser" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the authenticated user's credentials to perform authorization comparisons</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPCompareAsUser on|off</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPCompareDNOnServer" id="AuthLDAPCompareDNOnServer">AuthLDAPCompareDNOnServer</a> <a name="authldapcomparednonserver" id="authldapcomparednonserver">Directive</a> <a title="Permanent link" href="#authldapcomparednonserver" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapcomparednonserver"><span id="AuthLDAPCompareDNOnServer">AuthLDAPCompareDNOnServer</span> Directive <a title="Permanent link" href="#authldapcomparednonserver" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the LDAP server to compare the DNs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPCompareDNOnServer on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPDereferenceAliases" id="AuthLDAPDereferenceAliases">AuthLDAPDereferenceAliases</a> <a name="authldapdereferencealiases" id="authldapdereferencealiases">Directive</a> <a title="Permanent link" href="#authldapdereferencealiases" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapdereferencealiases"><span id="AuthLDAPDereferenceAliases">AuthLDAPDereferenceAliases</span> Directive <a title="Permanent link" href="#authldapdereferencealiases" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>When will the module de-reference aliases</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPDereferenceAliases never|searching|finding|always</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPGroupAttribute" id="AuthLDAPGroupAttribute">AuthLDAPGroupAttribute</a> <a name="authldapgroupattribute" id="authldapgroupattribute">Directive</a> <a title="Permanent link" href="#authldapgroupattribute" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapgroupattribute"><span id="AuthLDAPGroupAttribute">AuthLDAPGroupAttribute</span> Directive <a title="Permanent link" href="#authldapgroupattribute" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>LDAP attributes used to identify the user members of
groups.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPGroupAttributeIsDN" id="AuthLDAPGroupAttributeIsDN">AuthLDAPGroupAttributeIsDN</a> <a name="authldapgroupattributeisdn" id="authldapgroupattributeisdn">Directive</a> <a title="Permanent link" href="#authldapgroupattributeisdn" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapgroupattributeisdn"><span id="AuthLDAPGroupAttributeIsDN">AuthLDAPGroupAttributeIsDN</span> Directive <a title="Permanent link" href="#authldapgroupattributeisdn" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the DN of the client username when checking for
group membership</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPInitialBindAsUser" id="AuthLDAPInitialBindAsUser">AuthLDAPInitialBindAsUser</a> <a name="authldapinitialbindasuser" id="authldapinitialbindasuser">Directive</a> <a title="Permanent link" href="#authldapinitialbindasuser" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapinitialbindasuser"><span id="AuthLDAPInitialBindAsUser">AuthLDAPInitialBindAsUser</span> Directive <a title="Permanent link" href="#authldapinitialbindasuser" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines if the server does the initial DN lookup using the basic authentication users'
own username, instead of anonymously or with hard-coded credentials for the server</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPInitialBindPattern" id="AuthLDAPInitialBindPattern">AuthLDAPInitialBindPattern</a> <a name="authldapinitialbindpattern" id="authldapinitialbindpattern">Directive</a> <a title="Permanent link" href="#authldapinitialbindpattern" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapinitialbindpattern"><span id="AuthLDAPInitialBindPattern">AuthLDAPInitialBindPattern</span> Directive <a title="Permanent link" href="#authldapinitialbindpattern" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the transformation of the basic authentication username to be used when binding to the LDAP server
to perform a DN lookup</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPMaxSubGroupDepth" id="AuthLDAPMaxSubGroupDepth">AuthLDAPMaxSubGroupDepth</a> <a name="authldapmaxsubgroupdepth" id="authldapmaxsubgroupdepth">Directive</a> <a title="Permanent link" href="#authldapmaxsubgroupdepth" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapmaxsubgroupdepth"><span id="AuthLDAPMaxSubGroupDepth">AuthLDAPMaxSubGroupDepth</span> Directive <a title="Permanent link" href="#authldapmaxsubgroupdepth" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the maximum sub-group nesting depth that will be
evaluated before the user search is discontinued.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPRemoteUserAttribute" id="AuthLDAPRemoteUserAttribute">AuthLDAPRemoteUserAttribute</a> <a name="authldapremoteuserattribute" id="authldapremoteuserattribute">Directive</a> <a title="Permanent link" href="#authldapremoteuserattribute" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapremoteuserattribute"><span id="AuthLDAPRemoteUserAttribute">AuthLDAPRemoteUserAttribute</span> Directive <a title="Permanent link" href="#authldapremoteuserattribute" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the value of the attribute returned during the user
query to set the REMOTE_USER environment variable</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPRemoteUserIsDN" id="AuthLDAPRemoteUserIsDN">AuthLDAPRemoteUserIsDN</a> <a name="authldapremoteuserisdn" id="authldapremoteuserisdn">Directive</a> <a title="Permanent link" href="#authldapremoteuserisdn" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapremoteuserisdn"><span id="AuthLDAPRemoteUserIsDN">AuthLDAPRemoteUserIsDN</span> Directive <a title="Permanent link" href="#authldapremoteuserisdn" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the DN of the client username to set the REMOTE_USER
environment variable</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPSearchAsUser" id="AuthLDAPSearchAsUser">AuthLDAPSearchAsUser</a> <a name="authldapsearchasuser" id="authldapsearchasuser">Directive</a> <a title="Permanent link" href="#authldapsearchasuser" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapsearchasuser"><span id="AuthLDAPSearchAsUser">AuthLDAPSearchAsUser</span> Directive <a title="Permanent link" href="#authldapsearchasuser" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the authenticated user's credentials to perform authorization searches</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPSearchAsUser on|off</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPSubGroupAttribute" id="AuthLDAPSubGroupAttribute">AuthLDAPSubGroupAttribute</a> <a name="authldapsubgroupattribute" id="authldapsubgroupattribute">Directive</a> <a title="Permanent link" href="#authldapsubgroupattribute" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapsubgroupattribute"><span id="AuthLDAPSubGroupAttribute">AuthLDAPSubGroupAttribute</span> Directive <a title="Permanent link" href="#authldapsubgroupattribute" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the attribute labels, one value per
directive line, used to distinguish the members of the current group that
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPSubGroupClass" id="AuthLDAPSubGroupClass">AuthLDAPSubGroupClass</a> <a name="authldapsubgroupclass" id="authldapsubgroupclass">Directive</a> <a title="Permanent link" href="#authldapsubgroupclass" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapsubgroupclass"><span id="AuthLDAPSubGroupClass">AuthLDAPSubGroupClass</span> Directive <a title="Permanent link" href="#authldapsubgroupclass" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies which LDAP objectClass values identify directory
objects that are groups during sub-group processing.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthLDAPURL" id="AuthLDAPURL">AuthLDAPURL</a> <a name="authldapurl" id="authldapurl">Directive</a> <a title="Permanent link" href="#authldapurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authldapurl"><span id="AuthLDAPURL">AuthLDAPURL</span> Directive <a title="Permanent link" href="#authldapurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL specifying the LDAP search parameters</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPURL <var>url</var> [NONE|SSL|TLS|STARTTLS]</code></td></tr>
<a href="../fr/mod/mod_authnz_ldap.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_autht_core">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_autht_core">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="authtalias" id="authtalias">Creating Token Provider Aliases</a> <a title="Permanent link" href="#authtalias" class="permalink">¶</a></h2>
+<h2
id="authtalias">Creating Token Provider Aliases <a title="Permanent link" href="#authtalias" class="permalink">¶</a></h2>
<p>Extended token providers can be created within the configuration
file and assigned an alias name. The alias providers can then be
the same extended token provider to be reference by multiple
locations.</p>
- <h3><a name="example" id="example">Examples</a></h3>
+ <h3 id="example">Examples</h3>
<p>This example checks for JWT token signatures in two different
secret files.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthtProviderAlias" id="AuthtProviderAlias"><AuthtProviderAlias></a> <a name="authtprovideralias" id="authtprovideralias">Directive</a> <a title="Permanent link" href="#authtprovideralias" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authtprovideralias"><span id="AuthtProviderAlias"><AuthtProviderAlias></span> Directive <a title="Permanent link" href="#authtprovideralias" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that represent an
extension of a base token provider and referenced by the specified
<a href="../fr/mod/mod_autht_core.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthtJwtClaim" id="AuthtJwtClaim">AuthtJwtClaim</a> <a name="authtjwtclaim" id="authtjwtclaim">Directive</a> <a title="Permanent link" href="#authtjwtclaim" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authtjwtclaim"><span id="AuthtJwtClaim">AuthtJwtClaim</span> Directive <a title="Permanent link" href="#authtjwtclaim" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set a claim with the given name and expression, or unset the claim with the given name</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthtJwtVerify <var>[set|unset]</var> <var>name</var> [<var>value</var>]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthtJwtDriver" id="AuthtJwtDriver">AuthtJwtDriver</a> <a name="authtjwtdriver" id="authtjwtdriver">Directive</a> <a title="Permanent link" href="#authtjwtdriver" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authtjwtdriver"><span id="AuthtJwtDriver">AuthtJwtDriver</span> Directive <a title="Permanent link" href="#authtjwtdriver" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of the underlying crypto driver to
use</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthtJwtSign" id="AuthtJwtSign">AuthtJwtSign</a> <a name="authtjwtsign" id="authtjwtsign">Directive</a> <a title="Permanent link" href="#authtjwtsign" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authtjwtsign"><span id="AuthtJwtSign">AuthtJwtSign</span> Directive <a title="Permanent link" href="#authtjwtsign" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The JWS signing algorithm and passphrase/key to sign an outgoing
JWT token</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthtJwtVerify" id="AuthtJwtVerify">AuthtJwtVerify</a> <a name="authtjwtverify" id="authtjwtverify">Directive</a> <a title="Permanent link" href="#authtjwtverify" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authtjwtverify"><span id="AuthtJwtVerify">AuthtJwtVerify</span> Directive <a title="Permanent link" href="#authtjwtverify" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The JWS signing algorithm and passphrase/key to verify an incoming
JWT token</td></tr>
<a href="../fr/mod/mod_autht_jwt.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_authz_core">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_authz_core">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logic" id="logic">Authorization Containers</a> <a title="Permanent link" href="#logic" class="permalink">¶</a></h2>
+<h2
id="logic">Authorization Containers <a title="Permanent link" href="#logic" class="permalink">¶</a></h2>
<p>The authorization container directives
<code class="directive"><a href="#requireall"><RequireAll></a></code>,
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="authzresults" id="authzresults">Authorization Result States</a> <a title="Permanent link" href="#authzresults" class="permalink">¶</a></h2>
+<h2
id="authzresults">Authorization Result States <a title="Permanent link" href="#authzresults" class="permalink">¶</a></h2>
<p>Each authorization provider returns one of three possible results
when evaluating a <code class="directive"><a href="#require">Require</a></code>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requiredirectives" id="requiredirectives">The Require Directives</a> <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
+<h2
id="requiredirectives">The Require Directives <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> provides some generic authorization
providers which can be used with the
<code class="directive"><a href="#require">Require</a></code> directive.</p>
- <h3><a name="reqenv" id="reqenv">Require env</a></h3>
+ <h3 id="reqenv">Require env</h3>
<p>The <code>env</code> provider allows access to the server
to be controlled based on the existence of an <a href="../env.html">environment variable</a>. When <code>Require
- <h3><a name="reqall" id="reqall">Require all</a></h3>
+ <h3 id="reqall">Require all</h3>
<p>The <code>all</code> provider mimics the functionality that
was previously provided by the 'Allow from all' and 'Deny from all'
- <h3><a name="reqmethod" id="reqmethod">Require method</a></h3>
+ <h3 id="reqmethod">Require method</h3>
<p>The <code>method</code> provider allows using the HTTP method in
authorization decisions. The GET and HEAD methods are treated as
- <h3><a name="reqexpr" id="reqexpr">Require expr</a></h3>
+ <h3 id="reqexpr">Require expr</h3>
<p>The <code>expr</code> provider allows basing authorization
decisions on arbitrary expressions.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="authzalias" id="authzalias">Creating Authorization Provider Aliases</a> <a title="Permanent link" href="#authzalias" class="permalink">¶</a></h2>
+<h2
id="authzalias">Creating Authorization Provider Aliases <a title="Permanent link" href="#authzalias" class="permalink">¶</a></h2>
<p>Extended authorization providers can be created within the configuration
file and assigned an alias name. The alias providers can then be referenced
authorization provider to be referenced by multiple locations.
</p>
- <h3><a name="example" id="example">Example</a></h3>
+ <h3 id="example">Example</h3>
<p>The example below creates two different ldap authorization provider
aliases based on the ldap-group authorization provider. This example
allows a single authorization location to check group membership within
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthMerging" id="AuthMerging">AuthMerging</a> <a name="authmerging" id="authmerging">Directive</a> <a title="Permanent link" href="#authmerging" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authmerging"><span id="AuthMerging">AuthMerging</span> Directive <a title="Permanent link" href="#authmerging" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the manner in which each configuration section's
authorization logic is combined with that of preceding configuration
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthzProviderAlias" id="AuthzProviderAlias"><AuthzProviderAlias></a> <a name="authzprovideralias" id="authzprovideralias">Directive</a> <a title="Permanent link" href="#authzprovideralias" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authzprovideralias"><span id="AuthzProviderAlias"><AuthzProviderAlias></span> Directive <a title="Permanent link" href="#authzprovideralias" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that represent an
extension of a base authorization provider and referenced by the specified
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthzSendForbiddenOnFailure" id="AuthzSendForbiddenOnFailure">AuthzSendForbiddenOnFailure</a> <a name="authzsendforbiddenonfailure" id="authzsendforbiddenonfailure">Directive</a> <a title="Permanent link" href="#authzsendforbiddenonfailure" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authzsendforbiddenonfailure"><span id="AuthzSendForbiddenOnFailure">AuthzSendForbiddenOnFailure</span> Directive <a title="Permanent link" href="#authzsendforbiddenonfailure" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if
authentication succeeds but authorization fails
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Require" id="Require">Require</a> <a name="require" id="require">Directive</a> <a title="Permanent link" href="#require" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="require"><span id="Require">Require</span> Directive <a title="Permanent link" href="#require" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tests whether an authenticated user is authorized by
an authorization provider.</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RequireAll" id="RequireAll"><RequireAll></a> <a name="requireall" id="requireall">Directive</a> <a title="Permanent link" href="#requireall" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="requireall"><span id="RequireAll"><RequireAll></span> Directive <a title="Permanent link" href="#requireall" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of authorization directives of which none
must fail and at least one must succeed for the enclosing directive to
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RequireAny" id="RequireAny"><RequireAny></a> <a name="requireany" id="requireany">Directive</a> <a title="Permanent link" href="#requireany" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="requireany"><span id="RequireAny"><RequireAny></span> Directive <a title="Permanent link" href="#requireany" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of authorization directives of which one
must succeed for the enclosing directive to succeed.</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RequireNone" id="RequireNone"><RequireNone></a> <a name="requirenone" id="requirenone">Directive</a> <a title="Permanent link" href="#requirenone" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="requirenone"><span id="RequireNone"><RequireNone></span> Directive <a title="Permanent link" href="#requirenone" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of authorization directives of which none
must succeed for the enclosing directive to not fail.</td></tr>
<a href="../fr/mod/mod_authz_core.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requiredirectives" id="requiredirectives">The Require Directives</a> <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
+<h2
id="requiredirectives">The Require Directives <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
<p>Apache's <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
directives are used during the authorization phase to ensure that
<p>Since v2.4.8, <a href="../expr.html">expressions</a> are supported
within the DBD require directives.</p>
-<h3><a name="reqgroup" id="reqgroup">Require dbd-group</a></h3>
+<h3 id="reqgroup">Require dbd-group</h3>
<p>This directive specifies group membership that is required for the
user to gain access.</p>
-<h3><a name="reqlogin" id="reqlogin">Require dbd-login</a></h3>
+<h3 id="reqlogin">Require dbd-login</h3>
<p>This directive specifies a query to be run indicating the user
has logged in.</p>
-<h3><a name="reqlogout" id="reqlogout">Require dbd-logout</a></h3>
+<h3 id="reqlogout">Require dbd-logout</h3>
<p>This directive specifies a query to be run indicating the user
has logged out.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="login" id="login">Database Login</a> <a title="Permanent link" href="#login" class="permalink">¶</a></h2>
+<h2
id="login">Database Login <a title="Permanent link" href="#login" class="permalink">¶</a></h2>
<p>
In addition to the standard authorization function of checking group
For usage details, see the configuration example below.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="client" id="client">Client Login integration</a> <a title="Permanent link" href="#client" class="permalink">¶</a></h2>
+<h2
id="client">Client Login integration <a title="Permanent link" href="#client" class="permalink">¶</a></h2>
<p>Some administrators may wish to implement client-side session
management that works in concert with the server-side login/logout
to implement functions that start and end client-side sessions.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="example" id="example">Configuration example</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<h2
id="example">Configuration example <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<pre class="prettyprint lang-config"># mod_dbd configuration
DBDriver pgsql
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Preventing SQL injections</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Preventing SQL injections <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>Whether you need to care about SQL security depends on what DBD driver
and backend you use. With most drivers you don't have to do anything :
about security on this scope.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthzDBDLoginToReferer" id="AuthzDBDLoginToReferer">AuthzDBDLoginToReferer</a> <a name="authzdbdlogintoreferer" id="authzdbdlogintoreferer">Directive</a> <a title="Permanent link" href="#authzdbdlogintoreferer" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authzdbdlogintoreferer"><span id="AuthzDBDLoginToReferer">AuthzDBDLoginToReferer</span> Directive <a title="Permanent link" href="#authzdbdlogintoreferer" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether to redirect the Client to the Referring
page on successful login or logout if a <code>Referer</code> request
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthzDBDQuery" id="AuthzDBDQuery">AuthzDBDQuery</a> <a name="authzdbdquery" id="authzdbdquery">Directive</a> <a title="Permanent link" href="#authzdbdquery" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authzdbdquery"><span id="AuthzDBDQuery">AuthzDBDQuery</span> Directive <a title="Permanent link" href="#authzdbdquery" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify the SQL Query for the required operation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthzDBDQuery <var>query</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthzDBDRedirectQuery" id="AuthzDBDRedirectQuery">AuthzDBDRedirectQuery</a> <a name="authzdbdredirectquery" id="authzdbdredirectquery">Directive</a> <a title="Permanent link" href="#authzdbdredirectquery" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authzdbdredirectquery"><span id="AuthzDBDRedirectQuery">AuthzDBDRedirectQuery</span> Directive <a title="Permanent link" href="#authzdbdredirectquery" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a query to look up a login page for the user</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthzDBDRedirectQuery <var>query</var></code></td></tr>
<a href="../fr/mod/mod_authz_dbd.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requiredirectives" id="requiredirectives">The Require Directives</a> <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
+<h2
id="requiredirectives">The Require Directives <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
<p>Apache's <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
directives are used during the authorization phase to ensure that
<p>Since v2.4.8, <a href="../expr.html">expressions</a> are supported
within the DBM require directives.</p>
-<h3><a name="reqgroup" id="reqgroup">Require dbm-group</a></h3>
+<h3 id="reqgroup">Require dbm-group</h3>
<p>This directive specifies group membership that is required for the
user to gain access.</p>
-<h3><a name="reqfilegroup" id="reqfilegroup">Require dbm-file-group</a></h3>
+<h3 id="reqfilegroup">Require dbm-file-group</h3>
<p>When this directive is specified, the user must be a member of the group
assigned to the file being accessed.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Example usage</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Example usage <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p><em>Note that using mod_authz_dbm requires you to require <code>dbm-group</code>
instead of <code>group</code>:</em>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthDBMGroupFile" id="AuthDBMGroupFile">AuthDBMGroupFile</a> <a name="authdbmgroupfile" id="authdbmgroupfile">Directive</a> <a title="Permanent link" href="#authdbmgroupfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authdbmgroupfile"><span id="AuthDBMGroupFile">AuthDBMGroupFile</span> Directive <a title="Permanent link" href="#authdbmgroupfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of the database file containing the list
of user groups for authorization</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthzDBMType" id="AuthzDBMType">AuthzDBMType</a> <a name="authzdbmtype" id="authzdbmtype">Directive</a> <a title="Permanent link" href="#authzdbmtype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authzdbmtype"><span id="AuthzDBMType">AuthzDBMType</span> Directive <a title="Permanent link" href="#authzdbmtype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the type of database file that is used to
store list of user groups</td></tr>
<a href="../ko/mod/mod_authz_dbm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requiredirectives" id="requiredirectives">The Require Directives</a> <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
+<h2
id="requiredirectives">The Require Directives <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
<p>Apache's <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
directives are used during the authorization phase to ensure that
<p>Since v2.4.8, <a href="../expr.html">expressions</a> are supported
within the groupfile require directives.</p>
-<h3><a name="reqgroup" id="reqgroup">Require group</a></h3>
+<h3 id="reqgroup">Require group</h3>
<p>This directive specifies group membership that is required for the
user to gain access.</p>
-<h3><a name="reqfilegroup" id="reqfilegroup">Require file-group</a></h3>
+<h3 id="reqfilegroup">Require file-group</h3>
<p>When this directive is specified, the filesystem permissions on
the file being accessed are consulted. The user must be a member of
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AuthGroupFile" id="AuthGroupFile">AuthGroupFile</a> <a name="authgroupfile" id="authgroupfile">Directive</a> <a title="Permanent link" href="#authgroupfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="authgroupfile"><span id="AuthGroupFile">AuthGroupFile</span> Directive <a title="Permanent link" href="#authgroupfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of a text file containing the list
of user groups for authorization</td></tr>
<a href="../ko/mod/mod_authz_groupfile.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requiredirectives" id="requiredirectives">The Require Directives</a> <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
+<h2
id="requiredirectives">The Require Directives <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
<p>Apache's <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
directive is used during the authorization phase to ensure that a user is allowed or
<p>Since v2.4.8, <a href="../expr.html">expressions</a> are supported
within the host require directives.</p>
-<h3><a name="reqip" id="reqip">Require ip</a></h3>
+<h3 id="reqip">Require ip</h3>
<p>The <code>ip</code> provider allows access to the server
to be controlled based on the IP address of the remote client.
-<h3><a name="reqhost" id="reqhost">Require host</a></h3>
+<h3 id="reqhost">Require host</h3>
<p>The <code>host</code> provider allows access to the server
to be controlled based on the host name of the remote client.
-<h3><a name="reqfwddns" id="reqfwddns">Require forward-dns</a></h3>
+<h3 id="reqfwddns">Require forward-dns</h3>
<p>The <code>forward-dns</code> provider allows access to the server
to be controlled based on simple host names. When
<p>The <code>forward-dns</code> provider was added in 2.4.19.</p>
-<h3><a name="reqlocal" id="reqlocal">Require local</a></h3>
+<h3 id="reqlocal">Require local</h3>
<p>The <code>local</code> provider allows access to the server if any
of the following conditions is true:</p>
-<h3><a name="proxy" id="proxy">Security Note</a></h3>
+<h3 id="proxy">Security Note</h3>
<p>If you are proxying content to your server, you need to be aware
that the client address will be the address of your proxy server,
<a href="../fr/mod/mod_authz_host.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Configuration Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Configuration Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
- <h3><a name="examples.file-owner" id="examples.file-owner">Require file-owner</a></h3>
+ <h3 id="examples.file-owner">Require file-owner</h3>
<p>Consider a multi-user system running the Apache Web server, with
each user having his or her own files in <code>~/public_html/private</code>. Assuming that there is a single
<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code> database
- <h3><a name="examples.file-group" id="examples.file-group">Require file-group</a></h3>
+ <h3 id="examples.file-group">Require file-group</h3>
<p>Consider a system similar to the one described above, but with
some users that share their project files in
<code>~/public_html/project-foo</code>. The files are owned by the
<a href="../ko/mod/mod_authz_owner.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requiredirectives" id="requiredirectives">The Require Directives</a> <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
+<h2
id="requiredirectives">The Require Directives <a title="Permanent link" href="#requiredirectives" class="permalink">¶</a></h2>
<p>Apache's <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
directives are used during the authorization phase to ensure that
<p>Since v2.4.8, <a href="../expr.html">expressions</a> are supported
within the user require directives.</p>
-<h3><a name="requser" id="requser">Require user</a></h3>
+<h3 id="requser">Require user</h3>
<p>This directive specifies a list of users that are allowed to gain
access.</p>
-<h3><a name="reqvaliduser" id="reqvaliduser">Require valid-user</a></h3>
+<h3 id="reqvaliduser">Require valid-user</h3>
<p>When this directive is specified, any successfully authenticated
user will be allowed to gain access.</p>
<a href="../ko/mod/mod_authz_user.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_autoindex">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_autoindex">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="query" id="query">Autoindex Request Query Arguments</a> <a title="Permanent link" href="#query" class="permalink">¶</a></h2>
+<h2
id="query">Autoindex Request Query Arguments <a title="Permanent link" href="#query" class="permalink">¶</a></h2>
<p>Various query string arguments are available to give the client
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddAlt" id="AddAlt">AddAlt</a> <a name="addalt" id="addalt">Directive</a> <a title="Permanent link" href="#addalt" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addalt"><span id="AddAlt">AddAlt</span> Directive <a title="Permanent link" href="#addalt" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate text to display for a file, instead of an
icon selected by filename</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddAltByEncoding" id="AddAltByEncoding">AddAltByEncoding</a> <a name="addaltbyencoding" id="addaltbyencoding">Directive</a> <a title="Permanent link" href="#addaltbyencoding" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addaltbyencoding"><span id="AddAltByEncoding">AddAltByEncoding</span> Directive <a title="Permanent link" href="#addaltbyencoding" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate text to display for a file instead of an icon
selected by MIME-encoding</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddAltByType" id="AddAltByType">AddAltByType</a> <a name="addaltbytype" id="addaltbytype">Directive</a> <a title="Permanent link" href="#addaltbytype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addaltbytype"><span id="AddAltByType">AddAltByType</span> Directive <a title="Permanent link" href="#addaltbytype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate text to display for a file, instead of an
icon selected by MIME content-type</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddDescription" id="AddDescription">AddDescription</a> <a name="adddescription" id="adddescription">Directive</a> <a title="Permanent link" href="#adddescription" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="adddescription"><span id="AddDescription">AddDescription</span> Directive <a title="Permanent link" href="#adddescription" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Description to display for a file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDescription <var>string file</var> [<var>file</var>] ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddIcon" id="AddIcon">AddIcon</a> <a name="addicon" id="addicon">Directive</a> <a title="Permanent link" href="#addicon" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addicon"><span id="AddIcon">AddIcon</span> Directive <a title="Permanent link" href="#addicon" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icon to display for a file selected by name</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddIcon <var>icon</var> <var>name</var> [<var>name</var>]
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddIconByEncoding" id="AddIconByEncoding">AddIconByEncoding</a> <a name="addiconbyencoding" id="addiconbyencoding">Directive</a> <a title="Permanent link" href="#addiconbyencoding" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addiconbyencoding"><span id="AddIconByEncoding">AddIconByEncoding</span> Directive <a title="Permanent link" href="#addiconbyencoding" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icon to display next to files selected by MIME
content-encoding</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddIconByType" id="AddIconByType">AddIconByType</a> <a name="addiconbytype" id="addiconbytype">Directive</a> <a title="Permanent link" href="#addiconbytype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addiconbytype"><span id="AddIconByType">AddIconByType</span> Directive <a title="Permanent link" href="#addiconbytype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icon to display next to files selected by MIME
content-type</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DefaultIcon" id="DefaultIcon">DefaultIcon</a> <a name="defaulticon" id="defaulticon">Directive</a> <a title="Permanent link" href="#defaulticon" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="defaulticon"><span id="DefaultIcon">DefaultIcon</span> Directive <a title="Permanent link" href="#defaulticon" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icon to display for files when no specific icon is
configured</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="HeaderName" id="HeaderName">HeaderName</a> <a name="headername" id="headername">Directive</a> <a title="Permanent link" href="#headername" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="headername"><span id="HeaderName">HeaderName</span> Directive <a title="Permanent link" href="#headername" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the file that will be inserted at the top
of the index listing</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IndexForbiddenReturn404" id="IndexForbiddenReturn404">IndexForbiddenReturn404</a> <a name="indexforbiddenreturn404" id="indexforbiddenreturn404">Directive</a> <a title="Permanent link" href="#indexforbiddenreturn404" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="indexforbiddenreturn404"><span id="IndexForbiddenReturn404">IndexForbiddenReturn404</span> Directive <a title="Permanent link" href="#indexforbiddenreturn404" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Return an HTTP 404 error instead of Forbidden when options
don't permit directory listing</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IndexHeadInsert" id="IndexHeadInsert">IndexHeadInsert</a> <a name="indexheadinsert" id="indexheadinsert">Directive</a> <a title="Permanent link" href="#indexheadinsert" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="indexheadinsert"><span id="IndexHeadInsert">IndexHeadInsert</span> Directive <a title="Permanent link" href="#indexheadinsert" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inserts text in the HEAD section of an index page.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>IndexHeadInsert <var>"markup ..."</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IndexIgnore" id="IndexIgnore">IndexIgnore</a> <a name="indexignore" id="indexignore">Directive</a> <a title="Permanent link" href="#indexignore" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="indexignore"><span id="IndexIgnore">IndexIgnore</span> Directive <a title="Permanent link" href="#indexignore" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds to the list of files to hide when listing
a directory</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IndexIgnoreReset" id="IndexIgnoreReset">IndexIgnoreReset</a> <a name="indexignorereset" id="indexignorereset">Directive</a> <a title="Permanent link" href="#indexignorereset" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="indexignorereset"><span id="IndexIgnoreReset">IndexIgnoreReset</span> Directive <a title="Permanent link" href="#indexignorereset" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Empties the list of files to hide when listing
a directory</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IndexOptions" id="IndexOptions">IndexOptions</a> <a name="indexoptions" id="indexoptions">Directive</a> <a title="Permanent link" href="#indexoptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="indexoptions"><span id="IndexOptions">IndexOptions</span> Directive <a title="Permanent link" href="#indexoptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Various configuration settings for directory
indexing</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IndexOrderDefault" id="IndexOrderDefault">IndexOrderDefault</a> <a name="indexorderdefault" id="indexorderdefault">Directive</a> <a title="Permanent link" href="#indexorderdefault" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="indexorderdefault"><span id="IndexOrderDefault">IndexOrderDefault</span> Directive <a title="Permanent link" href="#indexorderdefault" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the default ordering of the directory index</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>IndexOrderDefault Ascending|Descending
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IndexStyleSheet" id="IndexStyleSheet">IndexStyleSheet</a> <a name="indexstylesheet" id="indexstylesheet">Directive</a> <a title="Permanent link" href="#indexstylesheet" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="indexstylesheet"><span id="IndexStyleSheet">IndexStyleSheet</span> Directive <a title="Permanent link" href="#indexstylesheet" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds a CSS stylesheet to the directory index</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>IndexStyleSheet <var>url-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ReadmeName" id="ReadmeName">ReadmeName</a> <a name="readmename" id="readmename">Directive</a> <a title="Permanent link" href="#readmename" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="readmename"><span id="ReadmeName">ReadmeName</span> Directive <a title="Permanent link" href="#readmename" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the file that will be inserted at the end
of the index listing</td></tr>
<a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="recommended" id="recommended">Sample Configurations</a> <a title="Permanent link" href="#recommended" class="permalink">¶</a></h2>
+<h2
id="recommended">Sample Configurations <a title="Permanent link" href="#recommended" class="permalink">¶</a></h2>
<div class="warning"><h3>Compression and TLS</h3>
<p>Some web applications are vulnerable to an information disclosure
attack when a TLS connection carries compressed data. For more
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="enable" id="enable">Enabling Compression</a> <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
+<h2
id="enable">Enabling Compression <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
<div class="warning"><h3>Compression and TLS</h3>
<p>Some web applications are vulnerable to an information disclosure
attack when a TLS connection carries compressed data. For more
information, review the details of the "BREACH" family of attacks.</p>
</div>
- <h3><a name="output" id="output">Output Compression</a></h3>
+ <h3 id="output">Output Compression</h3>
<p>Compression is implemented by the <code>BROTLI_COMPRESS</code>
<a href="../filter.html">filter</a>. The following directive
will enable compression for documents in the container where it
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="proxies" id="proxies">Dealing with proxy servers</a> <a title="Permanent link" href="#proxies" class="permalink">¶</a></h2>
+<h2
id="proxies">Dealing with proxy servers <a title="Permanent link" href="#proxies" class="permalink">¶</a></h2>
<p>The <code class="module"><a href="../mod/mod_brotli.html">mod_brotli</a></code> module sends a <code>Vary:
Accept-Encoding</code> HTTP response header to alert proxies that
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="precompressed" id="precompressed">Serving pre-compressed
-content
</a> <a title="Permanent link" href="#precompressed" class="permalink">¶</a></h2>
+<h2 id="precompressed">Serving pre-compressed
+content <a title="Permanent link" href="#precompressed" class="permalink">¶</a></h2>
<p>Since <code class="module"><a href="../mod/mod_brotli.html">mod_brotli</a></code> re-compresses content each
time a request is made, some performance benefit can be derived by
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BrotliAlterETag" id="BrotliAlterETag">BrotliAlterETag</a> <a name="brotlialteretag" id="brotlialteretag">Directive</a> <a title="Permanent link" href="#brotlialteretag" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="brotlialteretag"><span id="BrotliAlterETag">BrotliAlterETag</span> Directive <a title="Permanent link" href="#brotlialteretag" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How the outgoing ETag header should be modified during compression</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BrotliAlterETag AddSuffix|NoChange|Remove</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BrotliCompressionMaxInputBlock" id="BrotliCompressionMaxInputBlock">BrotliCompressionMaxInputBlock</a> <a name="brotlicompressionmaxinputblock" id="brotlicompressionmaxinputblock">Directive</a> <a title="Permanent link" href="#brotlicompressionmaxinputblock" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="brotlicompressionmaxinputblock"><span id="BrotliCompressionMaxInputBlock">BrotliCompressionMaxInputBlock</span> Directive <a title="Permanent link" href="#brotlicompressionmaxinputblock" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum input block size</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BrotliCompressionMaxInputBlock <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BrotliCompressionQuality" id="BrotliCompressionQuality">BrotliCompressionQuality</a> <a name="brotlicompressionquality" id="brotlicompressionquality">Directive</a> <a title="Permanent link" href="#brotlicompressionquality" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="brotlicompressionquality"><span id="BrotliCompressionQuality">BrotliCompressionQuality</span> Directive <a title="Permanent link" href="#brotlicompressionquality" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Compression quality</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BrotliCompressionQuality <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BrotliCompressionWindow" id="BrotliCompressionWindow">BrotliCompressionWindow</a> <a name="brotlicompressionwindow" id="brotlicompressionwindow">Directive</a> <a title="Permanent link" href="#brotlicompressionwindow" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="brotlicompressionwindow"><span id="BrotliCompressionWindow">BrotliCompressionWindow</span> Directive <a title="Permanent link" href="#brotlicompressionwindow" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Brotli sliding compression window size</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BrotliCompressionWindow <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BrotliFilterNote" id="BrotliFilterNote">BrotliFilterNote</a> <a name="brotlifilternote" id="brotlifilternote">Directive</a> <a title="Permanent link" href="#brotlifilternote" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="brotlifilternote"><span id="BrotliFilterNote">BrotliFilterNote</span> Directive <a title="Permanent link" href="#brotlifilternote" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Places the compression ratio in a note for logging</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BrotliFilterNote [<var>type</var>] <var>notename</var></code></td></tr>
<a href="../fr/mod/mod_brotli.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BufferSize" id="BufferSize">BufferSize</a> <a name="buffersize" id="buffersize">Directive</a> <a title="Permanent link" href="#buffersize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="buffersize"><span id="BufferSize">BufferSize</span> Directive <a title="Permanent link" href="#buffersize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum size in bytes to buffer by the buffer filter</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BufferSize integer</code></td></tr>
<a href="../fr/mod/mod_buffer.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="related" id="related">Related Modules and Directives</a> <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
+<h2
id="related">Related Modules and Directives <a title="Permanent link" href="#related" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></li><li><code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cacheminfilesize">CacheMinFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachemaxfilesize">CacheMaxFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemaxtime">CacheSocacheMaxTime</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemintime">CacheSocacheMinTime</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemaxsize">CacheSocacheMaxSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachereadsize">CacheSocacheReadSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachereadtime">CacheSocacheReadTime</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="sampleconf" id="sampleconf">Sample Configuration</a> <a title="Permanent link" href="#sampleconf" class="permalink">¶</a></h2>
+<h2
id="sampleconf">Sample Configuration <a title="Permanent link" href="#sampleconf" class="permalink">¶</a></h2>
<div class="example"><h3>Sample httpd.conf</h3><pre class="prettyprint lang-config">#
# Sample Cache Configuration
#
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="thunderingherd" id="thunderingherd">Avoiding the Thundering Herd</a> <a title="Permanent link" href="#thunderingherd" class="permalink">¶</a></h2>
+<h2
id="thunderingherd">Avoiding the Thundering Herd <a title="Permanent link" href="#thunderingherd" class="permalink">¶</a></h2>
<p>When a cached entry becomes stale, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> will submit
a conditional request to the backend, which is expected to confirm whether the
cached entry is still fresh, and send an updated entity if not.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="finecontrol" id="finecontrol">Fine Control with the CACHE Filter</a> <a title="Permanent link" href="#finecontrol" class="permalink">¶</a></h2>
+<h2
id="finecontrol">Fine Control with the CACHE Filter <a title="Permanent link" href="#finecontrol" class="permalink">¶</a></h2>
<p>Under the default mode of cache operation, the cache runs as a quick handler,
short circuiting the majority of server processing and offering the highest
cache performance available.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="status" id="status">Cache Status and Logging</a> <a title="Permanent link" href="#status" class="permalink">¶</a></h2>
+<h2
id="status">Cache Status and Logging <a title="Permanent link" href="#status" class="permalink">¶</a></h2>
<p>Once <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> has made a decision as to whether or not
an entity is to be served from cache, the detailed reason for the decision
is written to the subprocess environment within the request under the
ways.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheDefaultExpire" id="CacheDefaultExpire">CacheDefaultExpire</a> <a name="cachedefaultexpire" id="cachedefaultexpire">Directive</a> <a title="Permanent link" href="#cachedefaultexpire" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachedefaultexpire"><span id="CacheDefaultExpire">CacheDefaultExpire</span> Directive <a title="Permanent link" href="#cachedefaultexpire" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The default duration to cache a document when no expiry date is specified.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheDefaultExpire <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheDetailHeader" id="CacheDetailHeader">CacheDetailHeader</a> <a name="cachedetailheader" id="cachedetailheader">Directive</a> <a title="Permanent link" href="#cachedetailheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachedetailheader"><span id="CacheDetailHeader">CacheDetailHeader</span> Directive <a title="Permanent link" href="#cachedetailheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add an X-Cache-Detail header to the response.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheDetailHeader <var>on|off</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheDisable" id="CacheDisable">CacheDisable</a> <a name="cachedisable" id="cachedisable">Directive</a> <a title="Permanent link" href="#cachedisable" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachedisable"><span id="CacheDisable">CacheDisable</span> Directive <a title="Permanent link" href="#cachedisable" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disable caching of specified URLs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheDisable <var>url-string</var> | <var>on</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheEnable" id="CacheEnable">CacheEnable</a> <a name="cacheenable" id="cacheenable">Directive</a> <a title="Permanent link" href="#cacheenable" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheenable"><span id="CacheEnable">CacheEnable</span> Directive <a title="Permanent link" href="#cacheenable" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable caching of specified URLs using a specified storage
manager</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheHeader" id="CacheHeader">CacheHeader</a> <a name="cacheheader" id="cacheheader">Directive</a> <a title="Permanent link" href="#cacheheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheheader"><span id="CacheHeader">CacheHeader</span> Directive <a title="Permanent link" href="#cacheheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add an X-Cache header to the response.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheHeader <var>on|off</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheIgnoreCacheControl" id="CacheIgnoreCacheControl">CacheIgnoreCacheControl</a> <a name="cacheignorecachecontrol" id="cacheignorecachecontrol">Directive</a> <a title="Permanent link" href="#cacheignorecachecontrol" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheignorecachecontrol"><span id="CacheIgnoreCacheControl">CacheIgnoreCacheControl</span> Directive <a title="Permanent link" href="#cacheignorecachecontrol" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore request to not serve cached content to client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheIgnoreCacheControl On|Off</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheIgnoreHeaders" id="CacheIgnoreHeaders">CacheIgnoreHeaders</a> <a name="cacheignoreheaders" id="cacheignoreheaders">Directive</a> <a title="Permanent link" href="#cacheignoreheaders" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheignoreheaders"><span id="CacheIgnoreHeaders">CacheIgnoreHeaders</span> Directive <a title="Permanent link" href="#cacheignoreheaders" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Do not store the given HTTP header(s) in the cache.
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheIgnoreNoLastMod" id="CacheIgnoreNoLastMod">CacheIgnoreNoLastMod</a> <a name="cacheignorenolastmod" id="cacheignorenolastmod">Directive</a> <a title="Permanent link" href="#cacheignorenolastmod" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheignorenolastmod"><span id="CacheIgnoreNoLastMod">CacheIgnoreNoLastMod</span> Directive <a title="Permanent link" href="#cacheignorenolastmod" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore the fact that a response has no Last Modified
header.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheIgnoreQueryString" id="CacheIgnoreQueryString">CacheIgnoreQueryString</a> <a name="cacheignorequerystring" id="cacheignorequerystring">Directive</a> <a title="Permanent link" href="#cacheignorequerystring" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheignorequerystring"><span id="CacheIgnoreQueryString">CacheIgnoreQueryString</span> Directive <a title="Permanent link" href="#cacheignorequerystring" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore query string when caching</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheIgnoreQueryString On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheIgnoreURLSessionIdentifiers" id="CacheIgnoreURLSessionIdentifiers">CacheIgnoreURLSessionIdentifiers</a> <a name="cacheignoreurlsessionidentifiers" id="cacheignoreurlsessionidentifiers">Directive</a> <a title="Permanent link" href="#cacheignoreurlsessionidentifiers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheignoreurlsessionidentifiers"><span id="CacheIgnoreURLSessionIdentifiers">CacheIgnoreURLSessionIdentifiers</span> Directive <a title="Permanent link" href="#cacheignoreurlsessionidentifiers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore defined session identifiers encoded in the URL when caching
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheKeyBaseURL" id="CacheKeyBaseURL">CacheKeyBaseURL</a> <a name="cachekeybaseurl" id="cachekeybaseurl">Directive</a> <a title="Permanent link" href="#cachekeybaseurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachekeybaseurl"><span id="CacheKeyBaseURL">CacheKeyBaseURL</span> Directive <a title="Permanent link" href="#cachekeybaseurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override the base URL of reverse proxied cache keys.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheKeyBaseURL <var>URL</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheLastModifiedFactor" id="CacheLastModifiedFactor">CacheLastModifiedFactor</a> <a name="cachelastmodifiedfactor" id="cachelastmodifiedfactor">Directive</a> <a title="Permanent link" href="#cachelastmodifiedfactor" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachelastmodifiedfactor"><span id="CacheLastModifiedFactor">CacheLastModifiedFactor</span> Directive <a title="Permanent link" href="#cachelastmodifiedfactor" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The factor used to compute an expiry date based on the
LastModified date.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheLock" id="CacheLock">CacheLock</a> <a name="cachelock" id="cachelock">Directive</a> <a title="Permanent link" href="#cachelock" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachelock"><span id="CacheLock">CacheLock</span> Directive <a title="Permanent link" href="#cachelock" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the thundering herd lock.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheLock <var>on|off</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheLockMaxAge" id="CacheLockMaxAge">CacheLockMaxAge</a> <a name="cachelockmaxage" id="cachelockmaxage">Directive</a> <a title="Permanent link" href="#cachelockmaxage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachelockmaxage"><span id="CacheLockMaxAge">CacheLockMaxAge</span> Directive <a title="Permanent link" href="#cachelockmaxage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the maximum possible age of a cache lock.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheLockMaxAge <var>integer</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheLockPath" id="CacheLockPath">CacheLockPath</a> <a name="cachelockpath" id="cachelockpath">Directive</a> <a title="Permanent link" href="#cachelockpath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachelockpath"><span id="CacheLockPath">CacheLockPath</span> Directive <a title="Permanent link" href="#cachelockpath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the lock path directory.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheLockPath <var>directory</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheMaxExpire" id="CacheMaxExpire">CacheMaxExpire</a> <a name="cachemaxexpire" id="cachemaxexpire">Directive</a> <a title="Permanent link" href="#cachemaxexpire" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachemaxexpire"><span id="CacheMaxExpire">CacheMaxExpire</span> Directive <a title="Permanent link" href="#cachemaxexpire" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum time in seconds to cache a document</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheMaxExpire <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheMinExpire" id="CacheMinExpire">CacheMinExpire</a> <a name="cacheminexpire" id="cacheminexpire">Directive</a> <a title="Permanent link" href="#cacheminexpire" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheminexpire"><span id="CacheMinExpire">CacheMinExpire</span> Directive <a title="Permanent link" href="#cacheminexpire" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time in seconds to cache a document</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheMinExpire <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheQuickHandler" id="CacheQuickHandler">CacheQuickHandler</a> <a name="cachequickhandler" id="cachequickhandler">Directive</a> <a title="Permanent link" href="#cachequickhandler" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachequickhandler"><span id="CacheQuickHandler">CacheQuickHandler</span> Directive <a title="Permanent link" href="#cachequickhandler" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Run the cache from the quick handler.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheQuickHandler <var>on|off</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheStaleOnError" id="CacheStaleOnError">CacheStaleOnError</a> <a name="cachestaleonerror" id="cachestaleonerror">Directive</a> <a title="Permanent link" href="#cachestaleonerror" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachestaleonerror"><span id="CacheStaleOnError">CacheStaleOnError</span> Directive <a title="Permanent link" href="#cachestaleonerror" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Serve stale content in place of 5xx responses.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheStaleOnError <var>on|off</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheStoreExpired" id="CacheStoreExpired">CacheStoreExpired</a> <a name="cachestoreexpired" id="cachestoreexpired">Directive</a> <a title="Permanent link" href="#cachestoreexpired" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachestoreexpired"><span id="CacheStoreExpired">CacheStoreExpired</span> Directive <a title="Permanent link" href="#cachestoreexpired" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Attempt to cache responses that the server reports as expired</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheStoreExpired On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheStoreNoStore" id="CacheStoreNoStore">CacheStoreNoStore</a> <a name="cachestorenostore" id="cachestorenostore">Directive</a> <a title="Permanent link" href="#cachestorenostore" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachestorenostore"><span id="CacheStoreNoStore">CacheStoreNoStore</span> Directive <a title="Permanent link" href="#cachestorenostore" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Attempt to cache requests or responses that have been marked as no-store.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheStoreNoStore On|Off</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheStorePrivate" id="CacheStorePrivate">CacheStorePrivate</a> <a name="cachestoreprivate" id="cachestoreprivate">Directive</a> <a title="Permanent link" href="#cachestoreprivate" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachestoreprivate"><span id="CacheStorePrivate">CacheStorePrivate</span> Directive <a title="Permanent link" href="#cachestoreprivate" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Attempt to cache responses that the server has marked as private</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheStorePrivate On|Off</code></td></tr>
<a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheDirLength" id="CacheDirLength">CacheDirLength</a> <a name="cachedirlength" id="cachedirlength">Directive</a> <a title="Permanent link" href="#cachedirlength" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachedirlength"><span id="CacheDirLength">CacheDirLength</span> Directive <a title="Permanent link" href="#cachedirlength" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The number of characters in subdirectory names</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheDirLength <var>length</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheDirLevels" id="CacheDirLevels">CacheDirLevels</a> <a name="cachedirlevels" id="cachedirlevels">Directive</a> <a title="Permanent link" href="#cachedirlevels" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachedirlevels"><span id="CacheDirLevels">CacheDirLevels</span> Directive <a title="Permanent link" href="#cachedirlevels" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The number of levels of subdirectories in the
cache.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheMaxFileSize" id="CacheMaxFileSize">CacheMaxFileSize</a> <a name="cachemaxfilesize" id="cachemaxfilesize">Directive</a> <a title="Permanent link" href="#cachemaxfilesize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachemaxfilesize"><span id="CacheMaxFileSize">CacheMaxFileSize</span> Directive <a title="Permanent link" href="#cachemaxfilesize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum size (in bytes) of a document to be placed in the
cache</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheMinFileSize" id="CacheMinFileSize">CacheMinFileSize</a> <a name="cacheminfilesize" id="cacheminfilesize">Directive</a> <a title="Permanent link" href="#cacheminfilesize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheminfilesize"><span id="CacheMinFileSize">CacheMinFileSize</span> Directive <a title="Permanent link" href="#cacheminfilesize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum size (in bytes) of a document to be placed in the
cache</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheReadSize" id="CacheReadSize">CacheReadSize</a> <a name="cachereadsize" id="cachereadsize">Directive</a> <a title="Permanent link" href="#cachereadsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachereadsize"><span id="CacheReadSize">CacheReadSize</span> Directive <a title="Permanent link" href="#cachereadsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum size (in bytes) of the document to read and be cached
before sending the data downstream</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheReadTime" id="CacheReadTime">CacheReadTime</a> <a name="cachereadtime" id="cachereadtime">Directive</a> <a title="Permanent link" href="#cachereadtime" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachereadtime"><span id="CacheReadTime">CacheReadTime</span> Directive <a title="Permanent link" href="#cachereadtime" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time (in milliseconds) that should elapse while reading
before data is sent downstream</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheRoot" id="CacheRoot">CacheRoot</a> <a name="cacheroot" id="cacheroot">Directive</a> <a title="Permanent link" href="#cacheroot" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cacheroot"><span id="CacheRoot">CacheRoot</span> Directive <a title="Permanent link" href="#cacheroot" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The directory root under which cache files are
stored</td></tr>
<a href="../ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheSocache" id="CacheSocache">CacheSocache</a> <a name="cachesocache" id="cachesocache">Directive</a> <a title="Permanent link" href="#cachesocache" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachesocache"><span id="CacheSocache">CacheSocache</span> Directive <a title="Permanent link" href="#cachesocache" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The shared object cache implementation to use</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheSocache <var>type[:args]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheSocacheMaxSize" id="CacheSocacheMaxSize">CacheSocacheMaxSize</a> <a name="cachesocachemaxsize" id="cachesocachemaxsize">Directive</a> <a title="Permanent link" href="#cachesocachemaxsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachesocachemaxsize"><span id="CacheSocacheMaxSize">CacheSocacheMaxSize</span> Directive <a title="Permanent link" href="#cachesocachemaxsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum size (in bytes) of an entry to be placed in the
cache</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheSocacheMaxTime" id="CacheSocacheMaxTime">CacheSocacheMaxTime</a> <a name="cachesocachemaxtime" id="cachesocachemaxtime">Directive</a> <a title="Permanent link" href="#cachesocachemaxtime" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachesocachemaxtime"><span id="CacheSocacheMaxTime">CacheSocacheMaxTime</span> Directive <a title="Permanent link" href="#cachesocachemaxtime" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum time (in seconds) for a document to be placed in the
cache</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheSocacheMinTime" id="CacheSocacheMinTime">CacheSocacheMinTime</a> <a name="cachesocachemintime" id="cachesocachemintime">Directive</a> <a title="Permanent link" href="#cachesocachemintime" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachesocachemintime"><span id="CacheSocacheMinTime">CacheSocacheMinTime</span> Directive <a title="Permanent link" href="#cachesocachemintime" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time (in seconds) for a document to be placed in the
cache</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheSocacheReadSize" id="CacheSocacheReadSize">CacheSocacheReadSize</a> <a name="cachesocachereadsize" id="cachesocachereadsize">Directive</a> <a title="Permanent link" href="#cachesocachereadsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachesocachereadsize"><span id="CacheSocacheReadSize">CacheSocacheReadSize</span> Directive <a title="Permanent link" href="#cachesocachereadsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum size (in bytes) of the document to read and be cached
before sending the data downstream</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheSocacheReadTime" id="CacheSocacheReadTime">CacheSocacheReadTime</a> <a name="cachesocachereadtime" id="cachesocachereadtime">Directive</a> <a title="Permanent link" href="#cachesocachereadtime" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachesocachereadtime"><span id="CacheSocacheReadTime">CacheSocacheReadTime</span> Directive <a title="Permanent link" href="#cachesocachereadtime" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time (in milliseconds) that should elapse while reading
before data is sent downstream</td></tr>
<a href="../fr/mod/mod_cache_socache.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MetaDir" id="MetaDir">MetaDir</a> <a name="metadir" id="metadir">Directive</a> <a title="Permanent link" href="#metadir" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="metadir"><span id="MetaDir">MetaDir</span> Directive <a title="Permanent link" href="#metadir" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the directory to find CERN-style meta information
files</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MetaFiles" id="MetaFiles">MetaFiles</a> <a name="metafiles" id="metafiles">Directive</a> <a title="Permanent link" href="#metafiles" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="metafiles"><span id="MetaFiles">MetaFiles</span> Directive <a title="Permanent link" href="#metafiles" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activates CERN meta-file processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MetaFiles on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MetaSuffix" id="MetaSuffix">MetaSuffix</a> <a name="metasuffix" id="metasuffix">Directive</a> <a title="Permanent link" href="#metasuffix" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="metasuffix"><span id="MetaSuffix">MetaSuffix</span> Directive <a title="Permanent link" href="#metasuffix" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File name suffix for the file containing CERN-style
meta information</td></tr>
<a href="../ko/mod/mod_cern_meta.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="env" id="env">CGI Environment variables</a> <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
+<h2
id="env">CGI Environment variables <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
<p>The server will set the CGI environment variables as described
in the CGI specification (<a href="https://www.rfc-editor.org/rfc/rfc3875">RFC 3875</a>),
with the following provisions:</p>
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cgi-debug" id="cgi-debug">CGI Debugging</a> <a title="Permanent link" href="#cgi-debug" class="permalink">¶</a></h2>
+<h2
id="cgi-debug">CGI Debugging <a title="Permanent link" href="#cgi-debug" class="permalink">¶</a></h2>
<p>Debugging CGI scripts has traditionally been difficult, mainly
because it has not been possible to study the output (standard
output and error) for scripts which are failing to run
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CGIScriptTimeout" id="CGIScriptTimeout">CGIScriptTimeout</a> <a name="cgiscripttimeout" id="cgiscripttimeout">Directive</a> <a title="Permanent link" href="#cgiscripttimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cgiscripttimeout"><span id="CGIScriptTimeout">CGIScriptTimeout</span> Directive <a title="Permanent link" href="#cgiscripttimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The length of time to wait for more output from the
CGI program</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ScriptLog" id="ScriptLog">ScriptLog</a> <a name="scriptlog" id="scriptlog">Directive</a> <a title="Permanent link" href="#scriptlog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="scriptlog"><span id="ScriptLog">ScriptLog</span> Directive <a title="Permanent link" href="#scriptlog" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the CGI script error logfile</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptLog <var>file-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ScriptLogBuffer" id="ScriptLogBuffer">ScriptLogBuffer</a> <a name="scriptlogbuffer" id="scriptlogbuffer">Directive</a> <a title="Permanent link" href="#scriptlogbuffer" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="scriptlogbuffer"><span id="ScriptLogBuffer">ScriptLogBuffer</span> Directive <a title="Permanent link" href="#scriptlogbuffer" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum amount of PUT or POST requests that will be recorded
in the scriptlog</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ScriptLogLength" id="ScriptLogLength">ScriptLogLength</a> <a name="scriptloglength" id="scriptloglength">Directive</a> <a title="Permanent link" href="#scriptloglength" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="scriptloglength"><span id="ScriptLogLength">ScriptLogLength</span> Directive <a title="Permanent link" href="#scriptloglength" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size limit of the CGI script logfile</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptLogLength <var>bytes</var></code></td></tr>
<a href="../ko/mod/mod_cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CGIDScriptTimeout" id="CGIDScriptTimeout">CGIDScriptTimeout</a> <a name="cgidscripttimeout" id="cgidscripttimeout">Directive</a> <a title="Permanent link" href="#cgidscripttimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cgidscripttimeout"><span id="CGIDScriptTimeout">CGIDScriptTimeout</span> Directive <a title="Permanent link" href="#cgidscripttimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The length of time to wait for more output from the
CGI program</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ScriptSock" id="ScriptSock">ScriptSock</a> <a name="scriptsock" id="scriptsock">Directive</a> <a title="Permanent link" href="#scriptsock" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="scriptsock"><span id="ScriptSock">ScriptSock</span> Directive <a title="Permanent link" href="#scriptsock" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The filename prefix of the socket to use for communication with
the cgi daemon</td></tr>
<a href="../ko/mod/mod_cgid.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_charset_lite">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_charset_lite">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="problems" id="problems">Common Problems</a> <a title="Permanent link" href="#problems" class="permalink">¶</a></h2>
+<h2
id="problems">Common Problems <a title="Permanent link" href="#problems" class="permalink">¶</a></h2>
<h3>Invalid character set names</h3>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CharsetDefault" id="CharsetDefault">CharsetDefault</a> <a name="charsetdefault" id="charsetdefault">Directive</a> <a title="Permanent link" href="#charsetdefault" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="charsetdefault"><span id="CharsetDefault">CharsetDefault</span> Directive <a title="Permanent link" href="#charsetdefault" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Charset to translate into</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CharsetDefault <var>charset</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CharsetOptions" id="CharsetOptions">CharsetOptions</a> <a name="charsetoptions" id="charsetoptions">Directive</a> <a title="Permanent link" href="#charsetoptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="charsetoptions"><span id="CharsetOptions">CharsetOptions</span> Directive <a title="Permanent link" href="#charsetoptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures charset translation behavior</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CharsetOptions <var>option</var> [<var>option</var>] ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CharsetSourceEnc" id="CharsetSourceEnc">CharsetSourceEnc</a> <a name="charsetsourceenc" id="charsetsourceenc">Directive</a> <a title="Permanent link" href="#charsetsourceenc" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="charsetsourceenc"><span id="CharsetSourceEnc">CharsetSourceEnc</span> Directive <a title="Permanent link" href="#charsetsourceenc" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Source charset of files</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CharsetSourceEnc <var>charset</var></code></td></tr>
<a href="../ko/mod/mod_charset_lite.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="format" id="format">Stream Format</a> <a title="Permanent link" href="#format" class="permalink">¶</a></h2>
+<h2
id="format">Stream Format <a title="Permanent link" href="#format" class="permalink">¶</a></h2>
<p>The encrypted stream consists of an optional IV block, followed by encrypted
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="config" id="config">Keys and IVs</a> <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
+<h2
id="config">Keys and IVs <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
<p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="handler" id="handler">Crypto Key Handler</a> <a title="Permanent link" href="#handler" class="permalink">¶</a></h2>
+<h2
id="handler">Crypto Key Handler <a title="Permanent link" href="#handler" class="permalink">¶</a></h2>
<p>For convenience, the <strong>crypto-key</strong> handler can be used to serve the key
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="hls" id="hls">HTTP Live Streaming</a> <a title="Permanent link" href="#hls" class="permalink">¶</a></h2>
+<h2
id="hls">HTTP Live Streaming <a title="Permanent link" href="#hls" class="permalink">¶</a></h2>
<p>The HLS protocol supports encrypted streams using the AES-128 cipher and a
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CryptoCipher" id="CryptoCipher">CryptoCipher</a> <a name="cryptocipher" id="cryptocipher">Directive</a> <a title="Permanent link" href="#cryptocipher" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cryptocipher"><span id="CryptoCipher">CryptoCipher</span> Directive <a title="Permanent link" href="#cryptocipher" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cipher to be used by the crypto filter</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CryptoCipher name</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CryptoDriver" id="CryptoDriver">CryptoDriver</a> <a name="cryptodriver" id="cryptodriver">Directive</a> <a title="Permanent link" href="#cryptodriver" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cryptodriver"><span id="CryptoDriver">CryptoDriver</span> Directive <a title="Permanent link" href="#cryptodriver" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the crypto driver to use</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CryptoDriver name</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CryptoIV" id="CryptoIV">CryptoIV</a> <a name="cryptoiv" id="cryptoiv">Directive</a> <a title="Permanent link" href="#cryptoiv" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cryptoiv"><span id="CryptoIV">CryptoIV</span> Directive <a title="Permanent link" href="#cryptoiv" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>IV (Initialization Vector) to be used by the crypto filter</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CryptoIV value</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CryptoKey" id="CryptoKey">CryptoKey</a> <a name="cryptokey" id="cryptokey">Directive</a> <a title="Permanent link" href="#cryptokey" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cryptokey"><span id="CryptoKey">CryptoKey</span> Directive <a title="Permanent link" href="#cryptokey" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Key to be used by the crypto filter</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CryptoKey value</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CryptoSize" id="CryptoSize">CryptoSize</a> <a name="cryptosize" id="cryptosize">Directive</a> <a title="Permanent link" href="#cryptosize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cryptosize"><span id="CryptoSize">CryptoSize</span> Directive <a title="Permanent link" href="#cryptosize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum size in bytes to buffer by the crypto filter</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CryptoSize integer</code></td></tr>
<a href="../fr/mod/mod_crypto.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_data.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="example" id="example">Enabling WebDAV</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<h2
id="example">Enabling WebDAV <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<p>To enable <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>, add the following to a
container in your <code>httpd.conf</code> file:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Issues</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Issues <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>Since DAV access methods allow remote clients to manipulate
files on the server, you must take particular care to assure that
DAV access to untrusted users.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="complex" id="complex">Complex Configurations</a> <a title="Permanent link" href="#complex" class="permalink">¶</a></h2>
+<h2
id="complex">Complex Configurations <a title="Permanent link" href="#complex" class="permalink">¶</a></h2>
<p>One common request is to use <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> to
manipulate dynamic files (PHP scripts, CGI scripts, etc). This is
client to manipulate them.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Dav" id="Dav">Dav</a> <a name="dav" id="dav">Directive</a> <a title="Permanent link" href="#dav" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dav"><span id="Dav">Dav</span> Directive <a title="Permanent link" href="#dav" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable WebDAV HTTP methods</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Dav On|Off|<var>provider-name</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavBasePath" id="DavBasePath">DavBasePath</a> <a name="davbasepath" id="davbasepath">Directive</a> <a title="Permanent link" href="#davbasepath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davbasepath"><span id="DavBasePath">DavBasePath</span> Directive <a title="Permanent link" href="#davbasepath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure repository root path</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DavBasePath <var>root-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavDepthInfinity" id="DavDepthInfinity">DavDepthInfinity</a> <a name="davdepthinfinity" id="davdepthinfinity">Directive</a> <a title="Permanent link" href="#davdepthinfinity" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davdepthinfinity"><span id="DavDepthInfinity">DavDepthInfinity</span> Directive <a title="Permanent link" href="#davdepthinfinity" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow PROPFIND, Depth: Infinity requests</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DavDepthInfinity on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavHonorMtimeHeader" id="DavHonorMtimeHeader">DavHonorMtimeHeader</a> <a name="davhonormtimeheader" id="davhonormtimeheader">Directive</a> <a title="Permanent link" href="#davhonormtimeheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davhonormtimeheader"><span id="DavHonorMtimeHeader">DavHonorMtimeHeader</span> Directive <a title="Permanent link" href="#davhonormtimeheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow clients to set resource modification times via the
X-OC-Mtime request header</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavMinTimeout" id="DavMinTimeout">DavMinTimeout</a> <a name="davmintimeout" id="davmintimeout">Directive</a> <a title="Permanent link" href="#davmintimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davmintimeout"><span id="DavMinTimeout">DavMinTimeout</span> Directive <a title="Permanent link" href="#davmintimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimum amount of time the server holds a lock on
a DAV resource</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavMSext" id="DavMSext">DavMSext</a> <a name="davmsext" id="davmsext">Directive</a> <a title="Permanent link" href="#davmsext" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davmsext"><span id="DavMSext">DavMSext</span> Directive <a title="Permanent link" href="#davmsext" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable support for Microsoft extensions</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DavMSext None | [+|-]WDV | All</code></td></tr>
<a href="../ko/mod/mod_dav.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavLockDB" id="DavLockDB">DavLockDB</a> <a name="davlockdb" id="davlockdb">Directive</a> <a title="Permanent link" href="#davlockdb" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davlockdb"><span id="DavLockDB">DavLockDB</span> Directive <a title="Permanent link" href="#davlockdb" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the DAV lock database</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DavLockDB <var>file-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavLockDBType" id="DavLockDBType">DavLockDBType</a> <a name="davlockdbtype" id="davlockdbtype">Directive</a> <a title="Permanent link" href="#davlockdbtype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davlockdbtype"><span id="DavLockDBType">DavLockDBType</span> Directive <a title="Permanent link" href="#davlockdbtype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Database type of the DAV lock database</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DavLockDBType <var>dbm-type</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavLockDiscovery" id="DavLockDiscovery">DavLockDiscovery</a> <a name="davlockdiscovery" id="davlockdiscovery">Directive</a> <a title="Permanent link" href="#davlockdiscovery" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davlockdiscovery"><span id="DavLockDiscovery">DavLockDiscovery</span> Directive <a title="Permanent link" href="#davlockdiscovery" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable lock discovery</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DavLockDiscovery on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DavQuota" id="DavQuota">DavQuota</a> <a name="davquota" id="davquota">Directive</a> <a title="Permanent link" href="#davquota" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="davquota"><span id="DavQuota">DavQuota</span> Directive <a title="Permanent link" href="#davquota" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set usage quota</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DavQuota Off | None | #bytes</code></td></tr>
<a href="../ko/mod/mod_dav_fs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="pooling" id="pooling">Connection Pooling</a> <a title="Permanent link" href="#pooling" class="permalink">¶</a></h2>
+<h2
id="pooling">Connection Pooling <a title="Permanent link" href="#pooling" class="permalink">¶</a></h2>
<p>This module manages database connections, in a manner
optimized for the platform. On non-threaded platforms,
it provides a persistent connection in the manner of
supersedes the modules presented in that article.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="connecting" id="connecting">Connecting</a> <a title="Permanent link" href="#connecting" class="permalink">¶</a></h2>
+<h2
id="connecting">Connecting <a title="Permanent link" href="#connecting" class="permalink">¶</a></h2>
<p>To connect to your database, you'll need to specify
a driver, and connection parameters. These vary from
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="API" id="API">Apache DBD API</a> <a title="Permanent link" href="#API" class="permalink">¶</a></h2>
+<h2
id="API">Apache DBD API <a title="Permanent link" href="#API" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> exports five functions for other modules
to use. The API is as follows:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="prepared" id="prepared">SQL Prepared Statements</a> <a title="Permanent link" href="#prepared" class="permalink">¶</a></h2>
+<h2
id="prepared">SQL Prepared Statements <a title="Permanent link" href="#prepared" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> supports SQL prepared statements on behalf
of modules that may wish to use them. Each prepared statement
must be assigned a name (label), and they are stored in a hash:
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">SECURITY WARNING</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">SECURITY WARNING <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>Any web/database application needs to secure itself against SQL
injection attacks. In most cases, Apache DBD is safe, because
which offers the security of genuine prepared statements.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDExptime" id="DBDExptime">DBDExptime</a> <a name="dbdexptime" id="dbdexptime">Directive</a> <a title="Permanent link" href="#dbdexptime" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdexptime"><span id="DBDExptime">DBDExptime</span> Directive <a title="Permanent link" href="#dbdexptime" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keepalive time for idle connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDExptime <var>time-in-seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDInitSQL" id="DBDInitSQL">DBDInitSQL</a> <a name="dbdinitsql" id="dbdinitsql">Directive</a> <a title="Permanent link" href="#dbdinitsql" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdinitsql"><span id="DBDInitSQL">DBDInitSQL</span> Directive <a title="Permanent link" href="#dbdinitsql" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Execute an SQL statement after connecting to a database</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDInitSQL <var>"SQL statement"</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDKeep" id="DBDKeep">DBDKeep</a> <a name="dbdkeep" id="dbdkeep">Directive</a> <a title="Permanent link" href="#dbdkeep" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdkeep"><span id="DBDKeep">DBDKeep</span> Directive <a title="Permanent link" href="#dbdkeep" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum sustained number of connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDKeep <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDMax" id="DBDMax">DBDMax</a> <a name="dbdmax" id="dbdmax">Directive</a> <a title="Permanent link" href="#dbdmax" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdmax"><span id="DBDMax">DBDMax</span> Directive <a title="Permanent link" href="#dbdmax" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDMax <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDMin" id="DBDMin">DBDMin</a> <a name="dbdmin" id="dbdmin">Directive</a> <a title="Permanent link" href="#dbdmin" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdmin"><span id="DBDMin">DBDMin</span> Directive <a title="Permanent link" href="#dbdmin" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimum number of connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDMin <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDParams" id="DBDParams">DBDParams</a> <a name="dbdparams" id="dbdparams">Directive</a> <a title="Permanent link" href="#dbdparams" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdparams"><span id="DBDParams">DBDParams</span> Directive <a title="Permanent link" href="#dbdparams" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Parameters for database connection</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDParams
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDPersist" id="DBDPersist">DBDPersist</a> <a name="dbdpersist" id="dbdpersist">Directive</a> <a title="Permanent link" href="#dbdpersist" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdpersist"><span id="DBDPersist">DBDPersist</span> Directive <a title="Permanent link" href="#dbdpersist" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether to use persistent connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDPersist On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDPrepareSQL" id="DBDPrepareSQL">DBDPrepareSQL</a> <a name="dbdpreparesql" id="dbdpreparesql">Directive</a> <a title="Permanent link" href="#dbdpreparesql" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdpreparesql"><span id="DBDPrepareSQL">DBDPrepareSQL</span> Directive <a title="Permanent link" href="#dbdpreparesql" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define an SQL prepared statement</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDPrepareSQL <var>"SQL statement"</var> <var>label</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DBDriver" id="DBDriver">DBDriver</a> <a name="dbdriver" id="dbdriver">Directive</a> <a title="Permanent link" href="#dbdriver" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dbdriver"><span id="DBDriver">DBDriver</span> Directive <a title="Permanent link" href="#dbdriver" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify an SQL driver</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DBDriver <var>name</var></code></td></tr>
<a href="../fr/mod/mod_dbd.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="supportedencodings" id="supportedencodings">Supported Encodings</a> <a title="Permanent link" href="#supportedencodings" class="permalink">¶</a></h2>
+<h2
id="supportedencodings">Supported Encodings <a title="Permanent link" href="#supportedencodings" class="permalink">¶</a></h2>
<p>The <code>gzip</code> encoding is the only one supported to ensure complete compatibility
with old browser implementations. The <code>deflate</code> encoding is not supported,
please check the <a href="https://zlib.net/zlib_faq.html#faq39">zlib's documentation</a>
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="recommended" id="recommended">Sample Configurations</a> <a title="Permanent link" href="#recommended" class="permalink">¶</a></h2>
+<h2
id="recommended">Sample Configurations <a title="Permanent link" href="#recommended" class="permalink">¶</a></h2>
<div class="warning"><h3>Compression and TLS</h3>
<p>Some web applications are vulnerable to an information disclosure
attack when a TLS connection carries deflate compressed data. For more
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="enable" id="enable">Enabling Compression</a> <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
+<h2
id="enable">Enabling Compression <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
<div class="warning"><h3>Compression and TLS</h3>
<p>Some web applications are vulnerable to an information disclosure
attack when a TLS connection carries deflate compressed data. For more
information, review the details of the "BREACH" family of attacks.</p>
</div>
- <h3><a name="output" id="output">Output Compression</a></h3>
+ <h3 id="output">Output Compression</h3>
<p>Compression is implemented by the <code>DEFLATE</code>
<a href="../filter.html">filter</a>. The following directive
will enable compression for documents in the container where it
</div>
- <h3><a name="inflate" id="inflate">Output Decompression</a></h3>
+ <h3 id="inflate">Output Decompression</h3>
<p>The <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> module also provides a filter for
inflating/uncompressing a gzip compressed response body. In order to activate
this feature you have to insert the <code>INFLATE</code> filter into
</p>
- <h3><a name="input" id="input">Input Decompression</a></h3>
+ <h3 id="input">Input Decompression</h3>
<p>The <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> module also provides a filter for
decompressing a gzip compressed request body. In order to activate
this feature you have to insert the <code>DEFLATE</code> filter into
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="proxies" id="proxies">Dealing with proxy servers</a> <a title="Permanent link" href="#proxies" class="permalink">¶</a></h2>
+<h2
id="proxies">Dealing with proxy servers <a title="Permanent link" href="#proxies" class="permalink">¶</a></h2>
<p>The <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> module sends a <code>Vary:
Accept-Encoding</code> HTTP response header to alert proxies that
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="precompressed" id="precompressed">Serving pre-compressed
-content
</a> <a title="Permanent link" href="#precompressed" class="permalink">¶</a></h2>
+<h2 id="precompressed">Serving pre-compressed
+content <a title="Permanent link" href="#precompressed" class="permalink">¶</a></h2>
<p>Since <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> re-compresses content each
time a request is made, some performance benefit can be derived by
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateAlterETag" id="DeflateAlterETag">DeflateAlterETag</a> <a name="deflatealteretag" id="deflatealteretag">Directive</a> <a title="Permanent link" href="#deflatealteretag" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflatealteretag"><span id="DeflateAlterETag">DeflateAlterETag</span> Directive <a title="Permanent link" href="#deflatealteretag" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How the outgoing ETag header should be modified during compression</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateAlterETag AddSuffix|NoChange|Remove</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateBufferSize" id="DeflateBufferSize">DeflateBufferSize</a> <a name="deflatebuffersize" id="deflatebuffersize">Directive</a> <a title="Permanent link" href="#deflatebuffersize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflatebuffersize"><span id="DeflateBufferSize">DeflateBufferSize</span> Directive <a title="Permanent link" href="#deflatebuffersize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fragment size to be compressed at one time by zlib</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateBufferSize <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateCompressionLevel" id="DeflateCompressionLevel">DeflateCompressionLevel</a> <a name="deflatecompressionlevel" id="deflatecompressionlevel">Directive</a> <a title="Permanent link" href="#deflatecompressionlevel" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflatecompressionlevel"><span id="DeflateCompressionLevel">DeflateCompressionLevel</span> Directive <a title="Permanent link" href="#deflatecompressionlevel" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How much compression do we apply to the output</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateCompressionLevel <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateFilterNote" id="DeflateFilterNote">DeflateFilterNote</a> <a name="deflatefilternote" id="deflatefilternote">Directive</a> <a title="Permanent link" href="#deflatefilternote" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflatefilternote"><span id="DeflateFilterNote">DeflateFilterNote</span> Directive <a title="Permanent link" href="#deflatefilternote" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Places the compression ratio in a note for logging</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateFilterNote [<var>type</var>] <var>notename</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateInflateLimitRequestBody" id="DeflateInflateLimitRequestBody">DeflateInflateLimitRequestBody</a> <a name="deflateinflatelimitrequestbody" id="deflateinflatelimitrequestbody">Directive</a> <a title="Permanent link" href="#deflateinflatelimitrequestbody" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflateinflatelimitrequestbody"><span id="DeflateInflateLimitRequestBody">DeflateInflateLimitRequestBody</span> Directive <a title="Permanent link" href="#deflateinflatelimitrequestbody" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum size of inflated request bodies</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateInflateLimitRequestBody <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateInflateRatioBurst" id="DeflateInflateRatioBurst">DeflateInflateRatioBurst</a> <a name="deflateinflateratioburst" id="deflateinflateratioburst">Directive</a> <a title="Permanent link" href="#deflateinflateratioburst" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflateinflateratioburst"><span id="DeflateInflateRatioBurst">DeflateInflateRatioBurst</span> Directive <a title="Permanent link" href="#deflateinflateratioburst" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of times the inflation ratio for request bodies
can be crossed</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateInflateRatioLimit" id="DeflateInflateRatioLimit">DeflateInflateRatioLimit</a> <a name="deflateinflateratiolimit" id="deflateinflateratiolimit">Directive</a> <a title="Permanent link" href="#deflateinflateratiolimit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflateinflateratiolimit"><span id="DeflateInflateRatioLimit">DeflateInflateRatioLimit</span> Directive <a title="Permanent link" href="#deflateinflateratiolimit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum inflation ratio for request bodies</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateInflateRatioLimit <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateMemLevel" id="DeflateMemLevel">DeflateMemLevel</a> <a name="deflatememlevel" id="deflatememlevel">Directive</a> <a title="Permanent link" href="#deflatememlevel" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflatememlevel"><span id="DeflateMemLevel">DeflateMemLevel</span> Directive <a title="Permanent link" href="#deflatememlevel" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How much memory should be used by zlib for compression</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateMemLevel <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DeflateWindowSize" id="DeflateWindowSize">DeflateWindowSize</a> <a name="deflatewindowsize" id="deflatewindowsize">Directive</a> <a title="Permanent link" href="#deflatewindowsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="deflatewindowsize"><span id="DeflateWindowSize">DeflateWindowSize</span> Directive <a title="Permanent link" href="#deflatewindowsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Zlib compression window size</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateWindowSize <var>value</var></code></td></tr>
<a href="../ko/mod/mod_deflate.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_dialup">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_dialup">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ModemStandard" id="ModemStandard">ModemStandard</a> <a name="modemstandard" id="modemstandard">Directive</a> <a title="Permanent link" href="#modemstandard" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="modemstandard"><span id="ModemStandard">ModemStandard</span> Directive <a title="Permanent link" href="#modemstandard" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modem standard to simulate</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ModemStandard V.21|V.26bis|V.32|V.34|V.92</code></td></tr>
<a href="../fr/mod/mod_dialup.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_dir">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_dir">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DirectoryCheckHandler" id="DirectoryCheckHandler">DirectoryCheckHandler</a> <a name="directorycheckhandler" id="directorycheckhandler">Directive</a> <a title="Permanent link" href="#directorycheckhandler" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="directorycheckhandler"><span id="DirectoryCheckHandler">DirectoryCheckHandler</span> Directive <a title="Permanent link" href="#directorycheckhandler" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Toggle how this module responds when another handler is configured</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectoryCheckHandler On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DirectoryIndex" id="DirectoryIndex">DirectoryIndex</a> <a name="directoryindex" id="directoryindex">Directive</a> <a title="Permanent link" href="#directoryindex" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="directoryindex"><span id="DirectoryIndex">DirectoryIndex</span> Directive <a title="Permanent link" href="#directoryindex" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>List of resources to look for when the client requests
a directory</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DirectoryIndexRedirect" id="DirectoryIndexRedirect">DirectoryIndexRedirect</a> <a name="directoryindexredirect" id="directoryindexredirect">Directive</a> <a title="Permanent link" href="#directoryindexredirect" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="directoryindexredirect"><span id="DirectoryIndexRedirect">DirectoryIndexRedirect</span> Directive <a title="Permanent link" href="#directoryindexredirect" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures an external redirect for directory indexes.
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DirectorySlash" id="DirectorySlash">DirectorySlash</a> <a name="directoryslash" id="directoryslash">Directive</a> <a title="Permanent link" href="#directoryslash" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="directoryslash"><span id="DirectorySlash">DirectorySlash</span> Directive <a title="Permanent link" href="#directoryslash" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Toggle trailing slash redirects on or off</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectorySlash On|Off|NotFound</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FallbackResource" id="FallbackResource">FallbackResource</a> <a name="fallbackresource" id="fallbackresource">Directive</a> <a title="Permanent link" href="#fallbackresource" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="fallbackresource"><span id="FallbackResource">FallbackResource</span> Directive <a title="Permanent link" href="#fallbackresource" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a default URL for requests that don't map to a file or handler</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FallbackResource disabled | <var>local-url</var></code></td></tr>
<a href="../tr/mod/mod_dir.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_dumpio">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_dumpio">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="enable" id="enable">Enabling dumpio Support</a> <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
+<h2
id="enable">Enabling dumpio Support <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
<p>To enable the module, it should be compiled and loaded
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DumpIOInput" id="DumpIOInput">DumpIOInput</a> <a name="dumpioinput" id="dumpioinput">Directive</a> <a title="Permanent link" href="#dumpioinput" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dumpioinput"><span id="DumpIOInput">DumpIOInput</span> Directive <a title="Permanent link" href="#dumpioinput" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dump all input data to the error log</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DumpIOInput On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DumpIOOutput" id="DumpIOOutput">DumpIOOutput</a> <a name="dumpiooutput" id="dumpiooutput">Directive</a> <a title="Permanent link" href="#dumpiooutput" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dumpiooutput"><span id="DumpIOOutput">DumpIOOutput</span> Directive <a title="Permanent link" href="#dumpiooutput" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dump all output data to the error log</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DumpIOOutput On|Off</code></td></tr>
<a href="../ja/mod/mod_dumpio.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_echo">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_echo">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProtocolEcho" id="ProtocolEcho">ProtocolEcho</a> <a name="protocolecho" id="protocolecho">Directive</a> <a title="Permanent link" href="#protocolecho" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="protocolecho"><span id="ProtocolEcho">ProtocolEcho</span> Directive <a title="Permanent link" href="#protocolecho" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Turn the echo server on or off</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProtocolEcho On|Off</code></td></tr>
<a href="../ko/mod/mod_echo.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PassEnv" id="PassEnv">PassEnv</a> <a name="passenv" id="passenv">Directive</a> <a title="Permanent link" href="#passenv" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="passenv"><span id="PassEnv">PassEnv</span> Directive <a title="Permanent link" href="#passenv" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Passes environment variables from the shell</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PassEnv <var>env-variable</var> [<var>env-variable</var>]
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SetEnv" id="SetEnv">SetEnv</a> <a name="setenv" id="setenv">Directive</a> <a title="Permanent link" href="#setenv" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="setenv"><span id="SetEnv">SetEnv</span> Directive <a title="Permanent link" href="#setenv" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetEnv <var>env-variable</var> [<var>value</var>]</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="UnsetEnv" id="UnsetEnv">UnsetEnv</a> <a name="unsetenv" id="unsetenv">Directive</a> <a title="Permanent link" href="#unsetenv" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="unsetenv"><span id="UnsetEnv">UnsetEnv</span> Directive <a title="Permanent link" href="#unsetenv" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes variables from the environment</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UnsetEnv <var>env-variable</var> [<var>env-variable</var>]
<a href="../tr/mod/mod_env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_example_hooks">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_example_hooks">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="compiling" id="compiling">Compiling the example_hooks module</a> <a title="Permanent link" href="#compiling" class="permalink">¶</a></h2>
+<h2
id="compiling">Compiling the example_hooks module <a title="Permanent link" href="#compiling" class="permalink">¶</a></h2>
<p>To include the example_hooks module in your server, follow the
steps below:</p>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="using" id="using">Using the <code>mod_example_hooks</code> Module</a> <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
+<h2
id="using">Using the <code>mod_example_hooks</code> Module <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
<p>To activate the example_hooks module, include a block similar to
the following in your <code>httpd.conf</code> file:</p>
earlier.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Example" id="Example">Example</a> <a name="example" id="example">Directive</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="example"><span id="Example">Example</span> Directive <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Demonstration directive to illustrate the Apache module
API</td></tr>
<a href="../ko/mod/mod_example_hooks.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_expires">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_expires">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="AltSyn" id="AltSyn">Alternate Interval Syntax</a> <a title="Permanent link" href="#AltSyn" class="permalink">¶</a></h2>
+<h2
id="AltSyn">Alternate Interval Syntax <a title="Permanent link" href="#AltSyn" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code> and
<code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> directives
can also be defined in a more readable syntax of the form:</p>
that there is no modification time for such content.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ExpiresActive" id="ExpiresActive">ExpiresActive</a> <a name="expiresactive" id="expiresactive">Directive</a> <a title="Permanent link" href="#expiresactive" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="expiresactive"><span id="ExpiresActive">ExpiresActive</span> Directive <a title="Permanent link" href="#expiresactive" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables generation of <code>Expires</code>
headers</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ExpiresByType" id="ExpiresByType">ExpiresByType</a> <a name="expiresbytype" id="expiresbytype">Directive</a> <a title="Permanent link" href="#expiresbytype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="expiresbytype"><span id="ExpiresByType">ExpiresByType</span> Directive <a title="Permanent link" href="#expiresbytype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Value of the <code>Expires</code> header configured
by MIME type</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ExpiresDefault" id="ExpiresDefault">ExpiresDefault</a> <a name="expiresdefault" id="expiresdefault">Directive</a> <a title="Permanent link" href="#expiresdefault" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="expiresdefault"><span id="ExpiresDefault">ExpiresDefault</span> Directive <a title="Permanent link" href="#expiresdefault" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default algorithm for calculating expiration time</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ExpiresDefault <var><code>seconds</var></code></td></tr>
<a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<h3>Generating HTML from some other type of response</h3>
<pre class="prettyprint lang-config"># mod_ext_filter directive to define a filter
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ExtFilterDefine" id="ExtFilterDefine">ExtFilterDefine</a> <a name="extfilterdefine" id="extfilterdefine">Directive</a> <a title="Permanent link" href="#extfilterdefine" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="extfilterdefine"><span id="ExtFilterDefine">ExtFilterDefine</span> Directive <a title="Permanent link" href="#extfilterdefine" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define an external filter</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ExtFilterDefine <var>filtername</var> <var>parameters</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ExtFilterOptions" id="ExtFilterOptions">ExtFilterOptions</a> <a name="extfilteroptions" id="extfilteroptions">Directive</a> <a title="Permanent link" href="#extfilteroptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="extfilteroptions"><span id="ExtFilterOptions">ExtFilterOptions</span> Directive <a title="Permanent link" href="#extfilteroptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> options</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ExtFilterOptions <var>option</var> [<var>option</var>] ...</code></td></tr>
<a href="../ko/mod/mod_ext_filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_file_cache">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_file_cache">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="using" id="using">Using mod_file_cache</a> <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
+<h2
id="using">Using mod_file_cache <a title="Permanent link" href="#using" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> caches a list of statically
configured files via <code class="directive"><a href="#mmapfile">MMapFile</a></code> or <code class="directive"><a href="#cachefile">CacheFile</a></code> directives in the main server configuration.</p>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheFile" id="CacheFile">CacheFile</a> <a name="cachefile" id="cachefile">Directive</a> <a title="Permanent link" href="#cachefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachefile"><span id="CacheFile">CacheFile</span> Directive <a title="Permanent link" href="#cachefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cache a list of file handles at startup time</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheFile <var>file-path</var> [<var>file-path</var>] ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MMapFile" id="MMapFile">MMapFile</a> <a name="mmapfile" id="mmapfile">Directive</a> <a title="Permanent link" href="#mmapfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mmapfile"><span id="MMapFile">MMapFile</span> Directive <a title="Permanent link" href="#mmapfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Map a list of files into memory at startup time</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MMapFile <var>file-path</var> [<var>file-path</var>] ...</code></td></tr>
<a href="../ko/mod/mod_file_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_filter">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_filter">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="smart" id="smart">Smart Filtering</a> <a title="Permanent link" href="#smart" class="permalink">¶</a></h2>
+<h2
id="smart">Smart Filtering <a title="Permanent link" href="#smart" class="permalink">¶</a></h2>
<p>In the traditional filtering model, filters are inserted unconditionally
using <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> and family.
Each filter then needs to determine whether to run, and there is little
flexibility offered by <code class="directive">AddOutputFilterByType</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="terms" id="terms">Filter Declarations, Providers and Chains</a> <a title="Permanent link" href="#terms" class="permalink">¶</a></h2>
+<h2
id="terms">Filter Declarations, Providers and Chains <a title="Permanent link" href="#terms" class="permalink">¶</a></h2>
<p class="figure">
<img src="../images/mod_filter_old.gif" width="160" height="310" alt="[This image displays the traditional filter model]"><br>
<dfn>Figure 1:</dfn> The traditional filter model</p>
is equivalent to inserting the provider filter directly into the chain.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="config" id="config">Configuring the Chain</a> <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
+<h2
id="config">Configuring the Chain <a title="Permanent link" href="#config" class="permalink">¶</a></h2>
<p>There are three stages to configuring a filter chain with
<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>. For details of the directives, see below.</p>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="errordocs" id="errordocs">Filtering and Response Status</a> <a title="Permanent link" href="#errordocs" class="permalink">¶</a></h2>
+<h2
id="errordocs">Filtering and Response Status <a title="Permanent link" href="#errordocs" class="permalink">¶</a></h2>
<p>mod_filter normally only runs filters on responses with
HTTP status 200 (OK). If you want to filter documents with
other response statuses, you can set the <var>filter-errordocs</var>
expression conditions with <code class="directive">FilterProvider</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="upgrade" id="upgrade">Upgrading from Apache HTTP Server 2.2 Configuration</a> <a title="Permanent link" href="#upgrade" class="permalink">¶</a></h2>
+<h2
id="upgrade">Upgrading from Apache HTTP Server 2.2 Configuration <a title="Permanent link" href="#upgrade" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="#filterprovider">FilterProvider</a></code>
directive has changed from httpd 2.2: the <var>match</var> and
<var>dispatch</var> arguments are replaced with a single but
replaced by regular expression matches.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<dl>
<dt>Server side Includes (SSI)</dt>
<dd>A simple case replacing <code class="directive">AddOutputFilterByType</code>.
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="protocol" id="protocol">Protocol Handling</a> <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
+<h2
id="protocol">Protocol Handling <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
<p>Historically, each filter is responsible for ensuring that whatever
changes it makes are correctly represented in the HTTP response headers,
and that it does not run when it would make an illegal change. This
Modules using it should test it carefully.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directive</a> <a title="Permanent link" href="#addoutputfilterbytype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addoutputfilterbytype"><span id="AddOutputFilterByType">AddOutputFilterByType</span> Directive <a title="Permanent link" href="#addoutputfilterbytype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>assigns an output filter to a particular media-type</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilterByType <var>filter</var>[;<var>filter</var>...]
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FilterChain" id="FilterChain">FilterChain</a> <a name="filterchain" id="filterchain">Directive</a> <a title="Permanent link" href="#filterchain" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="filterchain"><span id="FilterChain">FilterChain</span> Directive <a title="Permanent link" href="#filterchain" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure the filter chain</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FilterChain [+=-@!]<var>smart-filter-name</var> <var>...</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FilterDeclare" id="FilterDeclare">FilterDeclare</a> <a name="filterdeclare" id="filterdeclare">Directive</a> <a title="Permanent link" href="#filterdeclare" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="filterdeclare"><span id="FilterDeclare">FilterDeclare</span> Directive <a title="Permanent link" href="#filterdeclare" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare a smart filter</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FilterDeclare <var>smart-filter-name</var> <var>[type]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FilterProtocol" id="FilterProtocol">FilterProtocol</a> <a name="filterprotocol" id="filterprotocol">Directive</a> <a title="Permanent link" href="#filterprotocol" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="filterprotocol"><span id="FilterProtocol">FilterProtocol</span> Directive <a title="Permanent link" href="#filterprotocol" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Deal with correct HTTP protocol handling</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FilterProtocol <var>smart-filter-name</var> [<var>provider-name</var>]
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FilterProvider" id="FilterProvider">FilterProvider</a> <a name="filterprovider" id="filterprovider">Directive</a> <a title="Permanent link" href="#filterprovider" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="filterprovider"><span id="FilterProvider">FilterProvider</span> Directive <a title="Permanent link" href="#filterprovider" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Register a content filter</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FilterProvider <var>smart-filter-name</var> <var>provider-name</var>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FilterTrace" id="FilterTrace">FilterTrace</a> <a name="filtertrace" id="filtertrace">Directive</a> <a title="Permanent link" href="#filtertrace" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="filtertrace"><span id="FilterTrace">FilterTrace</span> Directive <a title="Permanent link" href="#filtertrace" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Get debug/diagnostic information from
<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code></td></tr>
<a href="../fr/mod/mod_filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="enable" id="enable">Enabling a Firehose</a> <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
+<h2
id="enable">Enabling a Firehose <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
<p>To enable the module, it should be compiled and loaded
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="format" id="format">Stream Format</a> <a title="Permanent link" href="#format" class="permalink">¶</a></h2>
+<h2
id="format">Stream Format <a title="Permanent link" href="#format" class="permalink">¶</a></h2>
<p>The server typically serves multiple connections simultaneously,
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FirehoseConnectionInput" id="FirehoseConnectionInput">FirehoseConnectionInput</a> <a name="firehoseconnectioninput" id="firehoseconnectioninput">Directive</a> <a title="Permanent link" href="#firehoseconnectioninput" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="firehoseconnectioninput"><span id="FirehoseConnectionInput">FirehoseConnectionInput</span> Directive <a title="Permanent link" href="#firehoseconnectioninput" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Capture traffic coming into the server on each connection</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FirehoseConnectionInput <var>[ block | nonblock ]</var> <var>filename</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FirehoseConnectionOutput" id="FirehoseConnectionOutput">FirehoseConnectionOutput</a> <a name="firehoseconnectionoutput" id="firehoseconnectionoutput">Directive</a> <a title="Permanent link" href="#firehoseconnectionoutput" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="firehoseconnectionoutput"><span id="FirehoseConnectionOutput">FirehoseConnectionOutput</span> Directive <a title="Permanent link" href="#firehoseconnectionoutput" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Capture traffic going out of the server on each connection</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FirehoseConnectionOutput <var>[ block | nonblock ]</var> <var>filename</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FirehoseProxyConnectionInput" id="FirehoseProxyConnectionInput">FirehoseProxyConnectionInput</a> <a name="firehoseproxyconnectioninput" id="firehoseproxyconnectioninput">Directive</a> <a title="Permanent link" href="#firehoseproxyconnectioninput" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="firehoseproxyconnectioninput"><span id="FirehoseProxyConnectionInput">FirehoseProxyConnectionInput</span> Directive <a title="Permanent link" href="#firehoseproxyconnectioninput" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Capture traffic coming into the back of mod_proxy</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FirehoseProxyConnectionInput <var>[ block | nonblock ]</var> <var>filename</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FirehoseProxyConnectionOutput" id="FirehoseProxyConnectionOutput">FirehoseProxyConnectionOutput</a> <a name="firehoseproxyconnectionoutput" id="firehoseproxyconnectionoutput">Directive</a> <a title="Permanent link" href="#firehoseproxyconnectionoutput" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="firehoseproxyconnectionoutput"><span id="FirehoseProxyConnectionOutput">FirehoseProxyConnectionOutput</span> Directive <a title="Permanent link" href="#firehoseproxyconnectionoutput" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Capture traffic sent out from the back of mod_proxy</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FirehoseProxyConnectionOutput <var>[ block | nonblock ]</var> <var>filename</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FirehoseRequestInput" id="FirehoseRequestInput">FirehoseRequestInput</a> <a name="firehoserequestinput" id="firehoserequestinput">Directive</a> <a title="Permanent link" href="#firehoserequestinput" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="firehoserequestinput"><span id="FirehoseRequestInput">FirehoseRequestInput</span> Directive <a title="Permanent link" href="#firehoserequestinput" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Capture traffic coming into the server on each request</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FirehoseRequestInput <var>[ block | nonblock ]</var> <var>filename</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="FirehoseRequestOutput" id="FirehoseRequestOutput">FirehoseRequestOutput</a> <a name="firehoserequestoutput" id="firehoserequestoutput">Directive</a> <a title="Permanent link" href="#firehoserequestoutput" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="firehoserequestoutput"><span id="FirehoseRequestOutput">FirehoseRequestOutput</span> Directive <a title="Permanent link" href="#firehoserequestoutput" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Capture traffic going out of the server on each request</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FirehoseRequestOutput <var>[ block | nonblock ]</var> <var>filename</var></code></td></tr>
<a href="../fr/mod/mod_firehose.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_headers">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_headers">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="order" id="order">Order of Processing</a> <a title="Permanent link" href="#order" class="permalink">¶</a></h2>
+<h2
id="order">Order of Processing <a title="Permanent link" href="#order" class="permalink">¶</a></h2>
<p>The directives provided by <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> can
occur almost anywhere within the server configuration, and can be
reversed, the MirrorID header is set to "mirror 12".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="early" id="early">Early and Late Processing</a> <a title="Permanent link" href="#early" class="permalink">¶</a></h2>
+<h2
id="early">Early and Late Processing <a title="Permanent link" href="#early" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> can be applied either early or late
in the request. The normal mode is late, when <em>Request</em> Headers are
set immediately before running the content generator and <em>Response</em>
<code class="directive"><a href="../mod/core.html#location"><Location></a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<ol>
<li>
</ol>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Header" id="Header">Header</a> <a name="header" id="header">Directive</a> <a title="Permanent link" href="#header" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="header"><span id="Header">Header</span> Directive <a title="Permanent link" href="#header" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure HTTP response headers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Header [<var>condition</var>] add|append|echo|edit|edit*|merge|set|setifempty|unset|note
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RequestHeader" id="RequestHeader">RequestHeader</a> <a name="requestheader" id="requestheader">Directive</a> <a title="Permanent link" href="#requestheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="requestheader"><span id="RequestHeader">RequestHeader</span> Directive <a title="Permanent link" href="#requestheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure HTTP request headers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RequestHeader add|append|edit|edit*|merge|set|setifempty|unset
<a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_heartbeat">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_heartbeat">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="consuming" id="consuming">Consuming mod_heartbeat Output</a> <a title="Permanent link" href="#consuming" class="permalink">¶</a></h2>
+<h2
id="consuming">Consuming mod_heartbeat Output <a title="Permanent link" href="#consuming" class="permalink">¶</a></h2>
<p>
Every 1 second, this module generates a single multicast UDP
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="HeartbeatAddress" id="HeartbeatAddress">HeartbeatAddress</a> <a name="heartbeataddress" id="heartbeataddress">Directive</a> <a title="Permanent link" href="#heartbeataddress" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="heartbeataddress"><span id="HeartbeatAddress">HeartbeatAddress</span> Directive <a title="Permanent link" href="#heartbeataddress" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Multicast address for heartbeat packets</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HeartbeatAddress <var>addr:port</var></code></td></tr>
<a href="../fr/mod/mod_heartbeat.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_heartmonitor">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_heartmonitor">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="HeartbeatListen" id="HeartbeatListen">HeartbeatListen</a> <a name="heartbeatlisten" id="heartbeatlisten">Directive</a> <a title="Permanent link" href="#heartbeatlisten" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="heartbeatlisten"><span id="HeartbeatListen">HeartbeatListen</span> Directive <a title="Permanent link" href="#heartbeatlisten" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>multicast address to listen for incoming heartbeat requests </td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HeartbeatListen <var>addr:port</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="HeartbeatMaxServers" id="HeartbeatMaxServers">HeartbeatMaxServers</a> <a name="heartbeatmaxservers" id="heartbeatmaxservers">Directive</a> <a title="Permanent link" href="#heartbeatmaxservers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="heartbeatmaxservers"><span id="HeartbeatMaxServers">HeartbeatMaxServers</span> Directive <a title="Permanent link" href="#heartbeatmaxservers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the maximum number of servers that will be sending
heartbeat requests to this server</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="HeartbeatStorage" id="HeartbeatStorage">HeartbeatStorage</a> <a name="heartbeatstorage" id="heartbeatstorage">Directive</a> <a title="Permanent link" href="#heartbeatstorage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="heartbeatstorage"><span id="HeartbeatStorage">HeartbeatStorage</span> Directive <a title="Permanent link" href="#heartbeatstorage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Path to store heartbeat data when using flat-file storage</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HeartbeatStorage <var>file-path</var></code></td></tr>
<a href="../fr/mod/mod_heartmonitor.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_http2">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_http2">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="how-it-works" id="how-it-works">How it works</a> <a title="Permanent link" href="#how-it-works" class="permalink">¶</a></h2>
+<h2
id="how-it-works">How it works <a title="Permanent link" href="#how-it-works" class="permalink">¶</a></h2>
- <h3><a name="dimensioning" id="dimensioning">HTTP/2 Dimensioning</a></h3>
+ <h3 id="dimensioning">HTTP/2 Dimensioning</h3>
<p>
Enabling HTTP/2 on your Apache Server has impact on the resource
consumption and if you have a busy site, you may need to consider
</p>
- <h3><a name="misdirected" id="misdirected">Multiple Hosts and Misdirected Requests</a></h3>
+ <h3 id="misdirected">Multiple Hosts and Misdirected Requests</h3>
<p>
Many sites use the same TLS certificate for multiple virtual hosts. The
certificate either has a wildcard name, such as '*.example.org' or carries
</p>
- <h3><a name="envvars" id="envvars">Environment Variables</a></h3>
+ <h3 id="envvars">Environment Variables</h3>
<p>
This module can be configured to provide HTTP/2 related information
as additional environment variables to the SSI and CGI namespace, as well
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2CopyFiles" id="H2CopyFiles">H2CopyFiles</a> <a name="h2copyfiles" id="h2copyfiles">Directive</a> <a title="Permanent link" href="#h2copyfiles" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2copyfiles"><span id="H2CopyFiles">H2CopyFiles</span> Directive <a title="Permanent link" href="#h2copyfiles" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine file handling in responses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2CopyFiles on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2Direct" id="H2Direct">H2Direct</a> <a name="h2direct" id="h2direct">Directive</a> <a title="Permanent link" href="#h2direct" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2direct"><span id="H2Direct">H2Direct</span> Directive <a title="Permanent link" href="#h2direct" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>H2 Direct Protocol Switch</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2Direct on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2EarlyHint" id="H2EarlyHint">H2EarlyHint</a> <a name="h2earlyhint" id="h2earlyhint">Directive</a> <a title="Permanent link" href="#h2earlyhint" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2earlyhint"><span id="H2EarlyHint">H2EarlyHint</span> Directive <a title="Permanent link" href="#h2earlyhint" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add a response header to be picked up in 103 Early Hints</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2EarlyHint <var>name</var> <var>value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2EarlyHints" id="H2EarlyHints">H2EarlyHints</a> <a name="h2earlyhints" id="h2earlyhints">Directive</a> <a title="Permanent link" href="#h2earlyhints" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2earlyhints"><span id="H2EarlyHints">H2EarlyHints</span> Directive <a title="Permanent link" href="#h2earlyhints" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine sending of 103 status codes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2EarlyHints on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2MaxDataFrameLen" id="H2MaxDataFrameLen">H2MaxDataFrameLen</a> <a name="h2maxdataframelen" id="h2maxdataframelen">Directive</a> <a title="Permanent link" href="#h2maxdataframelen" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2maxdataframelen"><span id="H2MaxDataFrameLen">H2MaxDataFrameLen</span> Directive <a title="Permanent link" href="#h2maxdataframelen" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum bytes inside a single HTTP/2 DATA frame</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2MaxDataFrameLen <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2MaxHeaderBlockLen" id="H2MaxHeaderBlockLen">H2MaxHeaderBlockLen</a> <a name="h2maxheaderblocklen" id="h2maxheaderblocklen">Directive</a> <a title="Permanent link" href="#h2maxheaderblocklen" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2maxheaderblocklen"><span id="H2MaxHeaderBlockLen">H2MaxHeaderBlockLen</span> Directive <a title="Permanent link" href="#h2maxheaderblocklen" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum size of response headers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2MaxHeaderBlockLen <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2MaxSessionStreams" id="H2MaxSessionStreams">H2MaxSessionStreams</a> <a name="h2maxsessionstreams" id="h2maxsessionstreams">Directive</a> <a title="Permanent link" href="#h2maxsessionstreams" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2maxsessionstreams"><span id="H2MaxSessionStreams">H2MaxSessionStreams</span> Directive <a title="Permanent link" href="#h2maxsessionstreams" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of active streams per HTTP/2 session.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2MaxSessionStreams <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2MaxStreamErrors" id="H2MaxStreamErrors">H2MaxStreamErrors</a> <a name="h2maxstreamerrors" id="h2maxstreamerrors">Directive</a> <a title="Permanent link" href="#h2maxstreamerrors" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2maxstreamerrors"><span id="H2MaxStreamErrors">H2MaxStreamErrors</span> Directive <a title="Permanent link" href="#h2maxstreamerrors" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum amount of client caused errors to tolerate</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2MaxStreamErrors <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2MaxWorkerIdleSeconds" id="H2MaxWorkerIdleSeconds">H2MaxWorkerIdleSeconds</a> <a name="h2maxworkeridleseconds" id="h2maxworkeridleseconds">Directive</a> <a title="Permanent link" href="#h2maxworkeridleseconds" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2maxworkeridleseconds"><span id="H2MaxWorkerIdleSeconds">H2MaxWorkerIdleSeconds</span> Directive <a title="Permanent link" href="#h2maxworkeridleseconds" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of seconds h2 workers remain idle until shut down.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2MaxWorkerIdleSeconds <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2MaxWorkers" id="H2MaxWorkers">H2MaxWorkers</a> <a name="h2maxworkers" id="h2maxworkers">Directive</a> <a title="Permanent link" href="#h2maxworkers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2maxworkers"><span id="H2MaxWorkers">H2MaxWorkers</span> Directive <a title="Permanent link" href="#h2maxworkers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of worker threads to use per child process.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2MaxWorkers <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2MinWorkers" id="H2MinWorkers">H2MinWorkers</a> <a name="h2minworkers" id="h2minworkers">Directive</a> <a title="Permanent link" href="#h2minworkers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2minworkers"><span id="H2MinWorkers">H2MinWorkers</span> Directive <a title="Permanent link" href="#h2minworkers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimal number of worker threads to use per child process.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2MinWorkers <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2ModernTLSOnly" id="H2ModernTLSOnly">H2ModernTLSOnly</a> <a name="h2moderntlsonly" id="h2moderntlsonly">Directive</a> <a title="Permanent link" href="#h2moderntlsonly" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2moderntlsonly"><span id="H2ModernTLSOnly">H2ModernTLSOnly</span> Directive <a title="Permanent link" href="#h2moderntlsonly" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Require HTTP/2 connections to be "modern TLS" only</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2ModernTLSOnly on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2OutputBuffering" id="H2OutputBuffering">H2OutputBuffering</a> <a name="h2outputbuffering" id="h2outputbuffering">Directive</a> <a title="Permanent link" href="#h2outputbuffering" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2outputbuffering"><span id="H2OutputBuffering">H2OutputBuffering</span> Directive <a title="Permanent link" href="#h2outputbuffering" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine buffering behavior of output</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2OutputBuffering on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2Padding" id="H2Padding">H2Padding</a> <a name="h2padding" id="h2padding">Directive</a> <a title="Permanent link" href="#h2padding" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2padding"><span id="H2Padding">H2Padding</span> Directive <a title="Permanent link" href="#h2padding" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine the range of padding bytes added to payload frames</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2Padding <var>numbits</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2ProxyRequests" id="H2ProxyRequests">H2ProxyRequests</a> <a name="h2proxyrequests" id="h2proxyrequests">Directive</a> <a title="Permanent link" href="#h2proxyrequests" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2proxyrequests"><span id="H2ProxyRequests">H2ProxyRequests</span> Directive <a title="Permanent link" href="#h2proxyrequests" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>En-/Disable forward proxy requests via HTTP/2</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2ProxyRequests on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2Push" id="H2Push">H2Push</a> <a name="h2push" id="h2push">Directive</a> <a title="Permanent link" href="#h2push" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2push"><span id="H2Push">H2Push</span> Directive <a title="Permanent link" href="#h2push" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>H2 Server Push Switch</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2Push on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2PushDiarySize" id="H2PushDiarySize">H2PushDiarySize</a> <a name="h2pushdiarysize" id="h2pushdiarysize">Directive</a> <a title="Permanent link" href="#h2pushdiarysize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2pushdiarysize"><span id="H2PushDiarySize">H2PushDiarySize</span> Directive <a title="Permanent link" href="#h2pushdiarysize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>H2 Server Push Diary Size</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2PushDiarySize <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2PushPriority" id="H2PushPriority">H2PushPriority</a> <a name="h2pushpriority" id="h2pushpriority">Directive</a> <a title="Permanent link" href="#h2pushpriority" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2pushpriority"><span id="H2PushPriority">H2PushPriority</span> Directive <a title="Permanent link" href="#h2pushpriority" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>H2 Server Push Priority</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2PushPriority <var>mime-type</var> [after|before|interleaved] [<var>weight</var>]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2PushResource" id="H2PushResource">H2PushResource</a> <a name="h2pushresource" id="h2pushresource">Directive</a> <a title="Permanent link" href="#h2pushresource" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2pushresource"><span id="H2PushResource">H2PushResource</span> Directive <a title="Permanent link" href="#h2pushresource" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declares resources for early pushing to the client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2PushResource [add] <var>path</var> [critical]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2SerializeHeaders" id="H2SerializeHeaders">H2SerializeHeaders</a> <a name="h2serializeheaders" id="h2serializeheaders">Directive</a> <a title="Permanent link" href="#h2serializeheaders" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2serializeheaders"><span id="H2SerializeHeaders">H2SerializeHeaders</span> Directive <a title="Permanent link" href="#h2serializeheaders" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Serialize Request/Response Processing Switch</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2SerializeHeaders on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2StreamMaxMemSize" id="H2StreamMaxMemSize">H2StreamMaxMemSize</a> <a name="h2streammaxmemsize" id="h2streammaxmemsize">Directive</a> <a title="Permanent link" href="#h2streammaxmemsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2streammaxmemsize"><span id="H2StreamMaxMemSize">H2StreamMaxMemSize</span> Directive <a title="Permanent link" href="#h2streammaxmemsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum amount of output data buffered per stream.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2StreamMaxMemSize <var>bytes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2StreamTimeout" id="H2StreamTimeout">H2StreamTimeout</a> <a name="h2streamtimeout" id="h2streamtimeout">Directive</a> <a title="Permanent link" href="#h2streamtimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2streamtimeout"><span id="H2StreamTimeout">H2StreamTimeout</span> Directive <a title="Permanent link" href="#h2streamtimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum time waiting when sending/receiving data to stream processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2StreamTimeout <var>time-interval</var>[s]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2TLSCoolDownSecs" id="H2TLSCoolDownSecs">H2TLSCoolDownSecs</a> <a name="h2tlscooldownsecs" id="h2tlscooldownsecs">Directive</a> <a title="Permanent link" href="#h2tlscooldownsecs" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2tlscooldownsecs"><span id="H2TLSCoolDownSecs">H2TLSCoolDownSecs</span> Directive <a title="Permanent link" href="#h2tlscooldownsecs" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure the number of seconds of idle time on TLS before shrinking writes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2TLSCoolDownSecs <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2TLSWarmUpSize" id="H2TLSWarmUpSize">H2TLSWarmUpSize</a> <a name="h2tlswarmupsize" id="h2tlswarmupsize">Directive</a> <a title="Permanent link" href="#h2tlswarmupsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2tlswarmupsize"><span id="H2TLSWarmUpSize">H2TLSWarmUpSize</span> Directive <a title="Permanent link" href="#h2tlswarmupsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure the number of bytes on TLS connection before doing max writes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2TLSWarmUpSize <var>amount</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2Upgrade" id="H2Upgrade">H2Upgrade</a> <a name="h2upgrade" id="h2upgrade">Directive</a> <a title="Permanent link" href="#h2upgrade" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2upgrade"><span id="H2Upgrade">H2Upgrade</span> Directive <a title="Permanent link" href="#h2upgrade" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>H2 Upgrade Protocol Switch</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2Upgrade on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2WebSockets" id="H2WebSockets">H2WebSockets</a> <a name="h2websockets" id="h2websockets">Directive</a> <a title="Permanent link" href="#h2websockets" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2websockets"><span id="H2WebSockets">H2WebSockets</span> Directive <a title="Permanent link" href="#h2websockets" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>En-/Disable WebSockets via HTTP/2</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2WebSockets on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="H2WindowSize" id="H2WindowSize">H2WindowSize</a> <a name="h2windowsize" id="h2windowsize">Directive</a> <a title="Permanent link" href="#h2windowsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="h2windowsize"><span id="H2WindowSize">H2WindowSize</span> Directive <a title="Permanent link" href="#h2windowsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size of Stream Window for upstream data.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>H2WindowSize <var>bytes</var></code></td></tr>
<a href="../fr/mod/mod_http2.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IdentityCheck" id="IdentityCheck">IdentityCheck</a> <a name="identitycheck" id="identitycheck">Directive</a> <a title="Permanent link" href="#identitycheck" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="identitycheck"><span id="IdentityCheck">IdentityCheck</span> Directive <a title="Permanent link" href="#identitycheck" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables logging of the RFC 1413 identity of the remote
user</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IdentityCheckTimeout" id="IdentityCheckTimeout">IdentityCheckTimeout</a> <a name="identitychecktimeout" id="identitychecktimeout">Directive</a> <a title="Permanent link" href="#identitychecktimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="identitychecktimeout"><span id="IdentityCheckTimeout">IdentityCheckTimeout</span> Directive <a title="Permanent link" href="#identitychecktimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the timeout duration for ident requests</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>IdentityCheckTimeout <var>seconds</var></code></td></tr>
<a href="../ko/mod/mod_ident.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_imagemap">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_imagemap">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="features" id="features">New Features</a> <a title="Permanent link" href="#features" class="permalink">¶</a></h2>
+<h2
id="features">New Features <a title="Permanent link" href="#features" class="permalink">¶</a></h2>
<p>The imagemap module adds some new features that were not
possible with previously distributed imagemap programs.</p>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="imapfile" id="imapfile">Imagemap File</a> <a title="Permanent link" href="#imapfile" class="permalink">¶</a></h2>
+<h2
id="imapfile">Imagemap File <a title="Permanent link" href="#imapfile" class="permalink">¶</a></h2>
<p>The lines in the imagemap files can have one of several
formats:</p>
the link if a imagemap menu is generated. Lines beginning with '#' are
comments.</p>
- <h3><a name="imapfile.directives" id="imapfile.directives">Imagemap File Directives</a></h3>
+ <h3 id="imapfile.directives">Imagemap File Directives</h3>
<p>There are six directives allowed in the imagemap file. The
directives can come in any order, but are processed in the
order they are found in the imagemap file.</p>
</dl>
- <h3><a name="imapfile.values" id="imapfile.values">Values</a></h3>
+ <h3 id="imapfile.values">Values</h3>
<p>The values for each of the directives can be any of the
following:</p>
</dl>
- <h3><a name="imapfile.coords" id="imapfile.coords">Coordinates</a></h3>
+ <h3 id="imapfile.coords">Coordinates</h3>
<dl>
<dt><code>0,0 200,200</code></dt>
- <h3><a name="imapfile.quotedtext" id="imapfile.quotedtext">Quoted Text</a></h3>
+ <h3 id="imapfile.quotedtext">Quoted Text</h3>
<dl>
<dt><code>"<var>Menu Text</var>"</code></dt>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="example" id="example">Example Mapfile</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<h2
id="example">Example Mapfile <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<div class="example"><p><code>
#Comments are printed in a 'formatted' or 'semiformatted' menu.<br>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="referencing" id="referencing">Referencing your mapfile</a> <a title="Permanent link" href="#referencing" class="permalink">¶</a></h2>
+<h2
id="referencing">Referencing your mapfile <a title="Permanent link" href="#referencing" class="permalink">¶</a></h2>
<div class="example"><h3>HTML example</h3><p><code>
<a href="/maps/imagemap1.map"><br>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ImapBase" id="ImapBase">ImapBase</a> <a name="imapbase" id="imapbase">Directive</a> <a title="Permanent link" href="#imapbase" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="imapbase"><span id="ImapBase">ImapBase</span> Directive <a title="Permanent link" href="#imapbase" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default <code>base</code> for imagemap files</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ImapBase map|referer|<var>URL</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ImapDefault" id="ImapDefault">ImapDefault</a> <a name="imapdefault" id="imapdefault">Directive</a> <a title="Permanent link" href="#imapdefault" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="imapdefault"><span id="ImapDefault">ImapDefault</span> Directive <a title="Permanent link" href="#imapdefault" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default action when an imagemap is called with coordinates
that are not explicitly mapped</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ImapMenu" id="ImapMenu">ImapMenu</a> <a name="imapmenu" id="imapmenu">Directive</a> <a title="Permanent link" href="#imapmenu" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="imapmenu"><span id="ImapMenu">ImapMenu</span> Directive <a title="Permanent link" href="#imapmenu" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action if no coordinates are given when calling
an imagemap</td></tr>
<a href="../ko/mod/mod_imagemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="enabling" id="enabling">Enabling Server-Side Includes</a> <a title="Permanent link" href="#enabling" class="permalink">¶</a></h2>
+<h2
id="enabling">Enabling Server-Side Includes <a title="Permanent link" href="#enabling" class="permalink">¶</a></h2>
<p>Server Side Includes are implemented by the
<p>For more information, see our <a href="../howto/ssi.html">Tutorial on Server Side Includes</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="pathinfo" id="pathinfo">PATH_INFO with Server Side Includes</a> <a title="Permanent link" href="#pathinfo" class="permalink">¶</a></h2>
+<h2
id="pathinfo">PATH_INFO with Server Side Includes <a title="Permanent link" href="#pathinfo" class="permalink">¶</a></h2>
<p>Files processed for server-side includes no longer accept
configure the server to accept requests with <code>PATH_INFO</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="elements" id="elements">Available Elements</a> <a title="Permanent link" href="#elements" class="permalink">¶</a></h2>
+<h2
id="elements">Available Elements <a title="Permanent link" href="#elements" class="permalink">¶</a></h2>
<p>The document is parsed as an HTML document, with special
commands embedded as SGML comments. A command has the syntax: </p>
<code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, and will only be available if this
module is loaded.</p>
- <h3><a name="element.comment" id="element.comment">The comment Element</a></h3>
+ <h3 id="element.comment">The comment Element</h3>
<p>This command doesn't output anything. Its only use is to
add comments within a file. These comments are not printed.</p>
</code></p></div>
- <h3><a name="element.config" id="element.config">The config Element</a></h3>
+ <h3 id="element.config">The config Element</h3>
<p>This command controls various aspects of the parsing. The
valid attributes are:</p>
</dl>
- <h3><a name="element.echo" id="element.echo">The echo Element</a></h3>
+ <h3 id="element.echo">The echo Element</h3>
<p>This command prints one of the <a href="#includevars">include
variables</a> defined below. If the variable is unset, the result is
determined by the <code class="directive"><a href="#ssiundefinedecho">SSIUndefinedEcho</a></code> directive. Any dates printed are
</dl>
- <h3><a name="element.exec" id="element.exec">The exec Element</a></h3>
+ <h3 id="element.exec">The exec Element</h3>
<p>The <code>exec</code> command executes a given shell command or
CGI script. It requires <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> to be present
in the server. If <code class="directive"><a href="../mod/core.html#options">Options</a></code>
</dl>
- <h3><a name="element.fsize" id="element.fsize">The fsize Element</a></h3>
+ <h3 id="element.fsize">The fsize Element</h3>
<p>This command prints the size of the specified file, subject
to the <code>sizefmt</code> format specification. Attributes:</p>
aliases.</p>
- <h3><a name="element.flastmod" id="element.flastmod">The flastmod Element</a></h3>
+ <h3 id="element.flastmod">The flastmod Element</h3>
<p>This command prints the last modification date of the
specified file, subject to the <code>timefmt</code> format
specification. The attributes are the same as for the
<code><a href="#element.fsize">fsize</a></code> command.</p>
- <h3><a name="element.include" id="element.include">The include Element</a></h3>
+ <h3 id="element.include">The include Element</h3>
<p>This command inserts the text of another document or file
into the parsed file. Any included file is subject to the usual
access control. If the directory containing the parsed file has
</dl>
- <h3><a name="element.printenv" id="element.printenv">The printenv Element</a></h3>
+ <h3 id="element.printenv">The printenv Element</h3>
<p>This prints out a plain text listing of all existing variables and
their values. Special characters are entity encoded (see the <code><a href="#element.echo">echo</a></code> element for details)
before being output. There are no attributes.</p>
</code></p></div>
- <h3><a name="element.set" id="element.set">The set Element</a></h3>
+ <h3 id="element.set">The set Element</h3>
<p>This sets the value of a variable. Attributes:</p>
<dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="includevars" id="includevars">Include Variables</a> <a title="Permanent link" href="#includevars" class="permalink">¶</a></h2>
+<h2
id="includevars">Include Variables <a title="Permanent link" href="#includevars" class="permalink">¶</a></h2>
<p>In addition to the variables in the standard CGI environment,
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="substitution" id="substitution">Variable Substitution</a> <a title="Permanent link" href="#substitution" class="permalink">¶</a></h2>
+<h2
id="substitution">Variable Substitution <a title="Permanent link" href="#substitution" class="permalink">¶</a></h2>
<p>Variable substitution is done within quoted strings in most
cases where they may reasonably occur as an argument to an SSI
"<code>Y</code>".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flowctrl" id="flowctrl">Flow Control Elements</a> <a title="Permanent link" href="#flowctrl" class="permalink">¶</a></h2>
+<h2
id="flowctrl">Flow Control Elements <a title="Permanent link" href="#flowctrl" class="permalink">¶</a></h2>
<p>The basic flow control elements are:</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="legacyexpr" id="legacyexpr">Legacy expression syntax</a> <a title="Permanent link" href="#legacyexpr" class="permalink">¶</a></h2>
+<h2
id="legacyexpr">Legacy expression syntax <a title="Permanent link" href="#legacyexpr" class="permalink">¶</a></h2>
<p>This section describes the syntax of the <code>#if expr</code>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSIEndTag" id="SSIEndTag">SSIEndTag</a> <a name="ssiendtag" id="ssiendtag">Directive</a> <a title="Permanent link" href="#ssiendtag" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssiendtag"><span id="SSIEndTag">SSIEndTag</span> Directive <a title="Permanent link" href="#ssiendtag" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>String that ends an include element</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSIEndTag <var>tag</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSIErrorMsg" id="SSIErrorMsg">SSIErrorMsg</a> <a name="ssierrormsg" id="ssierrormsg">Directive</a> <a title="Permanent link" href="#ssierrormsg" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssierrormsg"><span id="SSIErrorMsg">SSIErrorMsg</span> Directive <a title="Permanent link" href="#ssierrormsg" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Error message displayed when there is an SSI
error</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSIETag" id="SSIETag">SSIETag</a> <a name="ssietag" id="ssietag">Directive</a> <a title="Permanent link" href="#ssietag" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssietag"><span id="SSIETag">SSIETag</span> Directive <a title="Permanent link" href="#ssietag" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether ETags are generated by the server.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSIETag on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSILastModified" id="SSILastModified">SSILastModified</a> <a name="ssilastmodified" id="ssilastmodified">Directive</a> <a title="Permanent link" href="#ssilastmodified" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssilastmodified"><span id="SSILastModified">SSILastModified</span> Directive <a title="Permanent link" href="#ssilastmodified" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether <code>Last-Modified</code> headers are generated by the
server.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSILegacyExprParser" id="SSILegacyExprParser">SSILegacyExprParser</a> <a name="ssilegacyexprparser" id="ssilegacyexprparser">Directive</a> <a title="Permanent link" href="#ssilegacyexprparser" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssilegacyexprparser"><span id="SSILegacyExprParser">SSILegacyExprParser</span> Directive <a title="Permanent link" href="#ssilegacyexprparser" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable compatibility mode for conditional expressions.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSILegacyExprParser on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSIStartTag" id="SSIStartTag">SSIStartTag</a> <a name="ssistarttag" id="ssistarttag">Directive</a> <a title="Permanent link" href="#ssistarttag" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssistarttag"><span id="SSIStartTag">SSIStartTag</span> Directive <a title="Permanent link" href="#ssistarttag" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>String that starts an include element</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSIStartTag <var>tag</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSITimeFormat" id="SSITimeFormat">SSITimeFormat</a> <a name="ssitimeformat" id="ssitimeformat">Directive</a> <a title="Permanent link" href="#ssitimeformat" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssitimeformat"><span id="SSITimeFormat">SSITimeFormat</span> Directive <a title="Permanent link" href="#ssitimeformat" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the format in which date strings are
displayed</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSIUndefinedEcho" id="SSIUndefinedEcho">SSIUndefinedEcho</a> <a name="ssiundefinedecho" id="ssiundefinedecho">Directive</a> <a title="Permanent link" href="#ssiundefinedecho" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssiundefinedecho"><span id="SSIUndefinedEcho">SSIUndefinedEcho</span> Directive <a title="Permanent link" href="#ssiundefinedecho" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>String displayed when an unset variable is echoed</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSIUndefinedEcho <var>string</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="XBitHack" id="XBitHack">XBitHack</a> <a name="xbithack" id="xbithack">Directive</a> <a title="Permanent link" href="#xbithack" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="xbithack"><span id="XBitHack">XBitHack</span> Directive <a title="Permanent link" href="#xbithack" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Parse SSI directives in files with the execute bit
set</td></tr>
<a href="../ja/mod/mod_include.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_info">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_info">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Issues</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Issues <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>Once <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> is loaded into the server, its
handler capability is available in <em>all</em> configuration
files, including per-directory files (<em>e.g.</em>,
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="queries" id="queries">Selecting the information shown</a> <a title="Permanent link" href="#queries" class="permalink">¶</a></h2>
+<h2
id="queries">Selecting the information shown <a title="Permanent link" href="#queries" class="permalink">¶</a></h2>
<p>By default, the server information includes a list of
all enabled modules, and for each module, a description of
the directives understood by that module, the hooks implemented
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="startup" id="startup">Dumping the configuration on startup</a> <a title="Permanent link" href="#startup" class="permalink">¶</a></h2>
+<h2
id="startup">Dumping the configuration on startup <a title="Permanent link" href="#startup" class="permalink">¶</a></h2>
<p>If the config define <code>-DDUMP_CONFIG</code> is set,
<code class="module"><a href="../mod/mod_info.html">mod_info</a></code> will dump the pre-parsed configuration to
<code>stdout</code> during server startup.</p>
<p>This is roughly equivalent to the <code>?config</code> query.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="limitations" id="limitations">Known Limitations</a> <a title="Permanent link" href="#limitations" class="permalink">¶</a></h2>
+<h2
id="limitations">Known Limitations <a title="Permanent link" href="#limitations" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> provides its information by reading the
parsed configuration, rather than reading the original configuration
file. There are a few limitations as a result of the way the parsed
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo" id="addmoduleinfo">Directive</a> <a title="Permanent link" href="#addmoduleinfo" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addmoduleinfo"><span id="AddModuleInfo">AddModuleInfo</span> Directive <a title="Permanent link" href="#addmoduleinfo" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds additional information to the module
information displayed by the server-info handler</td></tr>
<a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_isapi">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_isapi">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usage" id="usage">Usage</a> <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
+<h2
id="usage">Usage <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
<p>In the server configuration file, use
the <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> directive to
<code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="notes" id="notes">Additional Notes</a> <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
+<h2
id="notes">Additional Notes <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
<p>Apache's ISAPI implementation conforms to all of the ISAPI
2.0 specification, except for some "Microsoft-specific"
at this time.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="journal" id="journal">Programmer's Journal</a> <a title="Permanent link" href="#journal" class="permalink">¶</a></h2>
+<h2
id="journal">Programmer's Journal <a title="Permanent link" href="#journal" class="permalink">¶</a></h2>
<p>If you are programming Apache 2.0 <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code>
modules, you must limit your calls to <code>ServerSupportFunction</code>
ISAPI .dlls for performance.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ISAPIAppendLogToErrors" id="ISAPIAppendLogToErrors">ISAPIAppendLogToErrors</a> <a name="isapiappendlogtoerrors" id="isapiappendlogtoerrors">Directive</a> <a title="Permanent link" href="#isapiappendlogtoerrors" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="isapiappendlogtoerrors"><span id="ISAPIAppendLogToErrors">ISAPIAppendLogToErrors</span> Directive <a title="Permanent link" href="#isapiappendlogtoerrors" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from
ISAPI extensions to the error log</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ISAPIAppendLogToQuery" id="ISAPIAppendLogToQuery">ISAPIAppendLogToQuery</a> <a name="isapiappendlogtoquery" id="isapiappendlogtoquery">Directive</a> <a title="Permanent link" href="#isapiappendlogtoquery" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="isapiappendlogtoquery"><span id="ISAPIAppendLogToQuery">ISAPIAppendLogToQuery</span> Directive <a title="Permanent link" href="#isapiappendlogtoquery" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from
ISAPI extensions to the query field</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ISAPICacheFile" id="ISAPICacheFile">ISAPICacheFile</a> <a name="isapicachefile" id="isapicachefile">Directive</a> <a title="Permanent link" href="#isapicachefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="isapicachefile"><span id="ISAPICacheFile">ISAPICacheFile</span> Directive <a title="Permanent link" href="#isapicachefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>ISAPI .dll files to be loaded at startup</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ISAPICacheFile <var>file-path</var> [<var>file-path</var>]
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ISAPIFakeAsync" id="ISAPIFakeAsync">ISAPIFakeAsync</a> <a name="isapifakeasync" id="isapifakeasync">Directive</a> <a title="Permanent link" href="#isapifakeasync" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="isapifakeasync"><span id="ISAPIFakeAsync">ISAPIFakeAsync</span> Directive <a title="Permanent link" href="#isapifakeasync" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fake asynchronous support for ISAPI callbacks</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ISAPIFakeAsync on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ISAPILogNotSupported" id="ISAPILogNotSupported">ISAPILogNotSupported</a> <a name="isapilognotsupported" id="isapilognotsupported">Directive</a> <a title="Permanent link" href="#isapilognotsupported" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="isapilognotsupported"><span id="ISAPILogNotSupported">ISAPILogNotSupported</span> Directive <a title="Permanent link" href="#isapilognotsupported" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Log unsupported feature requests from ISAPI
extensions</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ISAPIReadAheadBuffer" id="ISAPIReadAheadBuffer">ISAPIReadAheadBuffer</a> <a name="isapireadaheadbuffer" id="isapireadaheadbuffer">Directive</a> <a title="Permanent link" href="#isapireadaheadbuffer" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="isapireadaheadbuffer"><span id="ISAPIReadAheadBuffer">ISAPIReadAheadBuffer</span> Directive <a title="Permanent link" href="#isapireadaheadbuffer" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size of the Read Ahead Buffer sent to ISAPI
extensions</td></tr>
<a href="../ko/mod/mod_isapi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_journald">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_journald">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="structured" id="structured">Structured logging</a> <a title="Permanent link" href="#structured" class="permalink">¶</a></h2>
+<h2
id="structured">Structured logging <a title="Permanent link" href="#structured" class="permalink">¶</a></h2>
<p>Systemd-journald allows structured logging and therefore it is
possible to filter logged messages according to various variables.
<p>For more examples, see systemd-journalctl documentation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>Using <code>journald</code> in ErrorLog directive (see <code class="module"><a href="../mod/core.html">core</a></code>)
<a href="../fr/mod/mod_journald.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="busyness" id="busyness">Pending Request Counting Algorithm</a> <a title="Permanent link" href="#busyness" class="permalink">¶</a></h2>
+<h2
id="busyness">Pending Request Counting Algorithm <a title="Permanent link" href="#busyness" class="permalink">¶</a></h2>
<a href="../fr/mod/mod_lbmethod_bybusyness.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="requests" id="requests">Request Counting Algorithm</a> <a title="Permanent link" href="#requests" class="permalink">¶</a></h2>
+<h2
id="requests">Request Counting Algorithm <a title="Permanent link" href="#requests" class="permalink">¶</a></h2>
<p>Enabled via <code>lbmethod=byrequests</code>, the idea behind this
scheduler is that we distribute the requests among the
<a href="../fr/mod/mod_lbmethod_byrequests.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="traffic" id="traffic">Weighted Traffic Counting Algorithm</a> <a title="Permanent link" href="#traffic" class="permalink">¶</a></h2>
+<h2
id="traffic">Weighted Traffic Counting Algorithm <a title="Permanent link" href="#traffic" class="permalink">¶</a></h2>
<p>Enabled via <code>lbmethod=bytraffic</code>, the idea behind this
scheduler is very similar to the Request Counting method, with
<a href="../fr/mod/mod_lbmethod_bytraffic.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="HeartbeatStorage" id="HeartbeatStorage">HeartbeatStorage</a> <a name="heartbeatstorage" id="heartbeatstorage">Directive</a> <a title="Permanent link" href="#heartbeatstorage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="heartbeatstorage"><span id="HeartbeatStorage">HeartbeatStorage</span> Directive <a title="Permanent link" href="#heartbeatstorage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Path to read heartbeat data</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HeartbeatStorage <var>file-path</var></code></td></tr>
<a href="../fr/mod/mod_lbmethod_heartbeat.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_ldap">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_ldap">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="exampleconfig" id="exampleconfig">Example Configuration</a> <a title="Permanent link" href="#exampleconfig" class="permalink">¶</a></h2>
+<h2
id="exampleconfig">Example Configuration <a title="Permanent link" href="#exampleconfig" class="permalink">¶</a></h2>
<p>The following is an example configuration that uses
<code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> to increase the performance of HTTP Basic
authentication provided by <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="pool" id="pool">LDAP Connection Pool</a> <a title="Permanent link" href="#pool" class="permalink">¶</a></h2>
+<h2
id="pool">LDAP Connection Pool <a title="Permanent link" href="#pool" class="permalink">¶</a></h2>
<p>LDAP connections are pooled from request to request. This
allows the LDAP server to remain connected and bound ready for
directives. By default, this feature is enabled.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cache" id="cache">LDAP Cache</a> <a title="Permanent link" href="#cache" class="permalink">¶</a></h2>
+<h2
id="cache">LDAP Cache <a title="Permanent link" href="#cache" class="permalink">¶</a></h2>
<p>For improved performance, <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> uses an aggressive
caching strategy to minimize the number of times that the LDAP
caches</em>. Each LDAP URL that is used by the server has
its own set of these three caches.</p>
- <h3><a name="search-bind" id="search-bind">The Search/Bind Cache</a></h3>
+ <h3 id="search-bind">The Search/Bind Cache</h3>
<p>The process of doing a search and then a bind is the
most time-consuming aspect of LDAP operation, especially if
the directory is large. The search/bind cache is used to
<p>The search and bind cache is controlled with the <code class="directive"><a href="#ldapcacheentries">LDAPCacheEntries</a></code> and <code class="directive"><a href="#ldapcachettl">LDAPCacheTTL</a></code> directives.</p>
- <h3><a name="opcaches" id="opcaches">Operation Caches</a></h3>
+ <h3 id="opcaches">Operation Caches</h3>
<p>During attribute and distinguished name comparison
functions, <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> uses two operation caches
to cache the compare operations. The first compare cache is
directives.</p>
- <h3><a name="monitoring" id="monitoring">Monitoring the Cache</a></h3>
+ <h3 id="monitoring">Monitoring the Cache</h3>
<p><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> has a content handler that allows
administrators to monitor the cache performance. The name of
the content handler is <code>ldap-status</code>, so the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usingssltls" id="usingssltls">Using SSL/TLS</a> <a title="Permanent link" href="#usingssltls" class="permalink">¶</a></h2>
+<h2
id="usingssltls">Using SSL/TLS <a title="Permanent link" href="#usingssltls" class="permalink">¶</a></h2>
<p>The ability to create an SSL and TLS connections to an LDAP server
is defined by the directives
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="settingcerts" id="settingcerts">SSL/TLS Certificates</a> <a title="Permanent link" href="#settingcerts" class="permalink">¶</a></h2>
+<h2
id="settingcerts">SSL/TLS Certificates <a title="Permanent link" href="#settingcerts" class="permalink">¶</a></h2>
<p>The different LDAP SDKs have widely different methods of setting
and handling both CA and client side certificates.</p>
understand the differences between configurations on the different LDAP
toolkits supported.</p>
- <h3><a name="settingcerts-netscape" id="settingcerts-netscape">Netscape/Mozilla/iPlanet SDK</a></h3>
+ <h3 id="settingcerts-netscape">Netscape/Mozilla/iPlanet SDK</h3>
<p>CA certificates are specified within a file called cert7.db.
The SDK will not talk to any LDAP server whose certificate was
not signed by a CA specified in this file. If
- <h3><a name="settingcerts-openldap" id="settingcerts-openldap">OpenLDAP SDK</a></h3>
+ <h3 id="settingcerts-openldap">OpenLDAP SDK</h3>
<p>One or more CA certificates must be specified for the OpenLDAP
SDK to work correctly. These certificates can be specified as
- <h3><a name="settingcerts-solaris" id="settingcerts-solaris">Solaris SDK</a></h3>
+ <h3 id="settingcerts-solaris">Solaris SDK</h3>
<p>SSL/TLS for the native Solaris LDAP libraries is not yet
supported. If required, install and use the OpenLDAP libraries
- <h3><a name="settingcerts-microsoft" id="settingcerts-microsoft">Microsoft SDK</a></h3>
+ <h3 id="settingcerts-microsoft">Microsoft SDK</h3>
<p>SSL/TLS certificate configuration for the native Microsoft
LDAP libraries is done inside the system registry, and no
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPCacheEntries" id="LDAPCacheEntries">LDAPCacheEntries</a> <a name="ldapcacheentries" id="ldapcacheentries">Directive</a> <a title="Permanent link" href="#ldapcacheentries" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapcacheentries"><span id="LDAPCacheEntries">LDAPCacheEntries</span> Directive <a title="Permanent link" href="#ldapcacheentries" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of entries in the primary LDAP cache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPCacheEntries <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPCacheTTL" id="LDAPCacheTTL">LDAPCacheTTL</a> <a name="ldapcachettl" id="ldapcachettl">Directive</a> <a title="Permanent link" href="#ldapcachettl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapcachettl"><span id="LDAPCacheTTL">LDAPCacheTTL</span> Directive <a title="Permanent link" href="#ldapcachettl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Time that cached items remain valid</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPCacheTTL <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPConnectionPoolTTL" id="LDAPConnectionPoolTTL">LDAPConnectionPoolTTL</a> <a name="ldapconnectionpoolttl" id="ldapconnectionpoolttl">Directive</a> <a title="Permanent link" href="#ldapconnectionpoolttl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapconnectionpoolttl"><span id="LDAPConnectionPoolTTL">LDAPConnectionPoolTTL</span> Directive <a title="Permanent link" href="#ldapconnectionpoolttl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Discard backend connections that have been sitting in the connection pool too long</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPConnectionPoolTTL <var>n</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPConnectionTimeout" id="LDAPConnectionTimeout">LDAPConnectionTimeout</a> <a name="ldapconnectiontimeout" id="ldapconnectiontimeout">Directive</a> <a title="Permanent link" href="#ldapconnectiontimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapconnectiontimeout"><span id="LDAPConnectionTimeout">LDAPConnectionTimeout</span> Directive <a title="Permanent link" href="#ldapconnectiontimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the socket connection timeout in seconds</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPConnectionTimeout <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPLibraryDebug" id="LDAPLibraryDebug">LDAPLibraryDebug</a> <a name="ldaplibrarydebug" id="ldaplibrarydebug">Directive</a> <a title="Permanent link" href="#ldaplibrarydebug" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldaplibrarydebug"><span id="LDAPLibraryDebug">LDAPLibraryDebug</span> Directive <a title="Permanent link" href="#ldaplibrarydebug" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable debugging in the LDAP SDK</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPLibraryDebug <var>7</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPOpCacheEntries" id="LDAPOpCacheEntries">LDAPOpCacheEntries</a> <a name="ldapopcacheentries" id="ldapopcacheentries">Directive</a> <a title="Permanent link" href="#ldapopcacheentries" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapopcacheentries"><span id="LDAPOpCacheEntries">LDAPOpCacheEntries</span> Directive <a title="Permanent link" href="#ldapopcacheentries" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of entries used to cache LDAP compare
operations</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPOpCacheTTL" id="LDAPOpCacheTTL">LDAPOpCacheTTL</a> <a name="ldapopcachettl" id="ldapopcachettl">Directive</a> <a title="Permanent link" href="#ldapopcachettl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapopcachettl"><span id="LDAPOpCacheTTL">LDAPOpCacheTTL</span> Directive <a title="Permanent link" href="#ldapopcachettl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Time that entries in the operation cache remain
valid</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPReferralHopLimit" id="LDAPReferralHopLimit">LDAPReferralHopLimit</a> <a name="ldapreferralhoplimit" id="ldapreferralhoplimit">Directive</a> <a title="Permanent link" href="#ldapreferralhoplimit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapreferralhoplimit"><span id="LDAPReferralHopLimit">LDAPReferralHopLimit</span> Directive <a title="Permanent link" href="#ldapreferralhoplimit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum number of referral hops to chase before terminating an LDAP query.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPReferralHopLimit <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPReferrals" id="LDAPReferrals">LDAPReferrals</a> <a name="ldapreferrals" id="ldapreferrals">Directive</a> <a title="Permanent link" href="#ldapreferrals" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapreferrals"><span id="LDAPReferrals">LDAPReferrals</span> Directive <a title="Permanent link" href="#ldapreferrals" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable referral chasing during queries to the LDAP server.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPReferrals On|Off|default</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPRetries" id="LDAPRetries">LDAPRetries</a> <a name="ldapretries" id="ldapretries">Directive</a> <a title="Permanent link" href="#ldapretries" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapretries"><span id="LDAPRetries">LDAPRetries</span> Directive <a title="Permanent link" href="#ldapretries" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the number of LDAP server retries.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPRetries <var>number-of-retries</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPRetryDelay" id="LDAPRetryDelay">LDAPRetryDelay</a> <a name="ldapretrydelay" id="ldapretrydelay">Directive</a> <a title="Permanent link" href="#ldapretrydelay" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapretrydelay"><span id="LDAPRetryDelay">LDAPRetryDelay</span> Directive <a title="Permanent link" href="#ldapretrydelay" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the delay between LDAP server retries.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPRetryDelay <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPSharedCacheFile" id="LDAPSharedCacheFile">LDAPSharedCacheFile</a> <a name="ldapsharedcachefile" id="ldapsharedcachefile">Directive</a> <a title="Permanent link" href="#ldapsharedcachefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapsharedcachefile"><span id="LDAPSharedCacheFile">LDAPSharedCacheFile</span> Directive <a title="Permanent link" href="#ldapsharedcachefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the shared memory cache file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPSharedCacheFile <var>file-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPSharedCacheSize" id="LDAPSharedCacheSize">LDAPSharedCacheSize</a> <a name="ldapsharedcachesize" id="ldapsharedcachesize">Directive</a> <a title="Permanent link" href="#ldapsharedcachesize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapsharedcachesize"><span id="LDAPSharedCacheSize">LDAPSharedCacheSize</span> Directive <a title="Permanent link" href="#ldapsharedcachesize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size in bytes of the shared-memory cache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPSharedCacheSize <var>bytes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPTimeout" id="LDAPTimeout">LDAPTimeout</a> <a name="ldaptimeout" id="ldaptimeout">Directive</a> <a title="Permanent link" href="#ldaptimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldaptimeout"><span id="LDAPTimeout">LDAPTimeout</span> Directive <a title="Permanent link" href="#ldaptimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the timeout for LDAP search and bind operations, in seconds</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPTimeout <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPTrustedClientCert" id="LDAPTrustedClientCert">LDAPTrustedClientCert</a> <a name="ldaptrustedclientcert" id="ldaptrustedclientcert">Directive</a> <a title="Permanent link" href="#ldaptrustedclientcert" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldaptrustedclientcert"><span id="LDAPTrustedClientCert">LDAPTrustedClientCert</span> Directive <a title="Permanent link" href="#ldaptrustedclientcert" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the file containing or nickname referring to a per
connection client certificate. Not all LDAP toolkits support per
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPTrustedGlobalCert" id="LDAPTrustedGlobalCert">LDAPTrustedGlobalCert</a> <a name="ldaptrustedglobalcert" id="ldaptrustedglobalcert">Directive</a> <a title="Permanent link" href="#ldaptrustedglobalcert" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldaptrustedglobalcert"><span id="LDAPTrustedGlobalCert">LDAPTrustedGlobalCert</span> Directive <a title="Permanent link" href="#ldaptrustedglobalcert" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the file or database containing global trusted
Certificate Authority or global client certificates</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPTrustedMode" id="LDAPTrustedMode">LDAPTrustedMode</a> <a name="ldaptrustedmode" id="ldaptrustedmode">Directive</a> <a title="Permanent link" href="#ldaptrustedmode" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldaptrustedmode"><span id="LDAPTrustedMode">LDAPTrustedMode</span> Directive <a title="Permanent link" href="#ldaptrustedmode" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the SSL/TLS mode to be used when connecting to an LDAP server.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPTrustedMode <var>type</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LDAPVerifyServerCert" id="LDAPVerifyServerCert">LDAPVerifyServerCert</a> <a name="ldapverifyservercert" id="ldapverifyservercert">Directive</a> <a title="Permanent link" href="#ldapverifyservercert" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ldapverifyservercert"><span id="LDAPVerifyServerCert">LDAPVerifyServerCert</span> Directive <a title="Permanent link" href="#ldapverifyservercert" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force server certificate verification</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LDAPVerifyServerCert On|Off</code></td></tr>
<a href="../fr/mod/mod_ldap.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="formats" id="formats">Custom Log Formats</a> <a title="Permanent link" href="#formats" class="permalink">¶</a></h2>
+<h2
id="formats">Custom Log Formats <a title="Permanent link" href="#formats" class="permalink">¶</a></h2>
<p>The format argument to the <code class="directive"><a href="#logformat">LogFormat</a></code> and <code class="directive"><a href="#customlog">CustomLog</a></code> directives is a string. This string is
used to log each request to the log file. It can contain literal
in the response sent from the server. </td></tr>
</table>
- <h3><a name="modifiers" id="modifiers">Modifiers</a></h3>
+ <h3 id="modifiers">Modifiers</h3>
<p>Particular items can be restricted to print only for
responses with specific HTTP status codes by placing a
- <h3><a name="format-notes" id="format-notes">Format Notes</a></h3>
+ <h3 id="format-notes">Format Notes</h3>
<p>For security reasons, starting with version 2.0.46,
non-printable and other special characters in format strings
- <h3><a name="examples" id="examples">Examples</a></h3>
+ <h3 id="examples">Examples</h3>
<p>Some commonly used log format strings are:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Considerations</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Considerations <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>See the <a href="../misc/security_tips.html#serverroot">security tips</a>
document for details on why your security could be compromised
if the directory where logfiles are stored is writable by
anyone other than the user that starts the server.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">Directive</a> <a title="Permanent link" href="#bufferedlogs" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="bufferedlogs"><span id="BufferedLogs">BufferedLogs</span> Directive <a title="Permanent link" href="#bufferedlogs" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Buffer log entries in memory before writing to disk</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BufferedLogs On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">Directive</a> <a title="Permanent link" href="#customlog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="customlog"><span id="CustomLog">CustomLog</span> Directive <a title="Permanent link" href="#customlog" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets filename and format of log file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CustomLog <var>file</var>|<var>pipe</var>|<var>provider</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="GlobalLog" id="GlobalLog">GlobalLog</a> <a name="globallog" id="globallog">Directive</a> <a title="Permanent link" href="#globallog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="globallog"><span id="GlobalLog">GlobalLog</span> Directive <a title="Permanent link" href="#globallog" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets filename and format of log file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>GlobalLog <var>file</var>|<var>pipe</var>|<var>provider</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">Directive</a> <a title="Permanent link" href="#logformat" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="logformat"><span id="LogFormat">LogFormat</span> Directive <a title="Permanent link" href="#logformat" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Describes a format for use in a log file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogFormat <var>format</var>|<var>nickname</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">Directive</a> <a title="Permanent link" href="#transferlog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="transferlog"><span id="TransferLog">TransferLog</span> Directive <a title="Permanent link" href="#transferlog" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify location of a log file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TransferLog <var>file</var>|<var>pipe</var></code></td></tr>
<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_log_debug">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_log_debug">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<ol>
<li>
</ol>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LogMessage" id="LogMessage">LogMessage</a> <a name="logmessage" id="logmessage">Directive</a> <a title="Permanent link" href="#logmessage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="logmessage"><span id="LogMessage">LogMessage</span> Directive <a title="Permanent link" href="#logmessage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Log user-defined message to error log
</td></tr>
<a href="../fr/mod/mod_log_debug.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="formats" id="formats">Forensic Log Format</a> <a title="Permanent link" href="#formats" class="permalink">¶</a></h2>
+<h2
id="formats">Forensic Log Format <a title="Permanent link" href="#formats" class="permalink">¶</a></h2>
<p>Each request is logged two times. The first time is <em>before</em> it's
processed further (that is, after receiving the headers). The second log
entry is written <em>after</em> the request processing at the same time
and complains if a request was not completed.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Considerations</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Considerations <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>See the <a href="../misc/security_tips.html#serverroot">security tips</a>
document for details on why your security could be compromised
if the directory where logfiles are stored is writable by
server.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ForensicLog" id="ForensicLog">ForensicLog</a> <a name="forensiclog" id="forensiclog">Directive</a> <a title="Permanent link" href="#forensiclog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="forensiclog"><span id="ForensicLog">ForensicLog</span> Directive <a title="Permanent link" href="#forensiclog" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets filename of the forensic log</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForensicLog <var>filename</var>|<var>pipe</var></code></td></tr>
<a href="../tr/mod/mod_log_forensic.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="formats" id="formats">Custom Log Formats</a> <a title="Permanent link" href="#formats" class="permalink">¶</a></h2>
+<h2
id="formats">Custom Log Formats <a title="Permanent link" href="#formats" class="permalink">¶</a></h2>
<p>This module adds three new logging directives. The characteristics of the
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LogIOTrackTTFB" id="LogIOTrackTTFB">LogIOTrackTTFB</a> <a name="logiotrackttfb" id="logiotrackttfb">Directive</a> <a title="Permanent link" href="#logiotrackttfb" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="logiotrackttfb"><span id="LogIOTrackTTFB">LogIOTrackTTFB</span> Directive <a title="Permanent link" href="#logiotrackttfb" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable tracking of time to first byte (TTFB = time to first byte)
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LogIOTrackTTFU" id="LogIOTrackTTFU">LogIOTrackTTFU</a> <a name="logiotrackttfu" id="logiotrackttfu">Directive</a> <a title="Permanent link" href="#logiotrackttfu" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="logiotrackttfu"><span id="LogIOTrackTTFU">LogIOTrackTTFU</span> Directive <a title="Permanent link" href="#logiotrackttfu" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable tracking of time to last request byte (TTFU = time to finish
upload)</td></tr>
<a href="../tr/mod/mod_logio.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_lua">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_lua">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basicconf" id="basicconf">Basic Configuration</a> <a title="Permanent link" href="#basicconf" class="permalink">¶</a></h2>
+<h2
id="basicconf">Basic Configuration <a title="Permanent link" href="#basicconf" class="permalink">¶</a></h2>
<p>The basic module loading directive is</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="writinghandlers" id="writinghandlers">Writing Handlers</a> <a title="Permanent link" href="#writinghandlers" class="permalink">¶</a></h2>
+<h2
id="writinghandlers">Writing Handlers <a title="Permanent link" href="#writinghandlers" class="permalink">¶</a></h2>
<p> In the Apache HTTP Server API, the handler is a specific kind of hook
responsible for generating the response. Examples of modules that include a
handler are <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>,
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="writingauthzproviders" id="writingauthzproviders">Writing Authorization Providers</a> <a title="Permanent link" href="#writingauthzproviders" class="permalink">¶</a></h2>
+<h2
id="writingauthzproviders">Writing Authorization Providers <a title="Permanent link" href="#writingauthzproviders" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> provides a high-level interface to
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="writinghooks" id="writinghooks">Writing Hooks</a> <a title="Permanent link" href="#writinghooks" class="permalink">¶</a></h2>
+<h2
id="writinghooks">Writing Hooks <a title="Permanent link" href="#writinghooks" class="permalink">¶</a></h2>
<p>Hook functions are how modules (and Lua scripts) participate in the
processing of requests. Each type of hook exposed by the server exists for
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="datastructures" id="datastructures">Data Structures</a> <a title="Permanent link" href="#datastructures" class="permalink">¶</a></h2>
+<h2
id="datastructures">Data Structures <a title="Permanent link" href="#datastructures" class="permalink">¶</a></h2>
<dl>
<dt>request_rec</dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="functions" id="functions">Built in functions</a> <a title="Permanent link" href="#functions" class="permalink">¶</a></h2>
+<h2
id="functions">Built in functions <a title="Permanent link" href="#functions" class="permalink">¶</a></h2>
<p>The request_rec object has (at least) the following methods:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logging" id="logging">Logging Functions</a> <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
+<h2
id="logging">Logging Functions <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
<pre class="prettyprint lang-lua">-- examples of logging messages
r:trace1("This is a trace log message") -- trace1 through trace8 can be used
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="apache2" id="apache2">apache2 Package</a> <a title="Permanent link" href="#apache2" class="permalink">¶</a></h2>
+<h2
id="apache2">apache2 Package <a title="Permanent link" href="#apache2" class="permalink">¶</a></h2>
<p>A package named <code>apache2</code> is available with (at least) the following contents.</p>
<dl>
<dt>apache2.OK</dt>
<p>(Other HTTP status codes are not yet implemented.)</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="modifying_buckets" id="modifying_buckets">Modifying contents with Lua filters</a> <a title="Permanent link" href="#modifying_buckets" class="permalink">¶</a></h2>
+<h2
id="modifying_buckets">Modifying contents with Lua filters <a title="Permanent link" href="#modifying_buckets" class="permalink">¶</a></h2>
<p>
Filter functions implemented via <code class="directive"><a href="#luainputfilter">LuaInputFilter</a></code>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="databases" id="databases">Database connectivity</a> <a title="Permanent link" href="#databases" class="permalink">¶</a></h2>
+<h2
id="databases">Database connectivity <a title="Permanent link" href="#databases" class="permalink">¶</a></h2>
<p>
Mod_lua implements a simple database feature for querying and running commands
</p>
<pre class="prettyprint lang-lua">local database = r:dbacquire("mod_dbd")</pre>
- <h3><a name="database_object" id="database_object">Database object and contained functions</a></h3>
+ <h3 id="database_object">Database object and contained functions</h3>
<p>The database object returned by <code>dbacquire</code> has the following methods:</p>
<p><strong>Normal select and query from a database:</strong></p>
local connected = database:active()</pre>
- <h3><a name="result_sets" id="result_sets">Working with result sets</a></h3>
+ <h3 id="result_sets">Working with result sets</h3>
<p>The result set returned by <code>db:select</code> or by the prepared statement functions
created through <code>db:prepare</code> can be used to
end</pre>
- <h3><a name="closing_databases" id="closing_databases">Closing a database connection</a></h3>
+ <h3 id="closing_databases">Closing a database connection</h3>
<p>Database handles should be closed using <code>database:close()</code> when they are no longer
collectgarbage() -- close the handle via GC</pre>
- <h3><a name="database_caveat" id="database_caveat">Precautions when working with databases</a></h3>
+ <h3 id="database_caveat">Precautions when working with databases</h3>
<p>Although the standard <code>query</code> and <code>run</code> functions are freely
available, it is recommended that you use prepared statements whenever possible, to
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaAuthzProvider" id="LuaAuthzProvider">LuaAuthzProvider</a> <a name="luaauthzprovider" id="luaauthzprovider">Directive</a> <a title="Permanent link" href="#luaauthzprovider" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luaauthzprovider"><span id="LuaAuthzProvider">LuaAuthzProvider</span> Directive <a title="Permanent link" href="#luaauthzprovider" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Plug an authorization provider function into <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaCodeCache" id="LuaCodeCache">LuaCodeCache</a> <a name="luacodecache" id="luacodecache">Directive</a> <a title="Permanent link" href="#luacodecache" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luacodecache"><span id="LuaCodeCache">LuaCodeCache</span> Directive <a title="Permanent link" href="#luacodecache" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure the compiled code cache.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaCodeCache stat|forever|never</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookAccessChecker" id="LuaHookAccessChecker">LuaHookAccessChecker</a> <a name="luahookaccesschecker" id="luahookaccesschecker">Directive</a> <a title="Permanent link" href="#luahookaccesschecker" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahookaccesschecker"><span id="LuaHookAccessChecker">LuaHookAccessChecker</span> Directive <a title="Permanent link" href="#luahookaccesschecker" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the access_checker phase of request processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookAuthChecker" id="LuaHookAuthChecker">LuaHookAuthChecker</a> <a name="luahookauthchecker" id="luahookauthchecker">Directive</a> <a title="Permanent link" href="#luahookauthchecker" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahookauthchecker"><span id="LuaHookAuthChecker">LuaHookAuthChecker</span> Directive <a title="Permanent link" href="#luahookauthchecker" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the auth_checker phase of request processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookCheckUserID" id="LuaHookCheckUserID">LuaHookCheckUserID</a> <a name="luahookcheckuserid" id="luahookcheckuserid">Directive</a> <a title="Permanent link" href="#luahookcheckuserid" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahookcheckuserid"><span id="LuaHookCheckUserID">LuaHookCheckUserID</span> Directive <a title="Permanent link" href="#luahookcheckuserid" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the check_user_id phase of request processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaHookCheckUserID /path/to/lua/script.lua hook_function_name</code></td></tr>
</table>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookFixups" id="LuaHookFixups">LuaHookFixups</a> <a name="luahookfixups" id="luahookfixups">Directive</a> <a title="Permanent link" href="#luahookfixups" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahookfixups"><span id="LuaHookFixups">LuaHookFixups</span> Directive <a title="Permanent link" href="#luahookfixups" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the fixups phase of a request
processing</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookInsertFilter" id="LuaHookInsertFilter">LuaHookInsertFilter</a> <a name="luahookinsertfilter" id="luahookinsertfilter">Directive</a> <a title="Permanent link" href="#luahookinsertfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahookinsertfilter"><span id="LuaHookInsertFilter">LuaHookInsertFilter</span> Directive <a title="Permanent link" href="#luahookinsertfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the insert_filter phase of request processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaHookInsertFilter /path/to/lua/script.lua hook_function_name</code></td></tr>
</table><p>Not Yet Implemented</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookLog" id="LuaHookLog">LuaHookLog</a> <a name="luahooklog" id="luahooklog">Directive</a> <a title="Permanent link" href="#luahooklog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahooklog"><span id="LuaHookLog">LuaHookLog</span> Directive <a title="Permanent link" href="#luahooklog" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the access log phase of a request
processing</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookMapToStorage" id="LuaHookMapToStorage">LuaHookMapToStorage</a> <a name="luahookmaptostorage" id="luahookmaptostorage">Directive</a> <a title="Permanent link" href="#luahookmaptostorage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahookmaptostorage"><span id="LuaHookMapToStorage">LuaHookMapToStorage</span> Directive <a title="Permanent link" href="#luahookmaptostorage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the map_to_storage phase of request processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaHookMapToStorage /path/to/lua/script.lua hook_function_name</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookPreTranslate" id="LuaHookPreTranslate">LuaHookPreTranslate</a> <a name="luahookpretranslate" id="luahookpretranslate">Directive</a> <a title="Permanent link" href="#luahookpretranslate" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahookpretranslate"><span id="LuaHookPreTranslate">LuaHookPreTranslate</span> Directive <a title="Permanent link" href="#luahookpretranslate" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the pre_translate phase of a request
processing</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookTranslateName" id="LuaHookTranslateName">LuaHookTranslateName</a> <a name="luahooktranslatename" id="luahooktranslatename">Directive</a> <a title="Permanent link" href="#luahooktranslatename" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahooktranslatename"><span id="LuaHookTranslateName">LuaHookTranslateName</span> Directive <a title="Permanent link" href="#luahooktranslatename" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the translate name phase of request processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaHookTypeChecker" id="LuaHookTypeChecker">LuaHookTypeChecker</a> <a name="luahooktypechecker" id="luahooktypechecker">Directive</a> <a title="Permanent link" href="#luahooktypechecker" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luahooktypechecker"><span id="LuaHookTypeChecker">LuaHookTypeChecker</span> Directive <a title="Permanent link" href="#luahooktypechecker" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the type_checker phase of request processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaHookTypeChecker /path/to/lua/script.lua hook_function_name</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaInherit" id="LuaInherit">LuaInherit</a> <a name="luainherit" id="luainherit">Directive</a> <a title="Permanent link" href="#luainherit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luainherit"><span id="LuaInherit">LuaInherit</span> Directive <a title="Permanent link" href="#luainherit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls how parent configuration sections are merged into children</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaInherit none|parent-first|parent-last</code></td></tr>
directives from parent configuration sections.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaInputFilter" id="LuaInputFilter">LuaInputFilter</a> <a name="luainputfilter" id="luainputfilter">Directive</a> <a title="Permanent link" href="#luainputfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luainputfilter"><span id="LuaInputFilter">LuaInputFilter</span> Directive <a title="Permanent link" href="#luainputfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a Lua function for content input filtering</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaInputFilter filter_name /path/to/lua/script.lua function_name</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaMapHandler" id="LuaMapHandler">LuaMapHandler</a> <a name="luamaphandler" id="luamaphandler">Directive</a> <a title="Permanent link" href="#luamaphandler" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luamaphandler"><span id="LuaMapHandler">LuaMapHandler</span> Directive <a title="Permanent link" href="#luamaphandler" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Map a path to a lua handler</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaOutputFilter" id="LuaOutputFilter">LuaOutputFilter</a> <a name="luaoutputfilter" id="luaoutputfilter">Directive</a> <a title="Permanent link" href="#luaoutputfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luaoutputfilter"><span id="LuaOutputFilter">LuaOutputFilter</span> Directive <a title="Permanent link" href="#luaoutputfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a Lua function for content output filtering</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaOutputFilter filter_name /path/to/lua/script.lua function_name</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaPackageCPath" id="LuaPackageCPath">LuaPackageCPath</a> <a name="luapackagecpath" id="luapackagecpath">Directive</a> <a title="Permanent link" href="#luapackagecpath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luapackagecpath"><span id="LuaPackageCPath">LuaPackageCPath</span> Directive <a title="Permanent link" href="#luapackagecpath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add a directory to lua's package.cpath</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaPackageCPath /path/to/include/?.soa</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaPackagePath" id="LuaPackagePath">LuaPackagePath</a> <a name="luapackagepath" id="luapackagepath">Directive</a> <a title="Permanent link" href="#luapackagepath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luapackagepath"><span id="LuaPackagePath">LuaPackagePath</span> Directive <a title="Permanent link" href="#luapackagepath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add a directory to lua's package.path</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaPackagePath /path/to/include/?.lua</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaQuickHandler" id="LuaQuickHandler">LuaQuickHandler</a> <a name="luaquickhandler" id="luaquickhandler">Directive</a> <a title="Permanent link" href="#luaquickhandler" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luaquickhandler"><span id="LuaQuickHandler">LuaQuickHandler</span> Directive <a title="Permanent link" href="#luaquickhandler" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the quick handler of request processing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaQuickHandler /path/to/script.lua hook_function_name</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaRoot" id="LuaRoot">LuaRoot</a> <a name="luaroot" id="luaroot">Directive</a> <a title="Permanent link" href="#luaroot" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luaroot"><span id="LuaRoot">LuaRoot</span> Directive <a title="Permanent link" href="#luaroot" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify the base path for resolving relative paths for <code class="module"><a href="../mod/mod_lua.html">mod_lua</a></code> directives</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaRoot /path/to/a/directory</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LuaScope" id="LuaScope">LuaScope</a> <a name="luascope" id="luascope">Directive</a> <a title="Permanent link" href="#luascope" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="luascope"><span id="LuaScope">LuaScope</span> Directive <a title="Permanent link" href="#luascope" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>One of once, request, conn, thread -- default is once</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LuaScope once|request|conn|thread|server [min] [max]</code></td></tr>
<a href="../fr/mod/mod_lua.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_macro">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_macro">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usage" id="usage">Usage</a> <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
+<h2
id="usage">Usage <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
<p>Macros are defined using <code class="directive"><a href="#macro"><Macro></a></code> blocks, which contain the portion of
your configuration that needs to be repeated, complete with variables
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="tips" id="tips">Tips</a> <a title="Permanent link" href="#tips" class="permalink">¶</a></h2>
+<h2
id="tips">Tips <a title="Permanent link" href="#tips" class="permalink">¶</a></h2>
<p>Parameter names should begin with a sigil such as <code>$</code>,
<code>%</code>, or <code>@</code>, so that they are clearly
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<h3>Virtual Host Definition</h3>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Macro" id="Macro"><Macro></a> <a name="macro" id="macro">Directive</a> <a title="Permanent link" href="#macro" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="macro"><span id="Macro"><Macro></span> Directive <a title="Permanent link" href="#macro" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a configuration file macro</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MacroIgnoreBadNesting" id="MacroIgnoreBadNesting">MacroIgnoreBadNesting</a> <a name="macroignorebadnesting" id="macroignorebadnesting">Directive</a> <a title="Permanent link" href="#macroignorebadnesting" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="macroignorebadnesting"><span id="MacroIgnoreBadNesting">MacroIgnoreBadNesting</span> Directive <a title="Permanent link" href="#macroignorebadnesting" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore warnings, and does not log, about bad nesting of Macros</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MacroIgnoreBadNesting</code></td></tr>
</table>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MacroIgnoreEmptyArgs" id="MacroIgnoreEmptyArgs">MacroIgnoreEmptyArgs</a> <a name="macroignoreemptyargs" id="macroignoreemptyargs">Directive</a> <a title="Permanent link" href="#macroignoreemptyargs" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="macroignoreemptyargs"><span id="MacroIgnoreEmptyArgs">MacroIgnoreEmptyArgs</span> Directive <a title="Permanent link" href="#macroignoreemptyargs" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore warnings, and does not log, about empty Macro argument(s)</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MacroIgnoreEmptyArgs</code></td></tr>
</table>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="UndefMacro" id="UndefMacro">UndefMacro</a> <a name="undefmacro" id="undefmacro">Directive</a> <a title="Permanent link" href="#undefmacro" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="undefmacro"><span id="UndefMacro">UndefMacro</span> Directive <a title="Permanent link" href="#undefmacro" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Undefine a macro</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UndefMacro <var>name</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Use" id="Use">Use</a> <a name="use" id="use">Directive</a> <a title="Permanent link" href="#use" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="use"><span id="Use">Use</span> Directive <a title="Permanent link" href="#use" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use a macro</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Use <var>name</var> [<var>value1</var> ... <var>valueN</var>]
<a href="../fr/mod/mod_macro.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_md">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_md">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDActivationDelay" id="MDActivationDelay">MDActivationDelay</a> <a name="mdactivationdelay" id="mdactivationdelay">Directive</a> <a title="Permanent link" href="#mdactivationdelay" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdactivationdelay"><span id="MDActivationDelay">MDActivationDelay</span> Directive <a title="Permanent link" href="#mdactivationdelay" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How long to delay activation of new certificates</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDActivationDelay <var>duration</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDBaseServer" id="MDBaseServer">MDBaseServer</a> <a name="mdbaseserver" id="mdbaseserver">Directive</a> <a title="Permanent link" href="#mdbaseserver" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdbaseserver"><span id="MDBaseServer">MDBaseServer</span> Directive <a title="Permanent link" href="#mdbaseserver" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control if base server may be managed or only virtual hosts.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDBaseServer on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCACertificateFile" id="MDCACertificateFile">MDCACertificateFile</a> <a name="mdcacertificatefile" id="mdcacertificatefile">Directive</a> <a title="Permanent link" href="#mdcacertificatefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcacertificatefile"><span id="MDCACertificateFile">MDCACertificateFile</span> Directive <a title="Permanent link" href="#mdcacertificatefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File containing x509 trust anchors to verify ACME servers.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCACertificateFile <var>file</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCAChallenges" id="MDCAChallenges">MDCAChallenges</a> <a name="mdcachallenges" id="mdcachallenges">Directive</a> <a title="Permanent link" href="#mdcachallenges" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcachallenges"><span id="MDCAChallenges">MDCAChallenges</span> Directive <a title="Permanent link" href="#mdcachallenges" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of ACME challenge used to prove domain ownership.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCAChallenges <var>name</var> [ <var>name</var> ... ]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCertificateAgreement" id="MDCertificateAgreement">MDCertificateAgreement</a> <a name="mdcertificateagreement" id="mdcertificateagreement">Directive</a> <a title="Permanent link" href="#mdcertificateagreement" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcertificateagreement"><span id="MDCertificateAgreement">MDCertificateAgreement</span> Directive <a title="Permanent link" href="#mdcertificateagreement" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>You confirm that you accepted the Terms of Service of the Certificate
Authority.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCertificateAuthority" id="MDCertificateAuthority">MDCertificateAuthority</a> <a name="mdcertificateauthority" id="mdcertificateauthority">Directive</a> <a title="Permanent link" href="#mdcertificateauthority" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcertificateauthority"><span id="MDCertificateAuthority">MDCertificateAuthority</span> Directive <a title="Permanent link" href="#mdcertificateauthority" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The URL(s) of the ACME Certificate Authority to use.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCertificateAuthority <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCertificateCheck" id="MDCertificateCheck">MDCertificateCheck</a> <a name="mdcertificatecheck" id="mdcertificatecheck">Directive</a> <a title="Permanent link" href="#mdcertificatecheck" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcertificatecheck"><span id="MDCertificateCheck">MDCertificateCheck</span> Directive <a title="Permanent link" href="#mdcertificatecheck" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set name and URL pattern for a certificate monitoring site.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCertificateCheck <var>name</var> <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCertificateFile" id="MDCertificateFile">MDCertificateFile</a> <a name="mdcertificatefile" id="mdcertificatefile">Directive</a> <a title="Permanent link" href="#mdcertificatefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcertificatefile"><span id="MDCertificateFile">MDCertificateFile</span> Directive <a title="Permanent link" href="#mdcertificatefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a static certificate file for the MD.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCertificateFile <var>path-to-pem-file</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCertificateKeyFile" id="MDCertificateKeyFile">MDCertificateKeyFile</a> <a name="mdcertificatekeyfile" id="mdcertificatekeyfile">Directive</a> <a title="Permanent link" href="#mdcertificatekeyfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcertificatekeyfile"><span id="MDCertificateKeyFile">MDCertificateKeyFile</span> Directive <a title="Permanent link" href="#mdcertificatekeyfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a static private key for for the static cerrtificate.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCertificateKeyFile <var>path-to-file</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCertificateMonitor" id="MDCertificateMonitor">MDCertificateMonitor</a> <a name="mdcertificatemonitor" id="mdcertificatemonitor">Directive</a> <a title="Permanent link" href="#mdcertificatemonitor" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcertificatemonitor"><span id="MDCertificateMonitor">MDCertificateMonitor</span> Directive <a title="Permanent link" href="#mdcertificatemonitor" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The URL of a certificate log monitor.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCertificateMonitor name url</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCertificateProtocol" id="MDCertificateProtocol">MDCertificateProtocol</a> <a name="mdcertificateprotocol" id="mdcertificateprotocol">Directive</a> <a title="Permanent link" href="#mdcertificateprotocol" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcertificateprotocol"><span id="MDCertificateProtocol">MDCertificateProtocol</span> Directive <a title="Permanent link" href="#mdcertificateprotocol" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The protocol to use with the Certificate Authority.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCertificateProtocol <var>protocol</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCertificateStatus" id="MDCertificateStatus">MDCertificateStatus</a> <a name="mdcertificatestatus" id="mdcertificatestatus">Directive</a> <a title="Permanent link" href="#mdcertificatestatus" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcertificatestatus"><span id="MDCertificateStatus">MDCertificateStatus</span> Directive <a title="Permanent link" href="#mdcertificatestatus" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Exposes public certificate information in JSON.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCertificateStatus on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDChallengeDns01" id="MDChallengeDns01">MDChallengeDns01</a> <a name="mdchallengedns01" id="mdchallengedns01">Directive</a> <a title="Permanent link" href="#mdchallengedns01" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdchallengedns01"><span id="MDChallengeDns01">MDChallengeDns01</span> Directive <a title="Permanent link" href="#mdchallengedns01" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the command for setup/teardown of dns-01 challenges</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDChallengeDns01 <var>path-to-command</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDChallengeDns01Version" id="MDChallengeDns01Version">MDChallengeDns01Version</a> <a name="mdchallengedns01version" id="mdchallengedns01version">Directive</a> <a title="Permanent link" href="#mdchallengedns01version" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdchallengedns01version"><span id="MDChallengeDns01Version">MDChallengeDns01Version</span> Directive <a title="Permanent link" href="#mdchallengedns01version" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the type of arguments to call MDChallengeDns01 with</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDChallengeDns01Version 1|2</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDCheckInterval" id="MDCheckInterval">MDCheckInterval</a> <a name="mdcheckinterval" id="mdcheckinterval">Directive</a> <a title="Permanent link" href="#mdcheckinterval" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcheckinterval"><span id="MDCheckInterval">MDCheckInterval</span> Directive <a title="Permanent link" href="#mdcheckinterval" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines how often certificates are checked</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDCheckInterval <var>duration</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDContactEmail" id="MDContactEmail">MDContactEmail</a> <a name="mdcontactemail" id="mdcontactemail">Directive</a> <a title="Permanent link" href="#mdcontactemail" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdcontactemail"><span id="MDContactEmail">MDContactEmail</span> Directive <a title="Permanent link" href="#mdcontactemail" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Email address used for account registration</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDContactEmail <var>address</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDDriveMode" id="MDDriveMode">MDDriveMode</a> <a name="mddrivemode" id="mddrivemode">Directive</a> <a title="Permanent link" href="#mddrivemode" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mddrivemode"><span id="MDDriveMode">MDDriveMode</span> Directive <a title="Permanent link" href="#mddrivemode" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>former name of MDRenewMode.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDDriveMode always|auto|manual</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDExternalAccountBinding" id="MDExternalAccountBinding">MDExternalAccountBinding</a> <a name="mdexternalaccountbinding" id="mdexternalaccountbinding">Directive</a> <a title="Permanent link" href="#mdexternalaccountbinding" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdexternalaccountbinding"><span id="MDExternalAccountBinding">MDExternalAccountBinding</span> Directive <a title="Permanent link" href="#mdexternalaccountbinding" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the external account binding keyid and hmac values to use at CA</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDExternalAccountBinding <var>key-id</var> <var>hmac-64</var> | none | <var>file</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDHttpProxy" id="MDHttpProxy">MDHttpProxy</a> <a name="mdhttpproxy" id="mdhttpproxy">Directive</a> <a title="Permanent link" href="#mdhttpproxy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdhttpproxy"><span id="MDHttpProxy">MDHttpProxy</span> Directive <a title="Permanent link" href="#mdhttpproxy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a proxy for outgoing connections.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDHttpProxy <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDInitialDelay" id="MDInitialDelay">MDInitialDelay</a> <a name="mdinitialdelay" id="mdinitialdelay">Directive</a> <a title="Permanent link" href="#mdinitialdelay" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdinitialdelay"><span id="MDInitialDelay">MDInitialDelay</span> Directive <a title="Permanent link" href="#mdinitialdelay" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How long to delay the first certificate check.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDInitialDelay <var>duration</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDMatchNames" id="MDMatchNames">MDMatchNames</a> <a name="mdmatchnames" id="mdmatchnames">Directive</a> <a title="Permanent link" href="#mdmatchnames" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdmatchnames"><span id="MDMatchNames">MDMatchNames</span> Directive <a title="Permanent link" href="#mdmatchnames" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines how DNS names are matched to vhosts</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDMatchNames all|servernames</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDMember" id="MDMember">MDMember</a> <a name="mdmember" id="mdmember">Directive</a> <a title="Permanent link" href="#mdmember" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdmember"><span id="MDMember">MDMember</span> Directive <a title="Permanent link" href="#mdmember" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Additional hostname for the managed domain.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDMember <var>hostname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDMembers" id="MDMembers">MDMembers</a> <a name="mdmembers" id="mdmembers">Directive</a> <a title="Permanent link" href="#mdmembers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdmembers"><span id="MDMembers">MDMembers</span> Directive <a title="Permanent link" href="#mdmembers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control if the alias domain names are automatically added.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDMembers auto|manual</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDMessageCmd" id="MDMessageCmd">MDMessageCmd</a> <a name="mdmessagecmd" id="mdmessagecmd">Directive</a> <a title="Permanent link" href="#mdmessagecmd" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdmessagecmd"><span id="MDMessageCmd">MDMessageCmd</span> Directive <a title="Permanent link" href="#mdmessagecmd" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Handle events for Manage Domains</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDMessageCmd <var>path-to-cmd</var> <var>optional-args</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDMustStaple" id="MDMustStaple">MDMustStaple</a> <a name="mdmuststaple" id="mdmuststaple">Directive</a> <a title="Permanent link" href="#mdmuststaple" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdmuststaple"><span id="MDMustStaple">MDMustStaple</span> Directive <a title="Permanent link" href="#mdmuststaple" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control if new certificates carry the OCSP Must Staple flag.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDMustStaple on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDNotifyCmd" id="MDNotifyCmd">MDNotifyCmd</a> <a name="mdnotifycmd" id="mdnotifycmd">Directive</a> <a title="Permanent link" href="#mdnotifycmd" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdnotifycmd"><span id="MDNotifyCmd">MDNotifyCmd</span> Directive <a title="Permanent link" href="#mdnotifycmd" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Run a program when a Managed Domain is ready.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDNotifyCmd <var>path</var> [ <var>args</var> ]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDomain" id="MDomain">MDomain</a> <a name="mdomain" id="mdomain">Directive</a> <a title="Permanent link" href="#mdomain" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdomain"><span id="MDomain">MDomain</span> Directive <a title="Permanent link" href="#mdomain" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define list of domain names that belong to one group.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDomain <var>dns-name</var> [ <var>other-dns-name</var>... ] [auto|manual]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDomainSetsection" id="MDomainSetsection"><MDomainSet></a> <a name="mdomainsetsection" id="mdomainsetsection">Directive</a> <a title="Permanent link" href="#mdomainsetsection" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdomainsetsection"><span id="MDomainSetsection"><MDomainSet></span> Directive <a title="Permanent link" href="#mdomainsetsection" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Container for directives applied to the same managed domains.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><MDomainSet <var>dns-name</var> [ <var>other-dns-name</var>... ]>...</MDomainSet></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDPortMap" id="MDPortMap">MDPortMap</a> <a name="mdportmap" id="mdportmap">Directive</a> <a title="Permanent link" href="#mdportmap" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdportmap"><span id="MDPortMap">MDPortMap</span> Directive <a title="Permanent link" href="#mdportmap" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Map external to internal ports for domain ownership verification.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDPortMap <var>map1</var> [ <var>map2</var> ]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDPrivateKeys" id="MDPrivateKeys">MDPrivateKeys</a> <a name="mdprivatekeys" id="mdprivatekeys">Directive</a> <a title="Permanent link" href="#mdprivatekeys" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdprivatekeys"><span id="MDPrivateKeys">MDPrivateKeys</span> Directive <a title="Permanent link" href="#mdprivatekeys" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set type and size of the private keys generated.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDPrivateKeys <var>type</var> [ <var>params</var>... ]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDProfile" id="MDProfile">MDProfile</a> <a name="mdprofile" id="mdprofile">Directive</a> <a title="Permanent link" href="#mdprofile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdprofile"><span id="MDProfile">MDProfile</span> Directive <a title="Permanent link" href="#mdprofile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use a specific ACME profile from the CA</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDProfile name</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDProfileMandatory" id="MDProfileMandatory">MDProfileMandatory</a> <a name="mdprofilemandatory" id="mdprofilemandatory">Directive</a> <a title="Permanent link" href="#mdprofilemandatory" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdprofilemandatory"><span id="MDProfileMandatory">MDProfileMandatory</span> Directive <a title="Permanent link" href="#mdprofilemandatory" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control if an MDProfile is mandatory.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDProfileMandatory on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDRenewMode" id="MDRenewMode">MDRenewMode</a> <a name="mdrenewmode" id="mdrenewmode">Directive</a> <a title="Permanent link" href="#mdrenewmode" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdrenewmode"><span id="MDRenewMode">MDRenewMode</span> Directive <a title="Permanent link" href="#mdrenewmode" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls if certificates shall be renewed.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDRenewMode always|auto|manual</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDRenewViaARI" id="MDRenewViaARI">MDRenewViaARI</a> <a name="mdrenewviaari" id="mdrenewviaari">Directive</a> <a title="Permanent link" href="#mdrenewviaari" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdrenewviaari"><span id="MDRenewViaARI">MDRenewViaARI</span> Directive <a title="Permanent link" href="#mdrenewviaari" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>usage of the ACME ARI extension (rfc9773).</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDRenewViaARI on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDRenewWindow" id="MDRenewWindow">MDRenewWindow</a> <a name="mdrenewwindow" id="mdrenewwindow">Directive</a> <a title="Permanent link" href="#mdrenewwindow" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdrenewwindow"><span id="MDRenewWindow">MDRenewWindow</span> Directive <a title="Permanent link" href="#mdrenewwindow" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control when a certificate will be renewed.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDRenewWindow <var>duration</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDRequireHttps" id="MDRequireHttps">MDRequireHttps</a> <a name="mdrequirehttps" id="mdrequirehttps">Directive</a> <a title="Permanent link" href="#mdrequirehttps" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdrequirehttps"><span id="MDRequireHttps">MDRequireHttps</span> Directive <a title="Permanent link" href="#mdrequirehttps" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Redirects http: traffic to https: for Managed Domains.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDRequireHttps off|temporary|permanent</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDRetryDelay" id="MDRetryDelay">MDRetryDelay</a> <a name="mdretrydelay" id="mdretrydelay">Directive</a> <a title="Permanent link" href="#mdretrydelay" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdretrydelay"><span id="MDRetryDelay">MDRetryDelay</span> Directive <a title="Permanent link" href="#mdretrydelay" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Time length for first retry, doubled on every consecutive error.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDRetryDelay <var>duration</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDRetryFailover" id="MDRetryFailover">MDRetryFailover</a> <a name="mdretryfailover" id="mdretryfailover">Directive</a> <a title="Permanent link" href="#mdretryfailover" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdretryfailover"><span id="MDRetryFailover">MDRetryFailover</span> Directive <a title="Permanent link" href="#mdretryfailover" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The number of errors before a failover to another CA is triggered</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDRetryFailover <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDServerStatus" id="MDServerStatus">MDServerStatus</a> <a name="mdserverstatus" id="mdserverstatus">Directive</a> <a title="Permanent link" href="#mdserverstatus" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdserverstatus"><span id="MDServerStatus">MDServerStatus</span> Directive <a title="Permanent link" href="#mdserverstatus" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control if Managed Domain information is added to server-status.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDServerStatus on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDStapleOthers" id="MDStapleOthers">MDStapleOthers</a> <a name="mdstapleothers" id="mdstapleothers">Directive</a> <a title="Permanent link" href="#mdstapleothers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdstapleothers"><span id="MDStapleOthers">MDStapleOthers</span> Directive <a title="Permanent link" href="#mdstapleothers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable stapling for certificates not managed by mod_md.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDStapleOthers on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDStapling" id="MDStapling">MDStapling</a> <a name="mdstapling" id="mdstapling">Directive</a> <a title="Permanent link" href="#mdstapling" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdstapling"><span id="MDStapling">MDStapling</span> Directive <a title="Permanent link" href="#mdstapling" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable stapling for all or a particular MDomain.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDStapling on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDStaplingKeepResponse" id="MDStaplingKeepResponse">MDStaplingKeepResponse</a> <a name="mdstaplingkeepresponse" id="mdstaplingkeepresponse">Directive</a> <a title="Permanent link" href="#mdstaplingkeepresponse" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdstaplingkeepresponse"><span id="MDStaplingKeepResponse">MDStaplingKeepResponse</span> Directive <a title="Permanent link" href="#mdstaplingkeepresponse" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls when old responses should be removed.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDStaplingKeepResponse <var>duration</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDStaplingRenewWindow" id="MDStaplingRenewWindow">MDStaplingRenewWindow</a> <a name="mdstaplingrenewwindow" id="mdstaplingrenewwindow">Directive</a> <a title="Permanent link" href="#mdstaplingrenewwindow" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdstaplingrenewwindow"><span id="MDStaplingRenewWindow">MDStaplingRenewWindow</span> Directive <a title="Permanent link" href="#mdstaplingrenewwindow" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control when the stapling responses will be renewed.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDStaplingRenewWindow <var>duration</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDStoreDir" id="MDStoreDir">MDStoreDir</a> <a name="mdstoredir" id="mdstoredir">Directive</a> <a title="Permanent link" href="#mdstoredir" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdstoredir"><span id="MDStoreDir">MDStoreDir</span> Directive <a title="Permanent link" href="#mdstoredir" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Path on the local file system to store the Managed Domains data.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDStoreDir <var>path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDStoreLocks" id="MDStoreLocks">MDStoreLocks</a> <a name="mdstorelocks" id="mdstorelocks">Directive</a> <a title="Permanent link" href="#mdstorelocks" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdstorelocks"><span id="MDStoreLocks">MDStoreLocks</span> Directive <a title="Permanent link" href="#mdstorelocks" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure locking of store for updates</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDStoreLocks on|off|<var>duration</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MDWarnWindow" id="MDWarnWindow">MDWarnWindow</a> <a name="mdwarnwindow" id="mdwarnwindow">Directive</a> <a title="Permanent link" href="#mdwarnwindow" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mdwarnwindow"><span id="MDWarnWindow">MDWarnWindow</span> Directive <a title="Permanent link" href="#mdwarnwindow" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the time window when you want to be warned about an expiring certificate.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MDWarnWindow duration</code></td></tr>
<a href="../fr/mod/mod_md.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="multipleext" id="multipleext">Files with Multiple Extensions</a> <a title="Permanent link" href="#multipleext" class="permalink">¶</a></h2>
+<h2
id="multipleext">Files with Multiple Extensions <a title="Permanent link" href="#multipleext" class="permalink">¶</a></h2>
<p>Files can have more than one extension; the order of the
extensions is <em>normally</em> irrelevant. For example, if the
file <code>welcome.html.fr</code> maps onto content type
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="contentencoding" id="contentencoding">Content encoding</a> <a title="Permanent link" href="#contentencoding" class="permalink">¶</a></h2>
+<h2
id="contentencoding">Content encoding <a title="Permanent link" href="#contentencoding" class="permalink">¶</a></h2>
<p>A file of a particular <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media-type</a> can additionally be encoded a
particular way to simplify transmission over the Internet.
While this usually will refer to compression, such as
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="charset-lang" id="charset-lang">Character sets and languages</a> <a title="Permanent link" href="#charset-lang" class="permalink">¶</a></h2>
+<h2
id="charset-lang">Character sets and languages <a title="Permanent link" href="#charset-lang" class="permalink">¶</a></h2>
<p>In addition to file type and the file encoding,
another important piece of information is what language a
particular document is in, and in what character set the file
Filename extensions that are only associated using the <code class="directive"><a href="#addhandler">AddHandler</a></code>, <code class="directive"><a href="#addinputfilter">AddInputFilter</a></code> or <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code> directives may be included or excluded
from matching by using the <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code> directive.</p>
- <h3><a name="charset" id="charset">Charset</a></h3>
+ <h3 id="charset">Charset</h3>
<p>To convey this further information, Apache optionally sends
a <code>Content-Language</code> header, to specify the language
that the document is in, and can append additional information
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddCharset" id="AddCharset">AddCharset</a> <a name="addcharset" id="addcharset">Directive</a> <a title="Permanent link" href="#addcharset" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addcharset"><span id="AddCharset">AddCharset</span> Directive <a title="Permanent link" href="#addcharset" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified content
charset</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddEncoding" id="AddEncoding">AddEncoding</a> <a name="addencoding" id="addencoding">Directive</a> <a title="Permanent link" href="#addencoding" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addencoding"><span id="AddEncoding">AddEncoding</span> Directive <a title="Permanent link" href="#addencoding" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified encoding
type</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddHandler" id="AddHandler">AddHandler</a> <a name="addhandler" id="addhandler">Directive</a> <a title="Permanent link" href="#addhandler" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addhandler"><span id="AddHandler">AddHandler</span> Directive <a title="Permanent link" href="#addhandler" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the filename extensions to the specified
handler</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddInputFilter" id="AddInputFilter">AddInputFilter</a> <a name="addinputfilter" id="addinputfilter">Directive</a> <a title="Permanent link" href="#addinputfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addinputfilter"><span id="AddInputFilter">AddInputFilter</span> Directive <a title="Permanent link" href="#addinputfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
client requests</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddLanguage" id="AddLanguage">AddLanguage</a> <a name="addlanguage" id="addlanguage">Directive</a> <a title="Permanent link" href="#addlanguage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addlanguage"><span id="AddLanguage">AddLanguage</span> Directive <a title="Permanent link" href="#addlanguage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extension to the specified content
language</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddOutputFilter" id="AddOutputFilter">AddOutputFilter</a> <a name="addoutputfilter" id="addoutputfilter">Directive</a> <a title="Permanent link" href="#addoutputfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addoutputfilter"><span id="AddOutputFilter">AddOutputFilter</span> Directive <a title="Permanent link" href="#addoutputfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
responses from the server</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AddType" id="AddType">AddType</a> <a name="addtype" id="addtype">Directive</a> <a title="Permanent link" href="#addtype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="addtype"><span id="AddType">AddType</span> Directive <a title="Permanent link" href="#addtype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions onto the specified content
type</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DefaultLanguage" id="DefaultLanguage">DefaultLanguage</a> <a name="defaultlanguage" id="defaultlanguage">Directive</a> <a title="Permanent link" href="#defaultlanguage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="defaultlanguage"><span id="DefaultLanguage">DefaultLanguage</span> Directive <a title="Permanent link" href="#defaultlanguage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a default language-tag to be sent in the Content-Language
header field for all resources in the current context that have not been
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MimeOptions" id="MimeOptions">MimeOptions</a> <a name="mimeoptions" id="mimeoptions">Directive</a> <a title="Permanent link" href="#mimeoptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mimeoptions"><span id="MimeOptions">MimeOptions</span> Directive <a title="Permanent link" href="#mimeoptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures mod_mime behavior</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MimeOptions <var>option</var> [<var>option</var>] ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ModMimeUsePathInfo" id="ModMimeUsePathInfo">ModMimeUsePathInfo</a> <a name="modmimeusepathinfo" id="modmimeusepathinfo">Directive</a> <a title="Permanent link" href="#modmimeusepathinfo" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="modmimeusepathinfo"><span id="ModMimeUsePathInfo">ModMimeUsePathInfo</span> Directive <a title="Permanent link" href="#modmimeusepathinfo" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tells <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> to treat <code>path_info</code>
components as part of the filename</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MultiviewsMatch" id="MultiviewsMatch">MultiviewsMatch</a> <a name="multiviewsmatch" id="multiviewsmatch">Directive</a> <a title="Permanent link" href="#multiviewsmatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="multiviewsmatch"><span id="MultiviewsMatch">MultiviewsMatch</span> Directive <a title="Permanent link" href="#multiviewsmatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The types of files that will be included when searching for
a matching file with MultiViews</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoveCharset" id="RemoveCharset">RemoveCharset</a> <a name="removecharset" id="removecharset">Directive</a> <a title="Permanent link" href="#removecharset" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="removecharset"><span id="RemoveCharset">RemoveCharset</span> Directive <a title="Permanent link" href="#removecharset" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any character set associations for a set of file
extensions</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoveEncoding" id="RemoveEncoding">RemoveEncoding</a> <a name="removeencoding" id="removeencoding">Directive</a> <a title="Permanent link" href="#removeencoding" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="removeencoding"><span id="RemoveEncoding">RemoveEncoding</span> Directive <a title="Permanent link" href="#removeencoding" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content encoding associations for a set of file
extensions</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoveHandler" id="RemoveHandler">RemoveHandler</a> <a name="removehandler" id="removehandler">Directive</a> <a title="Permanent link" href="#removehandler" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="removehandler"><span id="RemoveHandler">RemoveHandler</span> Directive <a title="Permanent link" href="#removehandler" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any handler associations for a set of file
extensions</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoveInputFilter" id="RemoveInputFilter">RemoveInputFilter</a> <a name="removeinputfilter" id="removeinputfilter">Directive</a> <a title="Permanent link" href="#removeinputfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="removeinputfilter"><span id="RemoveInputFilter">RemoveInputFilter</span> Directive <a title="Permanent link" href="#removeinputfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any input filter associations for a set of file
extensions</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoveLanguage" id="RemoveLanguage">RemoveLanguage</a> <a name="removelanguage" id="removelanguage">Directive</a> <a title="Permanent link" href="#removelanguage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="removelanguage"><span id="RemoveLanguage">RemoveLanguage</span> Directive <a title="Permanent link" href="#removelanguage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any language associations for a set of file
extensions</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoveOutputFilter" id="RemoveOutputFilter">RemoveOutputFilter</a> <a name="removeoutputfilter" id="removeoutputfilter">Directive</a> <a title="Permanent link" href="#removeoutputfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="removeoutputfilter"><span id="RemoveOutputFilter">RemoveOutputFilter</span> Directive <a title="Permanent link" href="#removeoutputfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any output filter associations for a set of file
extensions</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoveType" id="RemoveType">RemoveType</a> <a name="removetype" id="removetype">Directive</a> <a title="Permanent link" href="#removetype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="removetype"><span id="RemoveType">RemoveType</span> Directive <a title="Permanent link" href="#removetype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content type associations for a set of file
extensions</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="TypesConfig" id="TypesConfig">TypesConfig</a> <a name="typesconfig" id="typesconfig">Directive</a> <a title="Permanent link" href="#typesconfig" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="typesconfig"><span id="TypesConfig">TypesConfig</span> Directive <a title="Permanent link" href="#typesconfig" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The location of the <code>mime.types</code> file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TypesConfig <var>file-path</var></code></td></tr>
<a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_mime_magic">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_mime_magic">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="format" id="format">Format of the Magic File</a> <a title="Permanent link" href="#format" class="permalink">¶</a></h2>
+<h2
id="format">Format of the Magic File <a title="Permanent link" href="#format" class="permalink">¶</a></h2>
<p>The contents of the file are plain ASCII text in 4-5
columns. Blank lines are allowed but ignored. Commented lines
0 string \037\213 application/octet-stream x-gzip</pre></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="performance" id="performance">Performance Issues</a> <a title="Permanent link" href="#performance" class="permalink">¶</a></h2>
+<h2
id="performance">Performance Issues <a title="Permanent link" href="#performance" class="permalink">¶</a></h2>
<p>This module is not for every system. If your system is barely
keeping up with its load or if you're performing a web server
benchmark, you may not want to enable this because the
environment.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="notes" id="notes">Notes</a> <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
+<h2
id="notes">Notes <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
<p>The following notes apply to the <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>
module and are included here for compliance with contributors'
copyright restrictions that require their acknowledgment.</p>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MimeMagicDecompression" id="MimeMagicDecompression">MimeMagicDecompression</a> <a name="mimemagicdecompression" id="mimemagicdecompression">Directive</a> <a title="Permanent link" href="#mimemagicdecompression" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mimemagicdecompression"><span id="MimeMagicDecompression">MimeMagicDecompression</span> Directive <a title="Permanent link" href="#mimemagicdecompression" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable decompression of compressed files for MIME type detection</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MimeMagicDecompression On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MimeMagicFile" id="MimeMagicFile">MimeMagicFile</a> <a name="mimemagicfile" id="mimemagicfile">Directive</a> <a title="Permanent link" href="#mimemagicfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="mimemagicfile"><span id="MimeMagicFile">MimeMagicFile</span> Directive <a title="Permanent link" href="#mimemagicfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable MIME-type determination based on file contents
using the specified magic file</td></tr>
<a href="../fr/mod/mod_mime_magic.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="typemaps" id="typemaps">Type maps</a> <a title="Permanent link" href="#typemaps" class="permalink">¶</a></h2>
+<h2
id="typemaps">Type maps <a title="Permanent link" href="#typemaps" class="permalink">¶</a></h2>
<p>A type map has a format similar to RFC822 mail headers. It
contains document descriptions separated by blank lines, with
lines beginning with a hash character ('#') treated as
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="multiviews" id="multiviews">Multiviews</a> <a title="Permanent link" href="#multiviews" class="permalink">¶</a></h2>
+<h2
id="multiviews">Multiviews <a title="Permanent link" href="#multiviews" class="permalink">¶</a></h2>
<p>A Multiviews search is enabled by the <code>Multiviews</code>
<code class="directive"><a href="../mod/core.html#options">Options</a></code>. If the server receives a
request for <code>/some/dir/foo</code> and
to them when choosing files.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CacheNegotiatedDocs" id="CacheNegotiatedDocs">CacheNegotiatedDocs</a> <a name="cachenegotiateddocs" id="cachenegotiateddocs">Directive</a> <a title="Permanent link" href="#cachenegotiateddocs" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cachenegotiateddocs"><span id="CacheNegotiatedDocs">CacheNegotiatedDocs</span> Directive <a title="Permanent link" href="#cachenegotiateddocs" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allows content-negotiated documents to be
cached by proxy servers</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ForceLanguagePriority" id="ForceLanguagePriority">ForceLanguagePriority</a> <a name="forcelanguagepriority" id="forcelanguagepriority">Directive</a> <a title="Permanent link" href="#forcelanguagepriority" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="forcelanguagepriority"><span id="ForceLanguagePriority">ForceLanguagePriority</span> Directive <a title="Permanent link" href="#forcelanguagepriority" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action to take if a single acceptable document is not
found</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LanguagePriority" id="LanguagePriority">LanguagePriority</a> <a name="languagepriority" id="languagepriority">Directive</a> <a title="Permanent link" href="#languagepriority" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="languagepriority"><span id="LanguagePriority">LanguagePriority</span> Directive <a title="Permanent link" href="#languagepriority" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The precedence of language variants for cases where
the client does not express a preference</td></tr>
<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_nw_ssl">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_nw_ssl">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="NWSSLTrustedCerts" id="NWSSLTrustedCerts">NWSSLTrustedCerts</a> <a name="nwssltrustedcerts" id="nwssltrustedcerts">Directive</a> <a title="Permanent link" href="#nwssltrustedcerts" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="nwssltrustedcerts"><span id="NWSSLTrustedCerts">NWSSLTrustedCerts</span> Directive <a title="Permanent link" href="#nwssltrustedcerts" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>List of additional client certificates</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NWSSLTrustedCerts <var>filename</var> [<var>filename</var>] ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="NWSSLUpgradeable" id="NWSSLUpgradeable">NWSSLUpgradeable</a> <a name="nwsslupgradeable" id="nwsslupgradeable">Directive</a> <a title="Permanent link" href="#nwsslupgradeable" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="nwsslupgradeable"><span id="NWSSLUpgradeable">NWSSLUpgradeable</span> Directive <a title="Permanent link" href="#nwsslupgradeable" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allows a connection to be upgraded to an SSL connection upon request</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NWSSLUpgradeable [<var>IP-address</var>:]<var>portnumber</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SecureListen" id="SecureListen">SecureListen</a> <a name="securelisten" id="securelisten">Directive</a> <a title="Permanent link" href="#securelisten" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="securelisten"><span id="SecureListen">SecureListen</span> Directive <a title="Permanent link" href="#securelisten" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables SSL encryption for the specified port</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SecureListen [<var>IP-address</var>:]<var>portnumber</var>
<a href="../fr/mod/mod_nw_ssl.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="actions" id="actions">Actions</a> <a title="Permanent link" href="#actions" class="permalink">¶</a></h2>
+<h2
id="actions">Actions <a title="Permanent link" href="#actions" class="permalink">¶</a></h2>
<p>If a policy is violated, one of the following actions can be
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="tests" id="tests">Policy Tests</a> <a title="Permanent link" href="#tests" class="permalink">¶</a></h2>
+<h2
id="tests">Policy Tests <a title="Permanent link" href="#tests" class="permalink">¶</a></h2>
<p>The following policy filters are available:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="example" id="example">Example Configuration</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<h2
id="example">Example Configuration <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<p>A typical configuration protecting a server serving static content
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyConditional" id="PolicyConditional">PolicyConditional</a> <a name="policyconditional" id="policyconditional">Directive</a> <a title="Permanent link" href="#policyconditional" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyconditional"><span id="PolicyConditional">PolicyConditional</span> Directive <a title="Permanent link" href="#policyconditional" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the conditional request policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyConditional <var>ignore|log|enforce</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyConditionalURL" id="PolicyConditionalURL">PolicyConditionalURL</a> <a name="policyconditionalurl" id="policyconditionalurl">Directive</a> <a title="Permanent link" href="#policyconditionalurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyconditionalurl"><span id="PolicyConditionalURL">PolicyConditionalURL</span> Directive <a title="Permanent link" href="#policyconditionalurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the conditional request policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyConditionalURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyEnvironment" id="PolicyEnvironment">PolicyEnvironment</a> <a name="policyenvironment" id="policyenvironment">Directive</a> <a title="Permanent link" href="#policyenvironment" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyenvironment"><span id="PolicyEnvironment">PolicyEnvironment</span> Directive <a title="Permanent link" href="#policyenvironment" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override policies based on an environment variable.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyEnvironment <var>variable</var> <var>log-value</var> <var>ignore-value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyFilter" id="PolicyFilter">PolicyFilter</a> <a name="policyfilter" id="policyfilter">Directive</a> <a title="Permanent link" href="#policyfilter" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyfilter"><span id="PolicyFilter">PolicyFilter</span> Directive <a title="Permanent link" href="#policyfilter" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable policies for the given URL space.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyFilter <var>on|off</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyKeepalive" id="PolicyKeepalive">PolicyKeepalive</a> <a name="policykeepalive" id="policykeepalive">Directive</a> <a title="Permanent link" href="#policykeepalive" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policykeepalive"><span id="PolicyKeepalive">PolicyKeepalive</span> Directive <a title="Permanent link" href="#policykeepalive" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the keepalive policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyKeepalive <var>ignore|log|enforce</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyKeepaliveURL" id="PolicyKeepaliveURL">PolicyKeepaliveURL</a> <a name="policykeepaliveurl" id="policykeepaliveurl">Directive</a> <a title="Permanent link" href="#policykeepaliveurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policykeepaliveurl"><span id="PolicyKeepaliveURL">PolicyKeepaliveURL</span> Directive <a title="Permanent link" href="#policykeepaliveurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the keepalive policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyKeepaliveURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyLength" id="PolicyLength">PolicyLength</a> <a name="policylength" id="policylength">Directive</a> <a title="Permanent link" href="#policylength" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policylength"><span id="PolicyLength">PolicyLength</span> Directive <a title="Permanent link" href="#policylength" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the content length policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyLength <var>ignore|log|enforce</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyLengthURL" id="PolicyLengthURL">PolicyLengthURL</a> <a name="policylengthurl" id="policylengthurl">Directive</a> <a title="Permanent link" href="#policylengthurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policylengthurl"><span id="PolicyLengthURL">PolicyLengthURL</span> Directive <a title="Permanent link" href="#policylengthurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the content length policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyLengthURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyMaxage" id="PolicyMaxage">PolicyMaxage</a> <a name="policymaxage" id="policymaxage">Directive</a> <a title="Permanent link" href="#policymaxage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policymaxage"><span id="PolicyMaxage">PolicyMaxage</span> Directive <a title="Permanent link" href="#policymaxage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the caching minimum max-age policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyMaxage <var>ignore|log|enforce</var> <var>age</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyMaxageURL" id="PolicyMaxageURL">PolicyMaxageURL</a> <a name="policymaxageurl" id="policymaxageurl">Directive</a> <a title="Permanent link" href="#policymaxageurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policymaxageurl"><span id="PolicyMaxageURL">PolicyMaxageURL</span> Directive <a title="Permanent link" href="#policymaxageurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the caching minimum freshness lifetime policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyMaxageURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyNocache" id="PolicyNocache">PolicyNocache</a> <a name="policynocache" id="policynocache">Directive</a> <a title="Permanent link" href="#policynocache" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policynocache"><span id="PolicyNocache">PolicyNocache</span> Directive <a title="Permanent link" href="#policynocache" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the caching no-cache policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyNocache <var>ignore|log|enforce</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyNocacheURL" id="PolicyNocacheURL">PolicyNocacheURL</a> <a name="policynocacheurl" id="policynocacheurl">Directive</a> <a title="Permanent link" href="#policynocacheurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policynocacheurl"><span id="PolicyNocacheURL">PolicyNocacheURL</span> Directive <a title="Permanent link" href="#policynocacheurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the caching no-cache policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyNocacheURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyType" id="PolicyType">PolicyType</a> <a name="policytype" id="policytype">Directive</a> <a title="Permanent link" href="#policytype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policytype"><span id="PolicyType">PolicyType</span> Directive <a title="Permanent link" href="#policytype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the content type policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyType <var>ignore|log|enforce</var> <var>type</var> [ <var>type</var> [ ... ]]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyTypeURL" id="PolicyTypeURL">PolicyTypeURL</a> <a name="policytypeurl" id="policytypeurl">Directive</a> <a title="Permanent link" href="#policytypeurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policytypeurl"><span id="PolicyTypeURL">PolicyTypeURL</span> Directive <a title="Permanent link" href="#policytypeurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the content type policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyTypeURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyValidation" id="PolicyValidation">PolicyValidation</a> <a name="policyvalidation" id="policyvalidation">Directive</a> <a title="Permanent link" href="#policyvalidation" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyvalidation"><span id="PolicyValidation">PolicyValidation</span> Directive <a title="Permanent link" href="#policyvalidation" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the validation policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyValidation <var>ignore|log|enforce</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyValidationURL" id="PolicyValidationURL">PolicyValidationURL</a> <a name="policyvalidationurl" id="policyvalidationurl">Directive</a> <a title="Permanent link" href="#policyvalidationurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyvalidationurl"><span id="PolicyValidationURL">PolicyValidationURL</span> Directive <a title="Permanent link" href="#policyvalidationurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the content type policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyValidationURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyVary" id="PolicyVary">PolicyVary</a> <a name="policyvary" id="policyvary">Directive</a> <a title="Permanent link" href="#policyvary" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyvary"><span id="PolicyVary">PolicyVary</span> Directive <a title="Permanent link" href="#policyvary" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the Vary policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyVary <var>ignore|log|enforce</var> <var>header</var> [ <var>header</var> [ ... ]]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyVaryURL" id="PolicyVaryURL">PolicyVaryURL</a> <a name="policyvaryurl" id="policyvaryurl">Directive</a> <a title="Permanent link" href="#policyvaryurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyvaryurl"><span id="PolicyVaryURL">PolicyVaryURL</span> Directive <a title="Permanent link" href="#policyvaryurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the content type policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyVaryURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyVersion" id="PolicyVersion">PolicyVersion</a> <a name="policyversion" id="policyversion">Directive</a> <a title="Permanent link" href="#policyversion" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyversion"><span id="PolicyVersion">PolicyVersion</span> Directive <a title="Permanent link" href="#policyversion" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the version policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyVersion <var>ignore|log|enforce</var> <var>HTTP/0.9|HTTP/1.0|HTTP/1.1</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PolicyVersionURL" id="PolicyVersionURL">PolicyVersionURL</a> <a name="policyversionurl" id="policyversionurl">Directive</a> <a title="Permanent link" href="#policyversionurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="policyversionurl"><span id="PolicyVersionURL">PolicyVersionURL</span> Directive <a title="Permanent link" href="#policyversionurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL describing the minimum request HTTP version policy.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>PolicyVersionURL <var>url</var></code></td></tr>
<a href="../fr/mod/mod_policy.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_privileges">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_privileges">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Considerations</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Considerations <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_privileges.html">mod_privileges</a></code> introduces new security concerns
in situations where <strong>untrusted code</strong> may be run
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="DTracePrivileges" id="DTracePrivileges">DTracePrivileges</a> <a name="dtraceprivileges" id="dtraceprivileges">Directive</a> <a title="Permanent link" href="#dtraceprivileges" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="dtraceprivileges"><span id="DTracePrivileges">DTracePrivileges</span> Directive <a title="Permanent link" href="#dtraceprivileges" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether the privileges required by dtrace are enabled.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DTracePrivileges On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PrivilegesMode" id="PrivilegesMode">PrivilegesMode</a> <a name="privilegesmode" id="privilegesmode">Directive</a> <a title="Permanent link" href="#privilegesmode" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="privilegesmode"><span id="PrivilegesMode">PrivilegesMode</span> Directive <a title="Permanent link" href="#privilegesmode" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Trade off processing speed and efficiency vs security against
malicious privileges-aware code.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VHostCGIMode" id="VHostCGIMode">VHostCGIMode</a> <a name="vhostcgimode" id="vhostcgimode">Directive</a> <a title="Permanent link" href="#vhostcgimode" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="vhostcgimode"><span id="VHostCGIMode">VHostCGIMode</span> Directive <a title="Permanent link" href="#vhostcgimode" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether the virtualhost can run
subprocesses, and the privileges available to subprocesses.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VHostCGIPrivs" id="VHostCGIPrivs">VHostCGIPrivs</a> <a name="vhostcgiprivs" id="vhostcgiprivs">Directive</a> <a title="Permanent link" href="#vhostcgiprivs" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="vhostcgiprivs"><span id="VHostCGIPrivs">VHostCGIPrivs</span> Directive <a title="Permanent link" href="#vhostcgiprivs" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Assign arbitrary privileges to subprocesses created
by a virtual host.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VHostGroup" id="VHostGroup">VHostGroup</a> <a name="vhostgroup" id="vhostgroup">Directive</a> <a title="Permanent link" href="#vhostgroup" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="vhostgroup"><span id="VHostGroup">VHostGroup</span> Directive <a title="Permanent link" href="#vhostgroup" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the Group ID under which a virtual host runs.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>VHostGroup <var>unix-groupid</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VHostPrivs" id="VHostPrivs">VHostPrivs</a> <a name="vhostprivs" id="vhostprivs">Directive</a> <a title="Permanent link" href="#vhostprivs" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="vhostprivs"><span id="VHostPrivs">VHostPrivs</span> Directive <a title="Permanent link" href="#vhostprivs" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Assign arbitrary privileges to a virtual host.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>VHostPrivs [+-]?<var>privilege-name</var> [[+-]?privilege-name] ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VHostSecure" id="VHostSecure">VHostSecure</a> <a name="vhostsecure" id="vhostsecure">Directive</a> <a title="Permanent link" href="#vhostsecure" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="vhostsecure"><span id="VHostSecure">VHostSecure</span> Directive <a title="Permanent link" href="#vhostsecure" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether the server runs with enhanced security
for the virtualhost.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VHostUser" id="VHostUser">VHostUser</a> <a name="vhostuser" id="vhostuser">Directive</a> <a title="Permanent link" href="#vhostuser" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="vhostuser"><span id="VHostUser">VHostUser</span> Directive <a title="Permanent link" href="#vhostuser" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the User ID under which a virtual host runs.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>VHostUser <var>unix-userid</var></code></td></tr>
<a href="../fr/mod/mod_privileges.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="forwardreverse" id="forwardreverse">Forward Proxies and Reverse
- Proxies/Gateways
</a> <a title="Permanent link" href="#forwardreverse" class="permalink">¶</a></h2>
+<h2 id="forwardreverse">Forward Proxies and Reverse
+ Proxies/Gateways <a title="Permanent link" href="#forwardreverse" class="permalink">¶</a></h2>
<p>Apache HTTP Server can be configured in both a <dfn>forward</dfn> and
<dfn>reverse</dfn> proxy (also known as <dfn>gateway</dfn>) mode.</p>
configure a reverse proxy.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Basic Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Basic Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>The examples below are only a very basic idea to help you
get started. Please read the documentation on the individual
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="handler" id="handler">Access via Handler</a> <a title="Permanent link" href="#handler" class="permalink">¶</a></h2>
+<h2
id="handler">Access via Handler <a title="Permanent link" href="#handler" class="permalink">¶</a></h2>
<p>You can also force a request to be handled as a reverse-proxy
request, by creating a suitable Handler pass-through. The example
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="workers" id="workers">Workers</a> <a title="Permanent link" href="#workers" class="permalink">¶</a></h2>
+<h2
id="workers">Workers <a title="Permanent link" href="#workers" class="permalink">¶</a></h2>
<p>The proxy manages the configuration of origin servers and their
communication parameters in objects called <dfn>workers</dfn>.
There are two built-in workers: the default forward proxy worker and the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="access" id="access">Controlling Access to Your Proxy</a> <a title="Permanent link" href="#access" class="permalink">¶</a></h2>
+<h2
id="access">Controlling Access to Your Proxy <a title="Permanent link" href="#access" class="permalink">¶</a></h2>
<p>You can control who can access your proxy via the <code class="directive"><a href="#proxy"><Proxy></a></code> control block as in
the following example:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="startup" id="startup">Slow Startup</a> <a title="Permanent link" href="#startup" class="permalink">¶</a></h2>
+<h2
id="startup">Slow Startup <a title="Permanent link" href="#startup" class="permalink">¶</a></h2>
<p>If you're using the <code class="directive"><a href="#proxyblock">ProxyBlock</a></code> directive, hostnames' IP addresses are looked up
and cached during startup for later match test. This may take a few
seconds (or more) depending on the speed with which the hostname lookups
occur.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="intranet" id="intranet">Intranet Proxy</a> <a title="Permanent link" href="#intranet" class="permalink">¶</a></h2>
+<h2
id="intranet">Intranet Proxy <a title="Permanent link" href="#intranet" class="permalink">¶</a></h2>
<p>An Apache httpd proxy server situated in an intranet needs to forward
external requests through the company's firewall (for this, configure
the <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> directive
files will then contain fully qualified hosts.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="envsettings" id="envsettings">Protocol Adjustments</a> <a title="Permanent link" href="#envsettings" class="permalink">¶</a></h2>
+<h2
id="envsettings">Protocol Adjustments <a title="Permanent link" href="#envsettings" class="permalink">¶</a></h2>
<p>For circumstances where <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> is sending
requests to an origin server that doesn't properly implement
keepalives or HTTP/1.1, there are two <a href="../env.html">environment variables</a> that can force the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="request-bodies" id="request-bodies">Request Bodies</a> <a title="Permanent link" href="#request-bodies" class="permalink">¶</a></h2>
+<h2
id="request-bodies">Request Bodies <a title="Permanent link" href="#request-bodies" class="permalink">¶</a></h2>
<p>Some request methods such as POST include a request body.
The HTTP protocol requires that requests which include a body
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="x-headers" id="x-headers">Reverse Proxy Request Headers</a> <a title="Permanent link" href="#x-headers" class="permalink">¶</a></h2>
+<h2
id="x-headers">Reverse Proxy Request Headers <a title="Permanent link" href="#x-headers" class="permalink">¶</a></h2>
<p>When acting in a reverse-proxy mode (using the <code class="directive"><a href="#proxypass">ProxyPass</a></code> directive, for example),
<code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> adds several request headers in
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BalancerGrowth" id="BalancerGrowth">BalancerGrowth</a> <a name="balancergrowth" id="balancergrowth">Directive</a> <a title="Permanent link" href="#balancergrowth" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="balancergrowth"><span id="BalancerGrowth">BalancerGrowth</span> Directive <a title="Permanent link" href="#balancergrowth" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of additional Balancers that can be added Post-configuration</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BalancerGrowth <var>#</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BalancerInherit" id="BalancerInherit">BalancerInherit</a> <a name="balancerinherit" id="balancerinherit">Directive</a> <a title="Permanent link" href="#balancerinherit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="balancerinherit"><span id="BalancerInherit">BalancerInherit</span> Directive <a title="Permanent link" href="#balancerinherit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inherit proxy Balancers/Workers defined from the main server</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BalancerInherit On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BalancerMember" id="BalancerMember">BalancerMember</a> <a name="balancermember" id="balancermember">Directive</a> <a title="Permanent link" href="#balancermember" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="balancermember"><span id="BalancerMember">BalancerMember</span> Directive <a title="Permanent link" href="#balancermember" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add a member to a load balancing group</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BalancerMember [<var>balancerurl</var>] <var>url</var> [<var>key=value [key=value ...]]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BalancerPersist" id="BalancerPersist">BalancerPersist</a> <a name="balancerpersist" id="balancerpersist">Directive</a> <a title="Permanent link" href="#balancerpersist" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="balancerpersist"><span id="BalancerPersist">BalancerPersist</span> Directive <a title="Permanent link" href="#balancerpersist" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Attempt to persist changes made by the Balancer Manager across restarts.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BalancerPersist On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="NoProxy" id="NoProxy">NoProxy</a> <a name="noproxy" id="noproxy">Directive</a> <a title="Permanent link" href="#noproxy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="noproxy"><span id="NoProxy">NoProxy</span> Directive <a title="Permanent link" href="#noproxy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Hosts, domains, or networks that will be connected to
directly</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Proxy" id="Proxy"><Proxy></a> <a name="proxy" id="proxy">Directive</a> <a title="Permanent link" href="#proxy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxy"><span id="Proxy"><Proxy></span> Directive <a title="Permanent link" href="#proxy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Container for directives applied to proxied resources</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Proxy <var>wildcard-url</var>> ...</Proxy></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Proxy100Continue" id="Proxy100Continue">Proxy100Continue</a> <a name="proxy100continue" id="proxy100continue">Directive</a> <a title="Permanent link" href="#proxy100continue" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxy100continue"><span id="Proxy100Continue">Proxy100Continue</span> Directive <a title="Permanent link" href="#proxy100continue" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forward 100-continue expectation to the origin server</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Proxy100Continue Off|On</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyAddHeaders" id="ProxyAddHeaders">ProxyAddHeaders</a> <a name="proxyaddheaders" id="proxyaddheaders">Directive</a> <a title="Permanent link" href="#proxyaddheaders" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyaddheaders"><span id="ProxyAddHeaders">ProxyAddHeaders</span> Directive <a title="Permanent link" href="#proxyaddheaders" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add proxy information in X-Forwarded-* headers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyAddHeaders Off|On</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyAsyncDelay" id="ProxyAsyncDelay">ProxyAsyncDelay</a> <a name="proxyasyncdelay" id="proxyasyncdelay">Directive</a> <a title="Permanent link" href="#proxyasyncdelay" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyasyncdelay"><span id="ProxyAsyncDelay">ProxyAsyncDelay</span> Directive <a title="Permanent link" href="#proxyasyncdelay" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Time to poll synchronously before handing a connection to the
MPM for asynchronous processing</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyAsyncIdleTimeout" id="ProxyAsyncIdleTimeout">ProxyAsyncIdleTimeout</a> <a name="proxyasyncidletimeout" id="proxyasyncidletimeout">Directive</a> <a title="Permanent link" href="#proxyasyncidletimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyasyncidletimeout"><span id="ProxyAsyncIdleTimeout">ProxyAsyncIdleTimeout</span> Directive <a title="Permanent link" href="#proxyasyncidletimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inactivity timeout for asynchronous proxy connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyAsyncIdleTimeout <var>time</var>[s]</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyBadHeader" id="ProxyBadHeader">ProxyBadHeader</a> <a name="proxybadheader" id="proxybadheader">Directive</a> <a title="Permanent link" href="#proxybadheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxybadheader"><span id="ProxyBadHeader">ProxyBadHeader</span> Directive <a title="Permanent link" href="#proxybadheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines how to handle bad header lines in a
response</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyBlock" id="ProxyBlock">ProxyBlock</a> <a name="proxyblock" id="proxyblock">Directive</a> <a title="Permanent link" href="#proxyblock" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyblock"><span id="ProxyBlock">ProxyBlock</span> Directive <a title="Permanent link" href="#proxyblock" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disallow proxy requests to certain hosts</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyBlock *|<var>hostname</var>|<var>partial-hostname</var> [<var>hostname</var>|<var>partial-hostname</var>]...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyDomain" id="ProxyDomain">ProxyDomain</a> <a name="proxydomain" id="proxydomain">Directive</a> <a title="Permanent link" href="#proxydomain" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxydomain"><span id="ProxyDomain">ProxyDomain</span> Directive <a title="Permanent link" href="#proxydomain" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default domain name for proxied requests</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyDomain <var>Domain</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyErrorOverride" id="ProxyErrorOverride">ProxyErrorOverride</a> <a name="proxyerroroverride" id="proxyerroroverride">Directive</a> <a title="Permanent link" href="#proxyerroroverride" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyerroroverride"><span id="ProxyErrorOverride">ProxyErrorOverride</span> Directive <a title="Permanent link" href="#proxyerroroverride" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override error pages for proxied content</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyErrorOverride Off|On [<var>code</var> ...]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyIOBufferSize" id="ProxyIOBufferSize">ProxyIOBufferSize</a> <a name="proxyiobuffersize" id="proxyiobuffersize">Directive</a> <a title="Permanent link" href="#proxyiobuffersize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyiobuffersize"><span id="ProxyIOBufferSize">ProxyIOBufferSize</span> Directive <a title="Permanent link" href="#proxyiobuffersize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine size of internal data throughput buffer</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyIOBufferSize <var>bytes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyMatch" id="ProxyMatch"><ProxyMatch></a> <a name="proxymatch" id="proxymatch">Directive</a> <a title="Permanent link" href="#proxymatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxymatch"><span id="ProxyMatch"><ProxyMatch></span> Directive <a title="Permanent link" href="#proxymatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Container for directives applied to regular-expression-matched
proxied resources</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyMaxForwards" id="ProxyMaxForwards">ProxyMaxForwards</a> <a name="proxymaxforwards" id="proxymaxforwards">Directive</a> <a title="Permanent link" href="#proxymaxforwards" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxymaxforwards"><span id="ProxyMaxForwards">ProxyMaxForwards</span> Directive <a title="Permanent link" href="#proxymaxforwards" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of proxies that a request can be forwarded
through</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyPass" id="ProxyPass">ProxyPass</a> <a name="proxypass" id="proxypass">Directive</a> <a title="Permanent link" href="#proxypass" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxypass"><span id="ProxyPass">ProxyPass</span> Directive <a title="Permanent link" href="#proxypass" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps remote servers into the local server URL-space</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyPass [<var>path</var>] !|<var>url</var> [<var>key=value</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyPassInherit" id="ProxyPassInherit">ProxyPassInherit</a> <a name="proxypassinherit" id="proxypassinherit">Directive</a> <a title="Permanent link" href="#proxypassinherit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxypassinherit"><span id="ProxyPassInherit">ProxyPassInherit</span> Directive <a title="Permanent link" href="#proxypassinherit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inherit ProxyPass directives defined from the main server</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyPassInherit On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyPassInterpolateEnv" id="ProxyPassInterpolateEnv">ProxyPassInterpolateEnv</a> <a name="proxypassinterpolateenv" id="proxypassinterpolateenv">Directive</a> <a title="Permanent link" href="#proxypassinterpolateenv" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxypassinterpolateenv"><span id="ProxyPassInterpolateEnv">ProxyPassInterpolateEnv</span> Directive <a title="Permanent link" href="#proxypassinterpolateenv" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable Environment Variable interpolation in Reverse Proxy configurations</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyPassInterpolateEnv On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyPassMatch" id="ProxyPassMatch">ProxyPassMatch</a> <a name="proxypassmatch" id="proxypassmatch">Directive</a> <a title="Permanent link" href="#proxypassmatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxypassmatch"><span id="ProxyPassMatch">ProxyPassMatch</span> Directive <a title="Permanent link" href="#proxypassmatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps remote servers into the local server URL-space using regular expressions</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyPassMatch [<var>regex</var>] !|<var>url</var> [<var>key=value</var>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyPassReverse" id="ProxyPassReverse">ProxyPassReverse</a> <a name="proxypassreverse" id="proxypassreverse">Directive</a> <a title="Permanent link" href="#proxypassreverse" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxypassreverse"><span id="ProxyPassReverse">ProxyPassReverse</span> Directive <a title="Permanent link" href="#proxypassreverse" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adjusts the URL in HTTP response headers sent from a reverse
proxied server</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyPassReverseCookieDomain" id="ProxyPassReverseCookieDomain">ProxyPassReverseCookieDomain</a> <a name="proxypassreversecookiedomain" id="proxypassreversecookiedomain">Directive</a> <a title="Permanent link" href="#proxypassreversecookiedomain" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxypassreversecookiedomain"><span id="ProxyPassReverseCookieDomain">ProxyPassReverseCookieDomain</span> Directive <a title="Permanent link" href="#proxypassreversecookiedomain" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adjusts the Domain string in Set-Cookie headers from a reverse-
proxied server</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyPassReverseCookiePath" id="ProxyPassReverseCookiePath">ProxyPassReverseCookiePath</a> <a name="proxypassreversecookiepath" id="proxypassreversecookiepath">Directive</a> <a title="Permanent link" href="#proxypassreversecookiepath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxypassreversecookiepath"><span id="ProxyPassReverseCookiePath">ProxyPassReverseCookiePath</span> Directive <a title="Permanent link" href="#proxypassreversecookiepath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adjusts the Path string in Set-Cookie headers from a reverse-
proxied server</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyPreserveHost" id="ProxyPreserveHost">ProxyPreserveHost</a> <a name="proxypreservehost" id="proxypreservehost">Directive</a> <a title="Permanent link" href="#proxypreservehost" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxypreservehost"><span id="ProxyPreserveHost">ProxyPreserveHost</span> Directive <a title="Permanent link" href="#proxypreservehost" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use incoming Host HTTP request header for proxy
request</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyReceiveBufferSize" id="ProxyReceiveBufferSize">ProxyReceiveBufferSize</a> <a name="proxyreceivebuffersize" id="proxyreceivebuffersize">Directive</a> <a title="Permanent link" href="#proxyreceivebuffersize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyreceivebuffersize"><span id="ProxyReceiveBufferSize">ProxyReceiveBufferSize</span> Directive <a title="Permanent link" href="#proxyreceivebuffersize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Network buffer size for proxied HTTP and FTP
connections</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyRemote" id="ProxyRemote">ProxyRemote</a> <a name="proxyremote" id="proxyremote">Directive</a> <a title="Permanent link" href="#proxyremote" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyremote"><span id="ProxyRemote">ProxyRemote</span> Directive <a title="Permanent link" href="#proxyremote" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Remote proxy used to handle certain requests</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyRemote <var>match</var> <var>remote-server</var> [<var>username:password</var>]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyRemoteMatch" id="ProxyRemoteMatch">ProxyRemoteMatch</a> <a name="proxyremotematch" id="proxyremotematch">Directive</a> <a title="Permanent link" href="#proxyremotematch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyremotematch"><span id="ProxyRemoteMatch">ProxyRemoteMatch</span> Directive <a title="Permanent link" href="#proxyremotematch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Remote proxy used to handle requests matched by regular
expressions</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyRequests" id="ProxyRequests">ProxyRequests</a> <a name="proxyrequests" id="proxyrequests">Directive</a> <a title="Permanent link" href="#proxyrequests" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyrequests"><span id="ProxyRequests">ProxyRequests</span> Directive <a title="Permanent link" href="#proxyrequests" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables forward (standard) proxy requests</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyRequests On|Off</code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxySet" id="ProxySet">ProxySet</a> <a name="proxyset" id="proxyset">Directive</a> <a title="Permanent link" href="#proxyset" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyset"><span id="ProxySet">ProxySet</span> Directive <a title="Permanent link" href="#proxyset" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set various Proxy balancer or member parameters</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxySet <var>url</var> <var>key=value [key=value ...]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxySourceAddress" id="ProxySourceAddress">ProxySourceAddress</a> <a name="proxysourceaddress" id="proxysourceaddress">Directive</a> <a title="Permanent link" href="#proxysourceaddress" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxysourceaddress"><span id="ProxySourceAddress">ProxySourceAddress</span> Directive <a title="Permanent link" href="#proxysourceaddress" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set local IP address for outgoing proxy connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxySourceAddress <var>address</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyStatus" id="ProxyStatus">ProxyStatus</a> <a name="proxystatus" id="proxystatus">Directive</a> <a title="Permanent link" href="#proxystatus" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxystatus"><span id="ProxyStatus">ProxyStatus</span> Directive <a title="Permanent link" href="#proxystatus" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Show Proxy LoadBalancer status in mod_status</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyStatus Off|On|Full</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyTimeout" id="ProxyTimeout">ProxyTimeout</a> <a name="proxytimeout" id="proxytimeout">Directive</a> <a title="Permanent link" href="#proxytimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxytimeout"><span id="ProxyTimeout">ProxyTimeout</span> Directive <a title="Permanent link" href="#proxytimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Network timeout for proxied requests</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyTimeout <var>time-interval</var>[s]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyVia" id="ProxyVia">ProxyVia</a> <a name="proxyvia" id="proxyvia">Directive</a> <a title="Permanent link" href="#proxyvia" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyvia"><span id="ProxyVia">ProxyVia</span> Directive <a title="Permanent link" href="#proxyvia" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Information provided in the <code>Via</code> HTTP response
header for proxied requests</td></tr>
<a href="../ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usage" id="usage">Usage</a> <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
+<h2
id="usage">Usage <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
<p>This module is used to reverse proxy to a backend application server
(e.g. Apache Tomcat) using the AJP13 protocol. The usage is similar to
an HTTP reverse proxy, but uses the <code>ajp://</code> prefix:</p>
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="env" id="env">Environment Variables</a> <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
+<h2
id="env">Environment Variables <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
<p>Environment variables whose names have the prefix <code>AJP_</code>
are forwarded to the origin server as AJP request attributes
(with the <code>AJP_</code> prefix removed from the name of the key).</p>
method does not list them as those are handled as internal attributes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="overviewprotocol" id="overviewprotocol">Overview of the protocol</a> <a title="Permanent link" href="#overviewprotocol" class="permalink">¶</a></h2>
+<h2
id="overviewprotocol">Overview of the protocol <a title="Permanent link" href="#overviewprotocol" class="permalink">¶</a></h2>
<p>The <code>AJP13</code> protocol is packet-oriented. A binary format
was presumably chosen over the more readable plain text for reasons of
performance. The web server communicates with the servlet container over
See Response Packet Structures below for details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basppacketstruct" id="basppacketstruct">Basic Packet Structure</a> <a title="Permanent link" href="#basppacketstruct" class="permalink">¶</a></h2>
+<h2
id="basppacketstruct">Basic Packet Structure <a title="Permanent link" href="#basppacketstruct" class="permalink">¶</a></h2>
<p>There is a bit of an XDR heritage to this protocol, but it differs
in lots of ways (no 4 byte alignment, for example).</p>
<p>AJP13 uses network byte order for all data types.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rpacetstruct" id="rpacetstruct">Request Packet Structure</a> <a title="Permanent link" href="#rpacetstruct" class="permalink">¶</a></h2>
+<h2
id="rpacetstruct">Request Packet Structure <a title="Permanent link" href="#rpacetstruct" class="permalink">¶</a></h2>
<p>For messages from the server to the container of type
<em>Forward Request</em>:</p>
<div class="example"><pre>AJP13_FORWARD_REQUEST :=
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="resppacketstruct" id="resppacketstruct">Response Packet Structure</a> <a title="Permanent link" href="#resppacketstruct" class="permalink">¶</a></h2>
+<h2
id="resppacketstruct">Response Packet Structure <a title="Permanent link" href="#resppacketstruct" class="permalink">¶</a></h2>
<p>for messages which the container can send back to the server.</p>
<div class="example"><pre>AJP13_SEND_BODY_CHUNK :=
prefix_code 3
<a href="../ja/mod/mod_proxy_ajp.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="scheduler" id="scheduler">Load balancer scheduler algorithm</a> <a title="Permanent link" href="#scheduler" class="permalink">¶</a></h2>
+<h2
id="scheduler">Load balancer scheduler algorithm <a title="Permanent link" href="#scheduler" class="permalink">¶</a></h2>
<p>At present, there are 4 load balancer scheduler algorithms available
for use: Request Counting (<code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code>),
configure the Balancer and BalancerMembers.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="stickiness" id="stickiness">Load balancer stickiness</a> <a title="Permanent link" href="#stickiness" class="permalink">¶</a></h2>
+<h2
id="stickiness">Load balancer stickiness <a title="Permanent link" href="#stickiness" class="permalink">¶</a></h2>
<p>The balancer supports stickiness. When a request is proxied
to some back-end, then all following requests from the same user
itself. The URL encoding is usually done on the back-end.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="example" id="example">Examples of a balancer configuration</a> <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
+<h2
id="example">Examples of a balancer configuration <a title="Permanent link" href="#example" class="permalink">¶</a></h2>
<p>Before we dive into the technical details, here's an example of
how you might use <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> to provide
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="environment" id="environment">Exported Environment Variables</a> <a title="Permanent link" href="#environment" class="permalink">¶</a></h2>
+<h2
id="environment">Exported Environment Variables <a title="Permanent link" href="#environment" class="permalink">¶</a></h2>
<p>At present there are 6 environment variables exported:</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="balancer_manager" id="balancer_manager">Enabling Balancer Manager Support</a> <a title="Permanent link" href="#balancer_manager" class="permalink">¶</a></h2>
+<h2
id="balancer_manager">Enabling Balancer Manager Support <a title="Permanent link" href="#balancer_manager" class="permalink">¶</a></h2>
<p>This module <em>requires</em> the service of
<code class="module"><a href="../mod/mod_status.html">mod_status</a></code>.
containers can be dynamically controlled by the Manager.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="stickiness_implementation" id="stickiness_implementation">Details on load balancer stickiness</a> <a title="Permanent link" href="#stickiness_implementation" class="permalink">¶</a></h2>
+<h2
id="stickiness_implementation">Details on load balancer stickiness <a title="Permanent link" href="#stickiness_implementation" class="permalink">¶</a></h2>
<p>When using cookie based stickiness, you need to configure the
name of the cookie that contains the information about which back-end
for the same request, the information from the request parameter is used.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="stickiness_troubleshooting" id="stickiness_troubleshooting">Troubleshooting load balancer stickiness</a> <a title="Permanent link" href="#stickiness_troubleshooting" class="permalink">¶</a></h2>
+<h2
id="stickiness_troubleshooting">Troubleshooting load balancer stickiness <a title="Permanent link" href="#stickiness_troubleshooting" class="permalink">¶</a></h2>
<p>If you experience stickiness errors, e.g. users lose their
application sessions and need to login again, you first want to
<a href="../ja/mod/mod_proxy_balancer.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="notes" id="notes">Request notes</a> <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
+<h2
id="notes">Request notes <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> creates the following request notes for
logging using the <code>%{VARNAME}n</code> format in
<code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> or
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AllowCONNECT" id="AllowCONNECT">AllowCONNECT</a> <a name="allowconnect" id="allowconnect">Directive</a> <a title="Permanent link" href="#allowconnect" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="allowconnect"><span id="AllowCONNECT">AllowCONNECT</span> Directive <a title="Permanent link" href="#allowconnect" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ports that are allowed to <code>CONNECT</code> through the
proxy</td></tr>
<a href="../ja/mod/mod_proxy_connect.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyExpressDBMFile" id="ProxyExpressDBMFile">ProxyExpressDBMFile</a> <a name="proxyexpressdbmfile" id="proxyexpressdbmfile">Directive</a> <a title="Permanent link" href="#proxyexpressdbmfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyexpressdbmfile"><span id="ProxyExpressDBMFile">ProxyExpressDBMFile</span> Directive <a title="Permanent link" href="#proxyexpressdbmfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pathname to DBM file.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyExpressDBMFile <var>pathname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyExpressDBMType" id="ProxyExpressDBMType">ProxyExpressDBMType</a> <a name="proxyexpressdbmtype" id="proxyexpressdbmtype">Directive</a> <a title="Permanent link" href="#proxyexpressdbmtype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyexpressdbmtype"><span id="ProxyExpressDBMType">ProxyExpressDBMType</span> Directive <a title="Permanent link" href="#proxyexpressdbmtype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>DBM type of file.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyExpressDBMType <var>type</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyExpressEnable" id="ProxyExpressEnable">ProxyExpressEnable</a> <a name="proxyexpressenable" id="proxyexpressenable">Directive</a> <a title="Permanent link" href="#proxyexpressenable" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyexpressenable"><span id="ProxyExpressEnable">ProxyExpressEnable</span> Directive <a title="Permanent link" href="#proxyexpressenable" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the module functionality.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyExpressEnable on|off</code></td></tr>
<a href="../fr/mod/mod_proxy_express.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>Remember, in order to make the following examples work, you have to
enable <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> and <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>.</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="env" id="env">Environment Variables</a> <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
+<h2
id="env">Environment Variables <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
<p>In addition to the configuration directives that control the
behavior of <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, there are a number of
<dfn>environment variables</dfn> that control the FCGI protocol
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyFCGIBackendType" id="ProxyFCGIBackendType">ProxyFCGIBackendType</a> <a name="proxyfcgibackendtype" id="proxyfcgibackendtype">Directive</a> <a title="Permanent link" href="#proxyfcgibackendtype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyfcgibackendtype"><span id="ProxyFCGIBackendType">ProxyFCGIBackendType</span> Directive <a title="Permanent link" href="#proxyfcgibackendtype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify the type of backend FastCGI application</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyFCGIBackendType FPM|GENERIC</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyFCGISetEnvIf" id="ProxyFCGISetEnvIf">ProxyFCGISetEnvIf</a> <a name="proxyfcgisetenvif" id="proxyfcgisetenvif">Directive</a> <a title="Permanent link" href="#proxyfcgisetenvif" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyfcgisetenvif"><span id="ProxyFCGISetEnvIf">ProxyFCGISetEnvIf</span> Directive <a title="Permanent link" href="#proxyfcgisetenvif" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow variables sent to FastCGI servers to be fixed up</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyFCGISetEnvIf <var>conditional-expression</var>
<a href="../fr/mod/mod_proxy_fcgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_proxy_fdpass.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="mimetypes" id="mimetypes">Why doesn't file type <var>xxx</var>
- download via FTP?
</a> <a title="Permanent link" href="#mimetypes" class="permalink">¶</a></h2>
+<h2 id="mimetypes">Why doesn't file type <var>xxx</var>
+ download via FTP? <a title="Permanent link" href="#mimetypes" class="permalink">¶</a></h2>
<p>You probably don't have that particular file type defined as
<code>application/octet-stream</code> in your proxy's mime.types
configuration file. A useful line can be:</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="type" id="type">How can I force an FTP ASCII download of
- file <var>xxx</var>?
</a> <a title="Permanent link" href="#type" class="permalink">¶</a></h2>
+<h2 id="type">How can I force an FTP ASCII download of
+ file <var>xxx</var>? <a title="Permanent link" href="#type" class="permalink">¶</a></h2>
<p>In the rare situation where you must download a specific file using the
FTP <code>ASCII</code> transfer method (while the default transfer is in
<code>binary</code> mode), you can override <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>'s
however.)</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ftpnonget" id="ftpnonget">How can I do FTP upload?</a> <a title="Permanent link" href="#ftpnonget" class="permalink">¶</a></h2>
+<h2
id="ftpnonget">How can I do FTP upload? <a title="Permanent link" href="#ftpnonget" class="permalink">¶</a></h2>
<p>Currently, only GET is supported for FTP in <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. You can
of course use HTTP upload (POST or PUT) through an Apache proxy.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="percent2fhck" id="percent2fhck">How can I access FTP files outside
- of my home directory?
</a> <a title="Permanent link" href="#percent2fhck" class="permalink">¶</a></h2>
+<h2 id="percent2fhck">How can I access FTP files outside
+ of my home directory? <a title="Permanent link" href="#percent2fhck" class="permalink">¶</a></h2>
<p>An FTP URI is interpreted relative to the home directory of the user
who is logging in. Alas, to reach higher directory levels you cannot
use /../, as the dots are interpreted by the browser and not actually
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="ftppass" id="ftppass">How can I hide the FTP cleartext password
- in my browser's URL line?
</a> <a title="Permanent link" href="#ftppass" class="permalink">¶</a></h2>
+<h2 id="ftppass">How can I hide the FTP cleartext password
+ in my browser's URL line? <a title="Permanent link" href="#ftppass" class="permalink">¶</a></h2>
<p>To log in to an FTP server by username and password, Apache uses
different strategies. In absence of a user name and password in the URL
altogether, Apache sends an anonymous login to the FTP server,
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="wildcard" id="wildcard">Why do I get a file listing when I expected
- a file to be downloaded?
</a> <a title="Permanent link" href="#wildcard" class="permalink">¶</a></h2>
+<h2 id="wildcard">Why do I get a file listing when I expected
+ a file to be downloaded? <a title="Permanent link" href="#wildcard" class="permalink">¶</a></h2>
<p>In order to allow both browsing the directories on an FTP server and
downloading files, Apache looks at the request URL. If it looks like
a directory, or contains wildcard characters ("*?[{~"), then it
</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyFtpDirCharset" id="ProxyFtpDirCharset">ProxyFtpDirCharset</a> <a name="proxyftpdircharset" id="proxyftpdircharset">Directive</a> <a title="Permanent link" href="#proxyftpdircharset" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyftpdircharset"><span id="ProxyFtpDirCharset">ProxyFtpDirCharset</span> Directive <a title="Permanent link" href="#proxyftpdircharset" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the character set for proxied FTP listings</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyFtpDirCharset <var>character_set</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyFtpEscapeWildcards" id="ProxyFtpEscapeWildcards">ProxyFtpEscapeWildcards</a> <a name="proxyftpescapewildcards" id="proxyftpescapewildcards">Directive</a> <a title="Permanent link" href="#proxyftpescapewildcards" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyftpescapewildcards"><span id="ProxyFtpEscapeWildcards">ProxyFtpEscapeWildcards</span> Directive <a title="Permanent link" href="#proxyftpescapewildcards" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether wildcards in requested filenames are escaped when sent to the FTP server</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyFtpEscapeWildcards on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyFtpListOnWildcard" id="ProxyFtpListOnWildcard">ProxyFtpListOnWildcard</a> <a name="proxyftplistonwildcard" id="proxyftplistonwildcard">Directive</a> <a title="Permanent link" href="#proxyftplistonwildcard" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyftplistonwildcard"><span id="ProxyFtpListOnWildcard">ProxyFtpListOnWildcard</span> Directive <a title="Permanent link" href="#proxyftplistonwildcard" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether wildcards in requested filenames trigger a file listing</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyFtpListOnWildcard on|off</code></td></tr>
<a href="../fr/mod/mod_proxy_ftp.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Usage examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Usage examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>The following example shows how one might configured health checking
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHCExpr" id="ProxyHCExpr">ProxyHCExpr</a> <a name="proxyhcexpr" id="proxyhcexpr">Directive</a> <a title="Permanent link" href="#proxyhcexpr" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhcexpr"><span id="ProxyHCExpr">ProxyHCExpr</span> Directive <a title="Permanent link" href="#proxyhcexpr" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Creates a named condition expression to use to determine health of the backend based on its response</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCExpr <em>name</em> {<em>ap_expr expression</em>}</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHCTemplate" id="ProxyHCTemplate">ProxyHCTemplate</a> <a name="proxyhctemplate" id="proxyhctemplate">Directive</a> <a title="Permanent link" href="#proxyhctemplate" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhctemplate"><span id="ProxyHCTemplate">ProxyHCTemplate</span> Directive <a title="Permanent link" href="#proxyhctemplate" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Creates a named template for setting various health check parameters</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCTemplate <em>name</em> <em>parameter</em>=<em>setting</em> [...]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHCTPsize" id="ProxyHCTPsize">ProxyHCTPsize</a> <a name="proxyhctpsize" id="proxyhctpsize">Directive</a> <a title="Permanent link" href="#proxyhctpsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhctpsize"><span id="ProxyHCTPsize">ProxyHCTPsize</span> Directive <a title="Permanent link" href="#proxyhctpsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the total server-wide size of the threadpool used for the health check workers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCTPsize <em>size</em></code></td></tr>
<a href="../fr/mod/mod_proxy_hcheck.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_proxy_html">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_proxy_html">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="intro" id="intro">Introduction</a> <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
+<h2
id="intro">Introduction <a title="Permanent link" href="#intro" class="permalink">¶</a></h2>
<p>mod_proxy_html was originally a third-party module for Apache HTTPD
2.0.x and later versions. It was donated to the ASF in 2011 along with
<code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> (see <a href="#i18n">Internationalisation</a>)
and is a standard module in HTTPD 2.4 and development versions.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="custom" id="custom">Customized HTML Parsing</a> <a title="Permanent link" href="#custom" class="permalink">¶</a></h2>
+<h2
id="custom">Customized HTML Parsing <a title="Permanent link" href="#custom" class="permalink">¶</a></h2>
<p>Internally, mod_proxy_html uses the HTMLParser module from the
third-party <a href="http://xmlsoft.org/">libxml2</a> library.
Unlike other libxml2 parsers, HTMLParser deals with HTML without
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="i18n" id="i18n">Internationalisation</a> <a title="Permanent link" href="#i18n" class="permalink">¶</a></h2>
+<h2
id="i18n">Internationalisation <a title="Permanent link" href="#i18n" class="permalink">¶</a></h2>
<p>Internally, mod_proxy_html uses a smart HTML parser from the
third-party <a href="http://xmlsoft.org/">libxml2</a> library.
The parser uses Unicode (utf-8) internally. This makes it a
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLBufSize" id="ProxyHTMLBufSize">ProxyHTMLBufSize</a> <a name="proxyhtmlbufsize" id="proxyhtmlbufsize">Directive</a> <a title="Permanent link" href="#proxyhtmlbufsize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlbufsize"><span id="ProxyHTMLBufSize">ProxyHTMLBufSize</span> Directive <a title="Permanent link" href="#proxyhtmlbufsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the buffer size increment for buffering inline scripts and
stylesheets.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLCharsetOut" id="ProxyHTMLCharsetOut">ProxyHTMLCharsetOut</a> <a name="proxyhtmlcharsetout" id="proxyhtmlcharsetout">Directive</a> <a title="Permanent link" href="#proxyhtmlcharsetout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlcharsetout"><span id="ProxyHTMLCharsetOut">ProxyHTMLCharsetOut</span> Directive <a title="Permanent link" href="#proxyhtmlcharsetout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a charset for mod_proxy_html output.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHTMLCharsetOut <var>Charset | *</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLDocType" id="ProxyHTMLDocType">ProxyHTMLDocType</a> <a name="proxyhtmldoctype" id="proxyhtmldoctype">Directive</a> <a title="Permanent link" href="#proxyhtmldoctype" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmldoctype"><span id="ProxyHTMLDocType">ProxyHTMLDocType</span> Directive <a title="Permanent link" href="#proxyhtmldoctype" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets an HTML or XHTML document type declaration.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHTMLDocType HTML|XHTML [Legacy]<br><strong>OR</strong>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLEnable" id="ProxyHTMLEnable">ProxyHTMLEnable</a> <a name="proxyhtmlenable" id="proxyhtmlenable">Directive</a> <a title="Permanent link" href="#proxyhtmlenable" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlenable"><span id="ProxyHTMLEnable">ProxyHTMLEnable</span> Directive <a title="Permanent link" href="#proxyhtmlenable" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Turns the proxy_html filter on or off.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHTMLEnable On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLEvents" id="ProxyHTMLEvents">ProxyHTMLEvents</a> <a name="proxyhtmlevents" id="proxyhtmlevents">Directive</a> <a title="Permanent link" href="#proxyhtmlevents" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlevents"><span id="ProxyHTMLEvents">ProxyHTMLEvents</span> Directive <a title="Permanent link" href="#proxyhtmlevents" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify attributes to treat as scripting events.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHTMLEvents <var>attribute [attribute ...]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLExtended" id="ProxyHTMLExtended">ProxyHTMLExtended</a> <a name="proxyhtmlextended" id="proxyhtmlextended">Directive</a> <a title="Permanent link" href="#proxyhtmlextended" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlextended"><span id="ProxyHTMLExtended">ProxyHTMLExtended</span> Directive <a title="Permanent link" href="#proxyhtmlextended" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether to fix links in inline scripts, stylesheets,
and scripting events.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLFixups" id="ProxyHTMLFixups">ProxyHTMLFixups</a> <a name="proxyhtmlfixups" id="proxyhtmlfixups">Directive</a> <a title="Permanent link" href="#proxyhtmlfixups" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlfixups"><span id="ProxyHTMLFixups">ProxyHTMLFixups</span> Directive <a title="Permanent link" href="#proxyhtmlfixups" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fixes for simple HTML errors.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHTMLFixups [lowercase] [dospath] [reset]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLInterp" id="ProxyHTMLInterp">ProxyHTMLInterp</a> <a name="proxyhtmlinterp" id="proxyhtmlinterp">Directive</a> <a title="Permanent link" href="#proxyhtmlinterp" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlinterp"><span id="ProxyHTMLInterp">ProxyHTMLInterp</span> Directive <a title="Permanent link" href="#proxyhtmlinterp" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables per-request interpolation of
<code class="directive">ProxyHTMLURLMap</code> rules.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLLinks" id="ProxyHTMLLinks">ProxyHTMLLinks</a> <a name="proxyhtmllinks" id="proxyhtmllinks">Directive</a> <a title="Permanent link" href="#proxyhtmllinks" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmllinks"><span id="ProxyHTMLLinks">ProxyHTMLLinks</span> Directive <a title="Permanent link" href="#proxyhtmllinks" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify HTML elements that have URL attributes to be rewritten.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHTMLLinks <var>element attribute [attribute2 ...]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLMeta" id="ProxyHTMLMeta">ProxyHTMLMeta</a> <a name="proxyhtmlmeta" id="proxyhtmlmeta">Directive</a> <a title="Permanent link" href="#proxyhtmlmeta" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlmeta"><span id="ProxyHTMLMeta">ProxyHTMLMeta</span> Directive <a title="Permanent link" href="#proxyhtmlmeta" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Turns on or off extra pre-parsing of metadata in HTML
<code><head></code> sections.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLStripComments" id="ProxyHTMLStripComments">ProxyHTMLStripComments</a> <a name="proxyhtmlstripcomments" id="proxyhtmlstripcomments">Directive</a> <a title="Permanent link" href="#proxyhtmlstripcomments" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlstripcomments"><span id="ProxyHTMLStripComments">ProxyHTMLStripComments</span> Directive <a title="Permanent link" href="#proxyhtmlstripcomments" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether to strip HTML comments.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHTMLStripComments On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyHTMLURLMap" id="ProxyHTMLURLMap">ProxyHTMLURLMap</a> <a name="proxyhtmlurlmap" id="proxyhtmlurlmap">Directive</a> <a title="Permanent link" href="#proxyhtmlurlmap" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyhtmlurlmap"><span id="ProxyHTMLURLMap">ProxyHTMLURLMap</span> Directive <a title="Permanent link" href="#proxyhtmlurlmap" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a rule to rewrite HTML links</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHTMLURLMap <var>from-pattern to-pattern [flags] [cond]</var></code></td></tr>
<a href="../fr/mod/mod_proxy_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="env" id="env">Environment Variables</a> <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
+<h2
id="env">Environment Variables <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
<p>In addition to the configuration directives that control the
behavior of <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, there are a number of
<dfn>environment variables</dfn> that control the HTTP protocol
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="notes" id="notes">Request notes</a> <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
+<h2
id="notes">Request notes <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> creates the following request notes for
logging using the <code>%{VARNAME}n</code> format in
<code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> or
<a href="../fr/mod/mod_proxy_http.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Basic Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Basic Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>The examples below demonstrate how to configure HTTP/2 for
backend connections for a reverse proxy. </p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="notes" id="notes">Request notes</a> <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
+<h2
id="notes">Request notes <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> creates the following request notes for
logging using the <code>%{VARNAME}n</code> format in
<code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> or
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="h2push" id="h2push">HTTP/2 PUSH</a> <a title="Permanent link" href="#h2push" class="permalink">¶</a></h2>
+<h2
id="h2push">HTTP/2 PUSH <a title="Permanent link" href="#h2push" class="permalink">¶</a></h2>
<p>The module does not support the HTTP/2 feature PUSH. Backend servers
that would like to advertise preload resources should send the appropriate
<code>Link</code> headers.</p>
<a href="../fr/mod/mod_proxy_http2.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>Remember, in order to make the following examples work, you have to
enable <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> and <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>.</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="env" id="env">Environment Variables</a> <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
+<h2
id="env">Environment Variables <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
<p>In addition to the configuration directives that control the
behavior of <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, an <dfn>environment
variable</dfn> may also control the SCGI protocol
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxySCGIInternalRedirect" id="ProxySCGIInternalRedirect">ProxySCGIInternalRedirect</a> <a name="proxyscgiinternalredirect" id="proxyscgiinternalredirect">Directive</a> <a title="Permanent link" href="#proxyscgiinternalredirect" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyscgiinternalredirect"><span id="ProxySCGIInternalRedirect">ProxySCGIInternalRedirect</span> Directive <a title="Permanent link" href="#proxyscgiinternalredirect" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable internal redirect responses from the
backend</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxySCGISendfile" id="ProxySCGISendfile">ProxySCGISendfile</a> <a name="proxyscgisendfile" id="proxyscgisendfile">Directive</a> <a title="Permanent link" href="#proxyscgisendfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxyscgisendfile"><span id="ProxySCGISendfile">ProxySCGISendfile</span> Directive <a title="Permanent link" href="#proxyscgisendfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable evaluation of <var>X-Sendfile</var> pseudo response
header</td></tr>
<a href="../fr/mod/mod_proxy_scgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>Remember, in order to make the following examples work, you have to
enable <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> and <code class="module"><a href="../mod/mod_proxy_uwsgi.html">mod_proxy_uwsgi</a></code>.</p>
<a href="../fr/mod/mod_proxy_uwsgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyWebsocketAsync" id="ProxyWebsocketAsync">ProxyWebsocketAsync</a> <a name="proxywebsocketasync" id="proxywebsocketasync">Directive</a> <a title="Permanent link" href="#proxywebsocketasync" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxywebsocketasync"><span id="ProxyWebsocketAsync">ProxyWebsocketAsync</span> Directive <a title="Permanent link" href="#proxywebsocketasync" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Instructs this module to try to create an asynchronous tunnel</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyWebsocketAsync ON|OFF</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyWebsocketAsyncDelay" id="ProxyWebsocketAsyncDelay">ProxyWebsocketAsyncDelay</a> <a name="proxywebsocketasyncdelay" id="proxywebsocketasyncdelay">Directive</a> <a title="Permanent link" href="#proxywebsocketasyncdelay" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxywebsocketasyncdelay"><span id="ProxyWebsocketAsyncDelay">ProxyWebsocketAsyncDelay</span> Directive <a title="Permanent link" href="#proxywebsocketasyncdelay" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the amount of time the tunnel waits synchronously for data</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyWebsocketAsyncDelay <var>num</var>[ms]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyWebsocketFallbackToProxyHttp" id="ProxyWebsocketFallbackToProxyHttp">ProxyWebsocketFallbackToProxyHttp</a> <a name="proxywebsocketfallbacktoproxyhttp" id="proxywebsocketfallbacktoproxyhttp">Directive</a> <a title="Permanent link" href="#proxywebsocketfallbacktoproxyhttp" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxywebsocketfallbacktoproxyhttp"><span id="ProxyWebsocketFallbackToProxyHttp">ProxyWebsocketFallbackToProxyHttp</span> Directive <a title="Permanent link" href="#proxywebsocketfallbacktoproxyhttp" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Instructs this module to let <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> handle the request</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyWebsocketFallbackToProxyHttp On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ProxyWebsocketIdleTimeout" id="ProxyWebsocketIdleTimeout">ProxyWebsocketIdleTimeout</a> <a name="proxywebsocketidletimeout" id="proxywebsocketidletimeout">Directive</a> <a title="Permanent link" href="#proxywebsocketidletimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="proxywebsocketidletimeout"><span id="ProxyWebsocketIdleTimeout">ProxyWebsocketIdleTimeout</span> Directive <a title="Permanent link" href="#proxywebsocketidletimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the maximum amount of time to wait for data on the websockets tunnel</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyWebsocketIdleTimeout <var>num</var>[ms]</code></td></tr>
<a href="../fr/mod/mod_proxy_wstunnel.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_ratelimit.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_reflector">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_reflector">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<dl>
<dt>Compression service</dt>
<dd>Pass the request body through the DEFLATE filter to compress the
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ReflectorHeader" id="ReflectorHeader">ReflectorHeader</a> <a name="reflectorheader" id="reflectorheader">Directive</a> <a title="Permanent link" href="#reflectorheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="reflectorheader"><span id="ReflectorHeader">ReflectorHeader</span> Directive <a title="Permanent link" href="#reflectorheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Reflect an input header to the output headers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ReflectorHeader <var>inputheader</var> <var>[outputheader]</var></code></td></tr>
<a href="../fr/mod/mod_reflector.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="processing" id="processing">Remote IP Processing</a> <a title="Permanent link" href="#processing" class="permalink">¶</a></h2>
+<h2
id="processing">Remote IP Processing <a title="Permanent link" href="#processing" class="permalink">¶</a></h2>
<p>Apache by default identifies the useragent with the connection's
client_ip value, and the connection remote_host and remote_logname are
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoteIPHeader" id="RemoteIPHeader">RemoteIPHeader</a> <a name="remoteipheader" id="remoteipheader">Directive</a> <a title="Permanent link" href="#remoteipheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="remoteipheader"><span id="RemoteIPHeader">RemoteIPHeader</span> Directive <a title="Permanent link" href="#remoteipheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare the header field which should be parsed for useragent IP addresses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoteIPHeader <var>header-field</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoteIPInternalProxy" id="RemoteIPInternalProxy">RemoteIPInternalProxy</a> <a name="remoteipinternalproxy" id="remoteipinternalproxy">Directive</a> <a title="Permanent link" href="#remoteipinternalproxy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="remoteipinternalproxy"><span id="RemoteIPInternalProxy">RemoteIPInternalProxy</span> Directive <a title="Permanent link" href="#remoteipinternalproxy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare client intranet IP addresses trusted to present the RemoteIPHeader value</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoteIPInternalProxy <var>proxy-ip</var>|<var>proxy-ip/subnet</var>|<var>hostname</var> ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoteIPInternalProxyList" id="RemoteIPInternalProxyList">RemoteIPInternalProxyList</a> <a name="remoteipinternalproxylist" id="remoteipinternalproxylist">Directive</a> <a title="Permanent link" href="#remoteipinternalproxylist" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="remoteipinternalproxylist"><span id="RemoteIPInternalProxyList">RemoteIPInternalProxyList</span> Directive <a title="Permanent link" href="#remoteipinternalproxylist" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare client intranet IP addresses trusted to present the RemoteIPHeader value</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoteIPInternalProxyList <var>filename</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoteIPProxiesHeader" id="RemoteIPProxiesHeader">RemoteIPProxiesHeader</a> <a name="remoteipproxiesheader" id="remoteipproxiesheader">Directive</a> <a title="Permanent link" href="#remoteipproxiesheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="remoteipproxiesheader"><span id="RemoteIPProxiesHeader">RemoteIPProxiesHeader</span> Directive <a title="Permanent link" href="#remoteipproxiesheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare the header field which will record all intermediate IP addresses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoteIPProxiesHeader <var>HeaderFieldName</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoteIPProxyProtocol" id="RemoteIPProxyProtocol">RemoteIPProxyProtocol</a> <a name="remoteipproxyprotocol" id="remoteipproxyprotocol">Directive</a> <a title="Permanent link" href="#remoteipproxyprotocol" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="remoteipproxyprotocol"><span id="RemoteIPProxyProtocol">RemoteIPProxyProtocol</span> Directive <a title="Permanent link" href="#remoteipproxyprotocol" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable PROXY protocol handling</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoteIPProxyProtocol On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoteIPProxyProtocolExceptions" id="RemoteIPProxyProtocolExceptions">RemoteIPProxyProtocolExceptions</a> <a name="remoteipproxyprotocolexceptions" id="remoteipproxyprotocolexceptions">Directive</a> <a title="Permanent link" href="#remoteipproxyprotocolexceptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="remoteipproxyprotocolexceptions"><span id="RemoteIPProxyProtocolExceptions">RemoteIPProxyProtocolExceptions</span> Directive <a title="Permanent link" href="#remoteipproxyprotocolexceptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disable processing of PROXY header for certain hosts or networks</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoteIPProxyProtocolExceptions host|range [host|range] [host|range]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoteIPTrustedProxy" id="RemoteIPTrustedProxy">RemoteIPTrustedProxy</a> <a name="remoteiptrustedproxy" id="remoteiptrustedproxy">Directive</a> <a title="Permanent link" href="#remoteiptrustedproxy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="remoteiptrustedproxy"><span id="RemoteIPTrustedProxy">RemoteIPTrustedProxy</span> Directive <a title="Permanent link" href="#remoteiptrustedproxy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict client IP addresses trusted to present the RemoteIPHeader value</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoteIPTrustedProxy <var>proxy-ip</var>|<var>proxy-ip/subnet</var>|<var>hostname</var> ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RemoteIPTrustedProxyList" id="RemoteIPTrustedProxyList">RemoteIPTrustedProxyList</a> <a name="remoteiptrustedproxylist" id="remoteiptrustedproxylist">Directive</a> <a title="Permanent link" href="#remoteiptrustedproxylist" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="remoteiptrustedproxylist"><span id="RemoteIPTrustedProxyList">RemoteIPTrustedProxyList</span> Directive <a title="Permanent link" href="#remoteiptrustedproxylist" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict client IP addresses trusted to present the RemoteIPHeader value</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoteIPTrustedProxyList <var>filename</var></code></td></tr>
<a href="../fr/mod/mod_remoteip.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_reqtimeout">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_reqtimeout">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<ol>
<li>
</ol>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RequestReadTimeout" id="RequestReadTimeout">RequestReadTimeout</a> <a name="requestreadtimeout" id="requestreadtimeout">Directive</a> <a title="Permanent link" href="#requestreadtimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="requestreadtimeout"><span id="RequestReadTimeout">RequestReadTimeout</span> Directive <a title="Permanent link" href="#requestreadtimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set timeout values for completing the TLS handshake, receiving
the request headers and/or body from client.
<a href="../fr/mod/mod_reqtimeout.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_request">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_request">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="KeptBodySize" id="KeptBodySize">KeptBodySize</a> <a name="keptbodysize" id="keptbodysize">Directive</a> <a title="Permanent link" href="#keptbodysize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="keptbodysize"><span id="KeptBodySize">KeptBodySize</span> Directive <a title="Permanent link" href="#keptbodysize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keep the request body instead of discarding it up to
the specified maximum size, for potential use by filters such as
<a href="../tr/mod/mod_request.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logging" id="logging">Logging</a> <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
+<h2
id="logging">Logging <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> offers detailed logging of its actions
at the <code>trace1</code> to <code>trace8</code> log levels. The
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RewriteBase" id="RewriteBase">RewriteBase</a> <a name="rewritebase" id="rewritebase">Directive</a> <a title="Permanent link" href="#rewritebase" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rewritebase"><span id="RewriteBase">RewriteBase</span> Directive <a title="Permanent link" href="#rewritebase" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the base URL for per-directory rewrites</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RewriteBase <em>URL-path</em></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RewriteCond" id="RewriteCond">RewriteCond</a> <a name="rewritecond" id="rewritecond">Directive</a> <a title="Permanent link" href="#rewritecond" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rewritecond"><span id="RewriteCond">RewriteCond</span> Directive <a title="Permanent link" href="#rewritecond" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a condition under which rewriting will take place
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RewriteEngine" id="RewriteEngine">RewriteEngine</a> <a name="rewriteengine" id="rewriteengine">Directive</a> <a title="Permanent link" href="#rewriteengine" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rewriteengine"><span id="RewriteEngine">RewriteEngine</span> Directive <a title="Permanent link" href="#rewriteengine" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables or disables runtime rewriting engine</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RewriteEngine on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RewriteMap" id="RewriteMap">RewriteMap</a> <a name="rewritemap" id="rewritemap">Directive</a> <a title="Permanent link" href="#rewritemap" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rewritemap"><span id="RewriteMap">RewriteMap</span> Directive <a title="Permanent link" href="#rewritemap" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a mapping function for key-lookup</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RewriteOptions" id="RewriteOptions">RewriteOptions</a> <a name="rewriteoptions" id="rewriteoptions">Directive</a> <a title="Permanent link" href="#rewriteoptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rewriteoptions"><span id="RewriteOptions">RewriteOptions</span> Directive <a title="Permanent link" href="#rewriteoptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets some special options for the rewrite engine</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RewriteOptions <var>Options</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RewriteRule" id="RewriteRule">RewriteRule</a> <a name="rewriterule" id="rewriterule">Directive</a> <a title="Permanent link" href="#rewriterule" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="rewriterule"><span id="RewriteRule">RewriteRule</span> Directive <a title="Permanent link" href="#rewriterule" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines rules for the rewriting engine</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RewriteRule
<a href="../fr/mod/mod_rewrite.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_sed">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_sed">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="sampleconf" id="sampleconf">Sample Configuration</a> <a title="Permanent link" href="#sampleconf" class="permalink">¶</a></h2>
+<h2
id="sampleconf">Sample Configuration <a title="Permanent link" href="#sampleconf" class="permalink">¶</a></h2>
<div class="example"><h3>Adding an output filter </h3><pre class="prettyprint lang-config"># In the following example, the sed filter will change the string
# "monday" to "MON" and the string "sunday" to SUN in html documents
# before sending to the client.
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="sed_commands" id="sed_commands">Sed Commands</a> <a title="Permanent link" href="#sed_commands" class="permalink">¶</a></h2>
+<h2
id="sed_commands">Sed Commands <a title="Permanent link" href="#sed_commands" class="permalink">¶</a></h2>
<p>
Complete details of the <code>sed</code> command can be found from the
<a href="http://www.gnu.org/software/sed/manual/sed.txt">sed manual
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="InputSed" id="InputSed">InputSed</a> <a name="inputsed" id="inputsed">Directive</a> <a title="Permanent link" href="#inputsed" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="inputsed"><span id="InputSed">InputSed</span> Directive <a title="Permanent link" href="#inputsed" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sed command to filter request data (typically <code>POST</code> data)</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>InputSed <var>sed-command</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="OutputSed" id="OutputSed">OutputSed</a> <a name="outputsed" id="outputsed">Directive</a> <a title="Permanent link" href="#outputsed" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="outputsed"><span id="OutputSed">OutputSed</span> Directive <a title="Permanent link" href="#outputsed" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sed command for filtering response content</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>OutputSed <var>sed-command</var></code></td></tr>
<a href="../fr/mod/mod_sed.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="whatisasession" id="whatisasession">What is a session?</a> <a title="Permanent link" href="#whatisasession" class="permalink">¶</a></h2>
+<h2
id="whatisasession">What is a session? <a title="Permanent link" href="#whatisasession" class="permalink">¶</a></h2>
<p>At the core of the session interface is a table of key and value pairs
that are made accessible across browser requests. These pairs can be set
to any valid string, as needed by the application making use of the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="whocanuseasession" id="whocanuseasession">Who can use a session?</a> <a title="Permanent link" href="#whocanuseasession" class="permalink">¶</a></h2>
+<h2
id="whocanuseasession">Who can use a session? <a title="Permanent link" href="#whocanuseasession" class="permalink">¶</a></h2>
<p>The session interface is primarily developed for the use by other
server modules, such as <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, however CGI
based applications can optionally be granted access to the contents
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="serversession" id="serversession">Keeping sessions on the server</a> <a title="Permanent link" href="#serversession" class="permalink">¶</a></h2>
+<h2
id="serversession">Keeping sessions on the server <a title="Permanent link" href="#serversession" class="permalink">¶</a></h2>
<p>Apache can be configured to keep track of per user sessions stored
on a particular server or group of servers. This functionality is
similar to the sessions available in typical application servers.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="browsersession" id="browsersession">Keeping sessions on the browser</a> <a title="Permanent link" href="#browsersession" class="permalink">¶</a></h2>
+<h2
id="browsersession">Keeping sessions on the browser <a title="Permanent link" href="#browsersession" class="permalink">¶</a></h2>
<p>In high traffic environments where keeping track of a session on a
server is too resource intensive or inconvenient, the option exists to store
the contents of the session within a cookie on the client browser instead.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basicexamples" id="basicexamples">Basic Examples</a> <a title="Permanent link" href="#basicexamples" class="permalink">¶</a></h2>
+<h2
id="basicexamples">Basic Examples <a title="Permanent link" href="#basicexamples" class="permalink">¶</a></h2>
<p>Creating a session is as simple as turning the session on, and deciding
where the session will be stored. In this example, the session will be
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="sessionprivacy" id="sessionprivacy">Session Privacy</a> <a title="Permanent link" href="#sessionprivacy" class="permalink">¶</a></h2>
+<h2
id="sessionprivacy">Session Privacy <a title="Permanent link" href="#sessionprivacy" class="permalink">¶</a></h2>
<p>Using the "show cookies" feature of your browser, you would have seen
a clear text representation of the session. This could potentially be a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cookieprivacy" id="cookieprivacy">Cookie Privacy</a> <a title="Permanent link" href="#cookieprivacy" class="permalink">¶</a></h2>
+<h2
id="cookieprivacy">Cookie Privacy <a title="Permanent link" href="#cookieprivacy" class="permalink">¶</a></h2>
<p>The HTTP cookie mechanism also offers privacy features, such as the
ability to restrict cookie transport to SSL protected pages only, or
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="authentication" id="authentication">Session Support for Authentication</a> <a title="Permanent link" href="#authentication" class="permalink">¶</a></h2>
+<h2
id="authentication">Session Support for Authentication <a title="Permanent link" href="#authentication" class="permalink">¶</a></h2>
<p>As is possible within many application servers, authentication modules can use
a session for storing the username and password after login. The
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="integration" id="integration">Integrating Sessions with External Applications</a> <a title="Permanent link" href="#integration" class="permalink">¶</a></h2>
+<h2
id="integration">Integrating Sessions with External Applications <a title="Permanent link" href="#integration" class="permalink">¶</a></h2>
<p>In order for sessions to be useful, it must be possible to share the contents
of a session with external applications, and it must be possible for an
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Session" id="Session">Session</a> <a name="session" id="session">Directive</a> <a title="Permanent link" href="#session" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="session"><span id="Session">Session</span> Directive <a title="Permanent link" href="#session" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables a session for the current directory or location</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Session On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionEnv" id="SessionEnv">SessionEnv</a> <a name="sessionenv" id="sessionenv">Directive</a> <a title="Permanent link" href="#sessionenv" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessionenv"><span id="SessionEnv">SessionEnv</span> Directive <a title="Permanent link" href="#sessionenv" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control whether the contents of the session are written to the
<var>HTTP_SESSION</var> environment variable</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionExclude" id="SessionExclude">SessionExclude</a> <a name="sessionexclude" id="sessionexclude">Directive</a> <a title="Permanent link" href="#sessionexclude" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessionexclude"><span id="SessionExclude">SessionExclude</span> Directive <a title="Permanent link" href="#sessionexclude" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define URL prefixes for which a session is ignored</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionExclude <var>path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionExpiryUpdateInterval" id="SessionExpiryUpdateInterval">SessionExpiryUpdateInterval</a> <a name="sessionexpiryupdateinterval" id="sessionexpiryupdateinterval">Directive</a> <a title="Permanent link" href="#sessionexpiryupdateinterval" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessionexpiryupdateinterval"><span id="SessionExpiryUpdateInterval">SessionExpiryUpdateInterval</span> Directive <a title="Permanent link" href="#sessionexpiryupdateinterval" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the number of seconds a session's expiry may change without
the session being updated</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionHeader" id="SessionHeader">SessionHeader</a> <a name="sessionheader" id="sessionheader">Directive</a> <a title="Permanent link" href="#sessionheader" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessionheader"><span id="SessionHeader">SessionHeader</span> Directive <a title="Permanent link" href="#sessionheader" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Import session updates from a given HTTP response header</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionHeader <var>header</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionInclude" id="SessionInclude">SessionInclude</a> <a name="sessioninclude" id="sessioninclude">Directive</a> <a title="Permanent link" href="#sessioninclude" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioninclude"><span id="SessionInclude">SessionInclude</span> Directive <a title="Permanent link" href="#sessioninclude" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define URL prefixes for which a session is valid</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionInclude <var>path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionMaxAge" id="SessionMaxAge">SessionMaxAge</a> <a name="sessionmaxage" id="sessionmaxage">Directive</a> <a title="Permanent link" href="#sessionmaxage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessionmaxage"><span id="SessionMaxAge">SessionMaxAge</span> Directive <a title="Permanent link" href="#sessionmaxage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a maximum age in seconds for a session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionMaxAge <var>maxage</var></code></td></tr>
<a href="../fr/mod/mod_session.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basicexamples" id="basicexamples">Basic Examples</a> <a title="Permanent link" href="#basicexamples" class="permalink">¶</a></h2>
+<h2
id="basicexamples">Basic Examples <a title="Permanent link" href="#basicexamples" class="permalink">¶</a></h2>
<p>To create a simple session and store it in a cookie called
<var>session</var>, configure the session as follows:</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionCookieMaxAge" id="SessionCookieMaxAge">SessionCookieMaxAge</a> <a name="sessioncookiemaxage" id="sessioncookiemaxage">Directive</a> <a title="Permanent link" href="#sessioncookiemaxage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioncookiemaxage"><span id="SessionCookieMaxAge">SessionCookieMaxAge</span> Directive <a title="Permanent link" href="#sessioncookiemaxage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control whether session cookies have Max-Age transmitted to the client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionCookieMaxAge On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionCookieName" id="SessionCookieName">SessionCookieName</a> <a name="sessioncookiename" id="sessioncookiename">Directive</a> <a title="Permanent link" href="#sessioncookiename" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioncookiename"><span id="SessionCookieName">SessionCookieName</span> Directive <a title="Permanent link" href="#sessioncookiename" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2109 cookie storing the session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionCookieName <var>name</var> <var>attributes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionCookieName2" id="SessionCookieName2">SessionCookieName2</a> <a name="sessioncookiename2" id="sessioncookiename2">Directive</a> <a title="Permanent link" href="#sessioncookiename2" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioncookiename2"><span id="SessionCookieName2">SessionCookieName2</span> Directive <a title="Permanent link" href="#sessioncookiename2" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2965 cookie storing the session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionCookieName2 <var>name</var> <var>attributes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionCookieRemove" id="SessionCookieRemove">SessionCookieRemove</a> <a name="sessioncookieremove" id="sessioncookieremove">Directive</a> <a title="Permanent link" href="#sessioncookieremove" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioncookieremove"><span id="SessionCookieRemove">SessionCookieRemove</span> Directive <a title="Permanent link" href="#sessioncookieremove" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control for whether session cookies should be removed from incoming HTTP headers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionCookieRemove On|Off</code></td></tr>
<a href="../fr/mod/mod_session_cookie.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="basicusage" id="basicusage">Basic Usage</a> <a title="Permanent link" href="#basicusage" class="permalink">¶</a></h2>
+<h2
id="basicusage">Basic Usage <a title="Permanent link" href="#basicusage" class="permalink">¶</a></h2>
<p>To create a simple encrypted session and store it in a cookie called
<var>session</var>, configure the session as follows:</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionCryptoCipher" id="SessionCryptoCipher">SessionCryptoCipher</a> <a name="sessioncryptocipher" id="sessioncryptocipher">Directive</a> <a title="Permanent link" href="#sessioncryptocipher" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioncryptocipher"><span id="SessionCryptoCipher">SessionCryptoCipher</span> Directive <a title="Permanent link" href="#sessioncryptocipher" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The crypto cipher to be used to encrypt the session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionCryptoCipher <var>name</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionCryptoDriver" id="SessionCryptoDriver">SessionCryptoDriver</a> <a name="sessioncryptodriver" id="sessioncryptodriver">Directive</a> <a title="Permanent link" href="#sessioncryptodriver" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioncryptodriver"><span id="SessionCryptoDriver">SessionCryptoDriver</span> Directive <a title="Permanent link" href="#sessioncryptodriver" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The crypto driver to be used to encrypt the session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionCryptoDriver <var>name</var> <var>[param[=value]]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionCryptoPassphrase" id="SessionCryptoPassphrase">SessionCryptoPassphrase</a> <a name="sessioncryptopassphrase" id="sessioncryptopassphrase">Directive</a> <a title="Permanent link" href="#sessioncryptopassphrase" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioncryptopassphrase"><span id="SessionCryptoPassphrase">SessionCryptoPassphrase</span> Directive <a title="Permanent link" href="#sessioncryptopassphrase" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The key used to encrypt the session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionCryptoPassphrase <var>secret</var> [ <var>secret</var> ... ] </code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionCryptoPassphraseFile" id="SessionCryptoPassphraseFile">SessionCryptoPassphraseFile</a> <a name="sessioncryptopassphrasefile" id="sessioncryptopassphrasefile">Directive</a> <a title="Permanent link" href="#sessioncryptopassphrasefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessioncryptopassphrasefile"><span id="SessionCryptoPassphraseFile">SessionCryptoPassphraseFile</span> Directive <a title="Permanent link" href="#sessioncryptopassphrasefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File containing keys used to encrypt the session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionCryptoPassphraseFile <var>filename</var></code></td></tr>
<a href="../fr/mod/mod_session_crypto.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dbdconfig" id="dbdconfig">DBD Configuration</a> <a title="Permanent link" href="#dbdconfig" class="permalink">¶</a></h2>
+<h2
id="dbdconfig">DBD Configuration <a title="Permanent link" href="#dbdconfig" class="permalink">¶</a></h2>
<p>Before the <code class="module"><a href="../mod/mod_session_dbd.html">mod_session_dbd</a></code> module can be configured to maintain a
session, the <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> module must be configured to make the various database queries
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="anonymous" id="anonymous">Anonymous Sessions</a> <a title="Permanent link" href="#anonymous" class="permalink">¶</a></h2>
+<h2
id="anonymous">Anonymous Sessions <a title="Permanent link" href="#anonymous" class="permalink">¶</a></h2>
<p>Anonymous sessions are keyed against a unique UUID, and stored on the
browser within an HTTP cookie. This method is similar to that used by most
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="peruser" id="peruser">Per User Sessions</a> <a title="Permanent link" href="#peruser" class="permalink">¶</a></h2>
+<h2
id="peruser">Per User Sessions <a title="Permanent link" href="#peruser" class="permalink">¶</a></h2>
<p>Per user sessions are keyed against the username of a successfully
authenticated user. It offers the most privacy, as no external handle
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="housekeeping" id="housekeeping">Database Housekeeping</a> <a title="Permanent link" href="#housekeeping" class="permalink">¶</a></h2>
+<h2
id="housekeeping">Database Housekeeping <a title="Permanent link" href="#housekeeping" class="permalink">¶</a></h2>
<p>Over the course of time, the database can be expected to start accumulating
expired sessions. At this point, the <code class="module"><a href="../mod/mod_session_dbd.html">mod_session_dbd</a></code> module
is not yet able to handle session expiry automatically.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionDBDCookieName" id="SessionDBDCookieName">SessionDBDCookieName</a> <a name="sessiondbdcookiename" id="sessiondbdcookiename">Directive</a> <a title="Permanent link" href="#sessiondbdcookiename" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessiondbdcookiename"><span id="SessionDBDCookieName">SessionDBDCookieName</span> Directive <a title="Permanent link" href="#sessiondbdcookiename" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2109 cookie storing the session ID</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDCookieName <var>name</var> <var>attributes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionDBDCookieName2" id="SessionDBDCookieName2">SessionDBDCookieName2</a> <a name="sessiondbdcookiename2" id="sessiondbdcookiename2">Directive</a> <a title="Permanent link" href="#sessiondbdcookiename2" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessiondbdcookiename2"><span id="SessionDBDCookieName2">SessionDBDCookieName2</span> Directive <a title="Permanent link" href="#sessiondbdcookiename2" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2965 cookie storing the session ID</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDCookieName2 <var>name</var> <var>attributes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionDBDCookieRemove" id="SessionDBDCookieRemove">SessionDBDCookieRemove</a> <a name="sessiondbdcookieremove" id="sessiondbdcookieremove">Directive</a> <a title="Permanent link" href="#sessiondbdcookieremove" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessiondbdcookieremove"><span id="SessionDBDCookieRemove">SessionDBDCookieRemove</span> Directive <a title="Permanent link" href="#sessiondbdcookieremove" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control for whether session ID cookies should be removed from incoming HTTP headers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDCookieRemove On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionDBDDeleteLabel" id="SessionDBDDeleteLabel">SessionDBDDeleteLabel</a> <a name="sessiondbddeletelabel" id="sessiondbddeletelabel">Directive</a> <a title="Permanent link" href="#sessiondbddeletelabel" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessiondbddeletelabel"><span id="SessionDBDDeleteLabel">SessionDBDDeleteLabel</span> Directive <a title="Permanent link" href="#sessiondbddeletelabel" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to remove sessions from the database</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDDeleteLabel <var>label</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionDBDInsertLabel" id="SessionDBDInsertLabel">SessionDBDInsertLabel</a> <a name="sessiondbdinsertlabel" id="sessiondbdinsertlabel">Directive</a> <a title="Permanent link" href="#sessiondbdinsertlabel" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessiondbdinsertlabel"><span id="SessionDBDInsertLabel">SessionDBDInsertLabel</span> Directive <a title="Permanent link" href="#sessiondbdinsertlabel" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to insert sessions into the database</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDInsertLabel <var>label</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionDBDPerUser" id="SessionDBDPerUser">SessionDBDPerUser</a> <a name="sessiondbdperuser" id="sessiondbdperuser">Directive</a> <a title="Permanent link" href="#sessiondbdperuser" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessiondbdperuser"><span id="SessionDBDPerUser">SessionDBDPerUser</span> Directive <a title="Permanent link" href="#sessiondbdperuser" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable a per user session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDPerUser On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionDBDSelectLabel" id="SessionDBDSelectLabel">SessionDBDSelectLabel</a> <a name="sessiondbdselectlabel" id="sessiondbdselectlabel">Directive</a> <a title="Permanent link" href="#sessiondbdselectlabel" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessiondbdselectlabel"><span id="SessionDBDSelectLabel">SessionDBDSelectLabel</span> Directive <a title="Permanent link" href="#sessiondbdselectlabel" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to select sessions from the database</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDSelectLabel <var>label</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SessionDBDUpdateLabel" id="SessionDBDUpdateLabel">SessionDBDUpdateLabel</a> <a name="sessiondbdupdatelabel" id="sessiondbdupdatelabel">Directive</a> <a title="Permanent link" href="#sessiondbdupdatelabel" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sessiondbdupdatelabel"><span id="SessionDBDUpdateLabel">SessionDBDUpdateLabel</span> Directive <a title="Permanent link" href="#sessiondbdupdatelabel" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to update existing sessions in the database</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDUpdateLabel <var>label</var></code></td></tr>
<a href="../fr/mod/mod_session_dbd.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BrowserMatch" id="BrowserMatch">BrowserMatch</a> <a name="browsermatch" id="browsermatch">Directive</a> <a title="Permanent link" href="#browsermatch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="browsermatch"><span id="BrowserMatch">BrowserMatch</span> Directive <a title="Permanent link" href="#browsermatch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables conditional on HTTP User-Agent
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="BrowserMatchNoCase" id="BrowserMatchNoCase">BrowserMatchNoCase</a> <a name="browsermatchnocase" id="browsermatchnocase">Directive</a> <a title="Permanent link" href="#browsermatchnocase" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="browsermatchnocase"><span id="BrowserMatchNoCase">BrowserMatchNoCase</span> Directive <a title="Permanent link" href="#browsermatchnocase" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables conditional on User-Agent without
respect to case</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SetEnvIf" id="SetEnvIf">SetEnvIf</a> <a name="setenvif" id="setenvif">Directive</a> <a title="Permanent link" href="#setenvif" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="setenvif"><span id="SetEnvIf">SetEnvIf</span> Directive <a title="Permanent link" href="#setenvif" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables based on attributes of the request
</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SetEnvIfExpr" id="SetEnvIfExpr">SetEnvIfExpr</a> <a name="setenvifexpr" id="setenvifexpr">Directive</a> <a title="Permanent link" href="#setenvifexpr" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="setenvifexpr"><span id="SetEnvIfExpr">SetEnvIfExpr</span> Directive <a title="Permanent link" href="#setenvifexpr" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables based on an ap_expr expression</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetEnvIfExpr <em>expr
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SetEnvIfNoCase" id="SetEnvIfNoCase">SetEnvIfNoCase</a> <a name="setenvifnocase" id="setenvifnocase">Directive</a> <a title="Permanent link" href="#setenvifnocase" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="setenvifnocase"><span id="SetEnvIfNoCase">SetEnvIfNoCase</span> Directive <a title="Permanent link" href="#setenvifnocase" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables based on attributes of the request
without respect to case</td></tr>
<a href="../tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_slotmem_plain.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_slotmem_shm.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_so">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_so">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="windows" id="windows">Creating Loadable Modules for Windows</a> <a title="Permanent link" href="#windows" class="permalink">¶</a></h2>
+<h2
id="windows">Creating Loadable Modules for Windows <a title="Permanent link" href="#windows" class="permalink">¶</a></h2>
<div class="note"><h3>Note</h3>
<p>On Windows, where loadable files typically have a file extension
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LoadFile" id="LoadFile">LoadFile</a> <a name="loadfile" id="loadfile">Directive</a> <a title="Permanent link" href="#loadfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="loadfile"><span id="LoadFile">LoadFile</span> Directive <a title="Permanent link" href="#loadfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Link in the named object file or library</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LoadFile <em>filename</em> [<em>filename</em>] ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="LoadModule" id="LoadModule">LoadModule</a> <a name="loadmodule" id="loadmodule">Directive</a> <a title="Permanent link" href="#loadmodule" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="loadmodule"><span id="LoadModule">LoadModule</span> Directive <a title="Permanent link" href="#loadmodule" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Links in the object file or library, and adds to the list
of active modules</td></tr>
<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_socache_dbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_socache_dc.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_socache_memcache">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_socache_memcache">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MemcacheConnTTL" id="MemcacheConnTTL">MemcacheConnTTL</a> <a name="memcacheconnttl" id="memcacheconnttl">Directive</a> <a title="Permanent link" href="#memcacheconnttl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="memcacheconnttl"><span id="MemcacheConnTTL">MemcacheConnTTL</span> Directive <a title="Permanent link" href="#memcacheconnttl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keepalive time for idle connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MemcacheConnTTL <em>num[units]</em></code></td></tr>
<a href="../fr/mod/mod_socache_memcache.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_socache_redis">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_socache_redis">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RedisConnPoolTTL" id="RedisConnPoolTTL">RedisConnPoolTTL</a> <a name="redisconnpoolttl" id="redisconnpoolttl">Directive</a> <a title="Permanent link" href="#redisconnpoolttl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="redisconnpoolttl"><span id="RedisConnPoolTTL">RedisConnPoolTTL</span> Directive <a title="Permanent link" href="#redisconnpoolttl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>TTL used for the connection pool with the Redis server(s)</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RedisConnPoolTTL <em>num</em>[<em>units</em>]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="RedisTimeout" id="RedisTimeout">RedisTimeout</a> <a name="redistimeout" id="redistimeout">Directive</a> <a title="Permanent link" href="#redistimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="redistimeout"><span id="RedisTimeout">RedisTimeout</span> Directive <a title="Permanent link" href="#redistimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>R/W timeout used for the connection with the Redis server(s)</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RedisTimeout <em>num</em>[<em>units</em>]</code></td></tr>
<a href="../fr/mod/mod_socache_redis.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_socache_shmcb.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_speling">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_speling">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CheckBasenameMatch" id="CheckBasenameMatch">CheckBasenameMatch</a> <a name="checkbasenamematch" id="checkbasenamematch">Directive</a> <a title="Permanent link" href="#checkbasenamematch" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="checkbasenamematch"><span id="CheckBasenameMatch">CheckBasenameMatch</span> Directive <a title="Permanent link" href="#checkbasenamematch" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Also match files with differing file name extensions.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CheckBasenameMatch on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CheckCaseOnly" id="CheckCaseOnly">CheckCaseOnly</a> <a name="checkcaseonly" id="checkcaseonly">Directive</a> <a title="Permanent link" href="#checkcaseonly" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="checkcaseonly"><span id="CheckCaseOnly">CheckCaseOnly</span> Directive <a title="Permanent link" href="#checkcaseonly" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the action of the speling module to case corrections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CheckCaseOnly on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CheckSpelling" id="CheckSpelling">CheckSpelling</a> <a name="checkspelling" id="checkspelling">Directive</a> <a title="Permanent link" href="#checkspelling" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="checkspelling"><span id="CheckSpelling">CheckSpelling</span> Directive <a title="Permanent link" href="#checkspelling" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables the spelling
module</td></tr>
<a href="../ko/mod/mod_speling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_ssl">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_ssl">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="envvars" id="envvars">Environment Variables</a> <a title="Permanent link" href="#envvars" class="permalink">¶</a></h2>
+<h2
id="envvars">Environment Variables <a title="Permanent link" href="#envvars" class="permalink">¶</a></h2>
<p>This module can be configured to provide several items of SSL information
as additional environment variables to the SSI and CGI namespace. Except for
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logformats" id="logformats">Custom Log Formats</a> <a title="Permanent link" href="#logformats" class="permalink">¶</a></h2>
+<h2
id="logformats">Custom Log Formats <a title="Permanent link" href="#logformats" class="permalink">¶</a></h2>
<p>When <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> is built into Apache or at least
loaded (under DSO situation) additional functions exist for the <a href="mod_log_config.html#formats">Custom Log Format</a> of
directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="notes" id="notes">Request Notes</a> <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
+<h2
id="notes">Request Notes <a title="Permanent link" href="#notes" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> sets "notes" for the request which can be
used in logging with the <code>%{<var>name</var>}n</code> format
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="expressionparser" id="expressionparser">Expression Parser Extension</a> <a title="Permanent link" href="#expressionparser" class="permalink">¶</a></h2>
+<h2
id="expressionparser">Expression Parser Extension <a title="Permanent link" href="#expressionparser" class="permalink">¶</a></h2>
<p>When <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> is built into Apache or at least
loaded (under DSO situation) any <a name="envvars">variables</a>
directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="authzproviders" id="authzproviders">Authorization providers for use with Require</a> <a title="Permanent link" href="#authzproviders" class="permalink">¶</a></h2>
+<h2
id="authzproviders">Authorization providers for use with Require <a title="Permanent link" href="#authzproviders" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> provides the following authorization providers
for use with <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>'s
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive.</p>
- <h3><a name="reqssl" id="reqssl">Require ssl</a></h3>
+ <h3 id="reqssl">Require ssl</h3>
<p>The <code>ssl</code> provider denies access if a connection is not
encrypted with SSL. Unlike the
- <h3><a name="reqverifyclient" id="reqverifyclient">Require ssl-verify-client</a></h3>
+ <h3 id="reqverifyclient">Require ssl-verify-client</h3>
<p>The <code>ssl-verify-client</code> provider allows access if the
user is authenticated with a valid client certificate. This is only
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCACertificateFile" id="SSLCACertificateFile">SSLCACertificateFile</a> <a name="sslcacertificatefile" id="sslcacertificatefile">Directive</a> <a title="Permanent link" href="#sslcacertificatefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcacertificatefile"><span id="SSLCACertificateFile">SSLCACertificateFile</span> Directive <a title="Permanent link" href="#sslcacertificatefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA Certificates
for Client Auth</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCACertificatePath" id="SSLCACertificatePath">SSLCACertificatePath</a> <a name="sslcacertificatepath" id="sslcacertificatepath">Directive</a> <a title="Permanent link" href="#sslcacertificatepath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcacertificatepath"><span id="SSLCACertificatePath">SSLCACertificatePath</span> Directive <a title="Permanent link" href="#sslcacertificatepath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA Certificates for
Client Auth</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCADNRequestFile" id="SSLCADNRequestFile">SSLCADNRequestFile</a> <a name="sslcadnrequestfile" id="sslcadnrequestfile">Directive</a> <a title="Permanent link" href="#sslcadnrequestfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcadnrequestfile"><span id="SSLCADNRequestFile">SSLCADNRequestFile</span> Directive <a title="Permanent link" href="#sslcadnrequestfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA Certificates
for defining acceptable CA names</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCADNRequestPath" id="SSLCADNRequestPath">SSLCADNRequestPath</a> <a name="sslcadnrequestpath" id="sslcadnrequestpath">Directive</a> <a title="Permanent link" href="#sslcadnrequestpath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcadnrequestpath"><span id="SSLCADNRequestPath">SSLCADNRequestPath</span> Directive <a title="Permanent link" href="#sslcadnrequestpath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA Certificates for
defining acceptable CA names</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCARevocationCheck" id="SSLCARevocationCheck">SSLCARevocationCheck</a> <a name="sslcarevocationcheck" id="sslcarevocationcheck">Directive</a> <a title="Permanent link" href="#sslcarevocationcheck" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcarevocationcheck"><span id="SSLCARevocationCheck">SSLCARevocationCheck</span> Directive <a title="Permanent link" href="#sslcarevocationcheck" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable CRL-based revocation checking</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLCARevocationCheck chain|leaf|none [<var>flag</var>s ...]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCARevocationFile" id="SSLCARevocationFile">SSLCARevocationFile</a> <a name="sslcarevocationfile" id="sslcarevocationfile">Directive</a> <a title="Permanent link" href="#sslcarevocationfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcarevocationfile"><span id="SSLCARevocationFile">SSLCARevocationFile</span> Directive <a title="Permanent link" href="#sslcarevocationfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA CRLs for
Client Auth</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCARevocationPath" id="SSLCARevocationPath">SSLCARevocationPath</a> <a name="sslcarevocationpath" id="sslcarevocationpath">Directive</a> <a title="Permanent link" href="#sslcarevocationpath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcarevocationpath"><span id="SSLCARevocationPath">SSLCARevocationPath</span> Directive <a title="Permanent link" href="#sslcarevocationpath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA CRLs for
Client Auth</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCertificateChainFile" id="SSLCertificateChainFile">SSLCertificateChainFile</a> <a name="sslcertificatechainfile" id="sslcertificatechainfile">Directive</a> <a title="Permanent link" href="#sslcertificatechainfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcertificatechainfile"><span id="SSLCertificateChainFile">SSLCertificateChainFile</span> Directive <a title="Permanent link" href="#sslcertificatechainfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of PEM-encoded Server CA Certificates</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLCertificateChainFile <var>file-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCertificateFile" id="SSLCertificateFile">SSLCertificateFile</a> <a name="sslcertificatefile" id="sslcertificatefile">Directive</a> <a title="Permanent link" href="#sslcertificatefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcertificatefile"><span id="SSLCertificateFile">SSLCertificateFile</span> Directive <a title="Permanent link" href="#sslcertificatefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Server PEM-encoded X.509 certificate data file or token identifier</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLCertificateFile <var>file-path</var>|<var>certid</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCertificateKeyFile" id="SSLCertificateKeyFile">SSLCertificateKeyFile</a> <a name="sslcertificatekeyfile" id="sslcertificatekeyfile">Directive</a> <a title="Permanent link" href="#sslcertificatekeyfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcertificatekeyfile"><span id="SSLCertificateKeyFile">SSLCertificateKeyFile</span> Directive <a title="Permanent link" href="#sslcertificatekeyfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Server PEM-encoded private key file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLCertificateKeyFile <var>file-path</var>|<var>keyid</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCipherSuite" id="SSLCipherSuite">SSLCipherSuite</a> <a name="sslciphersuite" id="sslciphersuite">Directive</a> <a title="Permanent link" href="#sslciphersuite" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslciphersuite"><span id="SSLCipherSuite">SSLCipherSuite</span> Directive <a title="Permanent link" href="#sslciphersuite" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cipher Suite available for negotiation in SSL
handshake</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLClientHelloVars" id="SSLClientHelloVars">SSLClientHelloVars</a> <a name="sslclienthellovars" id="sslclienthellovars">Directive</a> <a title="Permanent link" href="#sslclienthellovars" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslclienthellovars"><span id="SSLClientHelloVars">SSLClientHelloVars</span> Directive <a title="Permanent link" href="#sslclienthellovars" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable collection of ClientHello variables</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLClientHelloVars on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCompression" id="SSLCompression">SSLCompression</a> <a name="sslcompression" id="sslcompression">Directive</a> <a title="Permanent link" href="#sslcompression" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcompression"><span id="SSLCompression">SSLCompression</span> Directive <a title="Permanent link" href="#sslcompression" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable compression on the SSL level</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLCompression on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLCryptoDevice" id="SSLCryptoDevice">SSLCryptoDevice</a> <a name="sslcryptodevice" id="sslcryptodevice">Directive</a> <a title="Permanent link" href="#sslcryptodevice" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslcryptodevice"><span id="SSLCryptoDevice">SSLCryptoDevice</span> Directive <a title="Permanent link" href="#sslcryptodevice" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable use of a cryptographic hardware accelerator</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLCryptoDevice <var>engine</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLECHKeyDir" id="SSLECHKeyDir">SSLECHKeyDir</a> <a name="sslechkeydir" id="sslechkeydir">Directive</a> <a title="Permanent link" href="#sslechkeydir" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslechkeydir"><span id="SSLECHKeyDir">SSLECHKeyDir</span> Directive <a title="Permanent link" href="#sslechkeydir" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Load the set of Encrypted Client Hello (ECH) PEM files in the named directory</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLECHKeyDir <var>dirname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLEngine" id="SSLEngine">SSLEngine</a> <a name="sslengine" id="sslengine">Directive</a> <a title="Permanent link" href="#sslengine" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslengine"><span id="SSLEngine">SSLEngine</span> Directive <a title="Permanent link" href="#sslengine" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SSL Engine Operation Switch</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLEngine on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLFIPS" id="SSLFIPS">SSLFIPS</a> <a name="sslfips" id="sslfips">Directive</a> <a title="Permanent link" href="#sslfips" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslfips"><span id="SSLFIPS">SSLFIPS</span> Directive <a title="Permanent link" href="#sslfips" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SSL FIPS mode Switch</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLFIPS on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLHonorCipherOrder" id="SSLHonorCipherOrder">SSLHonorCipherOrder</a> <a name="sslhonorcipherorder" id="sslhonorcipherorder">Directive</a> <a title="Permanent link" href="#sslhonorcipherorder" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslhonorcipherorder"><span id="SSLHonorCipherOrder">SSLHonorCipherOrder</span> Directive <a title="Permanent link" href="#sslhonorcipherorder" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Option to prefer the server's cipher preference order</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLHonorCipherOrder on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPDefaultResponder" id="SSLOCSPDefaultResponder">SSLOCSPDefaultResponder</a> <a name="sslocspdefaultresponder" id="sslocspdefaultresponder">Directive</a> <a title="Permanent link" href="#sslocspdefaultresponder" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocspdefaultresponder"><span id="SSLOCSPDefaultResponder">SSLOCSPDefaultResponder</span> Directive <a title="Permanent link" href="#sslocspdefaultresponder" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the default responder URI for OCSP validation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPDefaultResponder <var>uri</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPEnable" id="SSLOCSPEnable">SSLOCSPEnable</a> <a name="sslocspenable" id="sslocspenable">Directive</a> <a title="Permanent link" href="#sslocspenable" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocspenable"><span id="SSLOCSPEnable">SSLOCSPEnable</span> Directive <a title="Permanent link" href="#sslocspenable" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable OCSP validation of the client certificate chain</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPEnable on|leaf|off [<var>flags</var>]</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPNoverify" id="SSLOCSPNoverify">SSLOCSPNoverify</a> <a name="sslocspnoverify" id="sslocspnoverify">Directive</a> <a title="Permanent link" href="#sslocspnoverify" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocspnoverify"><span id="SSLOCSPNoverify">SSLOCSPNoverify</span> Directive <a title="Permanent link" href="#sslocspnoverify" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>skip the OCSP responder certificates verification</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPNoverify on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPOverrideResponder" id="SSLOCSPOverrideResponder">SSLOCSPOverrideResponder</a> <a name="sslocspoverrideresponder" id="sslocspoverrideresponder">Directive</a> <a title="Permanent link" href="#sslocspoverrideresponder" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocspoverrideresponder"><span id="SSLOCSPOverrideResponder">SSLOCSPOverrideResponder</span> Directive <a title="Permanent link" href="#sslocspoverrideresponder" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force use of the default responder URI for OCSP validation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPOverrideResponder on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPProxyURL" id="SSLOCSPProxyURL">SSLOCSPProxyURL</a> <a name="sslocspproxyurl" id="sslocspproxyurl">Directive</a> <a title="Permanent link" href="#sslocspproxyurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocspproxyurl"><span id="SSLOCSPProxyURL">SSLOCSPProxyURL</span> Directive <a title="Permanent link" href="#sslocspproxyurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Proxy URL to use for OCSP requests</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPProxyURL <var>url</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPResponderCertificateFile" id="SSLOCSPResponderCertificateFile">SSLOCSPResponderCertificateFile</a> <a name="sslocsprespondercertificatefile" id="sslocsprespondercertificatefile">Directive</a> <a title="Permanent link" href="#sslocsprespondercertificatefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocsprespondercertificatefile"><span id="SSLOCSPResponderCertificateFile">SSLOCSPResponderCertificateFile</span> Directive <a title="Permanent link" href="#sslocsprespondercertificatefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set of trusted PEM encoded OCSP responder certificates</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPResponderCertificateFile <var>file</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPResponderTimeout" id="SSLOCSPResponderTimeout">SSLOCSPResponderTimeout</a> <a name="sslocsprespondertimeout" id="sslocsprespondertimeout">Directive</a> <a title="Permanent link" href="#sslocsprespondertimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocsprespondertimeout"><span id="SSLOCSPResponderTimeout">SSLOCSPResponderTimeout</span> Directive <a title="Permanent link" href="#sslocsprespondertimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Timeout for OCSP queries</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPResponderTimeout <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPResponseMaxAge" id="SSLOCSPResponseMaxAge">SSLOCSPResponseMaxAge</a> <a name="sslocspresponsemaxage" id="sslocspresponsemaxage">Directive</a> <a title="Permanent link" href="#sslocspresponsemaxage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocspresponsemaxage"><span id="SSLOCSPResponseMaxAge">SSLOCSPResponseMaxAge</span> Directive <a title="Permanent link" href="#sslocspresponsemaxage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum allowable age for OCSP responses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPResponseMaxAge <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPResponseTimeSkew" id="SSLOCSPResponseTimeSkew">SSLOCSPResponseTimeSkew</a> <a name="sslocspresponsetimeskew" id="sslocspresponsetimeskew">Directive</a> <a title="Permanent link" href="#sslocspresponsetimeskew" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocspresponsetimeskew"><span id="SSLOCSPResponseTimeSkew">SSLOCSPResponseTimeSkew</span> Directive <a title="Permanent link" href="#sslocspresponsetimeskew" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum allowable time skew for OCSP response validation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPResponseTimeSkew <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOCSPUseRequestNonce" id="SSLOCSPUseRequestNonce">SSLOCSPUseRequestNonce</a> <a name="sslocspuserequestnonce" id="sslocspuserequestnonce">Directive</a> <a title="Permanent link" href="#sslocspuserequestnonce" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslocspuserequestnonce"><span id="SSLOCSPUseRequestNonce">SSLOCSPUseRequestNonce</span> Directive <a title="Permanent link" href="#sslocspuserequestnonce" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use a nonce within OCSP queries</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOCSPUseRequestNonce on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOpenSSLConfCmd" id="SSLOpenSSLConfCmd">SSLOpenSSLConfCmd</a> <a name="sslopensslconfcmd" id="sslopensslconfcmd">Directive</a> <a title="Permanent link" href="#sslopensslconfcmd" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslopensslconfcmd"><span id="SSLOpenSSLConfCmd">SSLOpenSSLConfCmd</span> Directive <a title="Permanent link" href="#sslopensslconfcmd" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure OpenSSL parameters through its <em>SSL_CONF</em> API</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOpenSSLConfCmd <var>command-name</var> <var>command-value</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLOptions" id="SSLOptions">SSLOptions</a> <a name="ssloptions" id="ssloptions">Directive</a> <a title="Permanent link" href="#ssloptions" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ssloptions"><span id="SSLOptions">SSLOptions</span> Directive <a title="Permanent link" href="#ssloptions" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure various SSL engine run-time options</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLOptions [+|-]<var>option</var> ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLPassPhraseDialog" id="SSLPassPhraseDialog">SSLPassPhraseDialog</a> <a name="sslpassphrasedialog" id="sslpassphrasedialog">Directive</a> <a title="Permanent link" href="#sslpassphrasedialog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslpassphrasedialog"><span id="SSLPassPhraseDialog">SSLPassPhraseDialog</span> Directive <a title="Permanent link" href="#sslpassphrasedialog" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of pass phrase dialog for encrypted private
keys</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLPolicy" id="SSLPolicy">SSLPolicy</a> <a name="sslpolicy" id="sslpolicy">Directive</a> <a title="Permanent link" href="#sslpolicy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslpolicy"><span id="SSLPolicy">SSLPolicy</span> Directive <a title="Permanent link" href="#sslpolicy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Apply a SSLPolicy by name</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLPolicy <var>name</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProtocol" id="SSLProtocol">SSLProtocol</a> <a name="sslprotocol" id="sslprotocol">Directive</a> <a title="Permanent link" href="#sslprotocol" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslprotocol"><span id="SSLProtocol">SSLProtocol</span> Directive <a title="Permanent link" href="#sslprotocol" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure usable SSL/TLS protocol versions</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLProtocol [+|-]<var>protocol</var> ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCACertificateFile" id="SSLProxyCACertificateFile">SSLProxyCACertificateFile</a> <a name="sslproxycacertificatefile" id="sslproxycacertificatefile">Directive</a> <a title="Permanent link" href="#sslproxycacertificatefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxycacertificatefile"><span id="SSLProxyCACertificateFile">SSLProxyCACertificateFile</span> Directive <a title="Permanent link" href="#sslproxycacertificatefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA Certificates
for Remote Server Auth</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCACertificatePath" id="SSLProxyCACertificatePath">SSLProxyCACertificatePath</a> <a name="sslproxycacertificatepath" id="sslproxycacertificatepath">Directive</a> <a title="Permanent link" href="#sslproxycacertificatepath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxycacertificatepath"><span id="SSLProxyCACertificatePath">SSLProxyCACertificatePath</span> Directive <a title="Permanent link" href="#sslproxycacertificatepath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA Certificates for
Remote Server Auth</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCARevocationCheck" id="SSLProxyCARevocationCheck">SSLProxyCARevocationCheck</a> <a name="sslproxycarevocationcheck" id="sslproxycarevocationcheck">Directive</a> <a title="Permanent link" href="#sslproxycarevocationcheck" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxycarevocationcheck"><span id="SSLProxyCARevocationCheck">SSLProxyCARevocationCheck</span> Directive <a title="Permanent link" href="#sslproxycarevocationcheck" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable CRL-based revocation checking for Remote Server Auth</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLProxyCARevocationCheck chain|leaf|none</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCARevocationFile" id="SSLProxyCARevocationFile">SSLProxyCARevocationFile</a> <a name="sslproxycarevocationfile" id="sslproxycarevocationfile">Directive</a> <a title="Permanent link" href="#sslproxycarevocationfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxycarevocationfile"><span id="SSLProxyCARevocationFile">SSLProxyCARevocationFile</span> Directive <a title="Permanent link" href="#sslproxycarevocationfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA CRLs for
Remote Server Auth</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCARevocationPath" id="SSLProxyCARevocationPath">SSLProxyCARevocationPath</a> <a name="sslproxycarevocationpath" id="sslproxycarevocationpath">Directive</a> <a title="Permanent link" href="#sslproxycarevocationpath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxycarevocationpath"><span id="SSLProxyCARevocationPath">SSLProxyCARevocationPath</span> Directive <a title="Permanent link" href="#sslproxycarevocationpath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA CRLs for
Remote Server Auth</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCheckPeerCN" id="SSLProxyCheckPeerCN">SSLProxyCheckPeerCN</a> <a name="sslproxycheckpeercn" id="sslproxycheckpeercn">Directive</a> <a title="Permanent link" href="#sslproxycheckpeercn" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxycheckpeercn"><span id="SSLProxyCheckPeerCN">SSLProxyCheckPeerCN</span> Directive <a title="Permanent link" href="#sslproxycheckpeercn" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether to check the remote server certificate's CN field
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCheckPeerExpire" id="SSLProxyCheckPeerExpire">SSLProxyCheckPeerExpire</a> <a name="sslproxycheckpeerexpire" id="sslproxycheckpeerexpire">Directive</a> <a title="Permanent link" href="#sslproxycheckpeerexpire" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxycheckpeerexpire"><span id="SSLProxyCheckPeerExpire">SSLProxyCheckPeerExpire</span> Directive <a title="Permanent link" href="#sslproxycheckpeerexpire" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether to check if remote server certificate is expired
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCheckPeerName" id="SSLProxyCheckPeerName">SSLProxyCheckPeerName</a> <a name="sslproxycheckpeername" id="sslproxycheckpeername">Directive</a> <a title="Permanent link" href="#sslproxycheckpeername" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxycheckpeername"><span id="SSLProxyCheckPeerName">SSLProxyCheckPeerName</span> Directive <a title="Permanent link" href="#sslproxycheckpeername" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure host name checking for remote server certificates
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyCipherSuite" id="SSLProxyCipherSuite">SSLProxyCipherSuite</a> <a name="sslproxyciphersuite" id="sslproxyciphersuite">Directive</a> <a title="Permanent link" href="#sslproxyciphersuite" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxyciphersuite"><span id="SSLProxyCipherSuite">SSLProxyCipherSuite</span> Directive <a title="Permanent link" href="#sslproxyciphersuite" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cipher Suite available for negotiation in SSL
proxy handshake</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyEngine" id="SSLProxyEngine">SSLProxyEngine</a> <a name="sslproxyengine" id="sslproxyengine">Directive</a> <a title="Permanent link" href="#sslproxyengine" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxyengine"><span id="SSLProxyEngine">SSLProxyEngine</span> Directive <a title="Permanent link" href="#sslproxyengine" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SSL Proxy Engine Operation Switch</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLProxyEngine on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyMachineCertificateChainFile" id="SSLProxyMachineCertificateChainFile">SSLProxyMachineCertificateChainFile</a> <a name="sslproxymachinecertificatechainfile" id="sslproxymachinecertificatechainfile">Directive</a> <a title="Permanent link" href="#sslproxymachinecertificatechainfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxymachinecertificatechainfile"><span id="SSLProxyMachineCertificateChainFile">SSLProxyMachineCertificateChainFile</span> Directive <a title="Permanent link" href="#sslproxymachinecertificatechainfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLProxyMachineCertificateChainFile <var>filename</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyMachineCertificateFile" id="SSLProxyMachineCertificateFile">SSLProxyMachineCertificateFile</a> <a name="sslproxymachinecertificatefile" id="sslproxymachinecertificatefile">Directive</a> <a title="Permanent link" href="#sslproxymachinecertificatefile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxymachinecertificatefile"><span id="SSLProxyMachineCertificateFile">SSLProxyMachineCertificateFile</span> Directive <a title="Permanent link" href="#sslproxymachinecertificatefile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded client certificates and keys to be used by the proxy</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLProxyMachineCertificateFile <var>filename</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyMachineCertificatePath" id="SSLProxyMachineCertificatePath">SSLProxyMachineCertificatePath</a> <a name="sslproxymachinecertificatepath" id="sslproxymachinecertificatepath">Directive</a> <a title="Permanent link" href="#sslproxymachinecertificatepath" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxymachinecertificatepath"><span id="SSLProxyMachineCertificatePath">SSLProxyMachineCertificatePath</span> Directive <a title="Permanent link" href="#sslproxymachinecertificatepath" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded client certificates and keys to be used by the proxy</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLProxyMachineCertificatePath <var>directory</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyProtocol" id="SSLProxyProtocol">SSLProxyProtocol</a> <a name="sslproxyprotocol" id="sslproxyprotocol">Directive</a> <a title="Permanent link" href="#sslproxyprotocol" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxyprotocol"><span id="SSLProxyProtocol">SSLProxyProtocol</span> Directive <a title="Permanent link" href="#sslproxyprotocol" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure usable SSL protocol flavors for proxy usage</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLProxyProtocol [+|-]<var>protocol</var> ...</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyVerify" id="SSLProxyVerify">SSLProxyVerify</a> <a name="sslproxyverify" id="sslproxyverify">Directive</a> <a title="Permanent link" href="#sslproxyverify" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxyverify"><span id="SSLProxyVerify">SSLProxyVerify</span> Directive <a title="Permanent link" href="#sslproxyverify" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of remote server Certificate verification</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLProxyVerify <var>level</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLProxyVerifyDepth" id="SSLProxyVerifyDepth">SSLProxyVerifyDepth</a> <a name="sslproxyverifydepth" id="sslproxyverifydepth">Directive</a> <a title="Permanent link" href="#sslproxyverifydepth" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslproxyverifydepth"><span id="SSLProxyVerifyDepth">SSLProxyVerifyDepth</span> Directive <a title="Permanent link" href="#sslproxyverifydepth" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum depth of CA Certificates in Remote Server
Certificate verification</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLRandomSeed" id="SSLRandomSeed">SSLRandomSeed</a> <a name="sslrandomseed" id="sslrandomseed">Directive</a> <a title="Permanent link" href="#sslrandomseed" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslrandomseed"><span id="SSLRandomSeed">SSLRandomSeed</span> Directive <a title="Permanent link" href="#sslrandomseed" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pseudo Random Number Generator (PRNG) seeding
source</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLRenegBufferSize" id="SSLRenegBufferSize">SSLRenegBufferSize</a> <a name="sslrenegbuffersize" id="sslrenegbuffersize">Directive</a> <a title="Permanent link" href="#sslrenegbuffersize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslrenegbuffersize"><span id="SSLRenegBufferSize">SSLRenegBufferSize</span> Directive <a title="Permanent link" href="#sslrenegbuffersize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the size for the SSL renegotiation buffer</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLRenegBufferSize <var>bytes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLRequire" id="SSLRequire">SSLRequire</a> <a name="sslrequire" id="sslrequire">Directive</a> <a title="Permanent link" href="#sslrequire" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslrequire"><span id="SSLRequire">SSLRequire</span> Directive <a title="Permanent link" href="#sslrequire" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow access only when an arbitrarily complex
boolean expression is true</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLRequireSSL" id="SSLRequireSSL">SSLRequireSSL</a> <a name="sslrequiressl" id="sslrequiressl">Directive</a> <a title="Permanent link" href="#sslrequiressl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslrequiressl"><span id="SSLRequireSSL">SSLRequireSSL</span> Directive <a title="Permanent link" href="#sslrequiressl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Deny access when SSL is not used for the
HTTP request</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLSessionCache" id="SSLSessionCache">SSLSessionCache</a> <a name="sslsessioncache" id="sslsessioncache">Directive</a> <a title="Permanent link" href="#sslsessioncache" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslsessioncache"><span id="SSLSessionCache">SSLSessionCache</span> Directive <a title="Permanent link" href="#sslsessioncache" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of the global/inter-process SSL Session
Cache</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLSessionCacheTimeout" id="SSLSessionCacheTimeout">SSLSessionCacheTimeout</a> <a name="sslsessioncachetimeout" id="sslsessioncachetimeout">Directive</a> <a title="Permanent link" href="#sslsessioncachetimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslsessioncachetimeout"><span id="SSLSessionCacheTimeout">SSLSessionCacheTimeout</span> Directive <a title="Permanent link" href="#sslsessioncachetimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of seconds before an SSL session expires
in the Session Cache</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLSessionTicketKeyFile" id="SSLSessionTicketKeyFile">SSLSessionTicketKeyFile</a> <a name="sslsessionticketkeyfile" id="sslsessionticketkeyfile">Directive</a> <a title="Permanent link" href="#sslsessionticketkeyfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslsessionticketkeyfile"><span id="SSLSessionTicketKeyFile">SSLSessionTicketKeyFile</span> Directive <a title="Permanent link" href="#sslsessionticketkeyfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Persistent encryption/decryption key for TLS session tickets</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLSessionTicketKeyFile <var>file-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLSessionTickets" id="SSLSessionTickets">SSLSessionTickets</a> <a name="sslsessiontickets" id="sslsessiontickets">Directive</a> <a title="Permanent link" href="#sslsessiontickets" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslsessiontickets"><span id="SSLSessionTickets">SSLSessionTickets</span> Directive <a title="Permanent link" href="#sslsessiontickets" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable use of TLS session tickets</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLSessionTickets on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLSRPUnknownUserSeed" id="SSLSRPUnknownUserSeed">SSLSRPUnknownUserSeed</a> <a name="sslsrpunknownuserseed" id="sslsrpunknownuserseed">Directive</a> <a title="Permanent link" href="#sslsrpunknownuserseed" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslsrpunknownuserseed"><span id="SSLSRPUnknownUserSeed">SSLSRPUnknownUserSeed</span> Directive <a title="Permanent link" href="#sslsrpunknownuserseed" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SRP unknown user seed</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLSRPUnknownUserSeed <var>secret-string</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLSRPVerifierFile" id="SSLSRPVerifierFile">SSLSRPVerifierFile</a> <a name="sslsrpverifierfile" id="sslsrpverifierfile">Directive</a> <a title="Permanent link" href="#sslsrpverifierfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslsrpverifierfile"><span id="SSLSRPVerifierFile">SSLSRPVerifierFile</span> Directive <a title="Permanent link" href="#sslsrpverifierfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Path to SRP verifier file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLSRPVerifierFile <var>file-path</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingCache" id="SSLStaplingCache">SSLStaplingCache</a> <a name="sslstaplingcache" id="sslstaplingcache">Directive</a> <a title="Permanent link" href="#sslstaplingcache" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingcache"><span id="SSLStaplingCache">SSLStaplingCache</span> Directive <a title="Permanent link" href="#sslstaplingcache" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the OCSP stapling cache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingCache <var>type</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingErrorCacheTimeout" id="SSLStaplingErrorCacheTimeout">SSLStaplingErrorCacheTimeout</a> <a name="sslstaplingerrorcachetimeout" id="sslstaplingerrorcachetimeout">Directive</a> <a title="Permanent link" href="#sslstaplingerrorcachetimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingerrorcachetimeout"><span id="SSLStaplingErrorCacheTimeout">SSLStaplingErrorCacheTimeout</span> Directive <a title="Permanent link" href="#sslstaplingerrorcachetimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of seconds before expiring invalid responses in the OCSP stapling cache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingErrorCacheTimeout <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingFakeTryLater" id="SSLStaplingFakeTryLater">SSLStaplingFakeTryLater</a> <a name="sslstaplingfaketrylater" id="sslstaplingfaketrylater">Directive</a> <a title="Permanent link" href="#sslstaplingfaketrylater" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingfaketrylater"><span id="SSLStaplingFakeTryLater">SSLStaplingFakeTryLater</span> Directive <a title="Permanent link" href="#sslstaplingfaketrylater" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Synthesize "tryLater" responses for failed OCSP stapling queries</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingFakeTryLater on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingForceURL" id="SSLStaplingForceURL">SSLStaplingForceURL</a> <a name="sslstaplingforceurl" id="sslstaplingforceurl">Directive</a> <a title="Permanent link" href="#sslstaplingforceurl" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingforceurl"><span id="SSLStaplingForceURL">SSLStaplingForceURL</span> Directive <a title="Permanent link" href="#sslstaplingforceurl" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override the OCSP responder URI specified in the certificate's AIA extension</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingForceURL <var>uri</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingResponderTimeout" id="SSLStaplingResponderTimeout">SSLStaplingResponderTimeout</a> <a name="sslstaplingrespondertimeout" id="sslstaplingrespondertimeout">Directive</a> <a title="Permanent link" href="#sslstaplingrespondertimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingrespondertimeout"><span id="SSLStaplingResponderTimeout">SSLStaplingResponderTimeout</span> Directive <a title="Permanent link" href="#sslstaplingrespondertimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Timeout for OCSP stapling queries</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingResponderTimeout <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingResponseMaxAge" id="SSLStaplingResponseMaxAge">SSLStaplingResponseMaxAge</a> <a name="sslstaplingresponsemaxage" id="sslstaplingresponsemaxage">Directive</a> <a title="Permanent link" href="#sslstaplingresponsemaxage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingresponsemaxage"><span id="SSLStaplingResponseMaxAge">SSLStaplingResponseMaxAge</span> Directive <a title="Permanent link" href="#sslstaplingresponsemaxage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum allowable age for OCSP stapling responses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingResponseMaxAge <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingResponseTimeSkew" id="SSLStaplingResponseTimeSkew">SSLStaplingResponseTimeSkew</a> <a name="sslstaplingresponsetimeskew" id="sslstaplingresponsetimeskew">Directive</a> <a title="Permanent link" href="#sslstaplingresponsetimeskew" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingresponsetimeskew"><span id="SSLStaplingResponseTimeSkew">SSLStaplingResponseTimeSkew</span> Directive <a title="Permanent link" href="#sslstaplingresponsetimeskew" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum allowable time skew for OCSP stapling response validation</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingResponseTimeSkew <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingReturnResponderErrors" id="SSLStaplingReturnResponderErrors">SSLStaplingReturnResponderErrors</a> <a name="sslstaplingreturnrespondererrors" id="sslstaplingreturnrespondererrors">Directive</a> <a title="Permanent link" href="#sslstaplingreturnrespondererrors" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingreturnrespondererrors"><span id="SSLStaplingReturnResponderErrors">SSLStaplingReturnResponderErrors</span> Directive <a title="Permanent link" href="#sslstaplingreturnrespondererrors" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pass stapling related OCSP errors on to client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingReturnResponderErrors on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStaplingStandardCacheTimeout" id="SSLStaplingStandardCacheTimeout">SSLStaplingStandardCacheTimeout</a> <a name="sslstaplingstandardcachetimeout" id="sslstaplingstandardcachetimeout">Directive</a> <a title="Permanent link" href="#sslstaplingstandardcachetimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstaplingstandardcachetimeout"><span id="SSLStaplingStandardCacheTimeout">SSLStaplingStandardCacheTimeout</span> Directive <a title="Permanent link" href="#sslstaplingstandardcachetimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of seconds before expiring responses in the OCSP stapling cache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLStaplingStandardCacheTimeout <var>seconds</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLStrictSNIVHostCheck" id="SSLStrictSNIVHostCheck">SSLStrictSNIVHostCheck</a> <a name="sslstrictsnivhostcheck" id="sslstrictsnivhostcheck">Directive</a> <a title="Permanent link" href="#sslstrictsnivhostcheck" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslstrictsnivhostcheck"><span id="SSLStrictSNIVHostCheck">SSLStrictSNIVHostCheck</span> Directive <a title="Permanent link" href="#sslstrictsnivhostcheck" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether to allow non-SNI clients to access a name-based virtual
host.
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLUserName" id="SSLUserName">SSLUserName</a> <a name="sslusername" id="sslusername">Directive</a> <a title="Permanent link" href="#sslusername" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslusername"><span id="SSLUserName">SSLUserName</span> Directive <a title="Permanent link" href="#sslusername" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Variable name to determine user name</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLUserName <var>varname</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLUseStapling" id="SSLUseStapling">SSLUseStapling</a> <a name="sslusestapling" id="sslusestapling">Directive</a> <a title="Permanent link" href="#sslusestapling" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslusestapling"><span id="SSLUseStapling">SSLUseStapling</span> Directive <a title="Permanent link" href="#sslusestapling" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable stapling of OCSP responses in the TLS handshake</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLUseStapling on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLVerifyClient" id="SSLVerifyClient">SSLVerifyClient</a> <a name="sslverifyclient" id="sslverifyclient">Directive</a> <a title="Permanent link" href="#sslverifyclient" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslverifyclient"><span id="SSLVerifyClient">SSLVerifyClient</span> Directive <a title="Permanent link" href="#sslverifyclient" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of Client Certificate verification</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLVerifyClient <var>level</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLVerifyDepth" id="SSLVerifyDepth">SSLVerifyDepth</a> <a name="sslverifydepth" id="sslverifydepth">Directive</a> <a title="Permanent link" href="#sslverifydepth" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslverifydepth"><span id="SSLVerifyDepth">SSLVerifyDepth</span> Directive <a title="Permanent link" href="#sslverifydepth" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum depth of CA Certificates in Client
Certificate verification</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SSLVHostSNIPolicy" id="SSLVHostSNIPolicy">SSLVHostSNIPolicy</a> <a name="sslvhostsnipolicy" id="sslvhostsnipolicy">Directive</a> <a title="Permanent link" href="#sslvhostsnipolicy" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sslvhostsnipolicy"><span id="SSLVHostSNIPolicy">SSLVHostSNIPolicy</span> Directive <a title="Permanent link" href="#sslvhostsnipolicy" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set compatibility policy for SNI client access to virtual hosts.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSLVHostSNIPolicy strict|secure|authonly|insecure</code></td></tr>
<a href="../fr/mod/mod_ssl.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_ssl_ct">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_ssl_ct">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="server" id="server">Server processing overview</a> <a title="Permanent link" href="#server" class="permalink">¶</a></h2>
+<h2
id="server">Server processing overview <a title="Permanent link" href="#server" class="permalink">¶</a></h2>
<p>Servers need to send SCTs to their clients. SCTs in a certificate
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="proxy" id="proxy">Proxy processing overview</a> <a title="Permanent link" href="#proxy" class="permalink">¶</a></h2>
+<h2
id="proxy">Proxy processing overview <a title="Permanent link" href="#proxy" class="permalink">¶</a></h2>
<p>The proxy indicates Certificate Transparency awareness in the ClientHello
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logconf" id="logconf">Log configuration</a> <a title="Permanent link" href="#logconf" class="permalink">¶</a></h2>
+<h2
id="logconf">Log configuration <a title="Permanent link" href="#logconf" class="permalink">¶</a></h2>
<p>Servers and proxies use different information about logs for their processing.
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="static" id="static">Storing SCTs in a form consumable by mod_ssl_ct</a> <a title="Permanent link" href="#static" class="permalink">¶</a></h2>
+<h2
id="static">Storing SCTs in a form consumable by mod_ssl_ct <a title="Permanent link" href="#static" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_ssl_ct.html">mod_ssl_ct</a></code> allows you to configure SCTs statically
repository</a>. Refer to <code>write-sct.py</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logging" id="logging">Logging CT status in the access log</a> <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
+<h2
id="logging">Logging CT status in the access log <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
<p>Proxy and server modes set the <code>SSL_CT_PROXY_STATUS</code> and
format of <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="audit" id="audit">Off-line audit for proxy</a> <a title="Permanent link" href="#audit" class="permalink">¶</a></h2>
+<h2
id="audit">Off-line audit for proxy <a title="Permanent link" href="#audit" class="permalink">¶</a></h2>
<p>Experimental support for this is implemented in the <code>ctauditscts</code>
<code>ctauditscts</code> source code for details on processing the data.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTAuditStorage" id="CTAuditStorage">CTAuditStorage</a> <a name="ctauditstorage" id="ctauditstorage">Directive</a> <a title="Permanent link" href="#ctauditstorage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctauditstorage"><span id="CTAuditStorage">CTAuditStorage</span> Directive <a title="Permanent link" href="#ctauditstorage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Existing directory where data for off-line audit will be stored</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CTAuditStorage <em>directory</em></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTLogClient" id="CTLogClient">CTLogClient</a> <a name="ctlogclient" id="ctlogclient">Directive</a> <a title="Permanent link" href="#ctlogclient" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctlogclient"><span id="CTLogClient">CTLogClient</span> Directive <a title="Permanent link" href="#ctlogclient" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of certificate-transparency log client tool</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CTLogClient <em>executable</em></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTLogConfigDB" id="CTLogConfigDB">CTLogConfigDB</a> <a name="ctlogconfigdb" id="ctlogconfigdb">Directive</a> <a title="Permanent link" href="#ctlogconfigdb" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctlogconfigdb"><span id="CTLogConfigDB">CTLogConfigDB</span> Directive <a title="Permanent link" href="#ctlogconfigdb" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Log configuration database supporting dynamic updates</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CTLogConfigDB <em>filename</em></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTMaxSCTAge" id="CTMaxSCTAge">CTMaxSCTAge</a> <a name="ctmaxsctage" id="ctmaxsctage">Directive</a> <a title="Permanent link" href="#ctmaxsctage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctmaxsctage"><span id="CTMaxSCTAge">CTMaxSCTAge</span> Directive <a title="Permanent link" href="#ctmaxsctage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum age of SCT obtained from a log, before it will be
refreshed</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTProxyAwareness" id="CTProxyAwareness">CTProxyAwareness</a> <a name="ctproxyawareness" id="ctproxyawareness">Directive</a> <a title="Permanent link" href="#ctproxyawareness" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctproxyawareness"><span id="CTProxyAwareness">CTProxyAwareness</span> Directive <a title="Permanent link" href="#ctproxyawareness" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Level of CT awareness and enforcement for a proxy
</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTSCTStorage" id="CTSCTStorage">CTSCTStorage</a> <a name="ctsctstorage" id="ctsctstorage">Directive</a> <a title="Permanent link" href="#ctsctstorage" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctsctstorage"><span id="CTSCTStorage">CTSCTStorage</span> Directive <a title="Permanent link" href="#ctsctstorage" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Existing directory where SCTs are managed</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CTSCTStorage <em>directory</em></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTServerHelloSCTLimit" id="CTServerHelloSCTLimit">CTServerHelloSCTLimit</a> <a name="ctserverhellosctlimit" id="ctserverhellosctlimit">Directive</a> <a title="Permanent link" href="#ctserverhellosctlimit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctserverhellosctlimit"><span id="CTServerHelloSCTLimit">CTServerHelloSCTLimit</span> Directive <a title="Permanent link" href="#ctserverhellosctlimit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit on number of SCTs that can be returned in
ServerHello</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTStaticLogConfig" id="CTStaticLogConfig">CTStaticLogConfig</a> <a name="ctstaticlogconfig" id="ctstaticlogconfig">Directive</a> <a title="Permanent link" href="#ctstaticlogconfig" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctstaticlogconfig"><span id="CTStaticLogConfig">CTStaticLogConfig</span> Directive <a title="Permanent link" href="#ctstaticlogconfig" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Static configuration of information about a log</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CTStaticLogConfig <em>log-id|-</em> <em>public-key-file|-</em>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CTStaticSCTs" id="CTStaticSCTs">CTStaticSCTs</a> <a name="ctstaticscts" id="ctstaticscts">Directive</a> <a title="Permanent link" href="#ctstaticscts" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ctstaticscts"><span id="CTStaticSCTs">CTStaticSCTs</span> Directive <a title="Permanent link" href="#ctstaticscts" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Static configuration of one or more SCTs for a server certificate
</td></tr>
<a href="../fr/mod/mod_ssl_ct.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_status">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_status">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="enable" id="enable">Enabling Status Support</a> <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
+<h2
id="enable">Enabling Status Support <a title="Permanent link" href="#enable" class="permalink">¶</a></h2>
<p>To enable status reports only for browsers from the example.com
<code>http://your.server.name/server-status</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="autoupdate" id="autoupdate">Automatic Updates</a> <a title="Permanent link" href="#autoupdate" class="permalink">¶</a></h2>
+<h2
id="autoupdate">Automatic Updates <a title="Permanent link" href="#autoupdate" class="permalink">¶</a></h2>
<p>You can get the status page to update itself automatically if
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="machinereadable" id="machinereadable">Machine Readable Status File</a> <a title="Permanent link" href="#machinereadable" class="permalink">¶</a></h2>
+<h2
id="machinereadable">Machine Readable Status File <a title="Permanent link" href="#machinereadable" class="permalink">¶</a></h2>
<p>A machine-readable version of the status file is available by
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="troubleshoot" id="troubleshoot">Using server-status to troubleshoot</a> <a title="Permanent link" href="#troubleshoot" class="permalink">¶</a></h2>
+<h2
id="troubleshoot">Using server-status to troubleshoot <a title="Permanent link" href="#troubleshoot" class="permalink">¶</a></h2>
<p>The <code>server-status</code> page may be used as a starting
<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_substitute">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_substitute">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Substitute" id="Substitute">Substitute</a> <a name="substitute" id="substitute">Directive</a> <a title="Permanent link" href="#substitute" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="substitute"><span id="Substitute">Substitute</span> Directive <a title="Permanent link" href="#substitute" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pattern to filter the response content</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Substitute <var>s/pattern/substitution/[infq]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SubstituteInheritBefore" id="SubstituteInheritBefore">SubstituteInheritBefore</a> <a name="substituteinheritbefore" id="substituteinheritbefore">Directive</a> <a title="Permanent link" href="#substituteinheritbefore" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="substituteinheritbefore"><span id="SubstituteInheritBefore">SubstituteInheritBefore</span> Directive <a title="Permanent link" href="#substituteinheritbefore" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Change the merge order of inherited patterns</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SubstituteInheritBefore on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SubstituteMaxLineLength" id="SubstituteMaxLineLength">SubstituteMaxLineLength</a> <a name="substitutemaxlinelength" id="substitutemaxlinelength">Directive</a> <a title="Permanent link" href="#substitutemaxlinelength" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="substitutemaxlinelength"><span id="SubstituteMaxLineLength">SubstituteMaxLineLength</span> Directive <a title="Permanent link" href="#substitutemaxlinelength" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the maximum line size</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SubstituteMaxLineLength <var>bytes</var>(b|B|k|K|m|M|g|G)</code></td></tr>
<a href="../fr/mod/mod_substitute.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SuexecUserGroup" id="SuexecUserGroup">SuexecUserGroup</a> <a name="suexecusergroup" id="suexecusergroup">Directive</a> <a title="Permanent link" href="#suexecusergroup" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="suexecusergroup"><span id="SuexecUserGroup">SuexecUserGroup</span> Directive <a title="Permanent link" href="#suexecusergroup" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>User and group for CGI programs to run as</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SuexecUserGroup <em>User Group</em></code></td></tr>
<a href="../tr/mod/mod_suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_syslog">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_syslog">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>Using <code>syslog</code> in ErrorLog directive (see <code class="module"><a href="../mod/core.html">core</a></code>)
<a href="../fr/mod/mod_syslog.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mod_systemd.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_unique_id">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_unique_id">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="theory" id="theory">Theory</a> <a title="Permanent link" href="#theory" class="permalink">¶</a></h2>
+<h2
id="theory">Theory <a title="Permanent link" href="#theory" class="permalink">¶</a></h2>
<p>First a brief recap of how the Apache server works on Unix
<a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ChrootDir" id="ChrootDir">ChrootDir</a> <a name="chrootdir" id="chrootdir">Directive</a> <a title="Permanent link" href="#chrootdir" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="chrootdir"><span id="ChrootDir">ChrootDir</span> Directive <a title="Permanent link" href="#chrootdir" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory for apache to run chroot(8) after startup.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ChrootDir <var>/path/to/directory</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Group" id="Group">Group</a> <a name="group" id="group">Directive</a> <a title="Permanent link" href="#group" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="group"><span id="Group">Group</span> Directive <a title="Permanent link" href="#group" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Group under which the server will answer
requests</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Suexec" id="Suexec">Suexec</a> <a name="suexec" id="suexec">Directive</a> <a title="Permanent link" href="#suexec" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="suexec"><span id="Suexec">Suexec</span> Directive <a title="Permanent link" href="#suexec" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable the suEXEC feature</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Suexec On|Off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="User" id="User">User</a> <a name="user" id="user">Directive</a> <a title="Permanent link" href="#user" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="user"><span id="User">User</span> Directive <a title="Permanent link" href="#user" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The userid under which the server will answer
requests</td></tr>
<a href="../tr/mod/mod_unixd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="UserDir" id="UserDir">UserDir</a> <a name="userdir" id="userdir">Directive</a> <a title="Permanent link" href="#userdir" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="userdir"><span id="UserDir">UserDir</span> Directive <a title="Permanent link" href="#userdir" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the user-specific directories</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UserDir <em>directory-filename</em> [<em>directory-filename</em>] ...
<a href="../tr/mod/mod_userdir.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_usertrack">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_usertrack">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logging" id="logging">Logging</a> <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
+<h2
id="logging">Logging <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code> sets a cookie which can be logged
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CookieDomain" id="CookieDomain">CookieDomain</a> <a name="cookiedomain" id="cookiedomain">Directive</a> <a title="Permanent link" href="#cookiedomain" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cookiedomain"><span id="CookieDomain">CookieDomain</span> Directive <a title="Permanent link" href="#cookiedomain" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The domain to which the tracking cookie applies</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CookieDomain <em>domain</em></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CookieExpires" id="CookieExpires">CookieExpires</a> <a name="cookieexpires" id="cookieexpires">Directive</a> <a title="Permanent link" href="#cookieexpires" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cookieexpires"><span id="CookieExpires">CookieExpires</span> Directive <a title="Permanent link" href="#cookieexpires" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Expiry time for the tracking cookie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CookieExpires <em>expiry-period</em></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CookieHTTPOnly" id="CookieHTTPOnly">CookieHTTPOnly</a> <a name="cookiehttponly" id="cookiehttponly">Directive</a> <a title="Permanent link" href="#cookiehttponly" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cookiehttponly"><span id="CookieHTTPOnly">CookieHTTPOnly</span> Directive <a title="Permanent link" href="#cookiehttponly" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds the 'HTTPOnly' attribute to the cookie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CookieHTTPOnly on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CookieName" id="CookieName">CookieName</a> <a name="cookiename" id="cookiename">Directive</a> <a title="Permanent link" href="#cookiename" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cookiename"><span id="CookieName">CookieName</span> Directive <a title="Permanent link" href="#cookiename" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the tracking cookie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CookieName <em>token</em></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CookieSameSite" id="CookieSameSite">CookieSameSite</a> <a name="cookiesamesite" id="cookiesamesite">Directive</a> <a title="Permanent link" href="#cookiesamesite" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cookiesamesite"><span id="CookieSameSite">CookieSameSite</span> Directive <a title="Permanent link" href="#cookiesamesite" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds the 'SameSite' attribute to the cookie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CookieSameSite None|Lax|Strict</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CookieSecure" id="CookieSecure">CookieSecure</a> <a name="cookiesecure" id="cookiesecure">Directive</a> <a title="Permanent link" href="#cookiesecure" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cookiesecure"><span id="CookieSecure">CookieSecure</span> Directive <a title="Permanent link" href="#cookiesecure" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds the 'Secure' attribute to the cookie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CookieSecure on|off</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CookieStyle" id="CookieStyle">CookieStyle</a> <a name="cookiestyle" id="cookiestyle">Directive</a> <a title="Permanent link" href="#cookiestyle" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cookiestyle"><span id="CookieStyle">CookieStyle</span> Directive <a title="Permanent link" href="#cookiestyle" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Format of the cookie header field</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CookieStyle
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CookieTracking" id="CookieTracking">CookieTracking</a> <a name="cookietracking" id="cookietracking">Directive</a> <a title="Permanent link" href="#cookietracking" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="cookietracking"><span id="CookieTracking">CookieTracking</span> Directive <a title="Permanent link" href="#cookietracking" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables tracking cookie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CookieTracking on|off</code></td></tr>
<a href="../fr/mod/mod_usertrack.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_version">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_version">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="IfVersion" id="IfVersion"><IfVersion></a> <a name="ifversion" id="ifversion">Directive</a> <a title="Permanent link" href="#ifversion" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="ifversion"><span id="IfVersion"><IfVersion></span> Directive <a title="Permanent link" href="#ifversion" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>contains version dependent configuration</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfVersion [[!]<var>operator</var>] <var>version</var>> ...
<a href="../ko/mod/mod_version.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="interpol" id="interpol">Directory Name Interpolation</a> <a title="Permanent link" href="#interpol" class="permalink">¶</a></h2>
+<h2
id="interpol">Directory Name Interpolation <a title="Permanent link" href="#interpol" class="permalink">¶</a></h2>
<p>All the directives in this module interpolate a string into
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>For simple name-based virtual hosts you might use the
in conjunction with this module.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VirtualDocumentRoot" id="VirtualDocumentRoot">VirtualDocumentRoot</a> <a name="virtualdocumentroot" id="virtualdocumentroot">Directive</a> <a title="Permanent link" href="#virtualdocumentroot" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="virtualdocumentroot"><span id="VirtualDocumentRoot">VirtualDocumentRoot</span> Directive <a title="Permanent link" href="#virtualdocumentroot" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dynamically configure the location of the document root
for a given virtual host</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VirtualDocumentRootIP" id="VirtualDocumentRootIP">VirtualDocumentRootIP</a> <a name="virtualdocumentrootip" id="virtualdocumentrootip">Directive</a> <a title="Permanent link" href="#virtualdocumentrootip" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="virtualdocumentrootip"><span id="VirtualDocumentRootIP">VirtualDocumentRootIP</span> Directive <a title="Permanent link" href="#virtualdocumentrootip" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dynamically configure the location of the document root
for a given virtual host</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VirtualScriptAlias" id="VirtualScriptAlias">VirtualScriptAlias</a> <a name="virtualscriptalias" id="virtualscriptalias">Directive</a> <a title="Permanent link" href="#virtualscriptalias" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="virtualscriptalias"><span id="VirtualScriptAlias">VirtualScriptAlias</span> Directive <a title="Permanent link" href="#virtualscriptalias" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dynamically configure the location of the CGI directory for
a given virtual host</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="VirtualScriptAliasIP" id="VirtualScriptAliasIP">VirtualScriptAliasIP</a> <a name="virtualscriptaliasip" id="virtualscriptaliasip">Directive</a> <a title="Permanent link" href="#virtualscriptaliasip" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="virtualscriptaliasip"><span id="VirtualScriptAliasIP">VirtualScriptAliasIP</span> Directive <a title="Permanent link" href="#virtualscriptaliasip" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dynamically configure the location of the CGI directory for
a given virtual host</td></tr>
<a href="../tr/mod/mod_vhost_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_watchdog">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_watchdog">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="WatchdogInterval" id="WatchdogInterval">WatchdogInterval</a> <a name="watchdoginterval" id="watchdoginterval">Directive</a> <a title="Permanent link" href="#watchdoginterval" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="watchdoginterval"><span id="WatchdogInterval">WatchdogInterval</span> Directive <a title="Permanent link" href="#watchdoginterval" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Watchdog interval in seconds</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>WatchdogInterval <var>time-interval</var>[s]</code></td></tr>
<a href="../fr/mod/mod_watchdog.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_xml2enc">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_xml2enc">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="usage" id="usage">Usage</a> <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
+<h2
id="usage">Usage <a title="Permanent link" href="#usage" class="permalink">¶</a></h2>
<p>There are two usage scenarios: with modules programmed to work
with mod_xml2enc, and with those that are not aware of it:</p>
<dl>
</dd></dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="api" id="api">Programming API</a> <a title="Permanent link" href="#api" class="permalink">¶</a></h2>
+<h2
id="api">Programming API <a title="Permanent link" href="#api" class="permalink">¶</a></h2>
<p>Programmers writing libxml2-based filter modules are encouraged to
enable them for mod_xml2enc, to provide strong i18n support for your
users without reinventing the wheel. The programming API is exposed in
<code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="sniffing" id="sniffing">Detecting an Encoding</a> <a title="Permanent link" href="#sniffing" class="permalink">¶</a></h2>
+<h2
id="sniffing">Detecting an Encoding <a title="Permanent link" href="#sniffing" class="permalink">¶</a></h2>
<p>Unlike <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>, mod_xml2enc is designed
to work with data whose encoding cannot be known in advance and thus
configured. It therefore uses 'sniffing' techniques to detect the
it is used and detection is stopped.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="output" id="output">Output Encoding</a> <a title="Permanent link" href="#output" class="permalink">¶</a></h2>
+<h2
id="output">Output Encoding <a title="Permanent link" href="#output" class="permalink">¶</a></h2>
<p><a href="http://xmlsoft.org/">libxml2</a> always uses UTF-8 (Unicode)
internally, and libxml2-based filter modules will output that by default.
mod_xml2enc can change the output encoding through the API, but there
the server of an unnecessary conversion.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="alias" id="alias">Unsupported Encodings</a> <a title="Permanent link" href="#alias" class="permalink">¶</a></h2>
+<h2
id="alias">Unsupported Encodings <a title="Permanent link" href="#alias" class="permalink">¶</a></h2>
<p>If you are working with encodings that are not supported by any of
the conversion methods available on your platform, you can still alias
them to a supported encoding using <code class="directive">xml2EncAlias</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="xml2EncAlias" id="xml2EncAlias">xml2EncAlias</a> <a name="xml2encalias" id="xml2encalias">Directive</a> <a title="Permanent link" href="#xml2encalias" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="xml2encalias"><span id="xml2EncAlias">xml2EncAlias</span> Directive <a title="Permanent link" href="#xml2encalias" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Recognize Aliases for encoding values</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>xml2EncAlias <var>charset alias [alias ...]</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="xml2EncDefault" id="xml2EncDefault">xml2EncDefault</a> <a name="xml2encdefault" id="xml2encdefault">Directive</a> <a title="Permanent link" href="#xml2encdefault" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="xml2encdefault"><span id="xml2EncDefault">xml2EncDefault</span> Directive <a title="Permanent link" href="#xml2encdefault" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets a default encoding to assume when absolutely no information
can be <a href="#sniffing">automatically detected</a></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="xml2StartParse" id="xml2StartParse">xml2StartParse</a> <a name="xml2startparse" id="xml2startparse">Directive</a> <a title="Permanent link" href="#xml2startparse" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="xml2startparse"><span id="xml2StartParse">xml2StartParse</span> Directive <a title="Permanent link" href="#xml2startparse" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Advise the parser to skip leading junk.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>xml2StartParse <var>element [element ...]</var></code></td></tr>
<a href="../fr/mod/mod_xml2enc.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Description" id="Description">Description</a> <a title="Permanent link" href="#Description" class="permalink">¶</a></h2>
+<h2
id="Description">Description <a title="Permanent link" href="#Description" class="permalink">¶</a></h2>
<p>A brief description of the purpose of the module.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Status" id="Status">Status</a> <a title="Permanent link" href="#Status" class="permalink">¶</a></h2>
+<h2
id="Status">Status <a title="Permanent link" href="#Status" class="permalink">¶</a></h2>
<p>This indicates how tightly bound into the Apache Web server
the module is; in other words, you may need to recompile the
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="SourceFile" id="SourceFile">Source File</a> <a title="Permanent link" href="#SourceFile" class="permalink">¶</a></h2>
+<h2
id="SourceFile">Source File <a title="Permanent link" href="#SourceFile" class="permalink">¶</a></h2>
<p>This quite simply lists the name of the source file which
contains the code for the module. This is also the name used by
directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ModuleIdentifier" id="ModuleIdentifier">Module Identifier</a> <a title="Permanent link" href="#ModuleIdentifier" class="permalink">¶</a></h2>
+<h2
id="ModuleIdentifier">Module Identifier <a title="Permanent link" href="#ModuleIdentifier" class="permalink">¶</a></h2>
<p>This is a string which identifies the module for use in the
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive when
the external variable of type module in the source file.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="Compatibility" id="Compatibility">Compatibility</a> <a title="Permanent link" href="#Compatibility" class="permalink">¶</a></h2>
+<h2
id="Compatibility">Compatibility <a title="Permanent link" href="#Compatibility" class="permalink">¶</a></h2>
<p>If the module was not part of the original Apache version 2
distribution, the version in which it was introduced should be
<a href="../tr/mod/module-dict.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mpm_common">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mpm_common">Report a bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="AcceptErrorsNonFatal" id="AcceptErrorsNonFatal">AcceptErrorsNonFatal</a> <a name="accepterrorsnonfatal" id="accepterrorsnonfatal">Directive</a> <a title="Permanent link" href="#accepterrorsnonfatal" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="accepterrorsnonfatal"><span id="AcceptErrorsNonFatal">AcceptErrorsNonFatal</span> Directive <a title="Permanent link" href="#accepterrorsnonfatal" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Treat some errors accepting a new connection as non-fatal
to the httpd process.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="CoreDumpDirectory" id="CoreDumpDirectory">CoreDumpDirectory</a> <a name="coredumpdirectory" id="coredumpdirectory">Directive</a> <a title="Permanent link" href="#coredumpdirectory" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="coredumpdirectory"><span id="CoreDumpDirectory">CoreDumpDirectory</span> Directive <a title="Permanent link" href="#coredumpdirectory" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory where Apache HTTP Server attempts to
switch before dumping core</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="EnableExceptionHook" id="EnableExceptionHook">EnableExceptionHook</a> <a name="enableexceptionhook" id="enableexceptionhook">Directive</a> <a title="Permanent link" href="#enableexceptionhook" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="enableexceptionhook"><span id="EnableExceptionHook">EnableExceptionHook</span> Directive <a title="Permanent link" href="#enableexceptionhook" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables a hook that runs exception handlers
after a crash</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="GracefulShutdownTimeout" id="GracefulShutdownTimeout">GracefulShutdownTimeout</a> <a name="gracefulshutdowntimeout" id="gracefulshutdowntimeout">Directive</a> <a title="Permanent link" href="#gracefulshutdowntimeout" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="gracefulshutdowntimeout"><span id="GracefulShutdownTimeout">GracefulShutdownTimeout</span> Directive <a title="Permanent link" href="#gracefulshutdowntimeout" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a timeout after which a gracefully shutdown server
will exit.</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="Listen" id="Listen">Listen</a> <a name="listen" id="listen">Directive</a> <a title="Permanent link" href="#listen" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="listen"><span id="Listen">Listen</span> Directive <a title="Permanent link" href="#listen" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>IP addresses and ports that the server
listens to</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ListenBackLog" id="ListenBackLog">ListenBackLog</a> <a name="listenbacklog" id="listenbacklog">Directive</a> <a title="Permanent link" href="#listenbacklog" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="listenbacklog"><span id="ListenBackLog">ListenBackLog</span> Directive <a title="Permanent link" href="#listenbacklog" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum length of the queue of pending connections</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ListenBackLog <var>backlog</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ListenCoresBucketsRatio" id="ListenCoresBucketsRatio">ListenCoresBucketsRatio</a> <a name="listencoresbucketsratio" id="listencoresbucketsratio">Directive</a> <a title="Permanent link" href="#listencoresbucketsratio" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="listencoresbucketsratio"><span id="ListenCoresBucketsRatio">ListenCoresBucketsRatio</span> Directive <a title="Permanent link" href="#listencoresbucketsratio" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ratio between the number of CPU cores (online) and the number of
listeners' buckets</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ListenTCPDeferAccept" id="ListenTCPDeferAccept">ListenTCPDeferAccept</a> <a name="listentcpdeferaccept" id="listentcpdeferaccept">Directive</a> <a title="Permanent link" href="#listentcpdeferaccept" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="listentcpdeferaccept"><span id="ListenTCPDeferAccept">ListenTCPDeferAccept</span> Directive <a title="Permanent link" href="#listentcpdeferaccept" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Value set for the socket option TCP_DEFER_ACCEPT if it is set</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ListenTCPDeferAccept <var>integer</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxConnectionsPerChild" id="MaxConnectionsPerChild">MaxConnectionsPerChild</a> <a name="maxconnectionsperchild" id="maxconnectionsperchild">Directive</a> <a title="Permanent link" href="#maxconnectionsperchild" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxconnectionsperchild"><span id="MaxConnectionsPerChild">MaxConnectionsPerChild</span> Directive <a title="Permanent link" href="#maxconnectionsperchild" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit on the number of connections that an individual child server
will handle during its life</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxMemFree" id="MaxMemFree">MaxMemFree</a> <a name="maxmemfree" id="maxmemfree">Directive</a> <a title="Permanent link" href="#maxmemfree" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxmemfree"><span id="MaxMemFree">MaxMemFree</span> Directive <a title="Permanent link" href="#maxmemfree" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum amount of memory that the main allocator is allowed
to hold without calling <code>free()</code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxRequestWorkers" id="MaxRequestWorkers">MaxRequestWorkers</a> <a name="maxrequestworkers" id="maxrequestworkers">Directive</a> <a title="Permanent link" href="#maxrequestworkers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxrequestworkers"><span id="MaxRequestWorkers">MaxRequestWorkers</span> Directive <a title="Permanent link" href="#maxrequestworkers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of connections that will be processed
simultaneously</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxSpareThreads" id="MaxSpareThreads">MaxSpareThreads</a> <a name="maxsparethreads" id="maxsparethreads">Directive</a> <a title="Permanent link" href="#maxsparethreads" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxsparethreads"><span id="MaxSpareThreads">MaxSpareThreads</span> Directive <a title="Permanent link" href="#maxsparethreads" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of idle threads</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxSpareThreads <var>number</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MinSpareThreads" id="MinSpareThreads">MinSpareThreads</a> <a name="minsparethreads" id="minsparethreads">Directive</a> <a title="Permanent link" href="#minsparethreads" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="minsparethreads"><span id="MinSpareThreads">MinSpareThreads</span> Directive <a title="Permanent link" href="#minsparethreads" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimum number of idle threads available to handle request
spikes</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="PidFile" id="PidFile">PidFile</a> <a name="pidfile" id="pidfile">Directive</a> <a title="Permanent link" href="#pidfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="pidfile"><span id="PidFile">PidFile</span> Directive <a title="Permanent link" href="#pidfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File where the server records the process ID
of the daemon</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ReceiveBufferSize" id="ReceiveBufferSize">ReceiveBufferSize</a> <a name="receivebuffersize" id="receivebuffersize">Directive</a> <a title="Permanent link" href="#receivebuffersize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="receivebuffersize"><span id="ReceiveBufferSize">ReceiveBufferSize</span> Directive <a title="Permanent link" href="#receivebuffersize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>TCP receive buffer size</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ReceiveBufferSize <var>bytes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ScoreBoardFile" id="ScoreBoardFile">ScoreBoardFile</a> <a name="scoreboardfile" id="scoreboardfile">Directive</a> <a title="Permanent link" href="#scoreboardfile" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="scoreboardfile"><span id="ScoreBoardFile">ScoreBoardFile</span> Directive <a title="Permanent link" href="#scoreboardfile" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the file used to store coordination data for
the child processes</td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="SendBufferSize" id="SendBufferSize">SendBufferSize</a> <a name="sendbuffersize" id="sendbuffersize">Directive</a> <a title="Permanent link" href="#sendbuffersize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="sendbuffersize"><span id="SendBufferSize">SendBufferSize</span> Directive <a title="Permanent link" href="#sendbuffersize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>TCP buffer size</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SendBufferSize <var>bytes</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ServerLimit" id="ServerLimit">ServerLimit</a> <a name="serverlimit" id="serverlimit">Directive</a> <a title="Permanent link" href="#serverlimit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="serverlimit"><span id="ServerLimit">ServerLimit</span> Directive <a title="Permanent link" href="#serverlimit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Upper limit on configurable number of processes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerLimit <var>number</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="StartServers" id="StartServers">StartServers</a> <a name="startservers" id="startservers">Directive</a> <a title="Permanent link" href="#startservers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="startservers"><span id="StartServers">StartServers</span> Directive <a title="Permanent link" href="#startservers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of child server processes created at startup</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>StartServers <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="StartThreads" id="StartThreads">StartThreads</a> <a name="startthreads" id="startthreads">Directive</a> <a title="Permanent link" href="#startthreads" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="startthreads"><span id="StartThreads">StartThreads</span> Directive <a title="Permanent link" href="#startthreads" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of threads created on startup</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>StartThreads <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ThreadLimit" id="ThreadLimit">ThreadLimit</a> <a name="threadlimit" id="threadlimit">Directive</a> <a title="Permanent link" href="#threadlimit" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="threadlimit"><span id="ThreadLimit">ThreadLimit</span> Directive <a title="Permanent link" href="#threadlimit" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the upper limit on the configurable number of threads
per child process</td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ThreadsPerChild" id="ThreadsPerChild">ThreadsPerChild</a> <a name="threadsperchild" id="threadsperchild">Directive</a> <a title="Permanent link" href="#threadsperchild" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="threadsperchild"><span id="ThreadsPerChild">ThreadsPerChild</span> Directive <a title="Permanent link" href="#threadsperchild" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of threads created by each child process</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ThreadsPerChild <var>number</var></code></td></tr>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="ThreadStackSize" id="ThreadStackSize">ThreadStackSize</a> <a name="threadstacksize" id="threadstacksize">Directive</a> <a title="Permanent link" href="#threadstacksize" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="threadstacksize"><span id="ThreadStackSize">ThreadStackSize</span> Directive <a title="Permanent link" href="#threadstacksize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The size in bytes of the stack used by threads handling
client connections</td></tr>
<a href="../tr/mod/mpm_common.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxThreads" id="MaxThreads">MaxThreads</a> <a name="maxthreads" id="maxthreads">Directive</a> <a title="Permanent link" href="#maxthreads" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxthreads"><span id="MaxThreads">MaxThreads</span> Directive <a title="Permanent link" href="#maxthreads" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the maximum number of worker threads</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxThreads <var>number</var></code></td></tr>
<a href="../fr/mod/mpm_netware.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../ja/mod/mpm_winnt.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/mpmt_os2.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../fr/mod/overrides.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="how-it-works" id="how-it-works">How it Works</a> <a title="Permanent link" href="#how-it-works" class="permalink">¶</a></h2>
+<h2
id="how-it-works">How it Works <a title="Permanent link" href="#how-it-works" class="permalink">¶</a></h2>
<p>A single control process is responsible for launching child
processes which listen for connections and serve them when they
arrive. Apache httpd always tries to maintain several <dfn>spare</dfn>
documentation has additional information about this mutex.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MaxSpareServers" id="MaxSpareServers">MaxSpareServers</a> <a name="maxspareservers" id="maxspareservers">Directive</a> <a title="Permanent link" href="#maxspareservers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="maxspareservers"><span id="MaxSpareServers">MaxSpareServers</span> Directive <a title="Permanent link" href="#maxspareservers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of idle child server processes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxSpareServers <var>number</var></code></td></tr>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
-<div class="directive-section"><h2
><a name="MinSpareServers" id="MinSpareServers">MinSpareServers</a> <a name="minspareservers" id="minspareservers">Directive</a> <a title="Permanent link" href="#minspareservers" class="permalink">¶</a></h2>
+<div class="directive-section"><h2
id="minspareservers"><span id="MinSpareServers">MinSpareServers</span> Directive <a title="Permanent link" href="#minspareservers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimum number of idle child server processes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MinSpareServers <var>number</var></code></td></tr>
<a href="../tr/mod/prefork.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../zh-cn/mod/quickreference.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="how-it-works" id="how-it-works">How it Works</a> <a title="Permanent link" href="#how-it-works" class="permalink">¶</a></h2>
+<h2
id="how-it-works">How it Works <a title="Permanent link" href="#how-it-works" class="permalink">¶</a></h2>
<p>A single control process (the parent) is responsible for launching
child processes. Each child process creates a fixed number of server
threads as specified in the <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> directive, as well
<a href="../tr/mod/worker.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
+<h2
id="introduction">Introduction <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
<p>The Apache HTTP Server is designed to be a powerful and
flexible web server that can work on a very wide variety of
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="defaults" id="defaults">MPM Defaults</a> <a title="Permanent link" href="#defaults" class="permalink">¶</a></h2>
+<h2
id="defaults">MPM Defaults <a title="Permanent link" href="#defaults" class="permalink">¶</a></h2>
<p>The following table lists the default MPMs for various operating
systems. This will be the MPM selected if you do not make another
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="static" id="static">Building an MPM as a static module</a> <a title="Permanent link" href="#static" class="permalink">¶</a></h2>
+<h2
id="static">Building an MPM as a static module <a title="Permanent link" href="#static" class="permalink">¶</a></h2>
<p>MPMs can be built as static modules on all platforms. A single MPM
is chosen at build time and linked into the server. The server must
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dynamic" id="dynamic">Building an MPM as a DSO module</a> <a title="Permanent link" href="#dynamic" class="permalink">¶</a></h2>
+<h2
id="dynamic">Building an MPM as a DSO module <a title="Permanent link" href="#dynamic" class="permalink">¶</a></h2>
<p>On Unix and similar platforms, MPMs can be built as DSO modules and
dynamically loaded into the server in the same manner as other DSO
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="upgrading.html">Upgrading to 2.0 from 1.3</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="core" id="core">Core Enhancements</a> <a title="Permanent link" href="#core" class="permalink">¶</a></h2>
+<h2
id="core">Core Enhancements <a title="Permanent link" href="#core" class="permalink">¶</a></h2>
<dl>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="module" id="module">Module Enhancements</a> <a title="Permanent link" href="#module" class="permalink">¶</a></h2>
+<h2
id="module">Module Enhancements <a title="Permanent link" href="#module" class="permalink">¶</a></h2>
<dl>
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="core" id="core">Core Enhancements</a> <a title="Permanent link" href="#core" class="permalink">¶</a></h2>
+<h2
id="core">Core Enhancements <a title="Permanent link" href="#core" class="permalink">¶</a></h2>
<dl>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="module" id="module">Module Enhancements</a> <a title="Permanent link" href="#module" class="permalink">¶</a></h2>
+<h2
id="module">Module Enhancements <a title="Permanent link" href="#module" class="permalink">¶</a></h2>
<dl>
<dt>Authn/Authz</dt>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="programs" id="programs">Program Enhancements</a> <a title="Permanent link" href="#programs" class="permalink">¶</a></h2>
+<h2
id="programs">Program Enhancements <a title="Permanent link" href="#programs" class="permalink">¶</a></h2>
<dl>
<dt><code class="program"><a href="./programs/httpd.html">httpd</a></code></dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="developer" id="developer">Module Developer Changes</a> <a title="Permanent link" href="#developer" class="permalink">¶</a></h2>
+<h2
id="developer">Module Developer Changes <a title="Permanent link" href="#developer" class="permalink">¶</a></h2>
<dl>
<dt><a class="glossarylink" href="./glossary.html#apr" title="see glossary">APR</a> 1.0 API</dt>
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="core" id="core">Core Enhancements</a> <a title="Permanent link" href="#core" class="permalink">¶</a></h2>
+<h2
id="core">Core Enhancements <a title="Permanent link" href="#core" class="permalink">¶</a></h2>
<dl>
<dt>Run-time Loadable MPMs</dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="newmods" id="newmods">New Modules</a> <a title="Permanent link" href="#newmods" class="permalink">¶</a></h2>
+<h2
id="newmods">New Modules <a title="Permanent link" href="#newmods" class="permalink">¶</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="module" id="module">Module Enhancements</a> <a title="Permanent link" href="#module" class="permalink">¶</a></h2>
+<h2
id="module">Module Enhancements <a title="Permanent link" href="#module" class="permalink">¶</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="programs" id="programs">Program Enhancements</a> <a title="Permanent link" href="#programs" class="permalink">¶</a></h2>
+<h2
id="programs">Program Enhancements <a title="Permanent link" href="#programs" class="permalink">¶</a></h2>
<dl>
<dt><code class="program"><a href="./programs/fcgistarter.html">fcgistarter</a></code></dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="documentation" id="documentation">Documentation</a> <a title="Permanent link" href="#documentation" class="permalink">¶</a></h2>
+<h2
id="documentation">Documentation <a title="Permanent link" href="#documentation" class="permalink">¶</a></h2>
<dl>
<dt>mod_rewrite</dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="developer" id="developer">Module Developer Changes</a> <a title="Permanent link" href="#developer" class="permalink">¶</a></h2>
+<h2
id="developer">Module Developer Changes <a title="Permanent link" href="#developer" class="permalink">¶</a></h2>
<dl>
<dt>Check Configuration Hook Added</dt>
<a href="./tr/new_features_2_4.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="core" id="core">Core Enhancements</a> <a title="Permanent link" href="#core" class="permalink">¶</a></h2>
+<h2
id="core">Core Enhancements <a title="Permanent link" href="#core" class="permalink">¶</a></h2>
<dl>
<dt>ContentDigest directive and Content-MD5 header</dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="newmods" id="newmods">New Modules</a> <a title="Permanent link" href="#newmods" class="permalink">¶</a></h2>
+<h2
id="newmods">New Modules <a title="Permanent link" href="#newmods" class="permalink">¶</a></h2>
<dl>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="module" id="module">Module Enhancements</a> <a title="Permanent link" href="#module" class="permalink">¶</a></h2>
+<h2
id="module">Module Enhancements <a title="Permanent link" href="#module" class="permalink">¶</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="programs" id="programs">Program Enhancements</a> <a title="Permanent link" href="#programs" class="permalink">¶</a></h2>
+<h2
id="programs">Program Enhancements <a title="Permanent link" href="#programs" class="permalink">¶</a></h2>
<dl>
<dt><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code></dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="documentation" id="documentation">Documentation</a> <a title="Permanent link" href="#documentation" class="permalink">¶</a></h2>
+<h2
id="documentation">Documentation <a title="Permanent link" href="#documentation" class="permalink">¶</a></h2>
<dl>
<dt>Fill me in</dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="developer" id="developer">Module Developer Changes</a> <a title="Permanent link" href="#developer" class="permalink">¶</a></h2>
+<h2
id="developer">Module Developer Changes <a title="Permanent link" href="#developer" class="permalink">¶</a></h2>
<dl>
<dt>New type <code>ap_method_mask_t</code>.</dt>
<a href="./fr/new_features_2_6.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="win" id="win">Microsoft Windows</a> <a title="Permanent link" href="#win" class="permalink">¶</a></h2>
+<h2
id="win">Microsoft Windows <a title="Permanent link" href="#win" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="unix" id="unix">Unix Systems</a> <a title="Permanent link" href="#unix" class="permalink">¶</a></h2>
+<h2
id="unix">Unix Systems <a title="Permanent link" href="#unix" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="other" id="other">Other Platforms</a> <a title="Permanent link" href="#other" class="permalink">¶</a></h2>
+<h2
id="other">Other Platforms <a title="Permanent link" href="#other" class="permalink">¶</a></h2>
<a href="../zh-cn/platform/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="req" id="req">Requirements</a> <a title="Permanent link" href="#req" class="permalink">¶</a></h2>
+<h2
id="req">Requirements <a title="Permanent link" href="#req" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="down" id="down">Downloading Apache httpd for NetWare</a> <a title="Permanent link" href="#down" class="permalink">¶</a></h2>
+<h2
id="down">Downloading Apache httpd for NetWare <a title="Permanent link" href="#down" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="inst" id="inst">Installing Apache httpd for NetWare</a> <a title="Permanent link" href="#inst" class="permalink">¶</a></h2>
+<h2
id="inst">Installing Apache httpd for NetWare <a title="Permanent link" href="#inst" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="run" id="run">Running Apache httpd for NetWare</a> <a title="Permanent link" href="#run" class="permalink">¶</a></h2>
+<h2
id="run">Running Apache httpd for NetWare <a title="Permanent link" href="#run" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="use" id="use">Configuring Apache httpd for NetWare</a> <a title="Permanent link" href="#use" class="permalink">¶</a></h2>
+<h2
id="use">Configuring Apache httpd for NetWare <a title="Permanent link" href="#use" class="permalink">¶</a></h2>
</li>
</ul>
- <h3><a name="use-add" id="use-add">Additional NetWare specific directives:</a></h3>
+ <h3 id="use-add">Additional NetWare specific directives:</h3>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="comp" id="comp">Compiling Apache httpd for NetWare</a> <a title="Permanent link" href="#comp" class="permalink">¶</a></h2>
+<h2
id="comp">Compiling Apache httpd for NetWare <a title="Permanent link" href="#comp" class="permalink">¶</a></h2>
Alternatively, a complete distribution can be built by including the keyword
<code>install</code> when invoking the makefiles.</p>
- <h3><a name="comp-req" id="comp-req">Requirements:</a></h3>
+ <h3 id="comp-req">Requirements:</h3>
- <h3><a name="comp-make" id="comp-make">Building Apache httpd using the NetWare makefiles:</a></h3>
+ <h3 id="comp-make">Building Apache httpd using the NetWare makefiles:</h3>
- <h3><a name="comp-add" id="comp-add">Additional make options</a></h3>
+ <h3 id="comp-add">Additional make options</h3>
- <h3><a name="comp-add-env" id="comp-add-env">Additional environment variable options</a></h3>
+ <h3 id="comp-add-env">Additional environment variable options</h3>
- <h3><a name="comp-mod_ssl" id="comp-mod_ssl">Building mod_ssl for the NetWare platform</a></h3>
+ <h3 id="comp-mod_ssl">Building mod_ssl for the NetWare platform</h3>
<a href="../ko/platform/netware.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="creating" id="creating">Creating a Source RPM</a> <a title="Permanent link" href="#creating" class="permalink">¶</a></h2>
+<h2
id="creating">Creating a Source RPM <a title="Permanent link" href="#creating" class="permalink">¶</a></h2>
<p>The Apache httpd source tarball can be converted into an SRPM as
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="building" id="building">Building RPMs</a> <a title="Permanent link" href="#building" class="permalink">¶</a></h2>
+<h2
id="building">Building RPMs <a title="Permanent link" href="#building" class="permalink">¶</a></h2>
<p>RPMs can be built directly from the Apache httpd source tarballs using
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="installing" id="installing">Installing the Server</a> <a title="Permanent link" href="#installing" class="permalink">¶</a></h2>
+<h2
id="installing">Installing the Server <a title="Permanent link" href="#installing" class="permalink">¶</a></h2>
<p>The <code>httpd</code> RPM is the only RPM necessary to get a basic
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="default" id="default">Configuring the Default Instance of Apache httpd</a> <a title="Permanent link" href="#default" class="permalink">¶</a></h2>
+<h2
id="default">Configuring the Default Instance of Apache httpd <a title="Permanent link" href="#default" class="permalink">¶</a></h2>
<p>The default configuration for the server is installed by default
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="additional" id="additional">Configuring Additional Instances of Apache httpd on the Same Machine</a> <a title="Permanent link" href="#additional" class="permalink">¶</a></h2>
+<h2
id="additional">Configuring Additional Instances of Apache httpd on the Same Machine <a title="Permanent link" href="#additional" class="permalink">¶</a></h2>
<p>It is possible to configure additional instances of the Apache
<a href="../fr/platform/rpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="vstudio" id="vstudio">Building httpd with the included Visual Studio project files</a> <a title="Permanent link" href="#vstudio" class="permalink">¶</a></h2>
+<h2
id="vstudio">Building httpd with the included Visual Studio project files <a title="Permanent link" href="#vstudio" class="permalink">¶</a></h2>
- <h3><a name="requirements" id="requirements">Requirements</a></h3>
+ <h3 id="requirements">Requirements</h3>
- <h3><a name="unixsrcbuild" id="unixsrcbuild">Building from Unix sources</a></h3>
+ <h3 id="unixsrcbuild">Building from Unix sources</h3>
- <h3><a name="commandbuild" id="commandbuild">Command-Line Build</a></h3>
+ <h3 id="commandbuild">Command-Line Build</h3>
- <h3><a name="workspacebuild" id="workspacebuild">Developer Studio Workspace IDE Build</a></h3>
+ <h3 id="workspacebuild">Developer Studio Workspace IDE Build</h3>
- <h3><a name="exportingmakfiles" id="exportingmakfiles">Exporting command-line .mak files</a></h3>
+ <h3 id="exportingmakfiles">Exporting command-line .mak files</h3>
- <h3><a name="installation" id="installation">Installation</a></h3>
+ <h3 id="installation">Installation</h3>
- <h3><a name="projectcomponents-warn" id="projectcomponents-warn">Warning about building Apache from the development tree</a></h3>
+ <h3 id="projectcomponents-warn">Warning about building Apache from the development tree</h3>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cmake" id="cmake">Building httpd with cmake</a> <a title="Permanent link" href="#cmake" class="permalink">¶</a></h2>
+<h2
id="cmake">Building httpd with cmake <a title="Permanent link" href="#cmake" class="permalink">¶</a></h2>
<p>The primary documentation for this build mechanism is in the
<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="req" id="req">Operating System Requirements</a> <a title="Permanent link" href="#req" class="permalink">¶</a></h2>
+<h2
id="req">Operating System Requirements <a title="Permanent link" href="#req" class="permalink">¶</a></h2>
<p>The primary Windows platform for running Apache httpd 2.5 is Windows
operating system earlier than Windows 2000.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="down" id="down">Downloading httpd for Windows</a> <a title="Permanent link" href="#down" class="permalink">¶</a></h2>
+<h2
id="down">Downloading httpd for Windows <a title="Permanent link" href="#down" class="permalink">¶</a></h2>
<p>The Apache HTTP Server Project itself does not provide binary releases of
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cust" id="cust">Customizing httpd for Windows</a> <a title="Permanent link" href="#cust" class="permalink">¶</a></h2>
+<h2
id="cust">Customizing httpd for Windows <a title="Permanent link" href="#cust" class="permalink">¶</a></h2>
<p>Apache httpd is configured by the files in the <code>conf</code>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="winsvc" id="winsvc">Running httpd as a Service</a> <a title="Permanent link" href="#winsvc" class="permalink">¶</a></h2>
+<h2
id="winsvc">Running httpd as a Service <a title="Permanent link" href="#winsvc" class="permalink">¶</a></h2>
<p>Apache httpd comes with a utility called the Apache Service Monitor.
start it as a service again.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="wincons" id="wincons">Running httpd as a Console Application</a> <a title="Permanent link" href="#wincons" class="permalink">¶</a></h2>
+<h2
id="wincons">Running httpd as a Console Application <a title="Permanent link" href="#wincons" class="permalink">¶</a></h2>
<p>Running Apache httpd as a service is usually the recommended way to
<code>httpd.conf</code> file to reflect the new location.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="test" id="test">Testing the Installation</a> <a title="Permanent link" href="#test" class="permalink">¶</a></h2>
+<h2
id="test">Testing the Installation <a title="Permanent link" href="#test" class="permalink">¶</a></h2>
<p>After starting Apache httpd (either in a console window or as a
80 to attempt to bypass firewall issues.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="windrivemap" id="windrivemap">Configuring Access to Network Resources</a> <a title="Permanent link" href="#windrivemap" class="permalink">¶</a></h2>
+<h2
id="windrivemap">Configuring Access to Network Resources <a title="Permanent link" href="#windrivemap" class="permalink">¶</a></h2>
<p>Access to files over the network can be specified using two
above.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="tuning" id="tuning">Windows Tuning</a> <a title="Permanent link" href="#tuning" class="permalink">¶</a></h2>
+<h2
id="tuning">Windows Tuning <a title="Permanent link" href="#tuning" class="permalink">¶</a></h2>
<ul>
<li><p>If more than a few dozen piped loggers are used on an operating system
<a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>ab</strong>
[ -<strong>A</strong> <var>auth-username</var>:<var>password</var> ]
[ -<strong>b</strong> <var>windowsize</var> ]
[http[s]://]<var>hostname</var>[:<var>port</var>]/<var>path</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-A <var>auth-username</var>:<var>password</var></code></dt>
<dd>Supply BASIC Authentication credentials to the server. The username and
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="output" id="output">Output</a> <a title="Permanent link" href="#output" class="permalink">¶</a></h2>
+<h2
id="output">Output <a title="Permanent link" href="#output" class="permalink">¶</a></h2>
<p>The following list describes the values returned by <code class="program"><a href="../programs/ab.html">ab</a></code>:
</p>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="bugs" id="bugs">Bugs</a> <a title="Permanent link" href="#bugs" class="permalink">¶</a></h2>
+<h2
id="bugs">Bugs <a title="Permanent link" href="#bugs" class="permalink">¶</a></h2>
<p>There are various statically declared buffers of fixed length. Combined
with the lazy parsing of the command line arguments, the response headers
from the server and other external inputs, this might bite you.</p>
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../invoking.html">Starting Apache</a></li><li><a href="../stopping.html">Stopping Apache</a></li><li><a href="../configuring.html">Configuration Files</a></li><li><a href="../platform/">Platform Docs</a></li><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p>When acting in pass-through mode, <code class="program"><a href="../programs/apachectl.html">apachectl</a></code> can take
all the arguments available for the <code class="program"><a href="../programs/httpd.html">httpd</a></code>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<p>Only the SysV init-style options are defined here. Other arguments
are defined on the <code class="program"><a href="../programs/httpd.html">httpd</a></code> manual page.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="files" id="files">Files</a> <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
+<h2
id="files">Files <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
<p>The default paths listed below may be changed at compile time.
Consult your local installation for the actual locations.</p>
<a href="../tr/programs/apachectl.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>apxs</strong> -<strong>g</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
-<strong>n</strong> <var>modname</var></code></p>
<var>dso-file</var> ...</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
- <h3><a name="options.common" id="options.common">Common Options</a></h3>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+ <h3 id="options.common">Common Options</h3>
<dl>
<dt><code>-n <var>modname</var></code></dt>
<dd>This explicitly sets the module name for the <code>-i</code> (install)
</dl>
- <h3><a name="options.query" id="options.query">Query Options</a></h3>
+ <h3 id="options.query">Query Options</h3>
<dl>
<dt><code>-q</code></dt>
<dd>Performs a query for variables and environment settings used to
</dl>
- <h3><a name="options.conf" id="options.conf">Configuration Options</a></h3>
+ <h3 id="options.conf">Configuration Options</h3>
<dl>
<dt><code>-S <var>name</var>=<var>value</var></code></dt>
<dd>This option changes the apxs settings described above.</dd>
</dl>
- <h3><a name="options.template" id="options.template">Template Generation Options</a></h3>
+ <h3 id="options.template">Template Generation Options</h3>
<dl>
<dt><code>-g</code></dt>
<dd>This generates a subdirectory <var>name</var> (see option
</dl>
- <h3><a name="options.dso" id="options.dso">DSO Compilation Options</a></h3>
+ <h3 id="options.dso">DSO Compilation Options</h3>
<dl>
<dt><code>-c</code></dt>
<dd>This indicates the compilation operation. It first compiles the C
</dl>
- <h3><a name="options.dsoinstall" id="options.dsoinstall">DSO Installation and Configuration Options</a></h3>
+ <h3 id="options.dsoinstall">DSO Installation and Configuration Options</h3>
<dl>
<dt><code>-i</code></dt>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>Assume you have an Apache module named <code>mod_foo.c</code> available
which should extend Apache's server functionality. To accomplish this you
first have to compile the C source into a shared object suitable for loading
<a href="../tr/programs/apxs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../install.html">Compiling and Installing</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p>You should call the <code class="program"><a href="../programs/configure.html">configure</a></code> script from within the
root directory of the distribution.</p>
for descriptions of some of the useful variables.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<ul>
<li><a href="#configurationoptions">Configuration options</a></li>
<li><a href="#installationdirectories">Installation directories</a></li>
<li><a href="#supportopt">Options for support programs</a></li>
</ul>
- <h3><a name="configurationoptions" id="configurationoptions">Configuration options</a></h3>
+ <h3 id="configurationoptions">Configuration options</h3>
<p>The following options influence the behavior of
<code class="program"><a href="../programs/configure.html">configure</a></code> itself.</p>
</dl>
- <h3><a name="installationdirectories" id="installationdirectories">Installation
- directories</a></h3>
+ <h3 id="installationdirectories">Installation
+ directories</h3>
<p>These options define the installation directory. The installation
tree depends on the selected layout.</p>
- <h3><a name="systemtypes" id="systemtypes">System types</a></h3>
+ <h3 id="systemtypes">System types</h3>
<p>These options are used to cross-compile the Apache HTTP Server to run on
another system. In normal cases, when building and running the server on
</dl>
- <h3><a name="optionalfeatures" id="optionalfeatures">Optional Features</a></h3>
+ <h3 id="optionalfeatures">Optional Features</h3>
<p>These options are used to fine tune the features your HTTP server will
have.</p>
- <h3><a name="packages" id="packages">Optional packages</a></h3>
+ <h3 id="packages">Optional packages</h3>
<p>These options are used to define optional packages.</p>
<h4><a name="generalpackages" id="generalpackages">General syntax</a></h4>
- <h3><a name="supportopt" id="supportopt">Options for support programs</a></h3>
+ <h3 id="supportopt">Options for support programs</h3>
<dl>
<dt><code>--enable-static-support</code></dt>
<dd>Build a statically linked version of the support binaries. This
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="env" id="env">Environment variables</a> <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
+<h2
id="env">Environment variables <a title="Permanent link" href="#env" class="permalink">¶</a></h2>
<p>There are some useful environment variables to override the choices made by
<code class="program"><a href="../programs/configure.html">configure</a></code> or to help it to find libraries and programs with
nonstandard names or locations.</p>
<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_ssl_ct.html">mod_ssl_ct</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code>
<strong>ctlogconfig</strong> <em>/path/to/db</em> <strong>dump</strong>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="subcommands" id="subcommands">Sub-commands</a> <a title="Permanent link" href="#subcommands" class="permalink">¶</a></h2>
+<h2
id="subcommands">Sub-commands <a title="Permanent link" href="#subcommands" class="permalink">¶</a></h2>
<dl>
<dt>dump</dt>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<p>Consider an Apache httpd instance which serves as a TLS server and a proxy.
<a href="../fr/programs/ctlogconfig.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>dbmmanage</strong> [ <var>encoding</var> ]
<var>filename</var> add|adduser|check|delete|update
<var>username</var>
<p><code><strong>dbmmanage</strong> <var>filename</var> import</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code><var>filename</var></code></dt>
<dd>The filename of the DBM format file. Usually without the extension
field.</dd>
</dl>
- <h3><a name="options.encodings" id="options.encodings">Encodings</a></h3>
+ <h3 id="options.encodings">Encodings</h3>
<dl>
<dt><code>-d</code></dt>
<dd>crypt hashing (default, except on Win32, Netware)</dd>
</dl>
- <h3><a name="options.commands" id="options.commands">Commands</a></h3>
+ <h3 id="options.commands">Commands</h3>
<dl>
<dt><code>add</code></dt>
<dd>Adds an entry for <var>username</var> to <var>filename</var> using the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="bugs" id="bugs">Bugs</a> <a title="Permanent link" href="#bugs" class="permalink">¶</a></h2>
+<h2
id="bugs">Bugs <a title="Permanent link" href="#bugs" class="permalink">¶</a></h2>
<p>One should be aware that there are a number of different DBM file formats
in existence, and with all likelihood, libraries for more than one format
may exist on your system. The three primary examples are SDBM, NDBM, the GNU
<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="note" id="note">Note</a> <a title="Permanent link" href="#note" class="permalink">¶</a></h2>
+<h2
id="note">Note <a title="Permanent link" href="#note" class="permalink">¶</a></h2>
<p>Currently only works on Unix systems.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>fcgistarter</strong>
-<strong>c</strong> <var>command</var>
-<strong>p</strong> <var>port</var>
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-c <var>command</var></code></dt>
<dd>Absolute path of the FastCGI program</dd>
<a href="../tr/programs/fcgistarter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_firehose.html">mod_firehose</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>firehose</strong>
[ -<strong>f</strong> <var>input</var> ]
[ -<strong>o</strong> <var>output-directory</var> ]
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>--file, -f <var>filename</var></code></dt>
<dd>File to read the firehose from. Defaults to stdin.</dd>
<a href="../fr/programs/firehose.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
<var>url</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-d<var>interval</var></code></dt>
<dd>Daemonize and repeat cache cleaning every <var>interval</var> minutes.
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="delete" id="delete">Deleting a specific URL</a> <a title="Permanent link" href="#delete" class="permalink">¶</a></h2>
+<h2
id="delete">Deleting a specific URL <a title="Permanent link" href="#delete" class="permalink">¶</a></h2>
<p>If <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> is passed one or more URLs, each URL will
be deleted from the cache. If multiple variants of an URL exists, all
variants would be deleted.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="list" id="list">Listing URLs in the Cache</a> <a title="Permanent link" href="#list" class="permalink">¶</a></h2>
+<h2
id="list">Listing URLs in the Cache <a title="Permanent link" href="#list" class="permalink">¶</a></h2>
<p>By passing the <code>-a</code> or <code>-A</code> options to
<code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code>, the URLs within the cache will be listed
as they are found, one URL per line. The <code>-A</code> option
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="exit" id="exit">Exit Status</a> <a title="Permanent link" href="#exit" class="permalink">¶</a></h2>
+<h2
id="exit">Exit Status <a title="Permanent link" href="#exit" class="permalink">¶</a></h2>
<p><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> returns a zero status ("true") if all
operations were successful, <code>1</code> otherwise. If an URL is
specified, and the URL was cached and successfully removed,
occurred during URL removal, <code>1</code> is returned.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="files" id="files">Files</a> <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
+<h2
id="files">Files <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
<p>The cache root directory is specified as an argument on the command line
and should match the <code>CacheRoot</code> directive in the server
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>htdbm</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>i</strong> ]
<var>filename</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-b</code></dt>
<dd>Use batch mode; <em>i.e.</em>, get the password from the command line
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="bugs" id="bugs">Bugs</a> <a title="Permanent link" href="#bugs" class="permalink">¶</a></h2>
+<h2
id="bugs">Bugs <a title="Permanent link" href="#bugs" class="permalink">¶</a></h2>
<p>One should be aware that there are a number of different DBM file
formats in existence, and with all likelihood, libraries for more than
one format may exist on your system. The three primary examples are
Unix systems to see what format a DBM file is in.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="exit" id="exit">Exit Status</a> <a title="Permanent link" href="#exit" class="permalink">¶</a></h2>
+<h2
id="exit">Exit Status <a title="Permanent link" href="#exit" class="permalink">¶</a></h2>
<p><code class="program"><a href="../programs/htdbm.html">htdbm</a></code> returns a zero status ("true") if the username and
password have been successfully added or updated in the DBM File.
<code class="program"><a href="../programs/htdbm.html">htdbm</a></code> returns <code>1</code> if it encounters some problem
file.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<div class="example"><p><code>
htdbm /usr/local/etc/apache/.htdbm-users jsmith
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Considerations</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Considerations <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>Web password files such as those managed by <code class="program"><a href="../programs/htdbm.html">htdbm</a></code> should
<em>not</em> be within the Web server's URI space -- that is, they should
not be fetchable with a browser.</p>
standards.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="restrictions" id="restrictions">Restrictions</a> <a title="Permanent link" href="#restrictions" class="permalink">¶</a></h2>
+<h2
id="restrictions">Restrictions <a title="Permanent link" href="#restrictions" class="permalink">¶</a></h2>
<p>On the Windows platform, passwords hashed with
<code class="program"><a href="../programs/htdbm.html">htdbm</a></code> are limited to no more than <code>255</code>
characters in length. Longer passwords will be truncated to 255
character <code>:</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="files" id="files">Files</a> <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
+<h2
id="files">Files <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
<p>The DBM password file path is specified as an argument on the command
line and may be located anywhere on the filesystem.</p>
<a href="../tr/programs/htdbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
<var>passwdfile</var> <var>realm</var> <var>username</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-c</code></dt>
<dd>Create the <var>passwdfile</var>. If <var>passwdfile</var> already
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Considerations</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Considerations <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>This program is not safe as a setuid executable. Do <em>not</em> make it
setuid.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="files" id="files">Files</a> <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
+<h2
id="files">Files <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
<p>The digest authentication file path is specified as an argument on the
command line and may be located anywhere on the filesystem.</p>
<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
distribution.</li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>htpasswd</strong>
[ -<strong>c</strong> ]
[ -<strong>i</strong> ]
<var>password</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-b</code></dt>
<dd>Use batch mode; <em>i.e.</em>, get the password from the command line
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="exit" id="exit">Exit Status</a> <a title="Permanent link" href="#exit" class="permalink">¶</a></h2>
+<h2
id="exit">Exit Status <a title="Permanent link" href="#exit" class="permalink">¶</a></h2>
<p><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> returns a zero status ("true") if the username and
password have been successfully added or updated in the
<var>passwdfile</var>. <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> returns <code>1</code> if it
if the file is not a valid password file.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<div class="example"><p><code>
htpasswd /usr/local/etc/apache/.htpasswd-users jsmith
</code></p></div>
file.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Considerations</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Considerations <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p>Web password files such as those managed by <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> should
<em>not</em> be within the Web server's URI space -- that is, they should
not be fetchable with a browser.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="restrictions" id="restrictions">Restrictions</a> <a title="Permanent link" href="#restrictions" class="permalink">¶</a></h2>
+<h2
id="restrictions">Restrictions <a title="Permanent link" href="#restrictions" class="permalink">¶</a></h2>
<p>On the Windows platform, passwords hashed with
<code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> are limited to no more than <code>255</code>
characters in length. Longer passwords will be truncated to 255
rounds of 17 in version <code>1.6.0</code> and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="files" id="files">Files</a> <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
+<h2
id="files">Files <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
<p>The password file path is specified as an argument on the command line
and may be located anywhere on the filesystem.</p>
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../invoking.html">Starting Apache httpd</a></li><li><a href="../stopping.html">Stopping Apache httpd</a></li><li><a href="../configuring.html">Configuration Files</a></li><li><a href="../platform/">Platform-specific Documentation</a></li><li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>httpd</strong> [ -<strong>d</strong>
<var>serverroot</var> ] [ -<strong>f</strong> <var>config</var> ]
[ -<strong>C</strong> <var>directive</var> ] [ -<strong>c</strong>
[ -<strong>w</strong> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-d <var>serverroot</var></code></dt>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dumpconf" id="dumpconf">Dumping configuration data</a> <a title="Permanent link" href="#dumpconf" class="permalink">¶</a></h2>
+<h2
id="dumpconf">Dumping configuration data <a title="Permanent link" href="#dumpconf" class="permalink">¶</a></h2>
<p>The following options can be combined with <var>-t</var> to show
information about the configuration:</p>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="files" id="files">Files</a> <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
+<h2
id="files">Files <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
<p>The default paths listed below may be changed at compile time or with
various command-line and configuration directives. Consult your local
<a href="../tr/programs/httpd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>httxt2dbm</strong>
[ -<strong>v</strong> ]
[ -<strong>f</strong> <var>DBM_TYPE</var> ]
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-v</code></dt>
<dd>More verbose output</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<div class="example"><pre class="prettyprint lang-sh">httxt2dbm -i rewritemap.txt -o rewritemap.dbm
httxt2dbm -f SDBM -i rewritemap.txt -o rewritemap.dbm</pre>
</div>
<a href="../tr/programs/httxt2dbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="index" id="index">Index</a> <a title="Permanent link" href="#index" class="permalink">¶</a></h2>
+<h2
id="index">Index <a title="Permanent link" href="#index" class="permalink">¶</a></h2>
<dl>
<dt><code class="program"><a href="../programs/httpd.html">httpd</a></code></dt>
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configure" id="configure">Usage</a> <a title="Permanent link" href="#configure" class="permalink">¶</a></h2>
+<h2
id="configure">Usage <a title="Permanent link" href="#configure" class="permalink">¶</a></h2>
<p>The script contains the following section.</p>
<a href="../fr/programs/log_server_status.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>logresolve</strong> [ -<strong>s</strong>
<var>filename</var> ] [ -<strong>c</strong> ] <
<var>access_log</var> > <var>access_log.new</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>rotatelogs</strong>
[ -<strong>l</strong> ]
[ <var>offset</var> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="examples" id="examples">Examples</a> <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
+<h2
id="examples">Examples <a title="Permanent link" href="#examples" class="permalink">¶</a></h2>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/logfile 86400" common</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="portability" id="portability">Portability</a> <a title="Permanent link" href="#portability" class="permalink">¶</a></h2>
+<h2
id="portability">Portability <a title="Permanent link" href="#portability" class="permalink">¶</a></h2>
<p>The following logfile format string substitutions should be
supported by all <code>strftime(3)</code> implementations, see
<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="split-logfile" id="split-logfile">Usage</a> <a title="Permanent link" href="#split-logfile" class="permalink">¶</a></h2>
+<h2
id="split-logfile">Usage <a title="Permanent link" href="#split-logfile" class="permalink">¶</a></h2>
<p>Create a log file with virtual host information in it:</p>
<a href="../fr/programs/split-logfile.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="synopsis" id="synopsis">Synopsis</a> <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
+<h2
id="synopsis">Synopsis <a title="Permanent link" href="#synopsis" class="permalink">¶</a></h2>
<p><code><strong>suexec</strong> -<strong>V</strong></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="options" id="options">Options</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
+<h2
id="options">Options <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
<dl>
<dt><code>-V</code></dt>
<a href="../tr/programs/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="htaccess.html">Per-directory Rewrites</a></li><li><a href="flags.html">RewriteRule Flags</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="tech.html">Technical details</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="redirect" id="redirect">Simple Redirection</a> <a title="Permanent link" href="#redirect" class="permalink">¶</a></h2>
+<h2
id="redirect">Simple Redirection <a title="Permanent link" href="#redirect" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> provides the <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code> and <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> directives, which provide a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="alias" id="alias">URL Aliasing</a> <a title="Permanent link" href="#alias" class="permalink">¶</a></h2>
+<h2
id="alias">URL Aliasing <a title="Permanent link" href="#alias" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> directive
provides mapping from a URL-path to a directory - usually a directory outside
of your <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Although it
server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="proxy" id="proxy">Simple Proxying</a> <a title="Permanent link" href="#proxy" class="permalink">¶</a></h2>
+<h2
id="proxy">Simple Proxying <a title="Permanent link" href="#proxy" class="permalink">¶</a></h2>
<p><code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> provides the <a href="flags.html#flag_p">[P]</a> flag to pass rewritten URIs through
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="setenv" id="setenv">Environment Variable Testing</a> <a title="Permanent link" href="#setenv" class="permalink">¶</a></h2>
+<h2
id="setenv">Environment Variable Testing <a title="Permanent link" href="#setenv" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> is frequently used to take a particular
action based on the presence or absence of a particular environment
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="fallback-resource" id="fallback-resource">Front Controller / Resource Routing</a> <a title="Permanent link" href="#fallback-resource" class="permalink">¶</a></h2>
+<h2
id="fallback-resource">Front Controller / Resource Routing <a title="Permanent link" href="#fallback-resource" class="permalink">¶</a></h2>
<p>A very common use of <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> is to route all
requests for non-existent resources to a single front controller script
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ifexpr" id="ifexpr">Conditional Configuration with Expressions</a> <a title="Permanent link" href="#ifexpr" class="permalink">¶</a></h2>
+<h2
id="ifexpr">Conditional Configuration with Expressions <a title="Permanent link" href="#ifexpr" class="permalink">¶</a></h2>
<p>Many uses of <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
can be replaced by the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="blocked-inline-images" id="blocked-inline-images">Forbidding Image Hotlinking</a> <a title="Permanent link" href="#blocked-inline-images" class="permalink">¶</a></h2>
+<h2
id="blocked-inline-images">Forbidding Image Hotlinking <a title="Permanent link" href="#blocked-inline-images" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="blocking-of-robots" id="blocking-of-robots">Blocking of Robots</a> <a title="Permanent link" href="#blocking-of-robots" class="permalink">¶</a></h2>
+<h2
id="blocking-of-robots">Blocking of Robots <a title="Permanent link" href="#blocking-of-robots" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="host-deny" id="host-deny">Denying Hosts in a Reject List</a> <a title="Permanent link" href="#host-deny" class="permalink">¶</a></h2>
+<h2
id="host-deny">Denying Hosts in a Reject List <a title="Permanent link" href="#host-deny" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="vhosts" id="vhosts">Virtual Hosting</a> <a title="Permanent link" href="#vhosts" class="permalink">¶</a></h2>
+<h2
id="vhosts">Virtual Hosting <a title="Permanent link" href="#vhosts" class="permalink">¶</a></h2>
<p>Although it is possible to handle <a href="vhosts.html">virtual hosts
with mod_rewrite</a>, it is seldom the right way. Creating individual
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> blocks is
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="load-balancing" id="load-balancing">Load Balancing</a> <a title="Permanent link" href="#load-balancing" class="permalink">¶</a></h2>
+<h2
id="load-balancing">Load Balancing <a title="Permanent link" href="#load-balancing" class="permalink">¶</a></h2>
<a href="../zh-cn/rewrite/avoid.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="htaccess.html">Per-directory Rewrites</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="tech.html">Technical details</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
+<h2
id="introduction">Introduction <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
<p>A <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> can have
its behavior modified by one or more flags. Flags are included in
square brackets at the end of the rule, and multiple flags are separated
of how you might use them.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_b" id="flag_b">B (escape backreferences)</a> <a title="Permanent link" href="#flag_b" class="permalink">¶</a></h2>
+<h2
id="flag_b">B (escape backreferences) <a title="Permanent link" href="#flag_b" class="permalink">¶</a></h2>
<p>The [B] flag instructs <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to escape non-alphanumeric
characters before applying the transformation.</p>
a full explanation of how Apache decodes URIs before pattern matching.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_bnp" id="flag_bnp">BNP|backrefnoplus (don't escape space to +)</a> <a title="Permanent link" href="#flag_bnp" class="permalink">¶</a></h2>
+<h2
id="flag_bnp">BNP|backrefnoplus (don't escape space to +) <a title="Permanent link" href="#flag_bnp" class="permalink">¶</a></h2>
<p>The [BNP] flag instructs <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to escape the space character
in a backreference to %20 rather than '+'. Useful when the backreference
will be used in the path component rather than the query string.</p>
background on how encoding is handled in the rewrite pipeline.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_bctls" id="flag_bctls">BCTLS</a> <a title="Permanent link" href="#flag_bctls" class="permalink">¶</a></h2>
+<h2
id="flag_bctls">BCTLS <a title="Permanent link" href="#flag_bctls" class="permalink">¶</a></h2>
<p>The [BCTLS] flag is similar to the [B] flag, but only escapes
control characters and the space character. This is the same set of
characters rejected when they are copied into the query string unencoded.
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_bne" id="flag_bne">BNE</a> <a title="Permanent link" href="#flag_bne" class="permalink">¶</a></h2>
+<h2
id="flag_bne">BNE <a title="Permanent link" href="#flag_bne" class="permalink">¶</a></h2>
<p>The list of characters in [BNE=...] are treated as exclusions to the
characters of the [B] or [BCTLS] flags. The listed characters will not be
escaped.
<p>This flag is available in version 2.4.57 and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_c" id="flag_c">C|chain</a> <a title="Permanent link" href="#flag_c" class="permalink">¶</a></h2>
+<h2
id="flag_c">C|chain <a title="Permanent link" href="#flag_c" class="permalink">¶</a></h2>
<p>The [C] or [chain] flag indicates that the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is chained to the next
rule. That is, if the rule matches, then it is processed as usual and
control moves on to the next rule. However, if it does not match, then
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_co" id="flag_co">CO|cookie</a> <a title="Permanent link" href="#flag_co" class="permalink">¶</a></h2>
+<h2
id="flag_co">CO|cookie <a title="Permanent link" href="#flag_co" class="permalink">¶</a></h2>
<p>The [CO], or [cookie] flag, allows you to set a cookie when a
particular <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
matches. The argument consists of three required fields and five optional
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_dpi" id="flag_dpi">DPI|discardpath</a> <a title="Permanent link" href="#flag_dpi" class="permalink">¶</a></h2>
+<h2
id="flag_dpi">DPI|discardpath <a title="Permanent link" href="#flag_dpi" class="permalink">¶</a></h2>
<p>The DPI flag causes the <a class="glossarylink" href="../glossary.html#pathinfo" title="see glossary">PATH_INFO</a>
that was appended to the rewritten
<a class="glossarylink" href="../glossary.html#urlpath" title="see glossary">URL-path</a> to be discarded.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_e" id="flag_e">E|env</a> <a title="Permanent link" href="#flag_e" class="permalink">¶</a></h2>
+<h2
id="flag_e">E|env <a title="Permanent link" href="#flag_e" class="permalink">¶</a></h2>
<p>With the [E], or [env] flag, you can set the value of an environment
variable. Note that some environment variables may be set after the rule
is run, thus unsetting what you have set. See <a href="../env.html">the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_end" id="flag_end">END</a> <a title="Permanent link" href="#flag_end" class="permalink">¶</a></h2>
+<h2
id="flag_end">END <a title="Permanent link" href="#flag_end" class="permalink">¶</a></h2>
<p>Using the [END] flag terminates not only the current round of rewrite
processing (like [L]) but also prevents any subsequent rewrite
processing from occurring in
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_f" id="flag_f">F|forbidden</a> <a title="Permanent link" href="#flag_f" class="permalink">¶</a></h2>
+<h2
id="flag_f">F|forbidden <a title="Permanent link" href="#flag_f" class="permalink">¶</a></h2>
<p>Using the [F] flag causes the server to return a 403 Forbidden status
code to the client. While the same behavior can be accomplished using
the <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> directive, this
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_g" id="flag_g">G|gone</a> <a title="Permanent link" href="#flag_g" class="permalink">¶</a></h2>
+<h2
id="flag_g">G|gone <a title="Permanent link" href="#flag_g" class="permalink">¶</a></h2>
<p>The [G] flag forces the server to return a 410 Gone status with the
response. This indicates that a resource used to be available, but is no
longer available.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_h" id="flag_h">H|handler</a> <a title="Permanent link" href="#flag_h" class="permalink">¶</a></h2>
+<h2
id="flag_h">H|handler <a title="Permanent link" href="#flag_h" class="permalink">¶</a></h2>
<p>Forces the resulting request to be handled with the specified
handler. For example, one might use this to force all files without a
file extension to be parsed by the php handler:</p>
expression.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_l" id="flag_l">L|last</a> <a title="Permanent link" href="#flag_l" class="permalink">¶</a></h2>
+<h2
id="flag_l">L|last <a title="Permanent link" href="#flag_l" class="permalink">¶</a></h2>
<p>The [L] flag causes <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> to stop processing
the rule set. In most contexts, this means that if the rule matches, no
further rules will be processed. This corresponds to the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_n" id="flag_n">N|next</a> <a title="Permanent link" href="#flag_n" class="permalink">¶</a></h2>
+<h2
id="flag_n">N|next <a title="Permanent link" href="#flag_n" class="permalink">¶</a></h2>
<p>
The [N] flag causes the ruleset to start over again from the top, using
the result of the ruleset so far as a starting point. Use
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_nc" id="flag_nc">NC|nocase</a> <a title="Permanent link" href="#flag_nc" class="permalink">¶</a></h2>
+<h2
id="flag_nc">NC|nocase <a title="Permanent link" href="#flag_nc" class="permalink">¶</a></h2>
<p>Use of the [NC] flag causes the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to be matched in a
case-insensitive manner. That is, it doesn't care whether letters appear
as upper-case or lower-case in the matched URL-path.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_ne" id="flag_ne">NE|noescape</a> <a title="Permanent link" href="#flag_ne" class="permalink">¶</a></h2>
+<h2
id="flag_ne">NE|noescape <a title="Permanent link" href="#flag_ne" class="permalink">¶</a></h2>
<p>By default, when a <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
results in an external redirect, any characters in the output that are
not in the following safe set will be converted to their hexcode
rewriting.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_ns" id="flag_ns">NS|nosubreq</a> <a title="Permanent link" href="#flag_ns" class="permalink">¶</a></h2>
+<h2
id="flag_ns">NS|nosubreq <a title="Permanent link" href="#flag_ns" class="permalink">¶</a></h2>
<p>Use of the [NS] flag prevents the rule from being used on
subrequests. For example, a page which is included using an SSI (Server
Side Include) is a subrequest, and you may want to avoid rewrites
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_p" id="flag_p">P|proxy</a> <a title="Permanent link" href="#flag_p" class="permalink">¶</a></h2>
+<h2
id="flag_p">P|proxy <a title="Permanent link" href="#flag_p" class="permalink">¶</a></h2>
<p>Use of the [P] flag causes the request to be handled by
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, and handled via a proxy request. For
example, if you wanted all image requests to be handled by a back-end
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_pt" id="flag_pt">PT|passthrough</a> <a title="Permanent link" href="#flag_pt" class="permalink">¶</a></h2>
+<h2
id="flag_pt">PT|passthrough <a title="Permanent link" href="#flag_pt" class="permalink">¶</a></h2>
<p>
The target (or substitution string) in a RewriteRule is assumed to be a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_qsa" id="flag_qsa">QSA|qsappend</a> <a title="Permanent link" href="#flag_qsa" class="permalink">¶</a></h2>
+<h2
id="flag_qsa">QSA|qsappend <a title="Permanent link" href="#flag_qsa" class="permalink">¶</a></h2>
<p>
When the replacement URL contains a query string, the default behavior
of <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is to discard
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_qsd" id="flag_qsd">QSD|qsdiscard</a> <a title="Permanent link" href="#flag_qsd" class="permalink">¶</a></h2>
+<h2
id="flag_qsd">QSD|qsdiscard <a title="Permanent link" href="#flag_qsd" class="permalink">¶</a></h2>
<p>
When the requested URL contains a query string, and the target URL does
not, the default behavior of <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is to copy that query
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_qsl" id="flag_qsl">QSL|qslast</a> <a title="Permanent link" href="#flag_qsl" class="permalink">¶</a></h2>
+<h2
id="flag_qsl">QSL|qslast <a title="Permanent link" href="#flag_qsl" class="permalink">¶</a></h2>
<p>
By default, the first (left-most) question mark in the substitution
delimits the path from the query string. Using the [QSL] flag instructs
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_r" id="flag_r">R|redirect</a> <a title="Permanent link" href="#flag_r" class="permalink">¶</a></h2>
+<h2
id="flag_r">R|redirect <a title="Permanent link" href="#flag_r" class="permalink">¶</a></h2>
<p>
Use of the [R] flag causes a HTTP redirect to be issued to the browser.
If a fully-qualified URL is specified (that is, including
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_s" id="flag_s">S|skip</a> <a title="Permanent link" href="#flag_s" class="permalink">¶</a></h2>
+<h2
id="flag_s">S|skip <a title="Permanent link" href="#flag_s" class="permalink">¶</a></h2>
<p>The [S] flag is used to skip rules that you don't want to run. The
syntax of the skip flag is [S=<em>N</em>], where <em>N</em> signifies
the number of rules to skip (provided the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_t" id="flag_t">T|type</a> <a title="Permanent link" href="#flag_t" class="permalink">¶</a></h2>
+<h2
id="flag_t">T|type <a title="Permanent link" href="#flag_t" class="permalink">¶</a></h2>
<p>Sets the MIME type with which the resulting response will be
sent. This has the same effect as the <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> directive.</p>
<em>current</em> round of <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> processing.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_unsafe_allow_3f" id="flag_unsafe_allow_3f">UnsafeAllow3F</a> <a title="Permanent link" href="#flag_unsafe_allow_3f" class="permalink">¶</a></h2>
+<h2
id="flag_unsafe_allow_3f">UnsafeAllow3F <a title="Permanent link" href="#flag_unsafe_allow_3f" class="permalink">¶</a></h2>
<p> Setting this flag is required to allow a rewrite to continue If the
HTTP request being written has an encoded question mark, '%3f', and the
rewritten result has a '?' in the substitution. This protects from a malicious
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_unsafe_prefix_stat" id="flag_unsafe_prefix_stat">UnsafePrefixStat</a> <a title="Permanent link" href="#flag_unsafe_prefix_stat" class="permalink">¶</a></h2>
+<h2
id="flag_unsafe_prefix_stat">UnsafePrefixStat <a title="Permanent link" href="#flag_unsafe_prefix_stat" class="permalink">¶</a></h2>
<p> Setting this flag is required in server-scoped substitutions
start with a variable or backreference and resolve to a filesystem path.
These substitutions are not prefixed with the document root.
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flag_unc" id="flag_unc">UNC</a> <a title="Permanent link" href="#flag_unc" class="permalink">¶</a></h2>
+<h2
id="flag_unc">UNC <a title="Permanent link" href="#flag_unc" class="permalink">¶</a></h2>
<p> Setting this flag prevents the merging of multiple leading slashes,
as used in Windows UNC paths. The flag is not necessary when the rules
substitution starts with multiple literal slashes.</p>
<a href="../zh-cn/rewrite/flags.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="flags.html">RewriteRule Flags</a></li><li><a href="tech.html">Technical details</a></li><li><a href="../mod/mod_rewrite.html#what_is_matched">What is matched?</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="prerequisites" id="prerequisites">Prerequisites: AllowOverride</a> <a title="Permanent link" href="#prerequisites" class="permalink">¶</a></h2>
+<h2
id="prerequisites">Prerequisites: AllowOverride <a title="Permanent link" href="#prerequisites" class="permalink">¶</a></h2>
<p>Before <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> directives in a
<code>.htaccess</code> file will be processed at all, the server
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="path-stripping" id="path-stripping">What URL does the rule see?</a> <a title="Permanent link" href="#path-stripping" class="permalink">¶</a></h2>
+<h2
id="path-stripping">What URL does the rule see? <a title="Permanent link" href="#path-stripping" class="permalink">¶</a></h2>
<p>In server or virtualhost context, the
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> pattern is
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rewritebase" id="rewritebase">When you need RewriteBase</a> <a title="Permanent link" href="#rewritebase" class="permalink">¶</a></h2>
+<h2
id="rewritebase">When you need RewriteBase <a title="Permanent link" href="#rewritebase" class="permalink">¶</a></h2>
<p>When <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> makes a substitution in
<code>.htaccess</code> context, it needs to turn the relative result
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="loops" id="loops">The [L] flag and looping</a> <a title="Permanent link" href="#loops" class="permalink">¶</a></h2>
+<h2
id="loops">The [L] flag and looping <a title="Permanent link" href="#loops" class="permalink">¶</a></h2>
<p>In server context, the <code>[L]</code> flag means "stop processing
the ruleset." In <code>.htaccess</code> context, it means something
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="rewritemap-restriction" id="rewritemap-restriction">RewriteMap cannot be
-declared in .htaccess
</a> <a title="Permanent link" href="#rewritemap-restriction" class="permalink">¶</a></h2>
+<h2 id="rewritemap-restriction">RewriteMap cannot be
+declared in .htaccess <a title="Permanent link" href="#rewritemap-restriction" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive
can only be declared in server or virtualhost context - not in
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="context-restrictions" id="context-restrictions">Which contexts support rewrite rules?</a> <a title="Permanent link" href="#context-restrictions" class="permalink">¶</a></h2>
+<h2
id="context-restrictions">Which contexts support rewrite rules? <a title="Permanent link" href="#context-restrictions" class="permalink">¶</a></h2>
<p>Rewrite rules are supported in
<a class="glossarylink" href="../glossary.html#perdirectory" title="see glossary">per-directory context</a>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="inheritance" id="inheritance">Rule inheritance with RewriteOptions</a> <a title="Permanent link" href="#inheritance" class="permalink">¶</a></h2>
+<h2
id="inheritance">Rule inheritance with RewriteOptions <a title="Permanent link" href="#inheritance" class="permalink">¶</a></h2>
<p>By default, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> rules are <strong>not
inherited</strong> by subdirectories. If you define rules in
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="debugging" id="debugging">Debugging .htaccess rewrite rules</a> <a title="Permanent link" href="#debugging" class="permalink">¶</a></h2>
+<h2
id="debugging">Debugging .htaccess rewrite rules <a title="Permanent link" href="#debugging" class="permalink">¶</a></h2>
<p>When <code>.htaccess</code> rules are not doing what you expect,
the rewrite log is your most important tool. Enable it at the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="caching" id="caching">Browser caching of 301 redirects</a> <a title="Permanent link" href="#caching" class="permalink">¶</a></h2>
+<h2
id="caching">Browser caching of 301 redirects <a title="Permanent link" href="#caching" class="permalink">¶</a></h2>
<p>When you issue a <code>301 Moved Permanently</code> redirect
(via <code>[R=301]</code> or <code class="directive"><a href="../mod/mod_alias.html#redirect permanent">Redirect permanent</a></code>), the browser is allowed to cache
<a href="../zh-cn/rewrite/htaccess.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<a href="../zh-cn/rewrite/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="htaccess.html">Per-directory Rewrites</a></li><li><a href="flags.html">RewriteRule Flags</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="tech.html">Technical details</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
+<h2
id="introduction">Introduction <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
<p>The Apache module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> is a very powerful and
sophisticated module which provides a way to do URL manipulations. With
it, you can do nearly all types of URL rewriting that you may need. It
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="regex" id="regex">Regular Expressions</a> <a title="Permanent link" href="#regex" class="permalink">¶</a></h2>
+<h2
id="regex">Regular Expressions <a title="Permanent link" href="#regex" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> uses the <a href="https://www.pcre.org/current/doc/html/pcre2syntax.html">Perl Compatible
Regular Expressions</a> vocabulary, via the PCRE2 library. In this document, we do not attempt
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>s will be scientific
formulae, rather than magical incantations.</p>
-<h3><a name="regexvocab" id="regexvocab">Regex vocabulary</a></h3>
+<h3 id="regexvocab">Regex vocabulary</h3>
<p>The following are the minimal building blocks you will need, in order
to write regular expressions and <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>s. They certainly do not
-<h3><a name="InternalBackRefs" id="InternalBackRefs">Regex Back-Reference Availability</a></h3>
+<h3 id="InternalBackRefs">Regex Back-Reference Availability</h3>
<p>One important thing here has to be remembered: Whenever you
use parentheses in <em>Pattern</em> or in one of the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rewriterule" id="rewriterule">RewriteRule Basics</a> <a title="Permanent link" href="#rewriterule" class="permalink">¶</a></h2>
+<h2
id="rewriterule">RewriteRule Basics <a title="Permanent link" href="#rewriterule" class="permalink">¶</a></h2>
<p>A <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> consists
of three arguments separated by spaces. The arguments are</p>
<ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="flags" id="flags">Rewrite Flags</a> <a title="Permanent link" href="#flags" class="permalink">¶</a></h2>
+<h2
id="flags">Rewrite Flags <a title="Permanent link" href="#flags" class="permalink">¶</a></h2>
<p>The behavior of a <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> can be modified by the
application of one or more flags to the end of the rule. For example, the
matching behavior of a rule can be made case-insensitive by the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rewritecond" id="rewritecond">Rewrite Conditions</a> <a title="Permanent link" href="#rewritecond" class="permalink">¶</a></h2>
+<h2
id="rewritecond">Rewrite Conditions <a title="Permanent link" href="#rewritecond" class="permalink">¶</a></h2>
<p>One or more <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
directives can be used to restrict the types of requests that will be
subject to the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rewritemap" id="rewritemap">Rewrite maps</a> <a title="Permanent link" href="#rewritemap" class="permalink">¶</a></h2>
+<h2
id="rewritemap">Rewrite maps <a title="Permanent link" href="#rewritemap" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive
provides a way to call an external function, so to speak, to do your
rewriting for you. This is discussed in greater detail in the <a href="rewritemap.html">RewriteMap supplementary documentation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="htaccess" id="htaccess">.htaccess files</a> <a title="Permanent link" href="#htaccess" class="permalink">¶</a></h2>
+<h2
id="htaccess">.htaccess files <a title="Permanent link" href="#htaccess" class="permalink">¶</a></h2>
<p>It is possible to use rewrite rules in
<a class="glossarylink" href="../glossary.html#perdirectory" title="see glossary">per-directory</a> context
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="security" id="security">Security Considerations</a> <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
+<h2
id="security">Security Considerations <a title="Permanent link" href="#security" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> is a powerful URL manipulation tool, and
with that power comes the potential for security mistakes. This section
highlights the most common security pitfalls to watch for when writing
rewrite rules.</p>
-<h3><a name="security-redirect" id="security-redirect">Open Redirects</a></h3>
+<h3 id="security-redirect">Open Redirects</h3>
<p>If a <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
constructs a redirect URL using unvalidated user input, an attacker
-<h3><a name="security-ssrf" id="security-ssrf">Server-Side Request Forgery (SSRF)</a></h3>
+<h3 id="security-ssrf">Server-Side Request Forgery (SSRF)</h3>
<p>When using the <a href="flags.html#flag_p">[P] (proxy) flag</a>,
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> causes the server to make an HTTP request
-<h3><a name="security-path" id="security-path">Path Traversal</a></h3>
+<h3 id="security-path">Path Traversal</h3>
<p>Rewrite rules that map user-supplied path components directly to
the filesystem can allow path traversal attacks if the input is not
<a href="../zh-cn/rewrite/intro.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="htaccess.html">Per-directory Rewrites</a></li><li><a href="flags.html">RewriteRule Flags</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="tech.html">Technical details</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="old-to-new" id="old-to-new">From Old to New (internal)</a> <a title="Permanent link" href="#old-to-new" class="permalink">¶</a></h2>
+<h2
id="old-to-new">From Old to New (internal) <a title="Permanent link" href="#old-to-new" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="https-redirect" id="https-redirect">Forcing HTTPS</a> <a title="Permanent link" href="#https-redirect" class="permalink">¶</a></h2>
+<h2
id="https-redirect">Forcing HTTPS <a title="Permanent link" href="#https-redirect" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="acme-exemption" id="acme-exemption">Exempting ACME challenge requests from HTTPS redirect</a> <a title="Permanent link" href="#acme-exemption" class="permalink">¶</a></h2>
+<h2
id="acme-exemption">Exempting ACME challenge requests from HTTPS redirect <a title="Permanent link" href="#acme-exemption" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="trailing-slash" id="trailing-slash">Trailing Slash Normalization</a> <a title="Permanent link" href="#trailing-slash" class="permalink">¶</a></h2>
+<h2
id="trailing-slash">Trailing Slash Normalization <a title="Permanent link" href="#trailing-slash" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="front-controller" id="front-controller">Front Controller / Application Routing</a> <a title="Permanent link" href="#front-controller" class="permalink">¶</a></h2>
+<h2
id="front-controller">Front Controller / Application Routing <a title="Permanent link" href="#front-controller" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="old-to-new-extern" id="old-to-new-extern">Rewriting From Old to New (external)</a> <a title="Permanent link" href="#old-to-new-extern" class="permalink">¶</a></h2>
+<h2
id="old-to-new-extern">Rewriting From Old to New (external) <a title="Permanent link" href="#old-to-new-extern" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="movehomedirs" id="movehomedirs">Resource Moved to Another Server</a> <a title="Permanent link" href="#movehomedirs" class="permalink">¶</a></h2>
+<h2
id="movehomedirs">Resource Moved to Another Server <a title="Permanent link" href="#movehomedirs" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="backward-compatibility" id="backward-compatibility">Backward Compatibility for file extension change</a> <a title="Permanent link" href="#backward-compatibility" class="permalink">¶</a></h2>
+<h2
id="backward-compatibility">Backward Compatibility for file extension change <a title="Permanent link" href="#backward-compatibility" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="canonicalhost" id="canonicalhost">Canonical Hostnames</a> <a title="Permanent link" href="#canonicalhost" class="permalink">¶</a></h2>
+<h2
id="canonicalhost">Canonical Hostnames <a title="Permanent link" href="#canonicalhost" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="multipledirs" id="multipledirs">Search for pages in more than one directory</a> <a title="Permanent link" href="#multipledirs" class="permalink">¶</a></h2>
+<h2
id="multipledirs">Search for pages in more than one directory <a title="Permanent link" href="#multipledirs" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="canonicalurl" id="canonicalurl">Canonical URLs</a> <a title="Permanent link" href="#canonicalurl" class="permalink">¶</a></h2>
+<h2
id="canonicalurl">Canonical URLs <a title="Permanent link" href="#canonicalurl" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="moveddocroot" id="moveddocroot">Moved <code>DocumentRoot</code></a> <a title="Permanent link" href="#moveddocroot" class="permalink">¶</a></h2>
+<h2
id="moveddocroot">Moved <code>DocumentRoot</code> <a title="Permanent link" href="#moveddocroot" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rewrite-query" id="rewrite-query">Rewrite query string</a> <a title="Permanent link" href="#rewrite-query" class="permalink">¶</a></h2>
+<h2
id="rewrite-query">Rewrite query string <a title="Permanent link" href="#rewrite-query" class="permalink">¶</a></h2>
<dl>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="structuredhomedirs" id="structuredhomedirs">Structured Userdirs</a> <a title="Permanent link" href="#structuredhomedirs" class="permalink">¶</a></h2>
+<h2
id="structuredhomedirs">Structured Userdirs <a title="Permanent link" href="#structuredhomedirs" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="redirectanchors" id="redirectanchors">Redirecting Anchors</a> <a title="Permanent link" href="#redirectanchors" class="permalink">¶</a></h2>
+<h2
id="redirectanchors">Redirecting Anchors <a title="Permanent link" href="#redirectanchors" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="time-dependent" id="time-dependent">Time-Dependent Rewriting</a> <a title="Permanent link" href="#time-dependent" class="permalink">¶</a></h2>
+<h2
id="time-dependent">Time-Dependent Rewriting <a title="Permanent link" href="#time-dependent" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="on-the-fly-content" id="on-the-fly-content">On-the-fly Content-Regeneration</a> <a title="Permanent link" href="#on-the-fly-content" class="permalink">¶</a></h2>
+<h2
id="on-the-fly-content">On-the-fly Content-Regeneration <a title="Permanent link" href="#on-the-fly-content" class="permalink">¶</a></h2>
<a href="../zh-cn/rewrite/remapping.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="flags.html">RewriteRule Flags</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="htaccess.html">Per-directory Rewrites</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="tech.html">Technical details</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
+<h2
id="introduction">Introduction <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
<p>
may be used, and give examples of each.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="int" id="int">int: Internal Function</a> <a title="Permanent link" href="#int" class="permalink">¶</a></h2>
+<h2
id="int">int: Internal Function <a title="Permanent link" href="#int" class="permalink">¶</a></h2>
<p>When a MapType of <code>int</code> is used, the MapSource is one
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="txt" id="txt">txt: Plain text maps</a> <a title="Permanent link" href="#txt" class="permalink">¶</a></h2>
+<h2
id="txt">txt: Plain text maps <a title="Permanent link" href="#txt" class="permalink">¶</a></h2>
<p>When a MapType of <code>txt</code> is used, the MapSource is a filesystem path to a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="rnd" id="rnd">rnd: Randomized Plain Text</a> <a title="Permanent link" href="#rnd" class="permalink">¶</a></h2>
+<h2
id="rnd">rnd: Randomized Plain Text <a title="Permanent link" href="#rnd" class="permalink">¶</a></h2>
<p>When a MapType of <code>rnd</code> is used, the MapSource is a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dbm" id="dbm">dbm: DBM Hash File</a> <a title="Permanent link" href="#dbm" class="permalink">¶</a></h2>
+<h2
id="dbm">dbm: DBM Hash File <a title="Permanent link" href="#dbm" class="permalink">¶</a></h2>
<p>When a MapType of <code>dbm</code> is used, the MapSource is a
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="prg" id="prg">prg: External Rewriting Program</a> <a title="Permanent link" href="#prg" class="permalink">¶</a></h2>
+<h2
id="prg">prg: External Rewriting Program <a title="Permanent link" href="#prg" class="permalink">¶</a></h2>
<p>When a MapType of <code>prg</code> is used, the MapSource is a
filesystem path to an executable program which will providing the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="dbd" id="dbd">dbd or fastdbd: SQL Query</a> <a title="Permanent link" href="#dbd" class="permalink">¶</a></h2>
+<h2
id="dbd">dbd or fastdbd: SQL Query <a title="Permanent link" href="#dbd" class="permalink">¶</a></h2>
<p>When a MapType of <code>dbd</code> or <code>fastdbd</code> is
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="sharding" id="sharding">URL-based sharding across multiple backends</a> <a title="Permanent link" href="#sharding" class="permalink">¶</a></h2>
+<h2
id="sharding">URL-based sharding across multiple backends <a title="Permanent link" href="#sharding" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="summary" id="summary">Summary</a> <a title="Permanent link" href="#summary" class="permalink">¶</a></h2>
+<h2
id="summary">Summary <a title="Permanent link" href="#summary" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive can
<a href="../zh-cn/rewrite/rewritemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="flags.html">RewriteRule Flags</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="htaccess.html">Per-directory Rewrites</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="InternalAPI" id="InternalAPI">API Phases</a> <a title="Permanent link" href="#InternalAPI" class="permalink">¶</a></h2>
+<h2
id="InternalAPI">API Phases <a title="Permanent link" href="#InternalAPI" class="permalink">¶</a></h2>
<p>The Apache HTTP Server handles requests in several phases. At
each of these phases, one or more modules may be called upon to
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="order" id="order">Module Processing Order</a> <a title="Permanent link" href="#order" class="permalink">¶</a></h2>
+<h2
id="order">Module Processing Order <a title="Permanent link" href="#order" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> and <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> both
operate during the URL-to-filename translation phase, but
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="encoding" id="encoding">URL Encoding and Decoding</a> <a title="Permanent link" href="#encoding" class="permalink">¶</a></h2>
+<h2
id="encoding">URL Encoding and Decoding <a title="Permanent link" href="#encoding" class="permalink">¶</a></h2>
<p>Apache httpd unescapes URL-encoded characters in the request URL-path before any
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> pattern
redirects.</li>
</ul>
- <h3><a name="allowencodedslashes" id="allowencodedslashes">AllowEncodedSlashes</a></h3>
+ <h3 id="allowencodedslashes">AllowEncodedSlashes</h3>
<p>By default, Apache returns 404 for any URL containing an encoded
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="InternalRuleset" id="InternalRuleset">Ruleset Processing</a> <a title="Permanent link" href="#InternalRuleset" class="permalink">¶</a></h2>
+<h2
id="InternalRuleset">Ruleset Processing <a title="Permanent link" href="#InternalRuleset" class="permalink">¶</a></h2>
<p>Now when <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> is triggered in these two API phases, it
reads the configured rulesets from its configuration
<a href="../zh-cn/rewrite/tech.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="htaccess.html">Per-directory Rewrites</a></li><li><a href="flags.html">RewriteRule Flags</a></li><li><a href="rewritemap.html">RewriteMap</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="tech.html">Technical details</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="per-hostname" id="per-hostname">Virtual Hosts For Arbitrary Hostnames</a> <a title="Permanent link" href="#per-hostname" class="permalink">¶</a></h2>
+<h2
id="per-hostname">Virtual Hosts For Arbitrary Hostnames <a title="Permanent link" href="#per-hostname" class="permalink">¶</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2><a name="simple.rewrite" id="simple.rewrite">Dynamic
- Virtual Hosts Using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
</a> <a title="Permanent link" href="#simple.rewrite" class="permalink">¶</a></h2>
+<h2 id="simple.rewrite">Dynamic
+ Virtual Hosts Using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> <a title="Permanent link" href="#simple.rewrite" class="permalink">¶</a></h2>
<p>This extract from <code>httpd.conf</code> does the same
thing as <a href="#per-hostname">the first example</a>. The first
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="xtra-conf" id="xtra-conf">Using a Separate Virtual Host Configuration File</a> <a title="Permanent link" href="#xtra-conf" class="permalink">¶</a></h2>
+<h2
id="xtra-conf">Using a Separate Virtual Host Configuration File <a title="Permanent link" href="#xtra-conf" class="permalink">¶</a></h2>
<p>This arrangement uses more advanced <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
features to work out the translation from virtual host to document
<a href="../zh-cn/rewrite/vhosts.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="types" id="types">Types of Configuration Section Containers</a> <a title="Permanent link" href="#types" class="permalink">¶</a></h2>
+<h2
id="types">Types of Configuration Section Containers <a title="Permanent link" href="#types" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#if"><If></a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/mod_md.html#mdomainsetsection"><MDomainSet></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
restrictions.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="file-and-web" id="file-and-web">Filesystem, Webspace, and Boolean Expressions</a> <a title="Permanent link" href="#file-and-web" class="permalink">¶</a></h2>
+<h2
id="file-and-web">Filesystem, Webspace, and Boolean Expressions <a title="Permanent link" href="#file-and-web" class="permalink">¶</a></h2>
<p>The most commonly used configuration section containers are the
ones that change the configuration of particular places in the
the filesystem, since webpages may be generated dynamically
from databases or other locations.</p>
-<h3><a name="filesystem" id="filesystem">Filesystem Containers</a></h3>
+<h3 id="filesystem">Filesystem Containers</h3>
<p>The <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
and <code class="directive"><a href="./mod/core.html#files"><Files></a></code>
-<h3><a name="webspace" id="webspace">Webspace Containers</a></h3>
+<h3 id="webspace">Webspace Containers</h3>
<p>The <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
directive and its <a class="glossarylink" href="./glossary.html#regex" title="see glossary">regex</a> counterpart, on
container for proxy configuration and module-provided endpoints.</p>
-<h3><a name="overlapping-webspace" id="overlapping-webspace">Overlapping Webspace</a></h3>
+<h3 id="overlapping-webspace">Overlapping Webspace</h3>
<p>In order to have two overlapping URLs one has to consider the order in which
certain sections or directives are evaluated. For
<code class="directive"><a href="./mod/core.html#location"><Location></a></code> this would be:</p>
-<h3><a name="wildcards" id="wildcards">Wildcards and Regular Expressions</a></h3>
+<h3 id="wildcards">Wildcards and Regular Expressions</h3>
<p>The <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>, and
-<h3><a name="expressions" id="expressions">Boolean expressions</a></h3>
+<h3 id="expressions">Boolean expressions</h3>
<p>The <code class="directive"><a href="./mod/core.html#if"><If></a></code>
directive change the configuration depending on a condition which can be
expressed by a boolean expression. For example, the following configuration
-<h3><a name="whichwhen" id="whichwhen">What to use When</a></h3>
+<h3 id="whichwhen">What to use When</h3>
<p>Choosing between filesystem containers and webspace containers is
actually quite easy. When applying directives to objects that reside
to all requests regardless of the specific URL.</p>
-<h3><a name="nesting" id="nesting">Nesting of sections</a></h3>
+<h3 id="nesting">Nesting of sections</h3>
<p>Some section types can be nested inside other section types. On the one
hand, <code class="directive"><a href="./mod/core.html#files"><Files></a></code> can be used
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="virtualhost" id="virtualhost">Virtual Hosts</a> <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
+<h2
id="virtualhost">Virtual Hosts <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
container encloses directives that apply to specific hosts.
see the <a href="vhosts/">Virtual Host Documentation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="proxy" id="proxy">Proxy</a> <a title="Permanent link" href="#proxy" class="permalink">¶</a></h2>
+<h2
id="proxy">Proxy <a title="Permanent link" href="#proxy" class="permalink">¶</a></h2>
<p>The <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
and <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="whatwhere" id="whatwhere">What Directives are Allowed?</a> <a title="Permanent link" href="#whatwhere" class="permalink">¶</a></h2>
+<h2
id="whatwhere">What Directives are Allowed? <a title="Permanent link" href="#whatwhere" class="permalink">¶</a></h2>
<p>To find out what directives are allowed in what types of
configuration sections, check the <a href="mod/directive-dict.html#Context">Context</a> of the directive.
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="merging" id="merging">How the sections are merged</a> <a title="Permanent link" href="#merging" class="permalink">¶</a></h2>
+<h2
id="merging">How the sections are merged <a title="Permanent link" href="#merging" class="permalink">¶</a></h2>
<p>The configuration sections are applied in a very particular order.
Since this can have important effects on how configuration directives
completed.
</div>
-<h3><a name="relationship-module-configuration" id="relationship-module-configuration">Relationship between modules and configuration sections</a></h3>
+<h3 id="relationship-module-configuration">Relationship between modules and configuration sections</h3>
<p>One question that often arises after reading how configuration sections are
merged is related to how and when directives of specific modules like <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
are processed. The answer is not trivial and needs a bit of background.
</p>
-<h3><a name="merge-examples" id="merge-examples">Some useful examples</a></h3>
+<h3 id="merge-examples">Some useful examples</h3>
<p>Below is an artificial example to show the order of
merging. Assuming they all apply to the request, the directives in
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="identification" id="identification">Server Identification</a> <a title="Permanent link" href="#identification" class="permalink">¶</a></h2>
+<h2
id="identification">Server Identification <a title="Permanent link" href="#identification" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td></td><td><ul><li><code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code></li><li><code class="directive"><a href="./mod/core.html#serversignature">ServerSignature</a></code></li><li><code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li></ul></td></tr></table>
correctly resolve relative references in the document.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="locations" id="locations">File Locations</a> <a title="Permanent link" href="#locations" class="permalink">¶</a></h2>
+<h2
id="locations">File Locations <a title="Permanent link" href="#locations" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td></td><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code></li><li><code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code></li></ul></td></tr></table>
documentation for more details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="resource" id="resource">Limiting Resource Usage</a> <a title="Permanent link" href="#resource" class="permalink">¶</a></h2>
+<h2
id="resource">Limiting Resource Usage <a title="Permanent link" href="#resource" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td></td><td><ul><li><code class="directive"><a href="./mod/core.html#limitrequestbody">LimitRequestBody</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfields">LimitRequestFields</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfieldsize">LimitRequestFieldsize</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestline">LimitRequestLine</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitcpu">RLimitCPU</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitmem">RLimitMEM</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitnproc">RLimitNPROC</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code></li></ul></td></tr></table>
directive is used with some platforms to control the stack size.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="implementation" id="implementation">Implementation Choices</a> <a title="Permanent link" href="#implementation" class="permalink">¶</a></h2>
+<h2
id="implementation">Implementation Choices <a title="Permanent link" href="#implementation" class="permalink">¶</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td></td><td><ul><li><code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code></li></ul></td></tr></table>
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
-<script src="./style/scripts/prettify.min.js" type="text/javascript">
+<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
-<h2
><a name="providers" id="providers">Shared Object Cache Providers</a> <a title="Permanent link" href="#providers" class="permalink">¶</a></h2>
+<h2
id="providers">Shared Object Cache Providers <a title="Permanent link" href="#providers" class="permalink">¶</a></h2>
<p>The shared object cache as such is an abstraction. Five different
modules implement it. To use the cache, one or more of these modules
<a href="./fr/socache.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="documentation" id="documentation">Documentation</a> <a title="Permanent link" href="#documentation" class="permalink">¶</a></h2>
+<h2
id="documentation">Documentation <a title="Permanent link" href="#documentation" class="permalink">¶</a></h2>
<ul>
<li><a href="ssl_howto.html">mod_ssl Configuration How-To</a></li>
<li><a href="ssl_intro.html">Introduction To SSL</a></li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="mod-ssl" id="mod-ssl">mod_ssl</a> <a title="Permanent link" href="#mod-ssl" class="permalink">¶</a></h2>
+<h2
id="mod-ssl">mod_ssl <a title="Permanent link" href="#mod-ssl" class="permalink">¶</a></h2>
<p>Extensive documentation on the directives and environment variables
provided by this module is provided in the <a href="../mod/mod_ssl.html">mod_ssl reference documentation</a>.
</p>
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configuration" id="configuration">Configuration Directives</a> <a title="Permanent link" href="#configuration" class="permalink">¶</a></h2>
+<h2
id="configuration">Configuration Directives <a title="Permanent link" href="#configuration" class="permalink">¶</a></h2>
<p>The mapping between configuration directives used by Apache-SSL
1.x and mod_ssl 2.0.x is given in <a href="#table1">Table
1</a>. The mapping from Sioux 1.x and Stronghold 2.x is only partial
doesn't provide.</p>
-<h3><a name="table1" id="table1">Table 1: Configuration Directive Mapping</a></h3>
+<h3 id="table1">Table 1: Configuration Directive Mapping</h3>
<table><tr class="header"><th>Old Directive</th><th>mod_ssl Directive</th><th>Comment</th></tr>
<tr class="header"><th colspan="3">Apache-SSL 1.x & mod_ssl 2.0.x compatibility:</th></tr>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="variables" id="variables">Environment Variables</a> <a title="Permanent link" href="#variables" class="permalink">¶</a></h2>
+<h2
id="variables">Environment Variables <a title="Permanent link" href="#variables" class="permalink">¶</a></h2>
<p>The mapping between environment variable names used by the older
SSL solutions and the names used by mod_ssl is given in <a href="#table2">Table 2</a>.</p>
-<h3><a name="table2" id="table2">Table 2: Environment Variable Derivation</a></h3>
+<h3 id="table2">Table 2: Environment Variable Derivation</h3>
<table><tr class="header"><th>Old Variable</th><th>mod_ssl Variable</th><th>Comment</th></tr>
<tr><td><code>SSL_PROTOCOL_VERSION</code></td><td><code>SSL_PROTOCOL</code></td><td>renamed</td></tr>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="customlog" id="customlog">Custom Log Functions</a> <a title="Permanent link" href="#customlog" class="permalink">¶</a></h2>
+<h2
id="customlog">Custom Log Functions <a title="Permanent link" href="#customlog" class="permalink">¶</a></h2>
<p>
When mod_ssl is enabled, additional functions exist for the <a href="../mod/mod_log_config.html#formats">Custom Log Format</a> of
<code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> as documented in the Reference
exists for backward compatibility. The currently implemented function calls
are listed in <a href="#table3">Table 3</a>.</p>
-<h3><a name="table3" id="table3">Table 3: Custom Log Cryptography Function</a></h3>
+<h3 id="table3">Table 3: Custom Log Cryptography Function</h3>
<table>
<a href="../fr/ssl/ssl_compat.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="installation" id="installation">Installation</a> <a title="Permanent link" href="#installation" class="permalink">¶</a></h2>
+<h2
id="installation">Installation <a title="Permanent link" href="#installation" class="permalink">¶</a></h2>
<ul>
<li><a href="#mutex">Why do I get permission errors related to
SSLMutex when I start Apache?</a></li>
generate temporary 512 bit RSA private key" when I start Apache?</a></li>
</ul>
-<h3><a name="mutex" id="mutex">Why do I get permission errors related to
- SSLMutex when I start Apache?</a></h3>
+<h3 id="mutex">Why do I get permission errors related to
+ SSLMutex when I start Apache?</h3>
<p>Errors such as ``<code>mod_ssl: Child could not open
SSLMutex lockfile /opt/apache/logs/ssl_mutex.18332 (System error follows)
[...] System: Permission denied (errno: 13)</code>'' are usually
the <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> directive).</p>
-<h3><a name="entropy" id="entropy">Why does mod_ssl stop with the error
+<h3 id="entropy">Why does mod_ssl stop with the error
"Failed to generate temporary 512 bit RSA private key" when I start
- Apache?</a></h3>
+ Apache?</h3>
<p>Cryptographic software needs a source of unpredictable data
to work correctly. Many open source operating systems provide
a "randomness device" that serves this purpose (usually named
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="aboutconfig" id="aboutconfig">Configuration</a> <a title="Permanent link" href="#aboutconfig" class="permalink">¶</a></h2>
+<h2
id="aboutconfig">Configuration <a title="Permanent link" href="#aboutconfig" class="permalink">¶</a></h2>
<ul>
<li><a href="#parallel">Is it possible to provide HTTP and HTTPS from
the same server?</a></li>
relative hyperlinks?</a></li>
</ul>
-<h3><a name="parallel" id="parallel">Is it possible to provide HTTP and HTTPS
- from the same server?</a></h3>
+<h3 id="parallel">Is it possible to provide HTTP and HTTPS
+ from the same server?</h3>
<p>Yes. HTTP and HTTPS use different server ports (HTTP binds to
port 80, HTTPS to port 443), so there is no direct conflict between
them. You can either run two separate server instances bound to
responding over HTTPS to requests on port 443.</p>
-<h3><a name="ports" id="ports">Which port does HTTPS use?</a></h3>
+<h3 id="ports">Which port does HTTPS use?</h3>
<p>You can run HTTPS on any port, but the standards specify port 443, which
is where any HTTPS compliant browser will look by default. You can force
your browser to look on a different port by specifying it in the URL. For
you can access them at <code>https://example.com:8080/</code></p>
-<h3><a name="httpstest" id="httpstest">How do I speak HTTPS manually for testing purposes?</a></h3>
+<h3 id="httpstest">How do I speak HTTPS manually for testing purposes?</h3>
<p>While you usually just use</p>
<div class="example"><p><code>$ telnet localhost 80<br>
$ curl https://localhost/</code></p></div>
-<h3><a name="hang" id="hang">Why does the connection hang when I connect
- to my SSL-aware Apache server?</a></h3>
+<h3 id="hang">Why does the connection hang when I connect
+ to my SSL-aware Apache server?</h3>
<p>This can happen when you try to connect to a HTTPS server (or virtual
server) via HTTP (eg, using <code>http://example.com/</code> instead of
or which supports it on a non-standard port). Make sure that you're
connecting to a (virtual) server that supports SSL.</p>
-<h3><a name="refused" id="refused">Why do I get ``Connection Refused'' messages,
- when trying to access my newly installed Apache+mod_ssl server via HTTPS?</a></h3>
+<h3 id="refused">Why do I get ``Connection Refused'' messages,
+ when trying to access my newly installed Apache+mod_ssl server via HTTPS?</h3>
<p>
This error can be caused by an incorrect configuration.
Please make sure that your <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directives match your
configuration provided by <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
-<h3><a name="envvars" id="envvars">Why are the <code>SSL_XXX</code> variables
- not available to my CGI & SSI scripts?</a></h3>
+<h3 id="envvars">Why are the <code>SSL_XXX</code> variables
+ not available to my CGI & SSI scripts?</h3>
<p>Please make sure you have ``<code>SSLOptions +StdEnvVars</code>''
enabled for the context of your CGI/SSI requests.</p>
-<h3><a name="relative" id="relative">How can I switch between HTTP and HTTPS in relative
- hyperlinks?</a></h3>
+<h3 id="relative">How can I switch between HTTP and HTTPS in relative
+ hyperlinks?</h3>
<p>Usually, to switch between HTTP and HTTPS, you have to use
fully-qualified hyperlinks (because you have to change the URL
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="aboutcerts" id="aboutcerts">Certificates</a> <a title="Permanent link" href="#aboutcerts" class="permalink">¶</a></h2>
+<h2
id="aboutcerts">Certificates <a title="Permanent link" href="#aboutcerts" class="permalink">¶</a></h2>
<ul>
<li><a href="#keyscerts">What are RSA Private Keys, CSRs and
Certificates?</a></li>
verify my server certificate?</a></li>
</ul>
-<h3><a name="keyscerts" id="keyscerts">What are RSA Private Keys, CSRs and Certificates?</a></h3>
+<h3 id="keyscerts">What are RSA Private Keys, CSRs and Certificates?</h3>
<p>An RSA private key file is a digital file that you can use to decrypt
messages sent to you. It has a public component which you distribute (via
your Certificate file) which allows people to encrypt those messages to
description of the SSL protocol.</p>
-<h3><a name="startup" id="startup">Is there a difference on startup between
- a non-SSL-aware Apache and an SSL-aware Apache?</a></h3>
+<h3 id="startup">Is there a difference on startup between
+ a non-SSL-aware Apache and an SSL-aware Apache?</h3>
<p>Yes. In general, starting Apache with
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> built-in is just like starting Apache
without it. However, if you have a passphrase on your SSL private
risks - proceed with caution!</p>
-<h3><a name="selfcert" id="selfcert">How do I create a self-signed SSL
-Certificate for testing purposes?</a></h3>
+<h3 id="selfcert">How do I create a self-signed SSL
+Certificate for testing purposes?</h3>
<ol>
<li>Make sure OpenSSL is installed and in your <code>PATH</code>.<br>
<br>
</ol>
-<h3><a name="realcert" id="realcert">How do I create a real SSL Certificate?</a></h3>
+<h3 id="realcert">How do I create a real SSL Certificate?</h3>
<p>Here is a step-by-step description:</p>
<ol>
<li>Make sure OpenSSL is installed and in your <code>PATH</code>.
</ol>
-<h3><a name="ownca" id="ownca">How do I create and use my own Certificate Authority (CA)?</a></h3>
+<h3 id="ownca">How do I create and use my own Certificate Authority (CA)?</h3>
<p>The short answer is to use the <code>CA.sh</code> or <code>CA.pl</code>
script provided by OpenSSL. Unless you have a good reason not to,
you should use these for preference. If you cannot, you can create a
</ol>
-<h3><a name="passphrase" id="passphrase">How can I change the pass-phrase on my private key file?</a></h3>
+<h3 id="passphrase">How can I change the pass-phrase on my private key file?</h3>
<p>You simply have to read it with the old pass-phrase and write it again,
specifying the new pass-phrase. You can accomplish this with the following commands:</p>
pass-phrase a second time.</p>
-<h3><a name="removepassphrase" id="removepassphrase">How can I get rid of the pass-phrase dialog at Apache startup time?</a></h3>
+<h3 id="removepassphrase">How can I get rid of the pass-phrase dialog at Apache startup time?</h3>
<p>The reason this dialog pops up at startup and every re-start
is that the RSA private key inside your server.key file is stored in
encrypted format for security reasons. The pass-phrase is needed to decrypt
neither more nor less secure, of course.</p>
-<h3><a name="verify" id="verify">How do I verify that a private key matches its Certificate?</a></h3>
+<h3 id="verify">How do I verify that a private key matches its Certificate?</h3>
<p>A private key contains a series of numbers. Two of these numbers form
the "public key", the others are part of the "private key". The "public
key" bits are included when you generate a CSR, and subsequently form
<p><code><strong>$ openssl req -noout -modulus -in server.csr | openssl md5</strong></code></p>
-<h3><a name="pemder" id="pemder">How can I convert a certificate from PEM to DER format?</a></h3>
+<h3 id="pemder">How can I convert a certificate from PEM to DER format?</h3>
<p>The default certificate format for OpenSSL is PEM, which is simply
Base64 encoded DER, with header and footer lines. For some applications
(e.g. Microsoft Internet Explorer) you need the certificate in plain DER
<code><strong>$ openssl x509 -in cert.pem -out cert.der -outform DER</strong></code></p>
-<h3><a name="gid" id="gid">Why do browsers complain that they cannot verify my server certificate?</a></h3>
+<h3 id="gid">Why do browsers complain that they cannot verify my server certificate?</h3>
<p>One reason this might happen is because your server certificate is signed
by an intermediate CA. Various CAs, such as Verisign or Thawte, have started
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="aboutssl" id="aboutssl">The SSL Protocol</a> <a title="Permanent link" href="#aboutssl" class="permalink">¶</a></h2>
+<h2
id="aboutssl">The SSL Protocol <a title="Permanent link" href="#aboutssl" class="permalink">¶</a></h2>
<ul>
<li><a href="#random">Why do I get lots of random SSL protocol
errors under heavy server load?</a></li>
<li><a href="#javadh">Why do I get handshake failures with Java-based clients when using a certificate with more than 1024 bits?</a></li>
</ul>
-<h3><a name="random" id="random">Why do I get lots of random SSL protocol
-errors under heavy server load?</a></h3>
+<h3 id="random">Why do I get lots of random SSL protocol
+errors under heavy server load?</h3>
<p>There can be a number of reasons for this, but the main one
is problems with the SSL session Cache specified by the
<code class="directive"><a href="../mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code> directive. The DBM session
no cache at all) may help.</p>
-<h3><a name="load" id="load">Why does my webserver have a higher load, now
-that it serves SSL encrypted traffic?</a></h3>
+<h3 id="load">Why does my webserver have a higher load, now
+that it serves SSL encrypted traffic?</h3>
<p>SSL uses strong cryptographic encryption, which necessitates a lot of
number crunching. When you request a webpage via HTTPS, everything (even
the images) is encrypted before it is transferred. So increased HTTPS
traffic leads to load increases.</p>
-<h3><a name="establishing" id="establishing">Why do HTTPS connections to my server
-sometimes take up to 30 seconds to establish a connection?</a></h3>
+<h3 id="establishing">Why do HTTPS connections to my server
+sometimes take up to 30 seconds to establish a connection?</h3>
<p>This is usually caused by a <code>/dev/random</code> device for
<code class="directive"><a href="../mod/mod_ssl.html#sslrandomseed">SSLRandomSeed</a></code> which blocks the
read(2) call until enough entropy is available to service the
directive.</p>
-<h3><a name="ciphers" id="ciphers">What SSL Ciphers are supported by mod_ssl?</a></h3>
+<h3 id="ciphers">What SSL Ciphers are supported by mod_ssl?</h3>
<p>Usually, any SSL ciphers supported by the version of OpenSSL in use,
are also supported by <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. Which ciphers are
available can depend on the way you built OpenSSL. Typically, at
<div class="example"><p><code>$ openssl ciphers -v</code></p></div>
-<h3><a name="adh" id="adh">Why do I get ``no shared cipher'' errors, when
-trying to use Anonymous Diffie-Hellman (ADH) ciphers?</a></h3>
+<h3 id="adh">Why do I get ``no shared cipher'' errors, when
+trying to use Anonymous Diffie-Hellman (ADH) ciphers?</h3>
<p>By default, OpenSSL does <em>not</em> allow ADH ciphers, for security
reasons. Please be sure you are aware of the potential side-effects
if you choose to enable these ciphers.</p>
``<code>ADH</code>'' into your <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code>.</p>
-<h3><a name="sharedciphers" id="sharedciphers">Why do I get a 'no shared ciphers'
-error when connecting to my newly installed server?</a></h3>
+<h3 id="sharedciphers">Why do I get a 'no shared ciphers'
+error when connecting to my newly installed server?</h3>
<p>Either you have made a mistake with your
<code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code>
directive (compare it with the pre-configured example in
certificate/key pair, using the RSA algorithm.</p>
-<h3><a name="vhosts" id="vhosts">Why can't I use SSL with name-based/non-IP-based virtual hosts?</a></h3>
+<h3 id="vhosts">Why can't I use SSL with name-based/non-IP-based virtual hosts?</h3>
<p>The reason is very technical, and a somewhat "chicken and egg" problem.
The SSL protocol layer stays below the HTTP protocol layer and
encapsulates HTTP. When an SSL connection (HTTPS) is established
workarounds.</p>
-<h3><a name="vhosts2" id="vhosts2">Is it possible to use Name-Based
-Virtual Hosting to identify different SSL virtual hosts?</a></h3>
+<h3 id="vhosts2">Is it possible to use Name-Based
+Virtual Hosting to identify different SSL virtual hosts?</h3>
<p>Name-Based Virtual Hosting is a very popular method of identifying
different virtual hosts. It allows you to use the same IP address and
the same port number for many different sites. When people move on to
Using different port numbers for different SSL hosts.</p>
-<h3><a name="comp" id="comp">How do I get SSL compression working?</a></h3>
+<h3 id="comp">How do I get SSL compression working?</h3>
<p>Although SSL compression negotiation was defined in the specification
of SSLv2 and TLS, it took until May 2004 for RFC 3749 to define DEFLATE as
a negotiable standard compression method.
</p>
-<h3><a name="lockicon" id="lockicon">When I use Basic Authentication over HTTPS
+<h3 id="lockicon">When I use Basic Authentication over HTTPS
the lock icon in Netscape browsers stays unlocked when the dialog pops up.
-Does this mean the username/password is being sent unencrypted?</a></h3>
+Does this mean the username/password is being sent unencrypted?</h3>
<p>No, the username/password is transmitted encrypted. The icon in
Netscape browsers is not actually synchronized with the SSL/TLS layer.
It only toggles to the locked state when the first part of the actual
confused by this icon.</p>
-<h3><a name="msie" id="msie">Why do I get I/O errors when connecting via
+<h3 id="msie">Why do I get I/O errors when connecting via
HTTPS to an Apache+mod_ssl server with older versions of Microsoft Internet
-Explorer (MSIE)?</a></h3>
+Explorer (MSIE)?</h3>
<p>The first reason is that the SSL implementation in some MSIE versions has
some subtle bugs related to the HTTP keep-alive facility and the SSL close
notify alerts on socket connection close. Additionally the interaction
or otherwise.</p>
-<h3><a name="srp" id="srp">How do I enable TLS-SRP?</a></h3>
+<h3 id="srp">How do I enable TLS-SRP?</h3>
<p>TLS-SRP (Secure Remote Password key exchange for TLS, specified in RFC 5054)
can supplement or replace certificates in authenticating an SSL connection.
To use TLS-SRP, set the
</code></p></div>
-<h3><a name="javadh" id="javadh">Why do I get handshake failures with Java-based clients when using a certificate with more than 1024 bits?</a></h3>
+<h3 id="javadh">Why do I get handshake failures with Java-based clients when using a certificate with more than 1024 bits?</h3>
<p>Beginning with version 2.5.0-dev as of 2013-09-29,
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> will use DH parameters which include primes
with lengths of more than 1024 bits. Java 7 and earlier limit their
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="support" id="support">mod_ssl Support</a> <a title="Permanent link" href="#support" class="permalink">¶</a></h2>
+<h2
id="support">mod_ssl Support <a title="Permanent link" href="#support" class="permalink">¶</a></h2>
<ul>
<li><a href="#resources">What information resources are available in
case of mod_ssl problems?</a></li>
for my core dump?</a></li>
</ul>
-<h3><a name="resources" id="resources">What information resources are available in case of mod_ssl problems?</a></h3>
+<h3 id="resources">What information resources are available in case of mod_ssl problems?</h3>
<p>The following information resources are available.
In case of problems you should search here first.</p>
</dl>
-<h3><a name="contact" id="contact">What support contacts are available in case
-of mod_ssl problems?</a></h3>
+<h3 id="contact">What support contacts are available in case
+of mod_ssl problems?</h3>
<p>The following lists all support possibilities for mod_ssl, in order of
preference. Please go through these possibilities
<em>in this order</em> - don't just pick the one you like the look of. </p>
</ol>
-<h3><a name="reportdetails" id="reportdetails">What information should I
-provide when writing a bug report?</a></h3>
+<h3 id="reportdetails">What information should I
+provide when writing a bug report?</h3>
<p>You should always provide at least the following information:</p>
<dl>
</dl>
-<h3><a name="coredumphelp" id="coredumphelp">I had a core dump, can you help me?</a></h3>
+<h3 id="coredumphelp">I had a core dump, can you help me?</h3>
<p>In general no, at least not unless you provide more details about the code
location where Apache dumped core. What is usually always required in
order to help you is a backtrace (see next question). Without this
fixing it.</p>
-<h3><a name="backtrace" id="backtrace">How do I get a backtrace, to help find
-the reason for my core dump?</a></h3>
+<h3 id="backtrace">How do I get a backtrace, to help find
+the reason for my core dump?</h3>
<p>Following are the steps you will need to complete, to get a backtrace:</p>
<ol>
<li>Make sure you have debugging symbols available, at least
<a href="../fr/ssl/ssl_faq.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="configexample" id="configexample">Basic Configuration Example</a> <a title="Permanent link" href="#configexample" class="permalink">¶</a></h2>
+<h2
id="configexample">Basic Configuration Example <a title="Permanent link" href="#configexample" class="permalink">¶</a></h2>
<p>Your SSL configuration will need to contain, at minimum, the
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ciphersuites" id="ciphersuites">Cipher Suites and Enforcing Strong Encryption</a> <a title="Permanent link" href="#ciphersuites" class="permalink">¶</a></h2>
+<h2
id="ciphersuites">Cipher Suites and Enforcing Strong Encryption <a title="Permanent link" href="#ciphersuites" class="permalink">¶</a></h2>
<div class="warning">
requires a strong cipher for access to a particular URL?</a></li>
</ul>
-<h3><a name="onlystrong" id="onlystrong">How can I create an SSL server which accepts strong encryption
-only?</a></h3>
+<h3 id="onlystrong">How can I create an SSL server which accepts strong encryption
+only?</h3>
<p>The following configuration enables "strong encryption", as defined
above, and is derived from the Mozilla Foundation's
modern version of OpenSSL in order to use them.</p>
-<h3><a name="strongurl" id="strongurl">How can I create an SSL server which accepts many types of ciphers
-in general, but requires a strong cipher for access to a particular URL?</a></h3>
+<h3 id="strongurl">How can I create an SSL server which accepts many types of ciphers
+in general, but requires a strong cipher for access to a particular URL?</h3>
<p>Obviously, a server-wide <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> which restricts
ciphers to the strong variants, isn't the answer here. However,
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ocspstapling" id="ocspstapling">OCSP Stapling</a> <a title="Permanent link" href="#ocspstapling" class="permalink">¶</a></h2>
+<h2
id="ocspstapling">OCSP Stapling <a title="Permanent link" href="#ocspstapling" class="permalink">¶</a></h2>
<p>The Online Certificate Status Protocol (OCSP) is a mechanism for
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="accesscontrol" id="accesscontrol">Client Authentication and Access Control</a> <a title="Permanent link" href="#accesscontrol" class="permalink">¶</a></h2>
+<h2
id="accesscontrol">Client Authentication and Access Control <a title="Permanent link" href="#accesscontrol" class="permalink">¶</a></h2>
<ul>
<li><a href="#allclients">How can I force clients to authenticate using certificates?</a></li>
Intranet website, for clients coming from the Internet?</a></li>
</ul>
-<h3><a name="allclients" id="allclients">How can I force clients to authenticate using certificates?</a></h3>
+<h3 id="allclients">How can I force clients to authenticate using certificates?</h3>
<p>When you know all of your users (eg, as is often the case on a corporate
-<h3><a name="arbitraryclients" id="arbitraryclients">How can I force clients to authenticate using certificates for a
- particular URL, but still allow arbitrary clients to access the rest of the server?</a></h3>
+<h3 id="arbitraryclients">How can I force clients to authenticate using certificates for a
+ particular URL, but still allow arbitrary clients to access the rest of the server?</h3>
<p>To force clients to authenticate using certificates for a particular URL,
-<h3><a name="certauthenticate" id="certauthenticate">How can I allow only clients who have certificates to access a
- particular URL, but allow all clients to access the rest of the server?</a></h3>
+<h3 id="certauthenticate">How can I allow only clients who have certificates to access a
+ particular URL, but allow all clients to access the rest of the server?</h3>
<p>The key to doing this is checking that part of the client certificate
-<h3><a name="intranet" id="intranet">How can I require HTTPS with strong ciphers, and either basic
+<h3 id="intranet">How can I require HTTPS with strong ciphers, and either basic
authentication or client certificates, for access to part of the
Intranet website, for clients coming from the Internet? I still want to allow
-plain HTTP access for clients on the Intranet.</a></h3>
+plain HTTP access for clients on the Intranet.</h3>
<p>These examples presume that clients on the Intranet have IPs in the range
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="logging" id="logging">Logging</a> <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
+<h2
id="logging">Logging <a title="Permanent link" href="#logging" class="permalink">¶</a></h2>
<p><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> can log extremely verbose debugging information
<a href="../fr/ssl/ssl_howto.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
-<script src="../style/scripts/prettify.min.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="cryptographictech" id="cryptographictech">Cryptographic Techniques</a> <a title="Permanent link" href="#cryptographictech" class="permalink">¶</a></h2>
+<h2
id="cryptographictech">Cryptographic Techniques <a title="Permanent link" href="#cryptographictech" class="permalink">¶</a></h2>
<p>Understanding SSL requires an understanding of cryptographic
algorithms, message digest functions (aka. one-way or hash functions), and
for instance [<a href="#AC96">AC96</a>]) and provide the basis for privacy,
integrity, and authentication.</p>
-<h3><a name="cryptographicalgo" id="cryptographicalgo">Cryptographic Algorithms</a></h3>
+<h3 id="cryptographicalgo">Cryptographic Algorithms</h3>
<p>Suppose Alice wants to send a message to her bank to transfer some
money. Alice would like the message to be private, since it will
decrypt them.</p>
-<h3><a name="messagedigests" id="messagedigests">Message Digests</a></h3>
+<h3 id="messagedigests">Message Digests</h3>
<p>Although Alice may encrypt her message to make it private, there
is still a concern that someone might modify her original message or
signature.</p>
-<h3><a name="digitalsignatures" id="digitalsignatures">Digital Signatures</a></h3>
+<h3 id="digitalsignatures">Digital Signatures</h3>
<p>When Alice sends a message to the bank, the bank needs to ensure that the
message is really from her, so an intruder cannot request a transaction
involving her account. A <em>digital signature</em>, created by Alice and
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="certificates" id="certificates">Certificates</a> <a title="Permanent link" href="#certificates" class="permalink">¶</a></h2>
+<h2
id="certificates">Certificates <a title="Permanent link" href="#certificates" class="permalink">¶</a></h2>
<p>Although Alice could have sent a private message to the bank, signed
it and ensured the integrity of the message, she still needs to be sure
Such a trusted agency is called a <em>Certificate Authority</em> and
certificates are used for authentication.</p>
-<h3><a name="certificatecontents" id="certificatecontents">Certificate Contents</a></h3>
+<h3 id="certificatecontents">Certificate Contents</h3>
<p>A certificate associates a public key with the real identity of
an individual, server, or other entity, known as the subject. As
-----END CERTIFICATE-----</pre></div>
-<h3><a name="certificateauthorities" id="certificateauthorities">Certificate Authorities</a></h3>
+<h3 id="certificateauthorities">Certificate Authorities</h3>
<p>By verifying the information in a certificate request
before granting the certificate, the Certificate Authority assures
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="ssl" id="ssl">Secure Sockets Layer (SSL)</a> <a title="Permanent link" href="#ssl" class="permalink">¶</a></h2>
+<h2
id="ssl">Secure Sockets Layer (SSL) <a title="Permanent link" href="#ssl" class="permalink">¶</a></h2>
<p>The Secure Sockets Layer protocol is a protocol layer which may be
placed between a reliable connection-oriented network layer protocol
algorithms. Choices are negotiated between client and server when
establishing a protocol session.</p>
-<h3><a name="table4" id="table4">Table 4: Versions of the SSL protocol</a></h3>
+<h3 id="table4">Table 4: Versions of the SSL protocol</h3>
<table class="bordered">
[<a href="#TLS1">TLS</a>] protocol standard, currently in development by
the Internet Engineering Task Force (IETF).</p>
-<h3><a name="session" id="session">Establishing a Session</a></h3>
+<h3 id="session">Establishing a Session</h3>
<p>The SSL session is established by following a handshake sequence
between client and server, as shown in <a href="#figure1">Figure 1</a>. This sequence may vary, depending on whether the server
<p>These three elements are described in the sections that follow.</p>
-<h3><a name="keyexchange" id="keyexchange">Key Exchange Method</a></h3>
+<h3 id="keyexchange">Key Exchange Method</h3>
<p>The key exchange method defines how the shared secret symmetric
cryptography key used for application data transfer will be agreed
used to generating the shared key [<a href="#AC96">AC96</a>, p516].</p>
-<h3><a name="ciphertransfer" id="ciphertransfer">Cipher for Data Transfer</a></h3>
+<h3 id="ciphertransfer">Cipher for Data Transfer</h3>
<p>SSL uses conventional symmetric cryptography, as described earlier,
for encrypting messages in a session.
and "RC2" is a proprietary algorithm from RSA DSI [<a href="#AC96">AC96</a>, ch13].</p>
-<h3><a name="digestfunction" id="digestfunction">Digest Function</a></h3>
+<h3 id="digestfunction">Digest Function</h3>
<p>The choice of digest function determines how a digest is created
from a record unit. SSL supports the following:</p>
protect against replay attacks.</p>
-<h3><a name="handshake" id="handshake">Handshake Sequence Protocol</a></h3>
+<h3 id="handshake">Handshake Sequence Protocol</h3>
<p>The handshake sequence uses three protocols:</p>
established.</p>
-<h3><a name="datatransfer" id="datatransfer">Data Transfer</a></h3>
+<h3 id="datatransfer">Data Transfer</h3>
<p>The SSL Record Protocol, shown in <a href="#figure3">Figure 3</a>,
is used to transfer application and SSL Control data between the
</p>
-<h3><a name="securehttp" id="securehttp">Securing HTTP Communication</a></h3>
+<h3 id="securehttp">Securing HTTP Communication</h3>
<p>One common use of SSL is to secure Web HTTP communication between
a browser and a webserver. This does not preclude the use of
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
-<h2
><a name="references" id="references">References</a> <a title="Permanent link" href="#references" class="permalink">¶</a></h2>
+<h2
id="references">References <a title="Permanent link" href="#references" class="permalink">¶</a></h2>
<dl>
<dt><a id="AC96" name="AC96">[AC96]</a></dt>
<a href="../ja/ssl/ssl_intro.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><
projects / thirdparty / apache / httpd.git / commitdiff
