www/apache
www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2025-05-30 01:07:09 +03:00
Code

Updates docs w/ transforms. Use Andre's patch to lib/DocUtil.pm

Browse Source 
to work around some OS X issues which mangled paths


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@432570 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Jim Jagielski 2006-08-18 13:09:12 +00:00
parent 5c94bb0140
commit 611d2fc34b
55 changed files with 1266 additions and 1266 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

78
docs/manual/bind.html.en
View File

@ -6,37 +6,37 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Binding - Apache HTTP Server</title> <title>Binding - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Binding</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Binding</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./bind.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./bind.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/bind.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/./bind.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./bind.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./bind.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>Configuring Apache to listen on specific addresses and ports.</p> <p>Configuring Apache to listen on specific addresses and ports.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#overview">Overview</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Overview</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipv6">Special IPv6 Considerations</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#ipv6">Special IPv6 Considerations</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">How This Works With Virtual Hosts</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">How This Works With Virtual Hosts</a></li>
</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> </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="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="overview" id="overview">Overview</a></h2> <h2><a name="overview" id="overview">Overview</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">&lt;VirtualHost&gt;</a></code></li><li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table> <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">&lt;VirtualHost&gt;</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
<p>When Apache starts, it binds to some port and address on <p>When Apache starts, it binds to some port and address on
@ -47,15 +47,15 @@
Virtual Host feature, which determines how Apache responds to Virtual Host feature, which determines how Apache responds to
different IP addresses, hostnames and ports.</p> different IP addresses, hostnames and ports.</p>
<p>The <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> <p>The <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
directive tells the server to accept directive tells the server to accept
incoming requests only on the specified ports or incoming requests only on the specified ports or
address-and-port combinations. If only a port number is address-and-port combinations. If only a port number is
specified in the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> specified in the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
directive, the server directive, the server
listens to the given port on all interfaces. If an IP address listens to the given port on all interfaces. If an IP address
is given as well as a port, the server will listen on the given is given as well as a port, the server will listen on the given
port and interface. Multiple <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directives may be used to port and interface. Multiple <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> directives may be used to
specify a number of addresses and ports to listen on. The specify a number of addresses and ports to listen on. The
server will respond to requests from any of the listed server will respond to requests from any of the listed
addresses and ports.</p> addresses and ports.</p>
@ -82,13 +82,13 @@
<div class="example"><p><code> <div class="example"><p><code>
Listen [2001:db8::a00:20ff:fea7:ccea]:80 Listen [2001:db8::a00:20ff:fea7:ccea]:80
</code></p></div> </code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="ipv6" id="ipv6">Special IPv6 Considerations</a></h2> <h2><a name="ipv6" id="ipv6">Special IPv6 Considerations</a></h2>
<p>A growing number of platforms implement IPv6, and <p>A growing number of platforms implement IPv6, and
<a class="glossarylink" href="../glossary.html#apr" title="see glossary">APR</a> supports IPv6 on most of these platforms, <a class="glossarylink" href="./glossary.html#apr" title="see glossary">APR</a> supports IPv6 on most of these platforms,
allowing Apache to allocate IPv6 sockets, and to handle requests sent allowing Apache to allocate IPv6 sockets, and to handle requests sent
over IPv6.</p> over IPv6.</p>
@ -99,14 +99,14 @@
platforms, but are disallowed by default on FreeBSD, NetBSD, and platforms, but are disallowed by default on FreeBSD, NetBSD, and
OpenBSD, in order to match the system-wide policy on those OpenBSD, in order to match the system-wide policy on those
platforms. On systems where it is disallowed by default, a platforms. On systems where it is disallowed by default, a
special <code class="program"><a href="../programs/configure.html">configure</a></code> parameter can change this behavior special <code class="program"><a href="./programs/configure.html">configure</a></code> parameter can change this behavior
for Apache.</p> for Apache.</p>
<p>On the other hand, on some platforms, such as Linux and Tru64, the <p>On the other hand, on some platforms, such as Linux and Tru64, the
<strong>only</strong> way to handle both IPv6 and IPv4 is to use <strong>only</strong> way to handle both IPv6 and IPv4 is to use
mapped addresses. If you want Apache to handle IPv4 and IPv6 connections mapped addresses. If you want Apache to handle IPv4 and IPv6 connections
with a minimum of sockets, which requires using IPv4-mapped IPv6 with a minimum of sockets, which requires using IPv4-mapped IPv6
addresses, specify the <code>--enable-v4-mapped</code> <code class="program"><a href="../programs/configure.html">configure</a></code> option.</p> addresses, specify the <code>--enable-v4-mapped</code> <code class="program"><a href="./programs/configure.html">configure</a></code> option.</p>
<p><code>--enable-v4-mapped</code> is the default on all platforms except <p><code>--enable-v4-mapped</code> is the default on all platforms except
FreeBSD, NetBSD, and OpenBSD, so this is probably how your Apache was FreeBSD, NetBSD, and OpenBSD, so this is probably how your Apache was
@ -114,7 +114,7 @@
<p>If you want Apache to handle IPv4 connections only, regardless of <p>If you want Apache to handle IPv4 connections only, regardless of
what your platform and APR will support, specify an IPv4 address on all what your platform and APR will support, specify an IPv4 address on all
<code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directives, as in the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> directives, as in the
following examples:</p> following examples:</p>
<div class="example"><p><code> <div class="example"><p><code>
@ -124,38 +124,38 @@
<p>If your platform supports it and you want Apache to handle IPv4 and <p>If your platform supports it and you want Apache to handle IPv4 and
IPv6 connections on separate sockets (i.e., to disable IPv4-mapped IPv6 connections on separate sockets (i.e., to disable IPv4-mapped
addresses), specify the <code>--disable-v4-mapped</code> <code class="program"><a href="../programs/configure.html">configure</a></code> option. <code>--disable-v4-mapped</code> is the addresses), specify the <code>--disable-v4-mapped</code> <code class="program"><a href="./programs/configure.html">configure</a></code> option. <code>--disable-v4-mapped</code> is the
default on FreeBSD, NetBSD, and OpenBSD.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="virtualhost" id="virtualhost">How This Works With Virtual Hosts</a></h2> <h2><a name="virtualhost" id="virtualhost">How This Works With Virtual Hosts</a></h2>
<p> The <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directive does not implement <p> The <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> directive does not implement
Virtual Hosts - it only tells the Virtual Hosts - it only tells the
main server what addresses and ports to listen on. If no main server what addresses and ports to listen on. If no
<code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
directives are used, the server will behave directives are used, the server will behave
in the same way for all accepted requests. However, in the same way for all accepted requests. However,
<code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
can be used to specify a different behavior can be used to specify a different behavior
for one or more of the addresses or ports. To implement a for one or more of the addresses or ports. To implement a
VirtualHost, the server must first be told to listen to the VirtualHost, the server must first be told to listen to the
address and port to be used. Then a address and port to be used. Then a
<code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> section <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> section
should be created for the specified address and port to set the should be created for the specified address and port to set the
behavior of this virtual host. Note that if the behavior of this virtual host. Note that if the
<code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
is set for an address and port that the is set for an address and port that the
server is not listening to, it cannot be accessed.</p> server is not listening to, it cannot be accessed.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./bind.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./bind.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/bind.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/./bind.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./bind.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./bind.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/bind.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>bind</basename> <basename>bind</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>de</variant> <variant>de</variant>

190
docs/manual/caching.html.en
View File

@ -6,68 +6,68 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Caching Guide - Apache HTTP Server</title> <title>Caching Guide - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Caching Guide</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Caching Guide</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./caching.html" title="English">&nbsp;en&nbsp;</a></p> <p><span>Available Languages: </span><a href="./en/caching.html" title="English">&nbsp;en&nbsp;</a></p>
</div> </div>
<p>This document supplements the <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>, <p>This document supplements the <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>,
<code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>, <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code>, <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code>, <code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code>,
<code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> and <a href="programs/htcacheclean.html">htcacheclean</a> reference documentation. <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> and <a href="programs/htcacheclean.html">htcacheclean</a> reference documentation.
It describes how to use Apache's caching features to accelerate web and It describes how to use Apache's caching features to accelerate web and
proxy serving, while avoiding common problems and misconfigurations.</p> proxy serving, while avoiding common problems and misconfigurations.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#overview">Caching Overview</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#overview">Caching Overview</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Security Considerations</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#security">Security Considerations</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#filehandle">File-Handle Caching</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#filehandle">File-Handle Caching</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#inmemory">In-Memory Caching</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#inmemory">In-Memory Caching</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#disk">Disk-based Caching</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#disk">Disk-based Caching</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="introduction" id="introduction">Introduction</a></h2> <h2><a name="introduction" id="introduction">Introduction</a></h2>
<p>As of Apache HTTP server version 2.2 <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> <p>As of Apache HTTP server version 2.2 <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
and <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> are no longer marked and <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> are no longer marked
experimental and are considered suitable for production use. These experimental and are considered suitable for production use. These
caching architectures provide a powerful means to accelerate HTTP caching architectures provide a powerful means to accelerate HTTP
handling, both as an origin webserver and as a proxy.</p> handling, both as an origin webserver and as a proxy.</p>
<p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> and its provider modules <p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> and its provider modules
<code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> and <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> <code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code> and <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code>
provide intelligent, HTTP-aware caching. The content itself is stored provide intelligent, HTTP-aware caching. The content itself is stored
in the cache, and mod_cache aims to honour all of the various HTTP in the cache, and mod_cache aims to honour all of the various HTTP
headers and options that control the cachability of content. It can headers and options that control the cachability of content. It can
handle both local and proxied content. <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> handle both local and proxied content. <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
is aimed at both simple and complex caching configurations, where is aimed at both simple and complex caching configurations, where
you are dealing with proxied content, dynamic local content or you are dealing with proxied content, dynamic local content or
have a need to speed up access to local files which change with have a need to speed up access to local files which change with
time.</p> time.</p>
<p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> on the other hand presents a more <p><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> on the other hand presents a more
basic, but sometimes useful, form of caching. Rather than maintain basic, but sometimes useful, form of caching. Rather than maintain
the complexity of actively ensuring the cachability of URLs, the complexity of actively ensuring the cachability of URLs,
<code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> offers file-handle and memory-mapping <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> offers file-handle and memory-mapping
tricks to keep a cache of files as they were when Apache was last tricks to keep a cache of files as they were when Apache was last
started. As such, <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> is aimed at improving started. As such, <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> is aimed at improving
the access time to local static files which do not change very the access time to local static files which do not change very
often.</p> often.</p>
<p>As <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> presents a relatively simple <p>As <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> presents a relatively simple
caching implementation, apart from the specific sections on <code class="directive"><a href="../mod/mod_file_cache.html#cachefile">CacheFile</a></code> and <code class="directive"><a href="../mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code>, the explanations caching implementation, apart from the specific sections on <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> and <code class="directive"><a href="./mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code>, the explanations
in this guide cover the <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> caching in this guide cover the <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> caching
architecture.</p> architecture.</p>
<p>To get the most from this document, you should be familiar with <p>To get the most from this document, you should be familiar with
@ -75,34 +75,34 @@
<a href="urlmapping.html">Mapping URLs to the Filesystem</a> and <a href="urlmapping.html">Mapping URLs to the Filesystem</a> and
<a href="content-negotiation.html">Content negotiation</a>.</p> <a href="content-negotiation.html">Content negotiation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="overview" id="overview">Caching Overview</a></h2> <h2><a name="overview" id="overview">Caching Overview</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_mem_cache.html">mod_mem_cache</a></code></li><li><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code></li><li><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</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.html#cachedisable">CacheDisable</a></code></li><li><code class="directive"><a href="../mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code></li><li><code class="directive"><a href="../mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="../mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="../mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code></li></ul></td></tr></table> <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_mem_cache.html">mod_mem_cache</a></code></li><li><code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code></li><li><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</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.html#cachedisable">CacheDisable</a></code></li><li><code class="directive"><a href="./mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code></li><li><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code></li></ul></td></tr></table>
<p>There are two main stages in <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> that can <p>There are two main stages in <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> that can
occur in the lifetime of a request. First, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> occur in the lifetime of a request. First, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
is a URL mapping module, which means that if a URL has been cached, is a URL mapping module, which means that if a URL has been cached,
and the cached version of that URL has not expired, the request will and the cached version of that URL has not expired, the request will
be served directly by <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p> be served directly by <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>.</p>
<p>This means that any other stages that might ordinarily happen <p>This means that any other stages that might ordinarily happen
in the process of serving a request -- for example being handled in the process of serving a request -- for example being handled
by <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, or <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> -- by <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>, or <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> --
won't happen. But then this is the point of caching content in won't happen. But then this is the point of caching content in
the first place.</p> the first place.</p>
<p>If the URL is not found within the cache, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> <p>If the URL is not found within the cache, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
will add a <a href="filter.html">filter</a> to the request handling. After will add a <a href="filter.html">filter</a> to the request handling. After
Apache has located the content by the usual means, the filter will be run Apache has located the content by the usual means, the filter will be run
as the content is served. If the content is determined to be cacheable, as the content is served. If the content is determined to be cacheable,
the content will be saved to the cache for future serving.</p> the content will be saved to the cache for future serving.</p>
<p>If the URL is found within the cache, but also found to have expired, <p>If the URL is found within the cache, but also found to have expired,
the filter is added anyway, but <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> will create the filter is added anyway, but <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will create
a conditional request to the backend, to determine if the cached version a conditional request to the backend, to determine if the cached version
is still current. If the cached version is still current, its is still current. If the cached version is still current, its
meta-information will be updated and the request will be served from the meta-information will be updated and the request will be served from the
@ -114,7 +114,7 @@
<p>When caching locally generated content, ensuring that <p>When caching locally generated content, ensuring that
<code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> is set to <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> is set to
<code>On</code> can dramatically improve the ratio of cache hits. This <code>On</code> can dramatically improve the ratio of cache hits. This
is because the hostname of the virtual-host serving the content forms is because the hostname of the virtual-host serving the content forms
a part of the cache key. With the setting set to <code>On</code> a part of the cache key. With the setting set to <code>On</code>
@ -144,19 +144,19 @@
<p>The default expiry period for cached entities is one hour, however <p>The default expiry period for cached entities is one hour, however
this can be easily over-ridden by using the <code class="directive"><a href="../mod/mod_cache.html#cachedefaultexpire">CacheDefaultExpire</a></code> directive. This this can be easily over-ridden by using the <code class="directive"><a href="./mod/mod_cache.html#cachedefaultexpire">CacheDefaultExpire</a></code> directive. This
default is only used when the original source of the content does not default is only used when the original source of the content does not
specify an expire time or time of last modification.</p> specify an expire time or time of last modification.</p>
<p>If a response does not include an <code>Expires</code> header but does <p>If a response does not include an <code>Expires</code> header but does
include a <code>Last-Modified</code> header, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> include a <code>Last-Modified</code> header, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
can infer an expiry period based on the use of the <code class="directive"><a href="../mod/mod_cache.html#cachelastmodifiedfactor">CacheLastModifiedFactor</a></code> directive.</p> can infer an expiry period based on the use of the <code class="directive"><a href="./mod/mod_cache.html#cachelastmodifiedfactor">CacheLastModifiedFactor</a></code> directive.</p>
<p>For local content, <code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> may be used to <p>For local content, <code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code> may be used to
fine-tune the expiry period.</p> fine-tune the expiry period.</p>
<p>The maximum expiry period may also be controlled by using the <p>The maximum expiry period may also be controlled by using the
<code class="directive"><a href="../mod/mod_cache.html#cachemaxexpire">CacheMaxExpire</a></code>.</p> <code class="directive"><a href="./mod/mod_cache.html#cachemaxexpire">CacheMaxExpire</a></code>.</p>
@ -204,19 +204,19 @@
<p>As mentioned already, the two styles of caching in Apache work <p>As mentioned already, the two styles of caching in Apache work
differently, <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> caching maintains file differently, <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> caching maintains file
contents as they were when Apache was started. When a request is contents as they were when Apache was started. When a request is
made for a file that is cached by this module, it is intercepted made for a file that is cached by this module, it is intercepted
and the cached file is served.</p> and the cached file is served.</p>
<p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> caching on the other hand is more <p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> caching on the other hand is more
complex. When serving a request, if it has not been cached complex. When serving a request, if it has not been cached
previously, the caching module will determine if the content previously, the caching module will determine if the content
is cacheable. The conditions for determining cachability of is cacheable. The conditions for determining cachability of
a response are;</p> a response are;</p>
<ol> <ol>
<li>Caching must be enabled for this URL. See the <code class="directive"><a href="../mod/mod_cache.html#cacheenable">CacheEnable</a></code> and <code class="directive"><a href="../mod/mod_cache.html#cachedisable">CacheDisable</a></code> directives.</li> <li>Caching must be enabled for this URL. See the <code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code> and <code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code> directives.</li>
<li>The response must have a HTTP status code of 200, 203, 300, 301 or <li>The response must have a HTTP status code of 200, 203, 300, 301 or
410.</li> 410.</li>
@ -237,17 +237,17 @@
<li>If the response has a status of 200 (OK), the response must <li>If the response has a status of 200 (OK), the response must
also include at least one of the "Etag", "Last-Modified" or also include at least one of the "Etag", "Last-Modified" or
the "Expires" headers, unless the the "Expires" headers, unless the
<code class="directive"><a href="../mod/mod_cache.html#cacheignorenolastmod">CacheIgnoreNoLastMod</a></code> <code class="directive"><a href="./mod/mod_cache.html#cacheignorenolastmod">CacheIgnoreNoLastMod</a></code>
directive has been used to require otherwise.</li> directive has been used to require otherwise.</li>
<li>If the response includes the "private" option in a "Cache-Control:" <li>If the response includes the "private" option in a "Cache-Control:"
header, it will not be stored unless the header, it will not be stored unless the
<code class="directive"><a href="../mod/mod_cache.html#cachestoreprivate">CacheStorePrivate</a></code> has been <code class="directive"><a href="./mod/mod_cache.html#cachestoreprivate">CacheStorePrivate</a></code> has been
used to require otherwise.</li> used to require otherwise.</li>
<li>Likewise, if the response includes the "no-store" option in a <li>Likewise, if the response includes the "no-store" option in a
"Cache-Control:" header, it will not be stored unless the "Cache-Control:" header, it will not be stored unless the
<code class="directive"><a href="../mod/mod_cache.html#cachestorenostore">CacheStoreNoStore</a></code> has been <code class="directive"><a href="./mod/mod_cache.html#cachestorenostore">CacheStoreNoStore</a></code> has been
used.</li> used.</li>
<li>A response will not be stored if it includes a "Vary:" header <li>A response will not be stored if it includes a "Vary:" header
@ -275,9 +275,9 @@
<p>If a response with a "Vary" header is received by <p>If a response with a "Vary" header is received by
<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> when requesting content by the backend it <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> when requesting content by the backend it
will attempt to handle it intelligently. If possible, will attempt to handle it intelligently. If possible,
<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> will detect the headers attributed in the <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will detect the headers attributed in the
"Vary" response in future requests and serve the correct cached "Vary" response in future requests and serve the correct cached
response.</p> response.</p>
@ -287,12 +287,12 @@
Vary: negotiate,accept-language,accept-charset Vary: negotiate,accept-language,accept-charset
</code></p></div> </code></p></div>
<p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> will only serve the cached content to <p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will only serve the cached content to
requesters with matching accept-language and accept-charset headers requesters with matching accept-language and accept-charset headers
matching those of the original request.</p> matching those of the original request.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="security" id="security">Security Considerations</a></h2> <h2><a name="security" id="security">Security Considerations</a></h2>
@ -300,7 +300,7 @@ Vary: negotiate,accept-language,accept-charset
<h3>Authentication, Authorization and Access Control</h3> <h3>Authentication, Authorization and Access Control</h3>
<p>Using <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> is very much like having a built <p>Using <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> is very much like having a built
in reverse-proxy. Requests will be served by the caching module unless in reverse-proxy. Requests will be served by the caching module unless
it determines that the backend should be queried. When caching local it determines that the backend should be queried. When caching local
resources, this drastically changes the security model of Apache.</p> resources, this drastically changes the security model of Apache.</p>
@ -308,16 +308,16 @@ Vary: negotiate,accept-language,accept-charset
<p>As traversing a filesystem hierarchy to examine potential <p>As traversing a filesystem hierarchy to examine potential
<code>.htaccess</code> files would be a very expensive operation, <code>.htaccess</code> files would be a very expensive operation,
partially defeating the point of caching (to speed up requests), partially defeating the point of caching (to speed up requests),
<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> makes no decision about whether a cached <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> makes no decision about whether a cached
entity is authorised for serving. In other words; if entity is authorised for serving. In other words; if
<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> has cached some content, it will be served <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> has cached some content, it will be served
from the cache as long as that content has not expired.</p> from the cache as long as that content has not expired.</p>
<p>If, for example, your configuration permits access to a resource by IP <p>If, for example, your configuration permits access to a resource by IP
address you should ensure that this content is not cached. You can do this address you should ensure that this content is not cached. You can do this
by using the <code class="directive"><a href="../mod/mod_cache.html#cachedisable">CacheDisable</a></code> by using the <code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code>
directive, or <code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code>. Left unchecked, directive, or <code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code>. Left unchecked,
<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> - very much like a reverse proxy - would cache <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> - very much like a reverse proxy - would cache
the content when served and then serve it to any client, on any IP the content when served and then serve it to any client, on any IP
address.</p> address.</p>
@ -334,12 +334,12 @@ Vary: negotiate,accept-language,accept-charset
<p>If the Apache user is compromised, for example through a flaw in <p>If the Apache user is compromised, for example through a flaw in
a CGI process, it is possible that the cache may be targeted. When a CGI process, it is possible that the cache may be targeted. When
using <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>, it is relatively easy to using <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code>, it is relatively easy to
insert or modify a cached entity.</p> insert or modify a cached entity.</p>
<p>This presents a somewhat elevated risk in comparison to the other <p>This presents a somewhat elevated risk in comparison to the other
types of attack it is possible to make as the Apache user. If you are types of attack it is possible to make as the Apache user. If you are
using <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> you should bear this in mind - using <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code> you should bear this in mind -
ensure you upgrade Apache when security upgrades are announced and ensure you upgrade Apache when security upgrades are announced and
run CGI processes as a non-Apache user using <a href="suexec.html">suEXEC</a> if possible.</p> run CGI processes as a non-Apache user using <a href="suexec.html">suEXEC</a> if possible.</p>
@ -366,12 +366,12 @@ Vary: negotiate,accept-language,accept-charset
webserver such that the attacker can entirely control the content webserver such that the attacker can entirely control the content
retrieved by the proxy.</p> retrieved by the proxy.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="filehandle" id="filehandle">File-Handle Caching</a></h2> <h2><a name="filehandle" id="filehandle">File-Handle Caching</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_file_cache.html">mod_file_cache</a></code></li><li><code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="../mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="../mod/mod_cache.html#cachedisable">CacheDisable</a></code></li></ul></td></tr></table> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></li><li><code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code></li></ul></td></tr></table>
<p>The act of opening a file can itself be a source of delay, particularly <p>The act of opening a file can itself be a source of delay, particularly
on network filesystems. By maintaining a cache of open file descriptors on network filesystems. By maintaining a cache of open file descriptors
@ -382,14 +382,14 @@ Vary: negotiate,accept-language,accept-charset
<p>The most basic form of caching present in Apache is the file-handle <p>The most basic form of caching present in Apache is the file-handle
caching provided by <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>. Rather than caching caching provided by <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code>. Rather than caching
file-contents, this cache maintains a table of open file descriptors. Files file-contents, this cache maintains a table of open file descriptors. Files
to be cached in this manner are specified in the configuration file using to be cached in this manner are specified in the configuration file using
the <code class="directive"><a href="../mod/mod_file_cache.html#cachefile">CacheFile</a></code> the <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code>
directive.</p> directive.</p>
<p>The <p>The
<code class="directive"><a href="../mod/mod_file_cache.html#cachefile">CacheFile</a></code> directive <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> directive
instructs Apache to open the file when Apache is started and to re-use instructs Apache to open the file when Apache is started and to re-use
this file-handle for all subsequent access to this file.</p> this file-handle for all subsequent access to this file.</p>
@ -399,7 +399,7 @@ Vary: negotiate,accept-language,accept-charset
must ensure that your operating system's limit for the number of open must ensure that your operating system's limit for the number of open
files is set appropriately.</p> files is set appropriately.</p>
<p>Although using <code class="directive"><a href="../mod/mod_file_cache.html#cachefile">CacheFile</a></code> <p>Although using <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code>
does not cause the file-contents to be cached per-se, it does mean does not cause the file-contents to be cached per-se, it does mean
that if the file changes while Apache is running these changes will that if the file changes while Apache is running these changes will
not be picked up. The file will be consistently served as it was not be picked up. The file will be consistently served as it was
@ -416,22 +416,22 @@ Vary: negotiate,accept-language,accept-charset
<h3>CacheEnable fd</h3> <h3>CacheEnable fd</h3>
<p><code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> also provides its own file-handle <p><code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code> also provides its own file-handle
caching scheme, which can be enabled via the caching scheme, which can be enabled via the
<code class="directive"><a href="../mod/mod_cache.html#cacheenable">CacheEnable</a></code> directive.</p> <code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code> directive.</p>
<div class="example"><pre>CacheEnable fd /</pre></div> <div class="example"><pre>CacheEnable fd /</pre></div>
<p>As with all of <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> this type of file-handle <p>As with all of <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> this type of file-handle
caching is intelligent, and handles will not be maintained beyond caching is intelligent, and handles will not be maintained beyond
the expiry time of the cached content.</p> the expiry time of the cached content.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="inmemory" id="inmemory">In-Memory Caching</a></h2> <h2><a name="inmemory" id="inmemory">In-Memory Caching</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_mem_cache.html">mod_mem_cache</a></code></li><li><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</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.html#cachedisable">CacheDisable</a></code></li><li><code class="directive"><a href="../mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code></li></ul></td></tr></table> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code></li><li><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</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.html#cachedisable">CacheDisable</a></code></li><li><code class="directive"><a href="./mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code></li></ul></td></tr></table>
<p>Serving directly from system memory is universally the fastest method <p>Serving directly from system memory is universally the fastest method
of serving content. Reading files from a disk controller or, even worse, of serving content. Reading files from a disk controller or, even worse,
@ -496,8 +496,8 @@ sys 0m0.000s</pre></div>
<h3>MMapStatic Caching</h3> <h3>MMapStatic Caching</h3>
<p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> provides the <p><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> provides the
<code class="directive"><a href="../mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code> directive, which <code class="directive"><a href="./mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code> directive, which
allows you to have Apache map a static file's contents into memory at allows you to have Apache map a static file's contents into memory at
start time (using the mmap system call). Apache will use the in-memory start time (using the mmap system call). Apache will use the in-memory
contents for all subsequent accesses to this file.</p> contents for all subsequent accesses to this file.</p>
@ -505,11 +505,11 @@ sys 0m0.000s</pre></div>
<div class="example"><pre>MMapStatic /usr/local/apache2/htdocs/index.html</pre></div> <div class="example"><pre>MMapStatic /usr/local/apache2/htdocs/index.html</pre></div>
<p>As with the <p>As with the
<code class="directive"><a href="../mod/mod_file_cache.html#cachefile">CacheFile</a></code> directive, any <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> directive, any
changes in these files will not be picked up by Apache after it has changes in these files will not be picked up by Apache after it has
started.</p> started.</p>
<p> The <code class="directive"><a href="../mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code> <p> The <code class="directive"><a href="./mod/mod_file_cache.html#mmapstatic">MMapStatic</a></code>
directive does not keep track of how much memory it allocates, so directive does not keep track of how much memory it allocates, so
you must ensure not to over-use the directive. Each Apache child you must ensure not to over-use the directive. Each Apache child
process will replicate this memory, so it is critically important process will replicate this memory, so it is critically important
@ -520,10 +520,10 @@ sys 0m0.000s</pre></div>
<h3>mod_mem_cache Caching</h3> <h3>mod_mem_cache Caching</h3>
<p><code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> provides a HTTP-aware intelligent <p><code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code> provides a HTTP-aware intelligent
in-memory cache. It also uses heap memory directly, which means that in-memory cache. It also uses heap memory directly, which means that
even if <var>MMap</var> is not supported on your system, even if <var>MMap</var> is not supported on your system,
<code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> may still be able to perform caching.</p> <code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code> may still be able to perform caching.</p>
<p>Caching of this type is enabled via;</p> <p>Caching of this type is enabled via;</p>
@ -534,15 +534,15 @@ CacheEnable mem /
# Limit the size of the cache to 1 Megabyte # Limit the size of the cache to 1 Megabyte
MCacheSize 1024</pre></div> MCacheSize 1024</pre></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="disk" id="disk">Disk-based Caching</a></h2> <h2><a name="disk" id="disk">Disk-based Caching</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_disk_cache.html">mod_disk_cache</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.html#cachedisable">CacheDisable</a></code></li></ul></td></tr></table> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</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.html#cachedisable">CacheDisable</a></code></li></ul></td></tr></table>
<p><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> provides a disk-based caching mechanism <p><code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code> provides a disk-based caching mechanism
for <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>. As with <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> for <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>. As with <code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code>
this cache is intelligent and content will be served from the cache only this cache is intelligent and content will be served from the cache only
as long as it is considered valid.</p> as long as it is considered valid.</p>
@ -563,7 +563,7 @@ CacheDirLength 1</pre></div>
<h3>Understanding the Cache-Store</h3> <h3>Understanding the Cache-Store</h3>
<p>To store items in the cache, <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> creates <p>To store items in the cache, <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code> creates
a 22 character hash of the url being requested. Thie hash incorporates a 22 character hash of the url being requested. Thie hash incorporates
the hostname, protocol, port, path and any CGI arguments to the URL, the hostname, protocol, port, path and any CGI arguments to the URL,
to ensure that multiple URLs do not collide.</p> to ensure that multiple URLs do not collide.</p>
@ -573,13 +573,13 @@ CacheDirLength 1</pre></div>
be hashed to <code>xyTGxSMO2b68mBCykqkp1w</code>. This hash is used be hashed to <code>xyTGxSMO2b68mBCykqkp1w</code>. This hash is used
as a prefix for the naming of the files specific to that url within as a prefix for the naming of the files specific to that url within
the cache, however first it is split up into directories as per the cache, however first it is split up into directories as per
the <code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlevels">CacheDirLevels</a></code> and the <code class="directive"><a href="./mod/mod_disk_cache.html#cachedirlevels">CacheDirLevels</a></code> and
<code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code> <code class="directive"><a href="./mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code>
directives.</p> directives.</p>
<p><code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlevels">CacheDirLevels</a></code> <p><code class="directive"><a href="./mod/mod_disk_cache.html#cachedirlevels">CacheDirLevels</a></code>
specifies how many levels of subdirectory there should be, and specifies how many levels of subdirectory there should be, and
<code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code> <code class="directive"><a href="./mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code>
specifies how many characters should be in each directory. With specifies how many characters should be in each directory. With
the example settings given above, the hash would be turned into the example settings given above, the hash would be turned into
a filename prefix as a filename prefix as
@ -589,15 +589,15 @@ CacheDirLength 1</pre></div>
subdirectories or files that may be in a particular directory, subdirectories or files that may be in a particular directory,
as most file-systems slow down as this number increases. With as most file-systems slow down as this number increases. With
setting of "1" for setting of "1" for
<code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code> <code class="directive"><a href="./mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code>
there can at most be 64 subdirectories at any particular level. there can at most be 64 subdirectories at any particular level.
With a setting of 2 there can be 64 * 64 subdirectories, and so on. With a setting of 2 there can be 64 * 64 subdirectories, and so on.
Unless you have a good reason not to, using a setting of "1" Unless you have a good reason not to, using a setting of "1"
for <code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code> for <code class="directive"><a href="./mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code>
is recommended.</p> is recommended.</p>
<p>Setting <p>Setting
<code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlevels">CacheDirLevels</a></code> <code class="directive"><a href="./mod/mod_disk_cache.html#cachedirlevels">CacheDirLevels</a></code>
depends on how many files you anticipate to store in the cache. depends on how many files you anticipate to store in the cache.
With the setting of "2" used in the above example, a grand With the setting of "2" used in the above example, a grand
total of 4096 subdirectories can ultimately be created. With total of 4096 subdirectories can ultimately be created. With
@ -618,7 +618,7 @@ CacheDirLength 1</pre></div>
<h3>Maintaining the Disk Cache</h3> <h3>Maintaining the Disk Cache</h3>
<p>Although <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> will remove cached content <p>Although <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code> will remove cached content
as it is expired, it does not maintain any information on the total as it is expired, it does not maintain any information on the total
size of the cache or how little free space may be left.</p> size of the cache or how little free space may be left.</p>
@ -640,7 +640,7 @@ CacheDirLength 1</pre></div>
<a id="figure1" name="figure1"><dfn>Figure 1</dfn></a>: Typical <a id="figure1" name="figure1"><dfn>Figure 1</dfn></a>: Typical
cache growth / clean sequence.</p> cache growth / clean sequence.</p>
<p>Because <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> does not itself pay attention <p>Because <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code> does not itself pay attention
to how much space is used you should ensure that to how much space is used you should ensure that
<a href="programs/htcacheclean.html">htcacheclean</a> is configured to <a href="programs/htcacheclean.html">htcacheclean</a> is configured to
leave enough "grow room" following a clean.</p> leave enough "grow room" following a clean.</p>
@ -648,8 +648,8 @@ CacheDirLength 1</pre></div>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./caching.html" title="English">&nbsp;en&nbsp;</a></p> <p><span>Available Languages: </span><a href="./en/caching.html" title="English">&nbsp;en&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/caching.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>caching</basename> <basename>caching</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

78
docs/manual/configuring.html.en
View File

@ -6,54 +6,54 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Configuration Files - Apache HTTP Server</title> <title>Configuration Files - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Configuration Files</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Configuration Files</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./configuring.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./configuring.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/configuring.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./configuring.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./configuring.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This document describes the files used to configure the Apache <p>This document describes the files used to configure the Apache
HTTP server.</p> HTTP server.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#main">Main Configuration Files</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">Main Configuration Files</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#syntax">Syntax of the Configuration Files</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#syntax">Syntax of the Configuration Files</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#modules">Modules</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#modules">Modules</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#scope">Scope of Directives</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#scope">Scope of Directives</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">.htaccess Files</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#htaccess">.htaccess Files</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="main" id="main">Main Configuration Files</a></h2> <h2><a name="main" id="main">Main Configuration Files</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">&lt;IfDefine&gt;</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> <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">&lt;IfDefine&gt;</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>
<p>Apache is configured by placing <a href="mod/directives.html">directives</a> in plain text <p>Apache is configured by placing <a href="mod/directives.html">directives</a> in plain text
configuration files. The main configuration file is usually called configuration files. The main configuration file is usually called
<code>httpd.conf</code>. The location of this file is set at <code>httpd.conf</code>. The location of this file is set at
compile-time, but may be overridden with the <code>-f</code> compile-time, but may be overridden with the <code>-f</code>
command line flag. In addition, other configuration files may be command line flag. In addition, other configuration files may be
added using the <code class="directive"><a href="../mod/core.html#include">Include</a></code> added using the <code class="directive"><a href="./mod/core.html#include">Include</a></code>
directive, and wildcards can be used to include many configuration directive, and wildcards can be used to include many configuration
files. Any directive may be placed in any of these configuration files. Any directive may be placed in any of these configuration
files. Changes to the main configuration files are only files. Changes to the main configuration files are only
recognized by Apache when it is started or restarted.</p> recognized by Apache when it is started or restarted.</p>
<p>The server also reads a file containing mime document types; <p>The server also reads a file containing mime document types;
the filename is set by the <code class="directive"><a href="../mod/mod_mime.html#typesconfig">TypesConfig</a></code> directive, the filename is set by the <code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code> directive,
and is <code>mime.types</code> by default.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="syntax" id="syntax">Syntax of the Configuration Files</a></h2> <h2><a name="syntax" id="syntax">Syntax of the Configuration Files</a></h2>
@ -76,12 +76,12 @@ HTTP server.</p>
without starting the server by using <code>apachectl without starting the server by using <code>apachectl
configtest</code> or the <code>-t</code> command line configtest</code> or the <code>-t</code> command line
option.</p> option.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="modules" id="modules">Modules</a></h2> <h2><a name="modules" id="modules">Modules</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">&lt;IfModule&gt;</a></code></li><li><code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table> <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">&lt;IfModule&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>Apache is a modular server. This implies that only the most <p>Apache is a modular server. This implies that only the most
basic functionality is included in the core server. Extended basic functionality is included in the core server. Extended
@ -90,25 +90,25 @@ HTTP server.</p>
included in the server at compile-time. If the server is included in the server at compile-time. If the server is
compiled to use <a href="dso.html">dynamically loaded</a> compiled to use <a href="dso.html">dynamically loaded</a>
modules, then modules can be compiled separately and added at modules, then modules can be compiled separately and added at
any time using the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> any time using the <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
directive. directive.
Otherwise, Apache must be recompiled to add or remove modules. Otherwise, Apache must be recompiled to add or remove modules.
Configuration directives may be included conditional on a Configuration directives may be included conditional on a
presence of a particular module by enclosing them in an <code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> block.</p> presence of a particular module by enclosing them in an <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> block.</p>
<p>To see which modules are currently compiled into the server, <p>To see which modules are currently compiled into the server,
you can use the <code>-l</code> command line option.</p> you can use the <code>-l</code> command line option.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="scope" id="scope">Scope of Directives</a></h2> <h2><a name="scope" id="scope">Scope of Directives</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li></ul></td></tr></table> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li></ul></td></tr></table>
<p>Directives placed in the main configuration files apply to <p>Directives placed in the main configuration files apply to
the entire server. If you wish to change the configuration for the entire server. If you wish to change the configuration for
only a part of the server, you can scope your directives by only a part of the server, you can scope your directives by
placing them in <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="../mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>, <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>, <code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>, <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>, and <code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> placing them in <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>, <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>, and <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>
sections. These sections limit the application of the sections. These sections limit the application of the
directives which they enclose to particular filesystem directives which they enclose to particular filesystem
locations or URLs. They can also be nested, allowing for very locations or URLs. They can also be nested, allowing for very
@ -117,7 +117,7 @@ HTTP server.</p>
<p>Apache has the capability to serve many different websites <p>Apache has the capability to serve many different websites
simultaneously. This is called <a href="vhosts/">Virtual simultaneously. This is called <a href="vhosts/">Virtual
Hosting</a>. Directives can also be scoped by placing them Hosting</a>. Directives can also be scoped by placing them
inside <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> inside <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
sections, so that they will only apply to requests for a sections, so that they will only apply to requests for a
particular website.</p> particular website.</p>
@ -128,17 +128,17 @@ HTTP server.</p>
can be placed in which sections, check the <a href="mod/directive-dict.html#Context">Context</a> of the can be placed in which sections, check the <a href="mod/directive-dict.html#Context">Context</a> of the
directive. For further information, we provide details on <a href="sections.html">How Directory, Location and Files sections directive. For further information, we provide details on <a href="sections.html">How Directory, Location and Files sections
work</a>.</p> work</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="htaccess" id="htaccess">.htaccess Files</a></h2> <h2><a name="htaccess" id="htaccess">.htaccess Files</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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>
<p>Apache allows for decentralized management of configuration <p>Apache allows for decentralized management of configuration
via special files placed inside the web tree. The special files via special files placed inside the web tree. The special files
are usually called <code>.htaccess</code>, but any name can be are usually called <code>.htaccess</code>, but any name can be
specified in the <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code> specified in the <code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code>
directive. Directives placed in <code>.htaccess</code> files directive. Directives placed in <code>.htaccess</code> files
apply to the directory where you place the file, and all apply to the directory where you place the file, and all
sub-directories. The <code>.htaccess</code> files follow the sub-directories. The <code>.htaccess</code> files follow the
@ -150,18 +150,18 @@ HTTP server.</p>
<code>.htaccess</code> files, check the <a href="mod/directive-dict.html#Context">Context</a> of the <code>.htaccess</code> files, check the <a href="mod/directive-dict.html#Context">Context</a> of the
directive. The server administrator further controls what directive. The server administrator further controls what
directives may be placed in <code>.htaccess</code> files by directives may be placed in <code>.htaccess</code> files by
configuring the <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> configuring the <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
directive in the main configuration files.</p> directive in the main configuration files.</p>
<p>For more information on <code>.htaccess</code> files, see <p>For more information on <code>.htaccess</code> files, see
the <a href="howto/htaccess.html">.htaccess tutorial</a>.</p> the <a href="howto/htaccess.html">.htaccess tutorial</a>.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./configuring.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./configuring.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/configuring.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./configuring.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./configuring.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/configuring.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>configuring</basename> <basename>configuring</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>de</variant> <variant>de</variant>

88
docs/manual/content-negotiation.html.en
View File

@ -6,21 +6,21 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Content Negotiation - Apache HTTP Server</title> <title>Content Negotiation - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Content Negotiation</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Content Negotiation</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./content-negotiation.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/content-negotiation.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./content-negotiation.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
@ -33,21 +33,21 @@
incomplete negotiation information.</p> incomplete negotiation information.</p>
<p>Content negotiation is provided by the <p>Content negotiation is provided by the
<code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> module, which is compiled in <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> module, which is compiled in
by default.</p> by default.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#about">About Content Negotiation</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#about">About Content Negotiation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#negotiation">Negotiation in Apache</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#negotiation">Negotiation in Apache</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#methods">The Negotiation Methods</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#methods">The Negotiation Methods</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#better">Fiddling with Quality <li><img alt="" src="./images/down.gif" /> <a href="#better">Fiddling with Quality
Values</a></li> Values</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#extensions">Extensions to Transparent Content <li><img alt="" src="./images/down.gif" /> <a href="#extensions">Extensions to Transparent Content
Negotiation</a></li> Negotiation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#naming">Note on hyperlinks and naming conventions</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#naming">Note on hyperlinks and naming conventions</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#caching">Note on Caching</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#caching">Note on Caching</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#more">More Information</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#more">More Information</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="about" id="about">About Content Negotiation</a></h2> <h2><a name="about" id="about">About Content Negotiation</a></h2>
@ -102,7 +102,7 @@ Negotiation</a></li>
representations is termed a <strong>variant</strong>. The ways representations is termed a <strong>variant</strong>. The ways
in which the variants for a negotiable resource vary are called in which the variants for a negotiable resource vary are called
the <strong>dimensions</strong> of negotiation.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="negotiation" id="negotiation">Negotiation in Apache</a></h2> <h2><a name="negotiation" id="negotiation">Negotiation in Apache</a></h2>
@ -124,7 +124,7 @@ Negotiation</a></li>
<p>A type map is a document which is associated with the handler <p>A type map is a document which is associated with the handler
named <code>type-map</code> (or, for backwards-compatibility with named <code>type-map</code> (or, for backwards-compatibility with
older Apache configurations, the <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME-type</a> older Apache configurations, the <a class="glossarylink" href="./glossary.html#mime-type" title="see glossary">MIME-type</a>
<code>application/x-type-map</code>). Note that to use this <code>application/x-type-map</code>). Note that to use this
feature, you must have a handler set in the configuration that feature, you must have a handler set in the configuration that
defines a file suffix as <code>type-map</code>; this is best done defines a file suffix as <code>type-map</code>; this is best done
@ -196,9 +196,9 @@ Negotiation</a></li>
<h3><a name="multiviews" id="multiviews">Multiviews</a></h3> <h3><a name="multiviews" id="multiviews">Multiviews</a></h3>
<p><code>MultiViews</code> is a per-directory option, meaning it <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> can be set with an <code class="directive"><a href="./mod/core.html#options">Options</a></code>
directive within a <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> or <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code> section in directive within a <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code> or <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code> section in
<code>httpd.conf</code>, or (if <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> is properly set) in <code>httpd.conf</code>, or (if <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> is properly set) in
<code>.htaccess</code> files. Note that <code>Options All</code> <code>.htaccess</code> files. Note that <code>Options All</code>
does not set <code>MultiViews</code>; you have to ask for it by does not set <code>MultiViews</code>; you have to ask for it by
name.</p> name.</p>
@ -214,7 +214,7 @@ Negotiation</a></li>
then chooses the best match to the client's requirements.</p> then chooses the best match to the client's requirements.</p>
<p><code>MultiViews</code> may also apply to searches for the file <p><code>MultiViews</code> may also apply to searches for the file
named by the <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> directive, if the named by the <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> directive, if the
server is trying to index a directory. If the configuration files server is trying to index a directory. If the configuration files
specify</p> specify</p>
<div class="example"><p><code>DirectoryIndex index</code></p></div> <div class="example"><p><code>DirectoryIndex index</code></p></div>
@ -226,11 +226,11 @@ Negotiation</a></li>
<p>If one of the files found when reading the directory does not <p>If one of the files found when reading the directory does not
have an extension recognized by <code>mod_mime</code> to designate have an extension recognized by <code>mod_mime</code> to designate
its Charset, Content-Type, Language, or Encoding, then the result its Charset, Content-Type, Language, or Encoding, then the result
depends on the setting of the <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code> directive. This depends on the setting of the <code class="directive"><a href="./mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code> directive. This
directive determines whether handlers, filters, and other directive determines whether handlers, filters, and other
extension types can participate in MultiViews negotiation.</p> extension types can participate in MultiViews negotiation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="methods" id="methods">The Negotiation Methods</a></h2> <h2><a name="methods" id="methods">The Negotiation Methods</a></h2>
@ -396,7 +396,7 @@ Negotiation</a></li>
indicate the dimensions of variance.</li> indicate the dimensions of variance.</li>
</ol> </ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="better" id="better">Fiddling with Quality <h2><a name="better" id="better">Fiddling with Quality
Values</a></h2> Values</a></h2>
@ -464,10 +464,10 @@ Negotiation</a></li>
these error messages, it is possible to configure Apache to ignore these error messages, it is possible to configure Apache to ignore
the <code>Accept-language</code> in these cases and provide a the <code>Accept-language</code> in these cases and provide a
document that does not explicitly match the client's request. The document that does not explicitly match the client's request. The
<code class="directive"><a href="../mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code> <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
directive can be used to override one or both of these error directive can be used to override one or both of these error
messages and substitute the servers judgement in the form of the messages and substitute the servers judgement in the form of the
<code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code> <code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
directive.</p> directive.</p>
<p>The server will also attempt to match language-subsets when no <p>The server will also attempt to match language-subsets when no
@ -482,7 +482,7 @@ Negotiation</a></li>
English in general. Unfortunately, many current clients have English in general. Unfortunately, many current clients have
default configurations that resemble this.) However, if no other default configurations that resemble this.) However, if no other
language match is possible and the server is about to return a "No language match is possible and the server is about to return a "No
Acceptable Variants" error or fallback to the <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>, the server Acceptable Variants" error or fallback to the <code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>, the server
will ignore the subset specification and match <code>en-GB</code> will ignore the subset specification and match <code>en-GB</code>
against <code>en</code> documents. Implicitly, Apache will add against <code>en</code> documents. Implicitly, Apache will add
the parent language to the client's acceptable language list with the parent language to the client's acceptable language list with
@ -495,10 +495,10 @@ Negotiation</a></li>
<p>In order to support advanced techniques (such as cookies or <p>In order to support advanced techniques (such as cookies or
special URL-paths) to determine the user's preferred language, special URL-paths) to determine the user's preferred language,
since Apache 2.0.47 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> recognizes since Apache 2.0.47 <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> recognizes
the <a href="env.html">environment variable</a> the <a href="env.html">environment variable</a>
<code>prefer-language</code>. If it exists and contains an <code>prefer-language</code>. If it exists and contains an
appropriate language tag, <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> will appropriate language tag, <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> will
try to select a matching variant. If there's no such variant, try to select a matching variant. If there's no such variant,
the normal negotiation process applies.</p> the normal negotiation process applies.</p>
@ -507,7 +507,7 @@ Negotiation</a></li>
Header append Vary cookie Header append Vary cookie
</code></p></div> </code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="extensions" id="extensions">Extensions to Transparent Content <h2><a name="extensions" id="extensions">Extensions to Transparent Content
Negotiation</a></h2> Negotiation</a></h2>
@ -521,7 +521,7 @@ to use them as candidate variants whenever their encodings are
acceptable according to the <code>Accept-Encoding</code> request acceptable according to the <code>Accept-Encoding</code> request
header. The RVSA/1.0 implementation does not round computed quality header. The RVSA/1.0 implementation does not round computed quality
factors to 5 decimal places before choosing the best variant.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="naming" id="naming">Note on hyperlinks and naming conventions</a></h2> <h2><a name="naming" id="naming">Note on hyperlinks and naming conventions</a></h2>
@ -631,7 +631,7 @@ factors to 5 decimal places before choosing the best variant.</p>
extension (including an encoding extension if there is one) extension (including an encoding extension if there is one)
must be on the right hand side of the MIME-type extension must be on the right hand side of the MIME-type extension
(<em>e.g.</em>, <code>foo.html.en</code>).</p> (<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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="caching" id="caching">Note on Caching</a></h2> <h2><a name="caching" id="caching">Note on Caching</a></h2>
@ -647,7 +647,7 @@ factors to 5 decimal places before choosing the best variant.</p>
responses.</p> responses.</p>
<p>For requests which come from a HTTP/1.0 compliant client <p>For requests which come from a HTTP/1.0 compliant client
(either a browser or a cache), the directive <code class="directive"><a href="../mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code> can be (either a browser or a cache), the directive <code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code> can be
used to allow caching of responses which were subject to used to allow caching of responses which were subject to
negotiation. This directive can be given in the server config or negotiation. This directive can be given in the server config or
virtual host, and takes no arguments. It has no effect on requests virtual host, and takes no arguments. It has no effect on requests
@ -660,7 +660,7 @@ factors to 5 decimal places before choosing the best variant.</p>
encourage a cache to use the local copy regardless of the encourage a cache to use the local copy regardless of the
negotiation dimensions, set the <code>force-no-vary</code> <a href="env.html#special">environment variable</a>.</p> negotiation dimensions, set the <code>force-no-vary</code> <a href="env.html#special">environment variable</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="more" id="more">More Information</a></h2> <h2><a name="more" id="more">More Information</a></h2>
@ -670,10 +670,10 @@ factors to 5 decimal places before choosing the best variant.</p>
updated to include changes in Apache 2.0.</p> updated to include changes in Apache 2.0.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./content-negotiation.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/content-negotiation.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./content-negotiation.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/content-negotiation.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>content-negotiation</basename> <basename>content-negotiation</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

52
docs/manual/custom-error.html.en
View File

@ -6,22 +6,22 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Custom Error Responses - Apache HTTP Server</title> <title>Custom Error Responses - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Custom Error Responses</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Custom Error Responses</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./custom-error.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/custom-error.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>Additional functionality allows webmasters to configure the response <p>Additional functionality allows webmasters to configure the response
@ -34,11 +34,11 @@
then this response can be replaced with either some friendlier text or by then this response can be replaced with either some friendlier text or by
a redirection to another URL (local or external).</p> a redirection to another URL (local or external).</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#behavior">Behavior</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">Behavior</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuration">Configuration</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#custom">Custom Error Responses and Redirects</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#custom">Custom Error Responses and Redirects</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="behavior" id="behavior">Behavior</a></h2> <h2><a name="behavior" id="behavior">Behavior</a></h2>
@ -94,19 +94,19 @@
new URL (assuming it's a cgi-script or a cgi-include). The new URL (assuming it's a cgi-script or a cgi-include). The
other variables will exist only if they existed prior to other variables will exist only if they existed prior to
the error/problem. <strong>None</strong> of these will be the error/problem. <strong>None</strong> of these will be
set if your <code class="directive"><a href="../mod/core.html#errordocument">ErrorDocument</a></code> is an set if your <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> is an
<em>external</em> redirect (anything starting with a <em>external</em> redirect (anything starting with a
scheme name like <code>http:</code>, even if it refers to the same host scheme name like <code>http:</code>, even if it refers to the same host
as the server).</p> as the server).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="configuration" id="configuration">Configuration</a></h2> <h2><a name="configuration" id="configuration">Configuration</a></h2>
<p>Use of <code class="directive"><a href="../mod/core.html#errordocument">ErrorDocument</a></code> is enabled <p>Use of <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> is enabled
for .htaccess files when the for .htaccess files when the
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> is set accordingly.</p> <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> is set accordingly.</p>
<p>Here are some examples...</p> <p>Here are some examples...</p>
@ -135,7 +135,7 @@
<li>A local URL to redirect to.</li> <li>A local URL to redirect to.</li>
</ol> </ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="custom" id="custom">Custom Error Responses and Redirects</a></h2> <h2><a name="custom" id="custom">Custom Error Responses and Redirects</a></h2>
@ -194,11 +194,11 @@
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./custom-error.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/custom-error.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/custom-error.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>custom-error</basename> <basename>custom-error</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

64
docs/manual/dns-caveats.html.en
View File

@ -6,21 +6,21 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Issues Regarding DNS and Apache - Apache HTTP Server</title> <title>Issues Regarding DNS and Apache - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Issues Regarding DNS and Apache</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Issues Regarding DNS and Apache</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./dns-caveats.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/dns-caveats.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./dns-caveats.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This page could be summarized with the statement: don't <p>This page could be summarized with the statement: don't
@ -31,13 +31,13 @@
or denial and theft of service attacks (including users able or denial and theft of service attacks (including users able
to steal hits from other users).</p> to steal hits from other users).</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#example">A Simple Example</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#example">A Simple Example</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#denial">Denial of Service</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#denial">Denial of Service</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#main">The "main server" Address</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#main">The "main server" Address</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#tips">Tips to Avoid These Problems</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#tips">Tips to Avoid These Problems</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#appendix">Appendix: Future Directions</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#appendix">Appendix: Future Directions</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="example" id="example">A Simple Example</a></h2> <h2><a name="example" id="example">A Simple Example</a></h2>
@ -51,7 +51,7 @@
<p>In order for Apache to function properly, it absolutely needs <p>In order for Apache to function properly, it absolutely needs
to have two pieces of information about each virtual host: the to have two pieces of information about each virtual host: the
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> and at least one <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> and at least one
IP address that the server will bind and respond to. The above IP address that the server will bind and respond to. The above
example does not include the IP address, so Apache must use DNS example does not include the IP address, so Apache must use DNS
to find the address of <code>www.abc.dom</code>. If for some to find the address of <code>www.abc.dom</code>. If for some
@ -90,7 +90,7 @@
DocumentRoot /www/abc <br /> DocumentRoot /www/abc <br />
&lt;/VirtualHost&gt; &lt;/VirtualHost&gt;
</code></p></div> </code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="denial" id="denial">Denial of Service</a></h2> <h2><a name="denial" id="denial">Denial of Service</a></h2>
@ -142,16 +142,16 @@
this happens requires a more in-depth discussion of how Apache this happens requires a more in-depth discussion of how Apache
matches up incoming requests with the virtual host that will matches up incoming requests with the virtual host that will
serve it. A rough document describing this <a href="vhosts/details.html">is available</a>.</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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="main" id="main">The "main server" Address</a></h2> <h2><a name="main" id="main">The "main server" Address</a></h2>
<p>The addition of <a href="vhosts/name-based.html">name-based <p>The addition of <a href="vhosts/name-based.html">name-based
virtual host support</a> in Apache 1.1 requires Apache to know virtual host support</a> in Apache 1.1 requires Apache to know
the IP address(es) of the host that <code class="program"><a href="../programs/httpd.html">httpd</a></code> the IP address(es) of the host that <code class="program"><a href="./programs/httpd.html">httpd</a></code>
is running on. To get this address it uses either the global is running on. To get this address it uses either the global
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
(if present) or calls the C function <code>gethostname</code> (if present) or calls the C function <code>gethostname</code>
(which should return the same as typing "hostname" at the (which should return the same as typing "hostname" at the
command prompt). Then it performs a DNS lookup on this address. command prompt). Then it performs a DNS lookup on this address.
@ -171,9 +171,9 @@
with the <code>HOSTRESORDER</code> environment variable set to with the <code>HOSTRESORDER</code> environment variable set to
"local". This all depends on what OS and resolver libraries you "local". This all depends on what OS and resolver libraries you
are using. It also affects CGIs unless you use are using. It also affects CGIs unless you use
<code class="module"><a href="../mod/mod_env.html">mod_env</a></code> to control the environment. It's best <code class="module"><a href="./mod/mod_env.html">mod_env</a></code> to control the environment. It's best
to consult the man pages or FAQs for your OS.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="tips" id="tips">Tips to Avoid These Problems</a></h2> <h2><a name="tips" id="tips">Tips to Avoid These Problems</a></h2>
@ -181,23 +181,23 @@
<ul> <ul>
<li> <li>
use IP addresses in use IP addresses in
<code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code>
</li> </li>
<li> <li>
use IP addresses in use IP addresses in
<code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
</li> </li>
<li> <li>
ensure all virtual hosts have an explicit ensure all virtual hosts have an explicit
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
</li> </li>
<li>create a <code>&lt;VirtualHost _default_:*&gt;</code> <li>create a <code>&lt;VirtualHost _default_:*&gt;</code>
server that has no pages to serve</li> server that has no pages to serve</li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="appendix" id="appendix">Appendix: Future Directions</a></h2> <h2><a name="appendix" id="appendix">Appendix: Future Directions</a></h2>
@ -234,10 +234,10 @@
webservers.</p> webservers.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./dns-caveats.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/dns-caveats.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./dns-caveats.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/dns-caveats.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>dns-caveats</basename> <basename>dns-caveats</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

80
docs/manual/dso.html.en
View File

@ -6,77 +6,77 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Dynamic Shared Object (DSO) Support - Apache HTTP Server</title> <title>Dynamic Shared Object (DSO) Support - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Dynamic Shared Object (DSO) Support</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Dynamic Shared Object (DSO) Support</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./dso.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/dso.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./dso.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./dso.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>The Apache HTTP Server is a modular program where the <p>The Apache HTTP Server is a modular program where the
administrator can choose the functionality to include in the administrator can choose the functionality to include in the
server by selecting a set of modules. The modules can be server by selecting a set of modules. The modules can be
statically compiled into the <code class="program"><a href="../programs/httpd.html">httpd</a></code> binary when the statically compiled into the <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary when the
server is built. Alternatively, modules can be compiled as server is built. Alternatively, modules can be compiled as
Dynamic Shared Objects (DSOs) that exist separately from the Dynamic Shared Objects (DSOs) that exist separately from the
main <code class="program"><a href="../programs/httpd.html">httpd</a></code> binary file. DSO modules may be main <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary file. DSO modules may be
compiled at the time the server is built, or they may be compiled at the time the server is built, or they may be
compiled and added at a later time using the Apache Extension compiled and added at a later time using the Apache Extension
Tool (<code class="program"><a href="../programs/apxs.html">apxs</a></code>).</p> Tool (<code class="program"><a href="./programs/apxs.html">apxs</a></code>).</p>
<p>This document describes how to use DSO modules as well as <p>This document describes how to use DSO modules as well as
the theory behind their use.</p> the theory behind their use.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#implementation">Implementation</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation">Implementation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#usage">Usage Summary</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#usage">Usage Summary</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#background">Background</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#background">Background</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#advantages">Advantages and Disadvantages</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#advantages">Advantages and Disadvantages</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="implementation" id="implementation">Implementation</a></h2> <h2><a name="implementation" id="implementation">Implementation</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> <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>
<p>The DSO support for loading individual Apache modules is based <p>The DSO support for loading individual Apache modules is based
on a module named <code class="module"><a href="../mod/mod_so.html">mod_so</a></code> which must be statically on a module named <code class="module"><a href="./mod/mod_so.html">mod_so</a></code> which must be statically
compiled into the Apache core. It is the only module besides compiled into the Apache core. It is the only module besides
<code class="module"><a href="../mod/core.html">core</a></code> which cannot be put into a DSO <code class="module"><a href="./mod/core.html">core</a></code> which cannot be put into a DSO
itself. Practically all other distributed Apache modules can then itself. Practically all other distributed Apache modules can then
be placed into a DSO by individually enabling the DSO build for be placed into a DSO by individually enabling the DSO build for
them via <code class="program"><a href="../programs/configure.html">configure</a></code>'s them via <code class="program"><a href="./programs/configure.html">configure</a></code>'s
<code>--enable-<em>module</em>=shared</code> option as discussed <code>--enable-<em>module</em>=shared</code> option as discussed
in the <a href="install.html">install documentation</a>. After a in the <a href="install.html">install documentation</a>. After a
module is compiled into a DSO named <code>mod_foo.so</code> you module is compiled into a DSO named <code>mod_foo.so</code> you
can use <code class="module"><a href="../mod/mod_so.html">mod_so</a></code>'s <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> command in your can use <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>'s <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> command in your
<code>httpd.conf</code> file to load this module at server startup <code>httpd.conf</code> file to load this module at server startup
or restart.</p> or restart.</p>
<p>To simplify this creation of DSO files for Apache modules <p>To simplify this creation of DSO files for Apache modules
(especially for third-party modules) a new support program (especially for third-party modules) a new support program
named <code class="program"><a href="../programs/apxs.html">apxs</a></code> (<dfn>APache named <code class="program"><a href="./programs/apxs.html">apxs</a></code> (<dfn>APache
eXtenSion</dfn>) is available. It can be used to build DSO based eXtenSion</dfn>) is available. It can be used to build DSO based
modules <em>outside of</em> the Apache source tree. The idea is modules <em>outside of</em> the Apache source tree. The idea is
simple: When installing Apache the <code class="program"><a href="../programs/configure.html">configure</a></code>'s simple: When installing Apache the <code class="program"><a href="./programs/configure.html">configure</a></code>'s
<code>make install</code> procedure installs the Apache C <code>make install</code> procedure installs the Apache C
header files and puts the platform-dependent compiler and header files and puts the platform-dependent compiler and
linker flags for building DSO files into the <code class="program"><a href="../programs/apxs.html">apxs</a></code> linker flags for building DSO files into the <code class="program"><a href="./programs/apxs.html">apxs</a></code>
program. This way the user can use <code class="program"><a href="../programs/apxs.html">apxs</a></code> to compile program. This way the user can use <code class="program"><a href="./programs/apxs.html">apxs</a></code> to compile
his Apache module sources without the Apache distribution his Apache module sources without the Apache distribution
source tree and without having to fiddle with the source tree and without having to fiddle with the
platform-dependent compiler and linker flags for DSO platform-dependent compiler and linker flags for DSO
support.</p> support.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="usage" id="usage">Usage Summary</a></h2> <h2><a name="usage" id="usage">Usage Summary</a></h2>
@ -123,7 +123,7 @@ $ make install
Build and install a <em>third-party</em> Apache module, say Build and install a <em>third-party</em> Apache module, say
<code>mod_foo.c</code>, into its own DSO <code>mod_foo.c</code>, into its own DSO
<code>mod_foo.so</code> <em>outside of</em> the Apache <code>mod_foo.so</code> <em>outside of</em> the Apache
source tree using <code class="program"><a href="../programs/apxs.html">apxs</a></code>: source tree using <code class="program"><a href="./programs/apxs.html">apxs</a></code>:
<div class="example"><p><code> <div class="example"><p><code>
$ cd /path/to/3rdparty<br /> $ cd /path/to/3rdparty<br />
@ -134,10 +134,10 @@ $ apxs -i -a -n foo mod_foo.la
</ol> </ol>
<p>In all cases, once the shared module is compiled, you must <p>In all cases, once the shared module is compiled, you must
use a <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> use a <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
directive in <code>httpd.conf</code> to tell Apache to activate directive in <code>httpd.conf</code> to tell Apache to activate
the module.</p> the module.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="background" id="background">Background</a></h2> <h2><a name="background" id="background">Background</a></h2>
@ -239,7 +239,7 @@ $ apxs -i -a -n foo mod_foo.la
modules into the Apache core functionality. So, Apache is modules into the Apache core functionality. So, Apache is
really predestined for using DSO to load its modules at really predestined for using DSO to load its modules at
run-time.</p> run-time.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="advantages" id="advantages">Advantages and Disadvantages</a></h2> <h2><a name="advantages" id="advantages">Advantages and Disadvantages</a></h2>
@ -249,9 +249,9 @@ $ apxs -i -a -n foo mod_foo.la
<ul> <ul>
<li>The server package is more flexible at run-time because <li>The server package is more flexible at run-time because
the actual server process can be assembled at run-time via the actual server process can be assembled at run-time via
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
<code>httpd.conf</code> configuration commands instead of <code>httpd.conf</code> configuration commands instead of
<code class="program"><a href="../programs/configure.html">configure</a></code> options at build-time. For instance <code class="program"><a href="./programs/configure.html">configure</a></code> options at build-time. For instance
this way one is able to run different server instances this way one is able to run different server instances
(standard &amp; SSL version, minimalistic &amp; powered up (standard &amp; SSL version, minimalistic &amp; powered up
version [mod_perl, PHP3], <em>etc.</em>) with only one Apache version [mod_perl, PHP3], <em>etc.</em>) with only one Apache
@ -265,7 +265,7 @@ $ apxs -i -a -n foo mod_foo.la
<em>etc.</em></li> <em>etc.</em></li>
<li>Easier Apache module prototyping because with the <li>Easier Apache module prototyping because with the
DSO/<code class="program"><a href="../programs/apxs.html">apxs</a></code> pair you can both work outside the DSO/<code class="program"><a href="./programs/apxs.html">apxs</a></code> pair you can both work outside the
Apache source tree and only need an <code>apxs -i</code> Apache source tree and only need an <code>apxs -i</code>
command followed by an <code>apachectl restart</code> to command followed by an <code>apachectl restart</code> to
bring a new version of your currently developed module into bring a new version of your currently developed module into
@ -306,10 +306,10 @@ $ apxs -i -a -n foo mod_foo.la
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./dso.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/dso.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./dso.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./dso.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/dso.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>dso</basename> <basename>dso</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

92
docs/manual/env.html.en
View File

@ -6,21 +6,21 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Environment Variables in Apache - Apache HTTP Server</title> <title>Environment Variables in Apache - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Environment Variables in Apache</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Environment Variables in Apache</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./env.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/env.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./env.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./env.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>The Apache HTTP Server provides a mechanism for storing <p>The Apache HTTP Server provides a mechanism for storing
@ -43,24 +43,24 @@
manipulation mechanisms provided by your operating system manipulation mechanisms provided by your operating system
shell.</p> shell.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#setting">Setting Environment Variables</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#setting">Setting Environment Variables</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using">Using Environment Variables</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#using">Using Environment Variables</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#special">Special Purpose Environment Variables</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#special">Special Purpose Environment Variables</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#examples">Examples</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="setting" id="setting">Setting Environment Variables</a></h2> <h2><a name="setting" id="setting">Setting Environment Variables</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_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> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><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><a name="basic-manipulation" id="basic-manipulation">Basic Environment Manipulation</a></h3>
<p>The most basic way to set an environment variable in Apache <p>The most basic way to set an environment variable in Apache
is using the unconditional <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code> directive. Variables may also be passed from is using the unconditional <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> directive. Variables may also be passed from
the environment of the shell which started the server using the the environment of the shell which started the server using the
<code class="directive"><a href="../mod/mod_env.html#passenv">PassEnv</a></code> directive.</p> <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><a name="conditional" id="conditional">Conditional Per-Request Settings</a></h3>
@ -72,7 +72,7 @@
requests. For example, a variable could be set only when a requests. For example, a variable could be set only when a
specific browser (User-Agent) is making a request, or only when specific browser (User-Agent) is making a request, or only when
a specific Referer [sic] header is found. Even more flexibility a specific Referer [sic] header is found. Even more flexibility
is available through the mod_rewrite's <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> which uses the is available through the mod_rewrite's <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> which uses the
<code>[E=...]</code> option to set environment variables.</p> <code>[E=...]</code> option to set environment variables.</p>
@ -103,7 +103,7 @@
<li>It is not possible to override or change the standard CGI <li>It is not possible to override or change the standard CGI
variables using the environment manipulation directives.</li> variables using the environment manipulation directives.</li>
<li>When <code class="program"><a href="../programs/suexec.html">suexec</a></code> is used to launch <li>When <code class="program"><a href="./programs/suexec.html">suexec</a></code> is used to launch
CGI scripts, the environment will be cleaned down to a set of CGI scripts, the environment will be cleaned down to a set of
<em>safe</em> variables before CGI scripts are launched. The <em>safe</em> variables before CGI scripts are launched. The
list of <em>safe</em> variables is defined at compile-time in list of <em>safe</em> variables is defined at compile-time in
@ -117,12 +117,12 @@
CGI scripts and SSI pages.</li> CGI scripts and SSI pages.</li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="using" id="using">Using Environment Variables</a></h2> <h2><a name="using" id="using">Using Environment Variables</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_host.html#allow">Allow</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_authz_host.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> <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_host.html#allow">Allow</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_authz_host.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>
<h3><a name="cgi-scripts" id="cgi-scripts">CGI Scripts</a></h3> <h3><a name="cgi-scripts" id="cgi-scripts">CGI Scripts</a></h3>
@ -153,7 +153,7 @@
<p>Access to the server can be controlled based on the value of <p>Access to the server can be controlled based on the value of
environment variables using the <code>allow from env=</code> environment variables using the <code>allow from env=</code>
and <code>deny from env=</code> directives. In combination with and <code>deny from env=</code> directives. In combination with
<code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, this <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, this
allows for flexible control of access to the server based on allows for flexible control of access to the server based on
characteristics of the client. For example, you can use these characteristics of the client. For example, you can use these
directives to deny access to a particular browser (User-Agent). directives to deny access to a particular browser (User-Agent).
@ -164,12 +164,12 @@
<p>Environment variables can be logged in the access log using <p>Environment variables can be logged in the access log using
the <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> the <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
option <code>%e</code>. In addition, the decision on whether option <code>%e</code>. In addition, the decision on whether
or not to log requests can be made based on the status of or not to log requests can be made based on the status of
environment variables using the conditional form of the environment variables using the conditional form of the
<code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
directive. In combination with <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> this allows for flexible control of which directive. In combination with <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> this allows for flexible control of which
requests are logged. For example, you can choose not to log requests are logged. For example, you can choose not to log
requests for filenames ending in <code>gif</code>, or you can requests for filenames ending in <code>gif</code>, or you can
choose to only log requests from clients which are outside your choose to only log requests from clients which are outside your
@ -179,7 +179,7 @@
<h3><a name="response-headers" id="response-headers">Conditional Response Headers</a></h3> <h3><a name="response-headers" id="response-headers">Conditional Response Headers</a></h3>
<p>The <code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code> <p>The <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
directive can use the presence or directive can use the presence or
absence of an environment variable to determine whether or not absence of an environment variable to determine whether or not
a certain HTTP header will be placed in the response to the a certain HTTP header will be placed in the response to the
@ -192,8 +192,8 @@
<h3><a name="external-filter" id="external-filter">External Filter Activation</a></h3> <h3><a name="external-filter" id="external-filter">External Filter Activation</a></h3>
<p>External filters configured by <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> <p>External filters configured by <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>
using the <code class="directive"><a href="../mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code> directive can using the <code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code> directive can
by activated conditional on an environment variable using the by activated conditional on an environment variable using the
<code>disableenv=</code> and <code>enableenv=</code> options.</p> <code>disableenv=</code> and <code>enableenv=</code> options.</p>
@ -202,7 +202,7 @@
<p>The <code>%{ENV:...}</code> form of <em>TestString</em> in <p>The <code>%{ENV:...}</code> form of <em>TestString</em> in
the <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> the <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
allows mod_rewrite's rewrite allows mod_rewrite's rewrite
engine to make decisions conditional on environment variables. engine to make decisions conditional on environment variables.
Note that the variables accessible in mod_rewrite without the Note that the variables accessible in mod_rewrite without the
@ -210,7 +210,7 @@
variables. Rather, they are variables special to mod_rewrite variables. Rather, they are variables special to mod_rewrite
which cannot be accessed from other modules.</p> which cannot be accessed from other modules.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="special" id="special">Special Purpose Environment Variables</a></h2> <h2><a name="special" id="special">Special Purpose Environment Variables</a></h2>
@ -219,7 +219,7 @@
mechanisms to modify the way Apache behaves when talking to mechanisms to modify the way Apache behaves when talking to
particular clients. To make these mechanisms as flexible as particular clients. To make these mechanisms as flexible as
possible, they are invoked by defining environment variables, 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> 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><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
@ -259,9 +259,9 @@
<p>When set to a value of "1", this variable disables the DEFLATE <p>When set to a value of "1", this variable disables the DEFLATE
output filter provided by <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> for output filter provided by <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> for
content-types other than <code>text/html</code>. If you'd rather content-types other than <code>text/html</code>. If you'd rather
use statically compressed files; <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> use statically compressed files; <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
evaluates the variable as well (not only for gzip, but for all evaluates the variable as well (not only for gzip, but for all
encodings that differ from "identity").</p> encodings that differ from "identity").</p>
@ -269,8 +269,8 @@
<h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3> <h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
<p>When set, the <code>DEFLATE</code> filter of <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 <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> will be turned off and
<code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> will refuse to deliver encoded <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> will refuse to deliver encoded
resources.</p> resources.</p>
@ -278,16 +278,16 @@
<h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3> <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
<p>This disables <code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code> <p>This disables <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
when set.</p> when set.</p>
<h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3> <h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
<p>This influences <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>'s behaviour. If <p>This influences <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>'s behaviour. If
it contains a language tag (such as <code>en</code>, <code>ja</code> it contains a language tag (such as <code>en</code>, <code>ja</code>
or <code>x-klingon</code>), <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> tries or <code>x-klingon</code>), <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> tries
to deliver a variant with that language. If there's no such variant, to deliver a variant with that language. If there's no such variant,
the normal <a href="content-negotiation.html">negotiation</a> process the normal <a href="content-negotiation.html">negotiation</a> process
applies.</p> applies.</p>
@ -329,11 +329,11 @@
<h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked, proxy-sendcl</a></h3> <h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked, proxy-sendcl</a></h3>
<p>These directives alter the protocol behavior of <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> <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>
documentation for more details.</p> documentation for more details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="examples" id="examples">Examples</a></h2> <h2><a name="examples" id="examples">Examples</a></h2>
@ -405,10 +405,10 @@ SetEnvIf Referer "^$" local_referal
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./env.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/env.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./env.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./env.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/env.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>env</basename> <basename>env</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

86
docs/manual/filter.html.en
View File

@ -6,36 +6,36 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Filters - Apache HTTP Server</title> <title>Filters - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Filters</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Filters</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./filter.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/filter.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./filter.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/filter.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../fr/./filter.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./filter.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./filter.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This document describes the use of filters in Apache.</p> <p>This document describes the use of filters in Apache.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Filtering in Apache 2</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#intro">Filtering in Apache 2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#smart">Smart Filtering</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#smart">Smart Filtering</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using">Using Filters</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#using">Using Filters</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="intro" id="intro">Filtering in Apache 2</a></h2> <h2><a name="intro" id="intro">Filtering in Apache 2</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></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_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> <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></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_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>
<p>The Filter Chain is available in Apache 2.0 and higher, <p>The Filter Chain is available in Apache 2.0 and higher,
and enables applications to process incoming and outgoing data and enables applications to process incoming and outgoing data
@ -48,11 +48,11 @@ independent of the traditional request processing phases.</p>
</p> </p>
<p>Some examples of filtering in the standard Apache distribution are:</p> <p>Some examples of filtering in the standard Apache distribution are:</p>
<ul> <ul>
<li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, implements server-side includes.</li> <li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, implements server-side includes.</li>
<li><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>, implements SSL encryption (https).</li> <li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, implements SSL encryption (https).</li>
<li><code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>, implements compression/decompression on the fly.</li> <li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>, implements compression/decompression on the fly.</li>
<li><code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>, transcodes between different character sets.</li> <li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>, transcodes between different character sets.</li>
<li><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>, runs an external program as a filter.</li> <li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>, runs an external program as a filter.</li>
</ul> </ul>
<p>Apache also uses a number of filters internally to perform <p>Apache also uses a number of filters internally to perform
functions like chunking and byte-range handling.</p> functions like chunking and byte-range handling.</p>
@ -70,14 +70,14 @@ elsewhere. A few of these are:</p>
<li>Protection of vulnerable applications such as PHP scripts</li> <li>Protection of vulnerable applications such as PHP scripts</li>
<li>Text search-and-replace editing</li> <li>Text search-and-replace editing</li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="smart" id="smart">Smart Filtering</a></h2> <h2><a name="smart" id="smart">Smart Filtering</a></h2>
<p class="figure"> <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" /> <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" />
</p> </p>
<p><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>, included in Apache 2.1 and later, <p><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, included in Apache 2.1 and later,
enables the filter chain to be configured dynamically at run time. enables the filter chain to be configured dynamically at run time.
So for example you can set up a proxy to rewrite So for example you can set up a proxy to rewrite
HTML with an HTML filter and JPEG images with a completely HTML with an HTML filter and JPEG images with a completely
@ -95,7 +95,7 @@ compressible type and not already compressed</li>
<li>A charset conversion filter will be inserted if a text <li>A charset conversion filter will be inserted if a text
document is not already in the desired charset</li> document is not already in the desired charset</li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="using" id="using">Using Filters</a></h2> <h2><a name="using" id="using">Using Filters</a></h2>
@ -106,32 +106,32 @@ can be mixed freely with either simple or dynamic Output filtering).</p>
<p>The Simple Way is the only way to configure input filters, and is <p>The Simple Way is the only way to configure input filters, and is
sufficient for output filters where you need a static filter chain. sufficient for output filters where you need a static filter chain.
Relevant directives are Relevant directives are
<code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>,
<code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>, <code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
<code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>, <code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>,
<code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>, <code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>,
<code class="directive"><a href="../mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code>, and <code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code>, and
<code class="directive"><a href="../mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>.</p> <code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>.</p>
<p>The Dynamic Way enables both static and flexible, dynamic configuration <p>The Dynamic Way enables both static and flexible, dynamic configuration
of output filters, as discussed in the <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> page. of output filters, as discussed in the <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> page.
Relevant directives are Relevant directives are
<code class="directive"><a href="../mod/mod_filter.html#filterchain">FilterChain</a></code>, <code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code>,
<code class="directive"><a href="../mod/mod_filter.html#filterdeclare">FilterDeclare</a></code>, and <code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code>, and
<code class="directive"><a href="../mod/mod_filter.html#filterprovider">FilterProvider</a></code>.</p> <code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code>.</p>
<p>One further directive <code class="directive"><a href="../mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code> is still supported, <p>One further directive <code class="directive"><a href="./mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code> is still supported,
but may be problematic and is now deprecated. Use dynamic but may be problematic and is now deprecated. Use dynamic
configuration instead.</p> configuration instead.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./filter.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/filter.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./filter.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/filter.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../fr/./filter.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./filter.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./filter.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/filter.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>filter</basename> <basename>filter</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

110
docs/manual/glossary.html.en
View File

@ -6,29 +6,29 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Glossary - Apache HTTP Server</title> <title>Glossary - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header"> <body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Glossary</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Glossary</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./glossary.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./glossary.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/glossary.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./glossary.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ko/./glossary.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This glossary defines some of the common terminology related to Apache in <p>This glossary defines some of the common terminology related to Apache in
particular, and web serving in general. More information on each concept particular, and web serving in general. More information on each concept
is provided in the links.</p> is provided in the links.</p>
</div> </div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="definitions" id="definitions">Definitions</a></h2> <h2><a name="definitions" id="definitions">Definitions</a></h2>
@ -48,10 +48,10 @@
<dt><a name="apacheextensiontool" id="apacheextensiontool">APache <dt><a name="apacheextensiontool" id="apacheextensiontool">APache
eXtension Tool</a> <a name="apxs" id="apxs">(apxs)</a></dt> eXtension Tool</a> <a name="apxs" id="apxs">(apxs)</a></dt>
<dd>A perl script that aids in compiling <a class="glossarylink" href="../glossary.html#module" title="see glossary">module</a> sources into Dynamic Shared Objects <dd>A perl script that aids in compiling <a class="glossarylink" href="./glossary.html#module" title="see glossary">module</a> sources into Dynamic Shared Objects
(<a class="glossarylink" href="../glossary.html#dso" title="see glossary">DSO</a>s) and helps install them in the (<a class="glossarylink" href="./glossary.html#dso" title="see glossary">DSO</a>s) and helps install them in the
Apache Web server.<br /> Apache Web server.<br />
See: Manual Page: <code class="program"><a href="../programs/apxs.html">apxs</a></code> See: Manual Page: <code class="program"><a href="./programs/apxs.html">apxs</a></code>
</dd> </dd>
<dt><a name="apacheportableruntime" id="apacheportableruntime">Apache Portable Runtime</a> <a name="apr" id="apr">(APR)</a></dt> <dt><a name="apacheportableruntime" id="apacheportableruntime">Apache Portable Runtime</a> <a name="apr" id="apr">(APR)</a></dt>
@ -72,8 +72,8 @@
<dt><a name="certificate" id="certificate">Certificate</a></dt> <dt><a name="certificate" id="certificate">Certificate</a></dt>
<dd>A data record used for authenticating network entities such <dd>A data record used for authenticating network entities such
as a server or a client. A certificate contains X.509 information pieces as a server or a client. A certificate contains X.509 information pieces
about its owner (called the subject) and the signing <a class="glossarylink" href="../glossary.html#certificationauthority" title="see glossary">Certification Authority</a> (called about its owner (called the subject) and the signing <a class="glossarylink" href="./glossary.html#certificationauthority" title="see glossary">Certification Authority</a> (called
the issuer), plus the owner's <a class="glossarylink" href="../glossary.html#publickey" title="see glossary">public the issuer), plus the owner's <a class="glossarylink" href="./glossary.html#publickey" title="see glossary">public
key</a> and the key</a> and the
signature made by the CA. Network entities verify these signatures signature made by the CA. Network entities verify these signatures
using CA certificates.<br /> using CA certificates.<br />
@ -82,9 +82,9 @@
<dt><a name="certificatsigningrequest" id="certificatsigningrequest">Certificate Signing Request</a> <dt><a name="certificatsigningrequest" id="certificatsigningrequest">Certificate Signing Request</a>
<a name="csr" id="csr">(CSR)</a></dt> <a name="csr" id="csr">(CSR)</a></dt>
<dd>An unsigned <a class="glossarylink" href="../glossary.html#certificate" title="see glossary">certificate</a> for <dd>An unsigned <a class="glossarylink" href="./glossary.html#certificate" title="see glossary">certificate</a> for
submission to a <a class="glossarylink" href="../glossary.html#certificationauthority" title="see glossary">Certification submission to a <a class="glossarylink" href="./glossary.html#certificationauthority" title="see glossary">Certification
Authority</a>, which signs it with the <a class="glossarylink" href="../glossary.html#privatekey" title="see glossary">Private Key</a> of their CA Authority</a>, which signs it with the <a class="glossarylink" href="./glossary.html#privatekey" title="see glossary">Private Key</a> of their CA
<em>Certificate</em>. Once the CSR is signed, it becomes a real <em>Certificate</em>. Once the CSR is signed, it becomes a real
certificate.<br /> certificate.<br />
See: <a href="ssl/">SSL/TLS Encryption</a> See: <a href="ssl/">SSL/TLS Encryption</a>
@ -106,8 +106,8 @@
</dd> </dd>
<dt><a name="ciphertext" id="ciphertext">Ciphertext</a></dt> <dt><a name="ciphertext" id="ciphertext">Ciphertext</a></dt>
<dd>The result after <a class="glossarylink" href="../glossary.html#plaintext" title="see glossary">Plaintext</a> is <dd>The result after <a class="glossarylink" href="./glossary.html#plaintext" title="see glossary">Plaintext</a> is
passed through a <a class="glossarylink" href="../glossary.html#cipher" title="see glossary">Cipher</a>.<br /> See: <a href="ssl/">SSL/TLS Encryption</a> passed through a <a class="glossarylink" href="./glossary.html#cipher" title="see glossary">Cipher</a>.<br /> See: <a href="ssl/">SSL/TLS Encryption</a>
</dd> </dd>
<dt><a name="commongatewayinterface" id="commongatewayinterface">Common <dt><a name="commongatewayinterface" id="commongatewayinterface">Common
@ -120,24 +120,24 @@
</dd> </dd>
<dt><a name="configurationdirective" id="configurationdirective">Configuration Directive</a></dt> <dt><a name="configurationdirective" id="configurationdirective">Configuration Directive</a></dt>
<dd>See: <a class="glossarylink" href="../glossary.html#directive" title="see glossary">Directive</a></dd> <dd>See: <a class="glossarylink" href="./glossary.html#directive" title="see glossary">Directive</a></dd>
<dt><a name="configurationfile" id="configurationfile">Configuration <dt><a name="configurationfile" id="configurationfile">Configuration
File</a></dt> File</a></dt>
<dd>A text file containing <a class="glossarylink" href="../glossary.html#directive" title="see glossary">Directives</a> <dd>A text file containing <a class="glossarylink" href="./glossary.html#directive" title="see glossary">Directives</a>
that control the configuration of Apache.<br /> that control the configuration of Apache.<br />
See: <a href="configuring.html">Configuration Files</a> See: <a href="configuring.html">Configuration Files</a>
</dd> </dd>
<dt><a name="connect" id="connect">CONNECT</a></dt> <dt><a name="connect" id="connect">CONNECT</a></dt>
<dd>An HTTP <a class="glossarylink" href="../glossary.html#method" title="see glossary">method</a> for proxying raw data <dd>An HTTP <a class="glossarylink" href="./glossary.html#method" title="see glossary">method</a> for proxying raw data
channels over HTTP. It can be used to encapsulate other protocols, such as channels over HTTP. It can be used to encapsulate other protocols, such as
the SSL protocol. the SSL protocol.
</dd> </dd>
<dt><a name="context" id="context">Context</a></dt> <dt><a name="context" id="context">Context</a></dt>
<dd>An area in the <a class="glossarylink" href="../glossary.html#configurationfile" title="see glossary">configuration <dd>An area in the <a class="glossarylink" href="./glossary.html#configurationfile" title="see glossary">configuration
files</a> where certain types of <a class="glossarylink" href="../glossary.html#directive" title="see glossary">directives</a> are allowed.<br /> files</a> where certain types of <a class="glossarylink" href="./glossary.html#directive" title="see glossary">directives</a> are allowed.<br />
See: <a href="mod/directive-dict.html#Context">Terms Used to Describe See: <a href="mod/directive-dict.html#Context">Terms Used to Describe
Apache Directives</a> Apache Directives</a>
</dd> </dd>
@ -145,7 +145,7 @@
<dt><a name="digitalsignature" id="digitalsignature">Digital <dt><a name="digitalsignature" id="digitalsignature">Digital
Signature</a></dt> Signature</a></dt>
<dd>An encrypted text block that validates a certificate or other file. A <dd>An encrypted text block that validates a certificate or other file. A
<a class="glossarylink" href="../glossary.html#certificationauthority" title="see glossary">Certification Authority</a> <a class="glossarylink" href="./glossary.html#certificationauthority" title="see glossary">Certification Authority</a>
creates a signature by generating a hash of the <em>Public Key</em> creates a signature by generating a hash of the <em>Public Key</em>
embedded in a <em>Certificate</em>, then encrypting the hash with its own embedded in a <em>Certificate</em>, then encrypting the hash with its own
<em>Private Key</em>. Only the CA's public key can decrypt the signature, <em>Private Key</em>. Only the CA's public key can decrypt the signature,
@ -156,14 +156,14 @@
<dt><a name="directive" id="directive">Directive</a></dt> <dt><a name="directive" id="directive">Directive</a></dt>
<dd>A configuration command that controls one or more aspects of Apache's <dd>A configuration command that controls one or more aspects of Apache's
behavior. Directives are placed in the <a class="glossarylink" href="../glossary.html#configurationfile" title="see glossary">Configuration File</a><br /> behavior. Directives are placed in the <a class="glossarylink" href="./glossary.html#configurationfile" title="see glossary">Configuration File</a><br />
See: <a href="mod/directives.html">Directive Index</a> See: <a href="mod/directives.html">Directive Index</a>
</dd> </dd>
<dt><a name="dynamicsharedobject" id="dynamicsharedobject">Dynamic <dt><a name="dynamicsharedobject" id="dynamicsharedobject">Dynamic
Shared Object</a> <a name="dso" id="dso">(DSO)</a></dt> Shared Object</a> <a name="dso" id="dso">(DSO)</a></dt>
<dd><a class="glossarylink" href="../glossary.html#module" title="see glossary">Modules</a> compiled separately from the <dd><a class="glossarylink" href="./glossary.html#module" title="see glossary">Modules</a> compiled separately from the
Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> binary that can be loaded on-demand.<br /> Apache <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary that can be loaded on-demand.<br />
See: <a href="dso.html">Dynamic Shared Object Support</a> See: <a href="dso.html">Dynamic Shared Object Support</a>
</dd> </dd>
@ -191,7 +191,7 @@
server. Input filters process data sent by the client to the server, server. Input filters process data sent by the client to the server,
while output filters process documents on the server before they are sent while output filters process documents on the server before they are sent
to the client. For example, the <code>INCLUDES</code> output filter to the client. For example, the <code>INCLUDES</code> output filter
processes documents for <a class="glossarylink" href="../glossary.html#ssi" title="see glossary">Server Side processes documents for <a class="glossarylink" href="./glossary.html#ssi" title="see glossary">Server Side
Includes</a>.<br /> Includes</a>.<br />
See: <a href="filter.html">Filters</a> See: <a href="filter.html">Filters</a>
</dd> </dd>
@ -210,7 +210,7 @@
type. Normally, all files are simply served by the server, but certain type. Normally, all files are simply served by the server, but certain
file types are "handled" separately. For example, the file types are "handled" separately. For example, the
<code>cgi-script</code> handler designates files to be processed as <code>cgi-script</code> handler designates files to be processed as
<a class="glossarylink" href="../glossary.html#cgi" title="see glossary">CGIs</a>.<br /> <a class="glossarylink" href="./glossary.html#cgi" title="see glossary">CGIs</a>.<br />
See: <a href="handler.html">Apache's Handler Use</a> See: <a href="handler.html">Apache's Handler Use</a>
</dd> </dd>
@ -221,21 +221,21 @@
</dd> </dd>
<dt><a name="header" id="header">Header</a></dt> <dt><a name="header" id="header">Header</a></dt>
<dd>The part of the <a class="glossarylink" href="../glossary.html#http" title="see glossary">HTTP</a> request and <dd>The part of the <a class="glossarylink" href="./glossary.html#http" title="see glossary">HTTP</a> request and
response that is sent before the actual content, and that contains response that is sent before the actual content, and that contains
meta-information describing the content. meta-information describing the content.
</dd> </dd>
<dt><a name="htaccess" id="htaccess">.htaccess</a></dt> <dt><a name="htaccess" id="htaccess">.htaccess</a></dt>
<dd>A <a class="glossarylink" href="../glossary.html#configurationfile" title="see glossary">configuration file</a> that <dd>A <a class="glossarylink" href="./glossary.html#configurationfile" title="see glossary">configuration file</a> that
is placed inside the web tree and applies configuration <a class="glossarylink" href="../glossary.html#directive" title="see glossary">directives</a> to the directory where it is is placed inside the web tree and applies configuration <a class="glossarylink" href="./glossary.html#directive" title="see glossary">directives</a> to the directory where it is
placed and all sub-directories. Despite its name, this file can hold placed and all sub-directories. Despite its name, this file can hold
almost any type of directive, not just access-control directives.<br /> almost any type of directive, not just access-control directives.<br />
See: <a href="configuring.html">Configuration Files</a> See: <a href="configuring.html">Configuration Files</a>
</dd> </dd>
<dt><a name="httpd.conf" id="httpd.conf">httpd.conf</a></dt> <dt><a name="httpd.conf" id="httpd.conf">httpd.conf</a></dt>
<dd>The main Apache <a class="glossarylink" href="../glossary.html#configurationfile" title="see glossary">configuration <dd>The main Apache <a class="glossarylink" href="./glossary.html#configurationfile" title="see glossary">configuration
file</a>. The default location is file</a>. The default location is
<code>/usr/local/apache2/conf/httpd.conf</code>, but it may be moved using <code>/usr/local/apache2/conf/httpd.conf</code>, but it may be moved using
run-time or compile-time configuration.<br /> run-time or compile-time configuration.<br />
@ -252,12 +252,12 @@
<dt><a name="https" id="https">HTTPS</a></dt> <dt><a name="https" id="https">HTTPS</a></dt>
<dd>The HyperText Transfer Protocol (Secure), the standard encrypted <dd>The HyperText Transfer Protocol (Secure), the standard encrypted
communication mechanism on the World Wide Web. This is actually just HTTP communication mechanism on the World Wide Web. This is actually just HTTP
over <a class="glossarylink" href="../glossary.html#ssl" title="see glossary">SSL</a>.<br /> over <a class="glossarylink" href="./glossary.html#ssl" title="see glossary">SSL</a>.<br />
See: <a href="ssl/">SSL/TLS Encryption</a> See: <a href="ssl/">SSL/TLS Encryption</a>
</dd> </dd>
<dt><a name="method" id="method">Method</a></dt> <dt><a name="method" id="method">Method</a></dt>
<dd>In the context of <a class="glossarylink" href="../glossary.html#http" title="see glossary">HTTP</a>, an action to <dd>In the context of <a class="glossarylink" href="./glossary.html#http" title="see glossary">HTTP</a>, an action to
perform on a resource, specified on the request line by the client. Some perform on a resource, specified on the request line by the client. Some
of the methods available in HTTP are <code>GET</code>, <code>POST</code>, of the methods available in HTTP are <code>GET</code>, <code>POST</code>,
and <code>PUT</code>. and <code>PUT</code>.
@ -276,20 +276,20 @@
separated by a slash. Some examples are <code>text/html</code>, separated by a slash. Some examples are <code>text/html</code>,
<code>image/gif</code>, and <code>application/octet-stream</code>. In <code>image/gif</code>, and <code>application/octet-stream</code>. In
HTTP, the MIME-type is transmitted in the <code>Content-Type</code> HTTP, the MIME-type is transmitted in the <code>Content-Type</code>
<a class="glossarylink" href="../glossary.html#header" title="see glossary">header</a>.<br /> <a class="glossarylink" href="./glossary.html#header" title="see glossary">header</a>.<br />
See: <a href="mod/mod_mime.html">mod_mime</a> See: <a href="mod/mod_mime.html">mod_mime</a>
</dd> </dd>
<dt><a name="module" id="module">Module</a></dt> <dt><a name="module" id="module">Module</a></dt>
<dd>An independent part of a program. Much of Apache's functionality is <dd>An independent part of a program. Much of Apache's functionality is
contained in modules that you can choose to include or exclude. Modules contained in modules that you can choose to include or exclude. Modules
that are compiled into the Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> binary are that are compiled into the Apache <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary are
called <dfn>static modules</dfn>, while modules that are stored called <dfn>static modules</dfn>, while modules that are stored
separately and can be optionally loaded at run-time are called separately and can be optionally loaded at run-time are called
<dfn>dynamic modules</dfn> or <a class="glossarylink" href="../glossary.html#dso" title="see glossary">DSOs</a>. <dfn>dynamic modules</dfn> or <a class="glossarylink" href="./glossary.html#dso" title="see glossary">DSOs</a>.
Modules that are included by default Modules that are included by default
are called <dfn>base modules</dfn>. Many modules are available for Apache are called <dfn>base modules</dfn>. Many modules are available for Apache
that are not distributed as part of the Apache HTTP Server <a class="glossarylink" href="../glossary.html#tarball" title="see glossary">tarball</a>. These are referred to as that are not distributed as part of the Apache HTTP Server <a class="glossarylink" href="./glossary.html#tarball" title="see glossary">tarball</a>. These are referred to as
<dfn>third-party modules</dfn>.<br /> <dfn>third-party modules</dfn>.<br />
See: <a href="mod/">Module Index</a> See: <a href="mod/">Module Index</a>
</dd> </dd>
@ -313,7 +313,7 @@
<dt><a name="passphrase" id="passphrase">Pass Phrase</a></dt> <dt><a name="passphrase" id="passphrase">Pass Phrase</a></dt>
<dd>The word or phrase that protects private key files. It prevents <dd>The word or phrase that protects private key files. It prevents
unauthorized users from encrypting them. Usually it's just the secret unauthorized users from encrypting them. Usually it's just the secret
encryption/decryption key used for <a class="glossarylink" href="../glossary.html#cipher" title="see glossary">Ciphers</a>.<br /> encryption/decryption key used for <a class="glossarylink" href="./glossary.html#cipher" title="see glossary">Ciphers</a>.<br />
See: <a href="ssl/">SSL/TLS Encryption</a> See: <a href="ssl/">SSL/TLS Encryption</a>
</dd> </dd>
@ -321,7 +321,7 @@
<dd>The unencrypted text.</dd> <dd>The unencrypted text.</dd>
<dt><a name="privatekey" id="privatekey">Private Key</a></dt> <dt><a name="privatekey" id="privatekey">Private Key</a></dt>
<dd>The secret key in a <a class="glossarylink" href="../glossary.html#publickeycryptography" title="see glossary">Public Key <dd>The secret key in a <a class="glossarylink" href="./glossary.html#publickeycryptography" title="see glossary">Public Key
Cryptography</a> system, used to decrypt incoming messages and Cryptography</a> system, used to decrypt incoming messages and
sign outgoing ones.<br /> sign outgoing ones.<br />
See: <a href="ssl/">SSL/TLS Encryption</a> See: <a href="ssl/">SSL/TLS Encryption</a>
@ -338,7 +338,7 @@
</dd> </dd>
<dt><a name="publickey" id="publickey">Public Key</a></dt> <dt><a name="publickey" id="publickey">Public Key</a></dt>
<dd>The publicly available key in a <a class="glossarylink" href="../glossary.html#publickeycryptography" title="see glossary">Public Key Cryptography</a> system, <dd>The publicly available key in a <a class="glossarylink" href="./glossary.html#publickeycryptography" title="see glossary">Public Key Cryptography</a> system,
used to encrypt messages bound for its owner and to decrypt signatures used to encrypt messages bound for its owner and to decrypt signatures
made by its owner.<br /> made by its owner.<br />
See: <a href="ssl/">SSL/TLS Encryption</a> See: <a href="ssl/">SSL/TLS Encryption</a>
@ -365,7 +365,7 @@
</dd> </dd>
<dt><a name="reverseproxy" id="reverseproxy">Reverse Proxy</a></dt> <dt><a name="reverseproxy" id="reverseproxy">Reverse Proxy</a></dt>
<dd>A <a class="glossarylink" href="../glossary.html#proxy" title="see glossary">proxy</a> server that appears to the client <dd>A <a class="glossarylink" href="./glossary.html#proxy" title="see glossary">proxy</a> server that appears to the client
as if it is an <em>origin server</em>. This is useful to hide the real as if it is an <em>origin server</em>. This is useful to hide the real
origin server from the client for security reasons, or to load balance. origin server from the client for security reasons, or to load balance.
</dd> </dd>
@ -418,7 +418,7 @@
<dt><a name="uniformresourcelocator" id="uniformresourcelocator">Uniform <dt><a name="uniformresourcelocator" id="uniformresourcelocator">Uniform
Resource Locator</a> <a name="url" id="url">(URL)</a></dt> Resource Locator</a> <a name="url" id="url">(URL)</a></dt>
<dd>The name/address of a resource on the Internet. This is the common <dd>The name/address of a resource on the Internet. This is the common
informal term for what is formally called a <a class="glossarylink" href="../glossary.html#uniformresourceidentifier" title="see glossary">Uniform Resource Identifier</a>. informal term for what is formally called a <a class="glossarylink" href="./glossary.html#uniformresourceidentifier" title="see glossary">Uniform Resource Identifier</a>.
URLs are usually made up of a scheme, like <code>http</code> or URLs are usually made up of a scheme, like <code>http</code> or
<code>https</code>, a hostname, and a path. A URL for this page might <code>https</code>, a hostname, and a path. A URL for this page might
be <code>http://httpd.apache.org/docs/trunk/glossary.html</code>. be <code>http://httpd.apache.org/docs/trunk/glossary.html</code>.
@ -428,7 +428,7 @@
<a name="URI" id="URI">(URI)</a></dt> <a name="URI" id="URI">(URI)</a></dt>
<dd>A compact string of characters for identifying an abstract or physical <dd>A compact string of characters for identifying an abstract or physical
resource. It is formally defined by <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>. URIs used on the resource. It is formally defined by <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>. URIs used on the
world-wide web are commonly referred to as <a class="glossarylink" href="../glossary.html#url" title="see glossary">URLs</a>. world-wide web are commonly referred to as <a class="glossarylink" href="./glossary.html#url" title="see glossary">URLs</a>.
</dd> </dd>
<dt><a name="virtualhosting" id="virtualhosting">Virtual Hosting</a></dt> <dt><a name="virtualhosting" id="virtualhosting">Virtual Hosting</a></dt>
@ -446,11 +446,11 @@
</dl> </dl>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./glossary.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./glossary.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/glossary.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./glossary.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ko/./glossary.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/glossary.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>glossary</basename> <basename>glossary</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>de</variant> <variant>de</variant>

62
docs/manual/handler.html.en
View File

@ -6,35 +6,35 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Apache's Handler Use - Apache HTTP Server</title> <title>Apache's Handler Use - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Apache's Handler Use</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Apache's Handler Use</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./handler.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/handler.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This document describes the use of Apache's Handlers.</p> <p>This document describes the use of Apache's Handlers.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#definition">What is a Handler</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">What is a Handler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#examples">Examples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#programmer">Programmer's Note</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#programmer">Programmer's Note</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="definition" id="definition">What is a Handler</a></h2> <h2><a name="definition" id="definition">What is a Handler</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> <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>
<p>A "handler" is an internal Apache representation of the <p>A "handler" is an internal Apache representation of the
@ -52,7 +52,7 @@
Extensions</a>.)</p> Extensions</a>.)</p>
<p>Handlers can either be built into the server or included in <p>Handlers can either be built into the server or included in
a module, or they can be added with the <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> directive. The a module, or they can be added with the <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code> directive. The
built-in handlers in the standard distribution are as built-in handlers in the standard distribution are as
follows:</p> follows:</p>
@ -62,24 +62,24 @@
default to handle static content. (core)</li> default to handle static content. (core)</li>
<li><strong>send-as-is</strong>: Send file with HTTP headers <li><strong>send-as-is</strong>: Send file with HTTP headers
as is. (<code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code>)</li> as is. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
<li><strong>cgi-script</strong>: Treat the file as a CGI <li><strong>cgi-script</strong>: Treat the file as a CGI
script. (<code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>)</li> script. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
<li><strong>imap-file</strong>: Parse as an imagemap rule <li><strong>imap-file</strong>: Parse as an imagemap rule
file. (<code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code>)</li> file. (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
<li><strong>server-info</strong>: Get the server's <li><strong>server-info</strong>: Get the server's
configuration information. (<code class="module"><a href="../mod/mod_info.html">mod_info</a></code>)</li> configuration information. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
<li><strong>server-status</strong>: Get the server's status <li><strong>server-status</strong>: Get the server's status
report. (<code class="module"><a href="../mod/mod_status.html">mod_status</a></code>)</li> report. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
<li><strong>type-map</strong>: Parse as a type map file for <li><strong>type-map</strong>: Parse as a type map file for
content negotiation. (<code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>)</li> content negotiation. (<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="examples" id="examples">Examples</a></h2> <h2><a name="examples" id="examples">Examples</a></h2>
@ -119,7 +119,7 @@
</code></p></div> </code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="programmer" id="programmer">Programmer's Note</a></h2> <h2><a name="programmer" id="programmer">Programmer's Note</a></h2>
@ -143,11 +143,11 @@
as to not invade the media type name-space.</p> as to not invade the media type name-space.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./handler.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/handler.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/handler.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>handler</basename> <basename>handler</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

44
docs/manual/index.html.en
View File

@ -7,28 +7,28 @@
--> -->
<title>Apache HTTP Server Version 2.3 <title>Apache HTTP Server Version 2.3
Documentation - Apache HTTP Server</title> Documentation - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page"> <body id="index-page">
<div id="page-header"> <div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="http://httpd.apache.org/docs-project/"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a></div> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a></div>
<div id="page-content"><h1>Apache HTTP Server Version 2.3 <div id="page-content"><h1>Apache HTTP Server Version 2.3
Documentation</h1> Documentation</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./" title="English">&nbsp;en&nbsp;</a> | <a href="./en/" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../fr/./" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> | <a href="./ko/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../pt-br/./" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p> <a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p>
</div> </div>
<form method="get" action="http://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google Search" type="submit" /><input value="10" name="num" type="hidden" /><input value="en" name="hl" type="hidden" /><input value="ISO-8859-1" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Version 2.3" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value="&quot;List-Post&quot;" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form> <form method="get" action="http://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google Search" type="submit" /><input value="10" name="num" type="hidden" /><input value="en" name="hl" type="hidden" /><input value="ISO-8859-1" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Version 2.3" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value="&quot;List-Post&quot;" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Release Notes</a></h2> <table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Release Notes</a></h2>
@ -91,14 +91,14 @@ Documentation</h1>
</ul> </ul>
</div></td></tr></table></div> </div></td></tr></table></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./" title="English">&nbsp;en&nbsp;</a> | <a href="./en/" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../fr/./" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> | <a href="./ko/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../pt-br/./" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p> <a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/index.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>index</basename> <basename>index</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>de</variant> <variant>de</variant>

122
docs/manual/install.html.en
View File

@ -6,24 +6,24 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Compiling and Installing - Apache HTTP Server</title> <title>Compiling and Installing - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Compiling and Installing</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Compiling and Installing</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./install.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./install.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/install.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./install.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/install.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../fr/./install.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./install.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./install.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
@ -40,19 +40,19 @@
example, 2.2.50 to 2.2.51), please skip down to the <a href="#upgrading">upgrading</a> section.</p> example, 2.2.50 to 2.2.51), please skip down to the <a href="#upgrading">upgrading</a> section.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#overview">Overview for the <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Overview for the
impatient</a></li> impatient</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#requirements">Requirements</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#requirements">Requirements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#download">Download</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#download">Download</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#extract">Extract</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#extract">Extract</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configure">Configuring the source tree</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuring the source tree</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#compile">Build</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#compile">Build</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#install">Install</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#install">Install</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#customize">Customize</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#customize">Customize</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#test">Test</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#test">Test</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#upgrading">Upgrading</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Upgrading</a></li>
</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</a></li><li><a href="stopping.html">Stopping and Restarting</a></li></ul></div> </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</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="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="overview" id="overview">Overview for the <h2><a name="overview" id="overview">Overview for the
impatient</a></h2> impatient</a></h2>
@ -116,7 +116,7 @@
<p>Each section of the compilation and installation process is <p>Each section of the compilation and installation process is
described in more detail below, beginning with the requirements described in more detail below, beginning with the requirements
for compiling and installing Apache httpd.</p> for compiling and installing Apache httpd.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="requirements" id="requirements">Requirements</a></h2> <h2><a name="requirements" id="requirements">Requirements</a></h2>
@ -150,19 +150,19 @@
<dt><a href="http://www.perl.org/">Perl 5</a> <dt><a href="http://www.perl.org/">Perl 5</a>
[OPTIONAL]</dt> [OPTIONAL]</dt>
<dd>For some of the support scripts like <code class="program"><a href="../programs/apxs.html">apxs</a></code> or <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> (which are <dd>For some of the support scripts like <code class="program"><a href="./programs/apxs.html">apxs</a></code> or <code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code> (which are
written in Perl) the Perl 5 interpreter is required (versions written in Perl) the Perl 5 interpreter is required (versions
5.003 or newer are sufficient). If you have multiple Perl 5.003 or newer are sufficient). If you have multiple Perl
interpreters (for example, a systemwide install of Perl 4, and interpreters (for example, a systemwide install of Perl 4, and
your own install of Perl 5), you are advised to use the your own install of Perl 5), you are advised to use the
<code>--with-perl</code> option (see below) to make sure the <code>--with-perl</code> option (see below) to make sure the
correct one is used by <code class="program"><a href="../programs/configure.html">configure</a></code>. correct one is used by <code class="program"><a href="./programs/configure.html">configure</a></code>.
If no Perl 5 interpreter is found by the If no Perl 5 interpreter is found by the
<code class="program"><a href="../programs/configure.html">configure</a></code> script, you will not be able to use <code class="program"><a href="./programs/configure.html">configure</a></code> script, you will not be able to use
the affected support scripts. Of course, you will still be able to the affected support scripts. Of course, you will still be able to
build and use Apache httpd.</dd> build and use Apache httpd.</dd>
</dl> </dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="download" id="download">Download</a></h2> <h2><a name="download" id="download">Download</a></h2>
@ -182,7 +182,7 @@
page</a> and an extended example is available describing the <a href="http://httpd.apache.org/dev/verification.html">use of page</a> and an extended example is available describing the <a href="http://httpd.apache.org/dev/verification.html">use of
PGP</a>.</p> PGP</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="extract" id="extract">Extract</a></h2> <h2><a name="extract" id="extract">Extract</a></h2>
@ -198,13 +198,13 @@ $ tar xvf httpd-<em>NN</em>.tar
containing the source code for the distribution. You should containing the source code for the distribution. You should
<code>cd</code> into that directory before proceeding with <code>cd</code> into that directory before proceeding with
compiling the server.</p> compiling the server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="configure" id="configure">Configuring the source tree</a></h2> <h2><a name="configure" id="configure">Configuring the source tree</a></h2>
<p>The next step is to configure the Apache source tree for your <p>The next step is to configure the Apache source tree for your
particular platform and personal requirements. This is done using particular platform and personal requirements. This is done using
the script <code class="program"><a href="../programs/configure.html">configure</a></code> included in the script <code class="program"><a href="./programs/configure.html">configure</a></code> included in
the root directory of the distribution. (Developers downloading the root directory of the distribution. (Developers downloading
an unreleased version of the Apache source tree will need to have an unreleased version of the Apache source tree will need to have
<code>autoconf</code> and <code>libtool</code> installed and will <code>autoconf</code> and <code>libtool</code> installed and will
@ -213,7 +213,7 @@ $ tar xvf httpd-<em>NN</em>.tar
<p>To configure the source tree using all the default options, <p>To configure the source tree using all the default options,
simply type <code>./configure</code>. To change the default simply type <code>./configure</code>. To change the default
options, <code class="program"><a href="../programs/configure.html">configure</a></code> accepts a variety of variables options, <code class="program"><a href="./programs/configure.html">configure</a></code> accepts a variety of variables
and command line options.</p> and command line options.</p>
<p>The most important option is the location <code>--prefix</code> <p>The most important option is the location <code>--prefix</code>
@ -233,22 +233,22 @@ $ tar xvf httpd-<em>NN</em>.tar
<code>--enable-<var>module</var>=shared</code>. Similarly, you can <code>--enable-<var>module</var>=shared</code>. Similarly, you can
disable Base modules with the disable Base modules with the
<code>--disable-<var>module</var></code> option. Be careful when <code>--disable-<var>module</var></code> option. Be careful when
using these options, since <code class="program"><a href="../programs/configure.html">configure</a></code> cannot warn you using these options, since <code class="program"><a href="./programs/configure.html">configure</a></code> cannot warn you
if the module you specify does not exist; it will simply ignore the if the module you specify does not exist; it will simply ignore the
option.</p> option.</p>
<p>In addition, it is sometimes necessary to provide the <p>In addition, it is sometimes necessary to provide the
<code class="program"><a href="../programs/configure.html">configure</a></code> script with extra information about the <code class="program"><a href="./programs/configure.html">configure</a></code> script with extra information about the
location of your compiler, libraries, or header files. This is location of your compiler, libraries, or header files. This is
done by passing either environment variables or command line done by passing either environment variables or command line
options to <code class="program"><a href="../programs/configure.html">configure</a></code>. For more information, see the options to <code class="program"><a href="./programs/configure.html">configure</a></code>. For more information, see the
<code class="program"><a href="../programs/configure.html">configure</a></code> manual page.</p> <code class="program"><a href="./programs/configure.html">configure</a></code> manual page.</p>
<p>For a short impression of what possibilities you have, here <p>For a short impression of what possibilities you have, here
is a typical example which compiles Apache for the installation is a typical example which compiles Apache for the installation
tree <code>/sw/pkg/apache</code> with a particular compiler and flags tree <code>/sw/pkg/apache</code> with a particular compiler and flags
plus the two additional modules <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> and plus the two additional modules <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> and
<code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code> for <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> for
later loading through the DSO mechanism:</p> later loading through the DSO mechanism:</p>
<div class="example"><p><code> <div class="example"><p><code>
@ -258,13 +258,13 @@ $ tar xvf httpd-<em>NN</em>.tar
--enable-speling=shared --enable-speling=shared
</code></p></div> </code></p></div>
<p>When <code class="program"><a href="../programs/configure.html">configure</a></code> is run it will take several minutes to <p>When <code class="program"><a href="./programs/configure.html">configure</a></code> is run it will take several minutes to
test for the availability of features on your system and build test for the availability of features on your system and build
Makefiles which will later be used to compile the server.</p> Makefiles which will later be used to compile the server.</p>
<p>Details on all the different <code class="program"><a href="../programs/configure.html">configure</a></code> options are <p>Details on all the different <code class="program"><a href="./programs/configure.html">configure</a></code> options are
available on the <code class="program"><a href="../programs/configure.html">configure</a></code> manual page.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="compile" id="compile">Build</a></h2> <h2><a name="compile" id="compile">Build</a></h2>
@ -277,7 +277,7 @@ $ tar xvf httpd-<em>NN</em>.tar
several minutes to compile and the time will vary widely several minutes to compile and the time will vary widely
depending on your hardware and the number of modules that you depending on your hardware and the number of modules that you
have enabled.</p> have enabled.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="install" id="install">Install</a></h2> <h2><a name="install" id="install">Install</a></h2>
@ -293,7 +293,7 @@ $ tar xvf httpd-<em>NN</em>.tar
<p>If you are upgrading, the installation will not overwrite <p>If you are upgrading, the installation will not overwrite
your configuration files or documents.</p> your configuration files or documents.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="customize" id="customize">Customize</a></h2> <h2><a name="customize" id="customize">Customize</a></h2>
@ -306,7 +306,7 @@ $ tar xvf httpd-<em>NN</em>.tar
<p>Have a look at the Apache manual under <p>Have a look at the Apache manual under
<code><em>PREFIX</em>/docs/manual/</code> or consult <a href="http://httpd.apache.org/docs/trunk/">http://httpd.apache.org/docs/trunk/</a> for the most recent <code><em>PREFIX</em>/docs/manual/</code> or consult <a href="http://httpd.apache.org/docs/trunk/">http://httpd.apache.org/docs/trunk/</a> for the most recent
version of this manual and a complete reference of available <a href="mod/directives.html">configuration directives</a>.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="test" id="test">Test</a></h2> <h2><a name="test" id="test">Test</a></h2>
@ -317,13 +317,13 @@ $ tar xvf httpd-<em>NN</em>.tar
<p>You should then be able to request your first document <p>You should then be able to request your first document
via the URL <code>http://localhost/</code>. The web page you see is located via the URL <code>http://localhost/</code>. The web page you see is located
under the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, under the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>,
which will usually be <code><em>PREFIX</em>/htdocs/</code>. which will usually be <code><em>PREFIX</em>/htdocs/</code>.
Then <a href="stopping.html">stop</a> the server again by Then <a href="stopping.html">stop</a> the server again by
running:</p> running:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</code></p></div> <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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="upgrading" id="upgrading">Upgrading</a></h2> <h2><a name="upgrading" id="upgrading">Upgrading</a></h2>
@ -341,9 +341,9 @@ $ tar xvf httpd-<em>NN</em>.tar
process will not overwrite any of your existing documents, log process will not overwrite any of your existing documents, log
files, or configuration files. In addition, the developers make files, or configuration files. In addition, the developers make
every effort to avoid incompatible changes in the every effort to avoid incompatible changes in the
<code class="program"><a href="../programs/configure.html">configure</a></code> options, run-time configuration, or the <code class="program"><a href="./programs/configure.html">configure</a></code> options, run-time configuration, or the
module API between minor versions. In most cases you should be able to module API between minor versions. In most cases you should be able to
use an identical <code class="program"><a href="../programs/configure.html">configure</a></code> command line, an identical use an identical <code class="program"><a href="./programs/configure.html">configure</a></code> command line, an identical
configuration file, and all of your modules should continue to configuration file, and all of your modules should continue to
work.</p> work.</p>
@ -351,7 +351,7 @@ $ tar xvf httpd-<em>NN</em>.tar
<code>config.nice</code> in the <code>build</code> directory of <code>config.nice</code> in the <code>build</code> directory of
your installed server or at the root of the source tree for your your installed server or at the root of the source tree for your
old install. This will contain the exact old install. This will contain the exact
<code class="program"><a href="../programs/configure.html">configure</a></code> command line that you used to <code class="program"><a href="./programs/configure.html">configure</a></code> command line that you used to
configure the source tree. Then to upgrade from one version to configure the source tree. Then to upgrade from one version to
the next, you need only copy the <code>config.nice</code> file to the next, you need only copy the <code>config.nice</code> file to
the source tree of the new version, edit it to make any desired the source tree of the new version, edit it to make any desired
@ -369,11 +369,11 @@ $ tar xvf httpd-<em>NN</em>.tar
environment before putting it into production. For example, you environment before putting it into production. For example, you
can install and run the new version along side the old one by can install and run the new version along side the old one by
using a different <code>--prefix</code> and a using a different <code>--prefix</code> and a
different port (by adjusting the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directive) to test for any different port (by adjusting the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> directive) to test for any
incompatibilities before doing the final upgrade.</div> incompatibilities before doing the final upgrade.</div>
<p>You can pass additional arguments to <code>config.nice</code>, <p>You can pass additional arguments to <code>config.nice</code>,
which will be appended to your original <code class="program"><a href="../programs/configure.html">configure</a></code> which will be appended to your original <code class="program"><a href="./programs/configure.html">configure</a></code>
options:</p> options:</p>
<div class="example"><p><code> <div class="example"><p><code>
@ -381,13 +381,13 @@ $ tar xvf httpd-<em>NN</em>.tar
</code></p></div> </code></p></div>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./install.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./install.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/install.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./install.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/install.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../fr/./install.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./install.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./install.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/install.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>install</basename> <basename>install</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant outdated="yes">de</variant> <variant outdated="yes">de</variant>

96
docs/manual/invoking.html.en
View File

@ -6,23 +6,23 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Starting Apache - Apache HTTP Server</title> <title>Starting Apache - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Starting Apache</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Starting Apache</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./invoking.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./invoking.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/invoking.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./invoking.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./invoking.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./invoking.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>On Windows, Apache is normally run as a service on Windows <p>On Windows, Apache is normally run as a service on Windows
@ -31,21 +31,21 @@
and <a href="platform/windows.html#wincons">Running Apache as a and <a href="platform/windows.html#wincons">Running Apache as a
Console Application</a>.</p> Console Application</a>.</p>
<p>On Unix, the <code class="program"><a href="../programs/httpd.html">httpd</a></code> program <p>On Unix, the <code class="program"><a href="./programs/httpd.html">httpd</a></code> program
is run as a daemon that executes continuously in the is run as a daemon that executes continuously in the
background to handle requests. This document describes how background to handle requests. This document describes how
to invoke <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p> to invoke <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#startup">How Apache Starts</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#startup">How Apache Starts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#errors">Errors During Start-up</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#errors">Errors During Start-up</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#boot">Starting at Boot-Time</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#boot">Starting at Boot-Time</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#info">Additional Information</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#info">Additional Information</a></li>
</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> </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="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="startup" id="startup">How Apache Starts</a></h2> <h2><a name="startup" id="startup">How Apache Starts</a></h2>
<p>If the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> <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 specified in the configuration file is default of 80 (or any other
port below 1024), then it is necessary to have root privileges in port below 1024), then it is necessary to have root privileges in
order to start apache, so that it can bind to this privileged order to start apache, so that it can bind to this privileged
@ -57,20 +57,20 @@
run as a less privileged user. This is controlled by the selected run as a less privileged user. This is controlled by the selected
<a href="mpm.html">Multi-Processing Module</a>.</p> <a href="mpm.html">Multi-Processing Module</a>.</p>
<p>The recommended method of invoking the <code class="program"><a href="../programs/httpd.html">httpd</a></code> <p>The recommended method of invoking the <code class="program"><a href="./programs/httpd.html">httpd</a></code>
executable is to use the <code class="program"><a href="../programs/apachectl.html">apachectl</a></code> control script. This executable is to use the <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> control script. This
script sets certain environment variables that are necessary for script sets certain environment variables that are necessary for
<code class="program"><a href="../programs/httpd.html">httpd</a></code> to function correctly under some operating <code class="program"><a href="./programs/httpd.html">httpd</a></code> to function correctly under some operating
systems, and then invokes the <code class="program"><a href="../programs/httpd.html">httpd</a></code> binary. systems, and then invokes the <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary.
<code class="program"><a href="../programs/apachectl.html">apachectl</a></code> will pass through any command line <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> will pass through any command line
arguments, so any <code class="program"><a href="../programs/httpd.html">httpd</a></code> options may also be used with arguments, so any <code class="program"><a href="./programs/httpd.html">httpd</a></code> options may also be used with
<code class="program"><a href="../programs/apachectl.html">apachectl</a></code>. You may also directly edit the <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>. You may also directly edit the
<code class="program"><a href="../programs/apachectl.html">apachectl</a></code> script by changing the <code>HTTPD</code> <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> script by changing the <code>HTTPD</code>
variable near the top to specify the correct location of the variable near the top to specify the correct location of the
<code class="program"><a href="../programs/httpd.html">httpd</a></code> binary and any command-line arguments that you <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary and any command-line arguments that you
wish to be <em>always</em> present.</p> wish to be <em>always</em> present.</p>
<p>The first thing that <code class="program"><a href="../programs/httpd.html">httpd</a></code> does when it is <p>The first thing that <code class="program"><a href="./programs/httpd.html">httpd</a></code> does when it is
invoked is to locate and read the <a href="configuring.html">configuration file</a> invoked is to locate and read the <a href="configuring.html">configuration file</a>
<code>httpd.conf</code>. The location of this file is set at <code>httpd.conf</code>. The location of this file is set at
compile-time, but it is possible to specify its location at run compile-time, but it is possible to specify its location at run
@ -83,16 +83,16 @@
the terminal and the command prompt will return almost the terminal and the command prompt will return almost
immediately. This indicates that the server is up and running. immediately. This indicates that the server is up and running.
You can then use your browser to connect to the server and view You can then use your browser to connect to the server and view
the test page in the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> directory the test page in the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> directory
and the local copy of the documentation linked from that and the local copy of the documentation linked from that
page.</p> page.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="errors" id="errors">Errors During Start-up</a></h2> <h2><a name="errors" id="errors">Errors During Start-up</a></h2>
<p>If Apache suffers a fatal problem during startup, it will <p>If Apache suffers a fatal problem during startup, it will
write a message describing the problem either to the console or write a message describing the problem either to the console or
to the <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> before to the <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> before
exiting. One of the most common error messages is "<code>Unable exiting. One of the most common error messages is "<code>Unable
to bind to Port ...</code>". This message is usually caused by to bind to Port ...</code>". This message is usually caused by
either:</p> either:</p>
@ -108,29 +108,29 @@
<p>For further trouble-shooting instructions, consult the <p>For further trouble-shooting instructions, consult the
Apache <a href="faq/">FAQ</a>.</p> Apache <a href="faq/">FAQ</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="boot" id="boot">Starting at Boot-Time</a></h2> <h2><a name="boot" id="boot">Starting at Boot-Time</a></h2>
<p>If you want your server to continue running after a system <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 reboot, you should add a call to <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> to your
system startup files (typically <code>rc.local</code> or a file in system startup files (typically <code>rc.local</code> or a file in
an <code>rc.N</code> directory). This will start Apache as an <code>rc.N</code> directory). This will start Apache as
root. Before doing this ensure that your server is properly root. Before doing this ensure that your server is properly
configured for security and access restrictions.</p> configured for security and access restrictions.</p>
<p>The <code class="program"><a href="../programs/apachectl.html">apachectl</a></code> script is designed to act like a <p>The <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> script is designed to act like a
standard SysV init script; it can take the arguments standard SysV init script; it can take the arguments
<code>start</code>, <code>restart</code>, and <code>stop</code> <code>start</code>, <code>restart</code>, and <code>stop</code>
and translate them into the appropriate signals to and translate them into the appropriate signals to
<code class="program"><a href="../programs/httpd.html">httpd</a></code>. So you can often simply link <code class="program"><a href="./programs/httpd.html">httpd</a></code>. So you can often simply link
<code class="program"><a href="../programs/apachectl.html">apachectl</a></code> into the appropriate init directory. But be <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> into the appropriate init directory. But be
sure to check the exact requirements of your system.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="info" id="info">Additional Information</a></h2> <h2><a name="info" id="info">Additional Information</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 <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 programs included with the server is available on the
<a href="programs/">Server and Supporting Programs</a> page. <a href="programs/">Server and Supporting Programs</a> page.
There is also documentation on all the <a href="mod/">modules</a> included with the Apache distribution There is also documentation on all the <a href="mod/">modules</a> included with the Apache distribution
@ -138,12 +138,12 @@
provide.</p> provide.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./invoking.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./invoking.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/invoking.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./invoking.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./invoking.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./invoking.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/invoking.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>invoking</basename> <basename>invoking</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant outdated="yes">de</variant> <variant outdated="yes">de</variant>

22
docs/manual/license.html.en
View File

@ -6,19 +6,19 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>The Apache License, Version 2.0 - Apache HTTP Server</title> <title>The Apache License, Version 2.0 - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header"> <body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>The Apache License, Version 2.0</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>The Apache License, Version 2.0</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./license.html" title="English">&nbsp;en&nbsp;</a></p> <p><span>Available Languages: </span><a href="./en/license.html" title="English">&nbsp;en&nbsp;</a></p>
</div> </div>
<p class="centered">Apache License<br /> <p class="centered">Apache License<br />
@ -231,8 +231,8 @@ limitations under the License.</pre></div>
</div> </div>
</div> </div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./license.html" title="English">&nbsp;en&nbsp;</a></p> <p><span>Available Languages: </span><a href="./en/license.html" title="English">&nbsp;en&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/license.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>license</basename> <basename>license</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

122
docs/manual/logs.html.en
View File

@ -6,21 +6,21 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Log Files - Apache HTTP Server</title> <title>Log Files - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Log Files</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Log Files</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./logs.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/logs.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./logs.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./logs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>In order to effectively manage a web server, it is necessary <p>In order to effectively manage a web server, it is necessary
@ -31,15 +31,15 @@
logging capabilities, and how to understand what the logs logging capabilities, and how to understand what the logs
contain.</p> contain.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#security">Security Warning</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#security">Security Warning</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#errorlog">Error Log</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#errorlog">Error Log</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#accesslog">Access Log</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#accesslog">Access Log</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rotation">Log Rotation</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#rotation">Log Rotation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#piped">Piped Logs</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#piped">Piped Logs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">Virtual Hosts</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Virtual Hosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#other">Other Log Files</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#other">Other Log Files</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="security" id="security">Security Warning</a></h2> <h2><a name="security" id="security">Security Warning</a></h2>
@ -57,15 +57,15 @@
possible for malicious clients to insert control-characters in possible for malicious clients to insert control-characters in
the log files, so care must be taken in dealing with raw the log files, so care must be taken in dealing with raw
logs.</p> logs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="errorlog" id="errorlog">Error Log</a></h2> <h2><a name="errorlog" id="errorlog">Error Log</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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#loglevel">LogLevel</a></code></li></ul></td></tr></table> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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#loglevel">LogLevel</a></code></li></ul></td></tr></table>
<p>The server error log, whose name and location is set by the <p>The server error log, whose name and location is set by the
<code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> directive, is the <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> directive, is the
most important log file. This is the place where Apache httpd most important log file. This is the place where Apache httpd
will send diagnostic information and record any errors that it will send diagnostic information and record any errors that it
encounters in processing requests. It is the first place to encounters in processing requests. It is the first place to
@ -93,7 +93,7 @@
<p>The first item in the log entry is the date and time of the <p>The first item in the log entry is the date and time of the
message. The second entry lists the severity of the error being message. The second entry lists the severity of the error being
reported. The <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> reported. The <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code>
directive is used to control the types of errors that are sent directive is used to control the types of errors that are sent
to the error log by restricting the severity level. The third to the error log by restricting the severity level. The third
entry gives the IP address of the client that generated the entry gives the IP address of the client that generated the
@ -123,17 +123,17 @@
<div class="example"><p><code> <div class="example"><p><code>
tail -f error_log tail -f error_log
</code></p></div> </code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="accesslog" id="accesslog">Access Log</a></h2> <h2><a name="accesslog" id="accesslog">Access Log</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> <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>
<p>The server access log records all requests processed by the <p>The server access log records all requests processed by the
server. The location and content of the access log are server. The location and content of the access log are
controlled by the <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> controlled by the <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
directive. The <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> directive. The <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
directive can be used to simplify the selection of directive can be used to simplify the selection of
the contents of the logs. This section describes how to configure the server the contents of the logs. This section describes how to configure the server
to record information in the access log.</p> to record information in the access log.</p>
@ -151,14 +151,14 @@
<p>Various versions of Apache httpd have used other modules and <p>Various versions of Apache httpd have used other modules and
directives to control access logging, including directives to control access logging, including
mod_log_referer, mod_log_agent, and the mod_log_referer, mod_log_agent, and the
<code>TransferLog</code> directive. The <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> directive now subsumes <code>TransferLog</code> directive. The <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> directive now subsumes
the functionality of all the older directives.</p> the functionality of all the older directives.</p>
<p>The format of the access log is highly configurable. The format <p>The format of the access log is highly configurable. The format
is specified using a format string that looks much like a C-style is specified using a format string that looks much like a C-style
printf(1) format string. Some examples are presented in the next printf(1) format string. Some examples are presented in the next
sections. For a complete list of the possible contents of the 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> 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><a name="common" id="common">Common Log Format</a></h3>
@ -183,10 +183,10 @@
control characters "<code>\n</code>" for new-line and control characters "<code>\n</code>" for new-line and
"<code>\t</code>" for tab.</p> "<code>\t</code>" for tab.</p>
<p>The <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> <p>The <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
directive sets up a new log file using the defined directive sets up a new log file using the defined
<em>nickname</em>. The filename for the access log is relative to <em>nickname</em>. The filename for the access log is relative to
the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> unless it the <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> unless it
begins with a slash.</p> begins with a slash.</p>
<p>The above configuration will write log entries in a format <p>The above configuration will write log entries in a format
@ -206,12 +206,12 @@
<dt><code>127.0.0.1</code> (<code>%h</code>)</dt> <dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
<dd>This is the IP address of the client (remote host) which <dd>This is the IP address of the client (remote host) which
made the request to the server. If <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> is made the request to the server. If <code class="directive"><a href="./mod/core.html#hostnamelookups">HostnameLookups</a></code> is
set to <code>On</code>, then the server will try to determine set to <code>On</code>, then the server will try to determine
the hostname and log it in place of the IP address. However, the hostname and log it in place of the IP address. However,
this configuration is not recommended since it can this configuration is not recommended since it can
significantly slow the server. Instead, it is best to use a significantly slow the server. Instead, it is best to use a
log post-processor such as <code class="program"><a href="../programs/logresolve.html">logresolve</a></code> to determine log post-processor such as <code class="program"><a href="./programs/logresolve.html">logresolve</a></code> to determine
the hostnames. The IP address reported here is not the hostnames. The IP address reported here is not
necessarily the address of the machine at which the user is necessarily the address of the machine at which the user is
sitting. If a proxy server exists between the user and the sitting. If a proxy server exists between the user and the
@ -227,7 +227,7 @@
machine. This information is highly unreliable and should machine. This information is highly unreliable and should
almost never be used except on tightly controlled internal almost never be used except on tightly controlled internal
networks. Apache httpd will not even attempt to determine networks. Apache httpd will not even attempt to determine
this information unless <code class="directive"><a href="../mod/core.html#identitycheck">IdentityCheck</a></code> is set this information unless <code class="directive"><a href="./mod/core.html#identitycheck">IdentityCheck</a></code> is set
to <code>On</code>.</dd> to <code>On</code>.</dd>
<dt><code>frank</code> (<code>%u</code>)</dt> <dt><code>frank</code> (<code>%u</code>)</dt>
@ -350,12 +350,12 @@
<p>Multiple access logs can be created simply by specifying <p>Multiple access logs can be created simply by specifying
multiple <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> multiple <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
directives in the configuration directives in the configuration
file. For example, the following directives will create three file. For example, the following directives will create three
access logs. The first contains the basic CLF information, access logs. The first contains the basic CLF information,
while the second and third contain referer and browser while the second and third contain referer and browser
information. The last two <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> lines show how information. The last two <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> lines show how
to mimic the effects of the <code>ReferLog</code> and <code>AgentLog</code> directives.</p> to mimic the effects of the <code>ReferLog</code> and <code>AgentLog</code> directives.</p>
<div class="example"><p><code> <div class="example"><p><code>
@ -366,8 +366,8 @@
</code></p></div> </code></p></div>
<p>This example also shows that it is not necessary to define a <p>This example also shows that it is not necessary to define a
nickname with the <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> directive. Instead, nickname with the <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> directive. Instead,
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> 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><a name="conditional" id="conditional">Conditional Logs</a></h3>
@ -378,8 +378,8 @@
client request. This is easily accomplished with the help of <a href="env.html">environment variables</a>. First, an client request. This is easily accomplished with the help of <a href="env.html">environment variables</a>. First, an
environment variable must be set to indicate that the request environment variable must be set to indicate that the request
meets certain conditions. This is usually accomplished with meets certain conditions. This is usually accomplished with
<code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>. Then the <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>. Then the
<code>env=</code> clause of the <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> directive is used to <code>env=</code> clause of the <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> directive is used to
include or exclude requests where the environment variable is include or exclude requests where the environment variable is
set. Some examples:</p> set. Some examples:</p>
@ -409,7 +409,7 @@
easier to simply post-process the log files to remove requests easier to simply post-process the log files to remove requests
that you do not want to consider.</p> that you do not want to consider.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="rotation" id="rotation">Log Rotation</a></h2> <h2><a name="rotation" id="rotation">Log Rotation</a></h2>
@ -444,7 +444,7 @@
<p>Another way to perform log rotation is using <a href="#piped">piped logs</a> as discussed in the next <p>Another way to perform log rotation is using <a href="#piped">piped logs</a> as discussed in the next
section.</p> section.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="piped" id="piped">Piped Logs</a></h2> <h2><a name="piped" id="piped">Piped Logs</a></h2>
@ -468,7 +468,7 @@
<p>One important use of piped logs is to allow log rotation <p>One important use of piped logs is to allow log rotation
without having to restart the server. The Apache HTTP Server without having to restart the server. The Apache HTTP Server
includes a simple program called <code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code> includes a simple program called <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code>
for this purpose. For example, to rotate the logs every 24 hours, you for this purpose. For example, to rotate the logs every 24 hours, you
can use:</p> can use:</p>
@ -489,7 +489,7 @@
<p>As with conditional logging, piped logs are a very powerful <p>As with conditional logging, piped logs are a very powerful
tool, but they should not be used where a simpler solution like tool, but they should not be used where a simpler solution like
off-line post-processing is available.</p> off-line post-processing is available.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="virtualhost" id="virtualhost">Virtual Hosts</a></h2> <h2><a name="virtualhost" id="virtualhost">Virtual Hosts</a></h2>
@ -498,16 +498,16 @@
hosts</a>, there are several options for dealing with log hosts</a>, there are several options for dealing with log
files. First, it is possible to use logs exactly as in a files. First, it is possible to use logs exactly as in a
single-host server. Simply by placing the logging directives single-host server. Simply by placing the logging directives
outside the <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> sections in the outside the <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> sections in the
main server context, it is possible to log all requests in the main server context, it is possible to log all requests in the
same access log and error log. This technique does not allow same access log and error log. This technique does not allow
for easy collection of statistics on individual virtual for easy collection of statistics on individual virtual
hosts.</p> hosts.</p>
<p>If <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> <p>If <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
or <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> or <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>
directives are placed inside a directives are placed inside a
<code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
section, all requests or errors for that virtual host will be section, all requests or errors for that virtual host will be
logged only to the specified file. Any virtual host which does logged only to the specified file. Any virtual host which does
not have logging directives will still have its requests sent not have logging directives will still have its requests sent
@ -533,18 +533,18 @@
host that is serving the request. Then a program like <a href="programs/other.html">split-logfile</a> can be used to host that is serving the request. Then a program like <a href="programs/other.html">split-logfile</a> can be used to
post-process the access log in order to split it into one file post-process the access log in order to split it into one file
per virtual host.</p> per virtual host.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="other" id="other">Other Log Files</a></h2> <h2><a name="other" id="other">Other Log Files</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_forensic.html">mod_log_forensic</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_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><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_forensic.html#forensiclog">ForensicLog</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_rewrite.html#rewritelog">RewriteLog</a></code></li><li><code class="directive"><a href="../mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</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> <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_forensic.html">mod_log_forensic</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_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><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_forensic.html#forensiclog">ForensicLog</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_rewrite.html#rewritelog">RewriteLog</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</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>
<h3>Logging actual bytes sent and recieved</h3> <h3>Logging actual bytes sent and recieved</h3>
<p><code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> adds in two additional <p><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code> adds in two additional
<code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> fields <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> fields
(%I and %O) that log the actual number of bytes received and sent (%I and %O) that log the actual number of bytes received and sent
on the network.</p> on the network.</p>
@ -552,7 +552,7 @@
<h3>Forensic Logging</h3> <h3>Forensic Logging</h3>
<p><code class="module"><a href="../mod/mod_log_forensic.html">mod_log_forensic</a></code> provides for forensic logging of <p><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code> provides for forensic logging of
client requests. Logging is done before and after processing a client requests. Logging is done before and after processing a
request, so the forensic log contains two log lines for each request, so the forensic log contains two log lines for each
request. The forensic logger is very strict with no customizations. request. The forensic logger is very strict with no customizations.
@ -564,7 +564,7 @@
<p>On startup, Apache httpd saves the process id of the parent <p>On startup, Apache httpd saves the process id of the parent
httpd process to the file <code>logs/httpd.pid</code>. This httpd process to the file <code>logs/httpd.pid</code>. This
filename can be changed with the <code class="directive"><a href="../mod/mpm_common.html#pidfile">PidFile</a></code> directive. The filename can be changed with the <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> directive. The
process-id is for use by the administrator in restarting and process-id is for use by the administrator in restarting and
terminating the daemon by sending signals to the parent terminating the daemon by sending signals to the parent
process; on Windows, use the -k command line option instead. process; on Windows, use the -k command line option instead.
@ -576,7 +576,7 @@
<p>In order to aid in debugging, the <p>In order to aid in debugging, the
<code class="directive"><a href="../mod/mod_cgi.html#scriptlog">ScriptLog</a></code> directive <code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> directive
allows you to record the input to and output from CGI scripts. allows you to record the input to and output from CGI scripts.
This should only be used in testing - not for live servers. This should only be used in testing - not for live servers.
More information is available in the <a href="mod/mod_cgi.html">mod_cgi</a> documentation.</p> More information is available in the <a href="mod/mod_cgi.html">mod_cgi</a> documentation.</p>
@ -586,17 +586,17 @@
<p>When using the powerful and complex features of <a href="mod/mod_rewrite.html">mod_rewrite</a>, it is almost <p>When using the powerful and complex features of <a href="mod/mod_rewrite.html">mod_rewrite</a>, it is almost
always necessary to use the <code class="directive"><a href="../mod/mod_rewrite.html#rewritelog">RewriteLog</a></code> to help always necessary to use the <code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code> to help
in debugging. This log file produces a detailed analysis of how in debugging. This log file produces a detailed analysis of how
the rewriting engine transforms requests. The level of detail the rewriting engine transforms requests. The level of detail
is controlled by the <code class="directive"><a href="../mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code> directive.</p> is controlled by the <code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code> directive.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./logs.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/logs.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./logs.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./logs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/logs.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>logs</basename> <basename>logs</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

2
docs/manual/mod/mod_proxy.xml.ja
View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="iso-2022-jp"?> <?xml version="1.0" encoding="iso-2022-jp"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?> <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
<!-- English Revision: 189754:432352 (outdated) --> <!-- English Revision: 189754:432359 (outdated) -->
<!-- <!--
Licensed to the Apache Software Foundation (ASF) under one or more Licensed to the Apache Software Foundation (ASF) under one or more

68
docs/manual/mpm.html.en
View File

@ -6,33 +6,33 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Multi-Processing Modules (MPMs) - Apache HTTP Server</title> <title>Multi-Processing Modules (MPMs) - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Multi-Processing Modules (MPMs)</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Multi-Processing Modules (MPMs)</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./mpm.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./mpm.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/mpm.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./mpm.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./mpm.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./mpm.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This document describes what a Multi-Processing Module is and <p>This document describes what a Multi-Processing Module is and
how they are used by the Apache HTTP Server.</p> how they are used by the Apache HTTP Server.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#choosing">Choosing an MPM</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#choosing">Choosing an MPM</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#defaults">MPM Defaults</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#defaults">MPM Defaults</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="introduction" id="introduction">Introduction</a></h2> <h2><a name="introduction" id="introduction">Introduction</a></h2>
@ -60,7 +60,7 @@ how they are used by the Apache HTTP Server.</p>
<li>Apache can more cleanly and efficiently support a wide <li>Apache can more cleanly and efficiently support a wide
variety of operating systems. In particular, the Windows variety of operating systems. In particular, the Windows
version of Apache is now much more efficient, since version of Apache is now much more efficient, since
<code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code> can use native <code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code> can use native
networking features in place of the POSIX layer used in networking features in place of the POSIX layer used in
Apache 1.3. This benefit also extends to other operating Apache 1.3. This benefit also extends to other operating
systems that implement specialized MPMs.</li> systems that implement specialized MPMs.</li>
@ -68,9 +68,9 @@ how they are used by the Apache HTTP Server.</p>
<li>The server can be better customized for the needs of the <li>The server can be better customized for the needs of the
particular site. For example, sites that need a great deal of particular site. For example, sites that need a great deal of
scalability can choose to use a threaded MPM like scalability can choose to use a threaded MPM like
<code class="module"><a href="../mod/worker.html">worker</a></code> or <code class="module"><a href="../mod/event.html">event</a></code>, while sites requiring <code class="module"><a href="./mod/worker.html">worker</a></code> or <code class="module"><a href="./mod/event.html">event</a></code>, while sites requiring
stability or compatibility with older software can use a stability or compatibility with older software can use a
<code class="module"><a href="../mod/prefork.html">prefork</a></code>.</li> <code class="module"><a href="./mod/prefork.html">prefork</a></code>.</li>
</ul> </ul>
<p>At the user level, MPMs appear much like other Apache <p>At the user level, MPMs appear much like other Apache
@ -78,7 +78,7 @@ how they are used by the Apache HTTP Server.</p>
be loaded into the server at any time. The list of available be loaded into the server at any time. The list of available
MPMs appears on the <a href="mod/">module index page</a>.</p> MPMs appears on the <a href="mod/">module index page</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="choosing" id="choosing">Choosing an MPM</a></h2> <h2><a name="choosing" id="choosing">Choosing an MPM</a></h2>
@ -89,14 +89,14 @@ how they are used by the Apache HTTP Server.</p>
<p>To actually choose the desired MPM, use the argument <p>To actually choose the desired MPM, use the argument
<code>--with-mpm=<em>NAME</em></code> with the <code>--with-mpm=<em>NAME</em></code> with the
<code class="program"><a href="../programs/configure.html">configure</a></code> script. <em>NAME</em> is the name of the <code class="program"><a href="./programs/configure.html">configure</a></code> script. <em>NAME</em> is the name of the
desired MPM.</p> desired MPM.</p>
<p>Once the server has been compiled, it is possible to <p>Once the server has been compiled, it is possible to
determine which MPM was chosen by using <code>./httpd determine which MPM was chosen by using <code>./httpd
-l</code>. This command will list every module that is compiled -l</code>. This command will list every module that is compiled
into the server, including the MPM.</p> into the server, including the MPM.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="defaults" id="defaults">MPM Defaults</a></h2> <h2><a name="defaults" id="defaults">MPM Defaults</a></h2>
@ -106,20 +106,20 @@ choice at compile-time.</p>
<table> <table>
<tr><td>BeOS</td><td><code class="module"><a href="../mod/beos.html">beos</a></code></td></tr> <tr><td>BeOS</td><td><code class="module"><a href="./mod/beos.html">beos</a></code></td></tr>
<tr><td>Netware</td><td><code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code></td></tr> <tr><td>Netware</td><td><code class="module"><a href="./mod/mpm_netware.html">mpm_netware</a></code></td></tr>
<tr><td>OS/2</td><td><code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr> <tr><td>OS/2</td><td><code class="module"><a href="./mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
<tr><td>Unix</td><td><code class="module"><a href="../mod/prefork.html">prefork</a></code></td></tr> <tr><td>Unix</td><td><code class="module"><a href="./mod/prefork.html">prefork</a></code></td></tr>
<tr><td>Windows</td><td><code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code></td></tr> <tr><td>Windows</td><td><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table> </table>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./mpm.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./mpm.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/mpm.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./mpm.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./mpm.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./mpm.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/mpm.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>mpm</basename> <basename>mpm</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>de</variant> <variant>de</variant>

104
docs/manual/new_features_2_0.html.en
View File

@ -6,34 +6,34 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Overview of new features in Apache 2.0 - Apache HTTP Server</title> <title>Overview of new features in Apache 2.0 - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache 2.0</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache 2.0</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./new_features_2_0.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/new_features_2_0.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/./new_features_2_0.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> | <a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../pt-br/./new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Portuguęs (Brasil)">&nbsp;pt-br&nbsp;</a> | <a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Portuguęs (Brasil)">&nbsp;pt-br&nbsp;</a> |
<a href="../ru/./new_features_2_0.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a></p> <a href="./ru/new_features_2_0.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a></p>
</div> </div>
<p>This document describes some of the major changes between the <p>This document describes some of the major changes between the
1.3 and 2.0 versions of the Apache HTTP Server.</p> 1.3 and 2.0 versions of the Apache HTTP Server.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#core">Core Enhancements</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Core Enhancements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#module">Module Enhancements</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#module">Module Enhancements</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="upgrading.html">Upgrading to 2.0 from 1.3</a></li></ul></div> </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="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="core" id="core">Core Enhancements</a></h2> <h2><a name="core" id="core">Core Enhancements</a></h2>
@ -55,7 +55,7 @@
<dt>Multiprotocol Support</dt> <dt>Multiprotocol Support</dt>
<dd>Apache now has some of the infrastructure in place to <dd>Apache now has some of the infrastructure in place to
support serving multiple protocols. <code class="module"><a href="../mod/mod_echo.html">mod_echo</a></code> has support serving multiple protocols. <code class="module"><a href="./mod/mod_echo.html">mod_echo</a></code> has
been written as an example.</dd> been written as an example.</dd>
<dt>Better support for non-Unix <dt>Better support for non-Unix
@ -81,7 +81,7 @@
<dd>On systems where IPv6 is supported by the underlying <dd>On systems where IPv6 is supported by the underlying
Apache Portable Runtime library, Apache gets IPv6 listening Apache Portable Runtime library, Apache gets IPv6 listening
sockets by default. Additionally, the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>, <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>, and <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> directives support sockets by default. Additionally, the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code>, and <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> directives support
IPv6 numeric address strings (e.g., "<code>Listen IPv6 numeric address strings (e.g., "<code>Listen
[2001:db8::1]:8080</code>").</dd> [2001:db8::1]:8080</code>").</dd>
@ -91,8 +91,8 @@
the stream of content as it is delivered to or from the the stream of content as it is delivered to or from the
server. This allows, for example, the output of CGI scripts to server. This allows, for example, the output of CGI scripts to
be parsed for Server Side Include directives using the be parsed for Server Side Include directives using the
<code>INCLUDES</code> filter in <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>. The <code>INCLUDES</code> filter in <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>. The
module <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> allows external programs to module <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> allows external programs to
act as filters in much the same way that CGI programs can act as act as filters in much the same way that CGI programs can act as
handlers.</dd> handlers.</dd>
@ -106,8 +106,8 @@
<dd>Many confusing directives have been simplified. The often <dd>Many confusing directives have been simplified. The often
confusing <code>Port</code> and <code>BindAddress</code> directives confusing <code>Port</code> and <code>BindAddress</code> directives
are gone; only the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> are gone; only the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
directive is used for IP address binding; the <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive specifies the directive is used for IP address binding; the <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> directive specifies the
server name and port number only for redirection and vhost server name and port number only for redirection and vhost
recognition.</dd> recognition.</dd>
@ -129,65 +129,65 @@
syntax.</dd> syntax.</dd>
</dl> </dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="module" id="module">Module Enhancements</a></h2> <h2><a name="module" id="module">Module Enhancements</a></h2>
<dl> <dl>
<dt><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></dt> <dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>New module in Apache 2.0. This module is an interface <dd>New module in Apache 2.0. This module is an interface
to the SSL/TLS encryption protocols provided by to the SSL/TLS encryption protocols provided by
OpenSSL.</dd> OpenSSL.</dd>
<dt><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></dt> <dt><code class="module"><a href="./mod/mod_dav.html">mod_dav</a></code></dt>
<dd>New module in Apache 2.0. This module implements the HTTP <dd>New module in Apache 2.0. This module implements the HTTP
Distributed Authoring and Versioning (DAV) specification for Distributed Authoring and Versioning (DAV) specification for
posting and maintaining web content.</dd> posting and maintaining web content.</dd>
<dt><code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code></dt> <dt><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></dt>
<dd>New module in Apache 2.0. This module allows supporting <dd>New module in Apache 2.0. This module allows supporting
browsers to request that content be compressed before delivery, browsers to request that content be compressed before delivery,
saving network bandwidth.</dd> saving network bandwidth.</dd>
<dt><code class="module"><a href="../mod/mod_auth_ldap.html">mod_auth_ldap</a></code></dt> <dt><code class="module"><a href="./mod/mod_auth_ldap.html">mod_auth_ldap</a></code></dt>
<dd>New module in Apache 2.0.41. This module allows an LDAP <dd>New module in Apache 2.0.41. This module allows an LDAP
database to be used to store credentials for HTTP Basic database to be used to store credentials for HTTP Basic
Authentication. A companion module, <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> Authentication. A companion module, <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>
provides connection pooling and results caching.</dd> provides connection pooling and results caching.</dd>
<dt><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></dt> <dt><code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code></dt>
<dd>Includes additional support for session caching across <dd>Includes additional support for session caching across
processes using shared memory.</dd> processes using shared memory.</dd>
<dt><code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code></dt> <dt><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></dt>
<dd>New module in Apache 2.0. This experimental module allows <dd>New module in Apache 2.0. This experimental module allows
for character set translation or recoding.</dd> for character set translation or recoding.</dd>
<dt><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code></dt> <dt><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></dt>
<dd>New module in Apache 2.0. This module includes the <dd>New module in Apache 2.0. This module includes the
functionality of <code>mod_mmap_static</code> in Apache 1.3, functionality of <code>mod_mmap_static</code> in Apache 1.3,
plus adds further caching abilities.</dd> plus adds further caching abilities.</dd>
<dt><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code></dt> <dt><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></dt>
<dd>This module is much more flexible in Apache 2.0. It can now <dd>This module is much more flexible in Apache 2.0. It can now
modify request headers used by <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, and modify request headers used by <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>, and
it can conditionally set response headers.</dd> it can conditionally set response headers.</dd>
<dt><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dt> <dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>The proxy module has been completely rewritten to take <dd>The proxy module has been completely rewritten to take
advantage of the new filter infrastructure and to implement a advantage of the new filter infrastructure and to implement a
more reliable, HTTP/1.1 compliant proxy. In addition, new more reliable, HTTP/1.1 compliant proxy. In addition, new
<code class="directive"><a href="../mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code> <code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>
configuration sections provide more readable (and internally configuration sections provide more readable (and internally
faster) control of proxied sites; overloaded <code>&lt;Directory faster) control of proxied sites; overloaded <code>&lt;Directory
"proxy:..."&gt;</code> configuration are not supported. The module "proxy:..."&gt;</code> configuration are not supported. The module
@ -195,49 +195,49 @@
<code>proxy_connect</code>, <code>proxy_ftp</code> and <code>proxy_connect</code>, <code>proxy_ftp</code> and
<code>proxy_http</code>.</dd> <code>proxy_http</code>.</dd>
<dt><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></dt> <dt><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></dt>
<dd>A new <code class="directive"><a href="../mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code> directive can be used to assure that <dd>A new <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code> directive can be used to assure that
the client receives a single document in all cases, rather than the client receives a single document in all cases, rather than
NOT ACCEPTABLE or MULTIPLE CHOICES responses. In addition, the NOT ACCEPTABLE or MULTIPLE CHOICES responses. In addition, the
negotiation and MultiViews algorithms have been cleaned up to negotiation and MultiViews algorithms have been cleaned up to
provide more consistent results and a new form of type map that provide more consistent results and a new form of type map that
can include document content is provided.</dd> can include document content is provided.</dd>
<dt><code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code></dt> <dt><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></dt>
<dd>Autoindex'ed directory listings can now be configured to <dd>Autoindex'ed directory listings can now be configured to
use HTML tables for cleaner formatting, and allow finer-grained use HTML tables for cleaner formatting, and allow finer-grained
control of sorting, including version-sorting, and wildcard control of sorting, including version-sorting, and wildcard
filtering of the directory listing.</dd> filtering of the directory listing.</dd>
<dt><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></dt> <dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>New directives allow the default start and end tags for SSI elements <dd>New directives allow the default start and end tags for SSI elements
to be changed and allow for error and time format configuration to be changed and allow for error and time format configuration
to take place in the main configuration file rather than in the to take place in the main configuration file rather than in the
SSI document. Results from regular expression parsing and grouping SSI document. Results from regular expression parsing and grouping
(now based on Perl's regular expression syntax) can be retrieved (now based on Perl's regular expression syntax) can be retrieved
using <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>'s variables <code>$0</code> using <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>'s variables <code>$0</code>
.. <code>$9</code>.</dd> .. <code>$9</code>.</dd>
<dt><code class="module"><a href="../mod/mod_auth_dbm.html">mod_auth_dbm</a></code></dt> <dt><code class="module"><a href="./mod/mod_auth_dbm.html">mod_auth_dbm</a></code></dt>
<dd>Now supports multiple types of DBM-like databases using the <dd>Now supports multiple types of DBM-like databases using the
<code class="directive"><a href="../mod/mod_auth_dbm.html#authdbmtype">AuthDBMType</a></code> <code class="directive"><a href="./mod/mod_auth_dbm.html#authdbmtype">AuthDBMType</a></code>
directive.</dd> directive.</dd>
</dl> </dl>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./new_features_2_0.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/new_features_2_0.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/./new_features_2_0.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> | <a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/./new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> | <a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../pt-br/./new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Portuguęs (Brasil)">&nbsp;pt-br&nbsp;</a> | <a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Portuguęs (Brasil)">&nbsp;pt-br&nbsp;</a> |
<a href="../ru/./new_features_2_0.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a></p> <a href="./ru/new_features_2_0.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/new_features_2_0.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>new_features_2_0</basename> <basename>new_features_2_0</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>de</variant> <variant>de</variant>

114
docs/manual/new_features_2_2.html.en
View File

@ -6,21 +6,21 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Overview of new features in Apache 2.2 - Apache HTTP Server</title> <title>Overview of new features in Apache 2.2 - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache 2.2</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache 2.2</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./new_features_2_2.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/new_features_2_2.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ko/./new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> | <a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../pt-br/./new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p> <a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p>
</div> </div>
<p>This document describes some of the major changes between the <p>This document describes some of the major changes between the
@ -28,12 +28,12 @@
version 1.3, see the <a href="new_features_2_0.html">2.0 new features</a> version 1.3, see the <a href="new_features_2_0.html">2.0 new features</a>
document.</p> document.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#core">Core Enhancements</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Core Enhancements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#module">Module Enhancements</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#module">Module Enhancements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#programs">Program Enhancements</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#programs">Program Enhancements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#developer">Module Developer Changes</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#developer">Module Developer Changes</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="core" id="core">Core Enhancements</a></h2> <h2><a name="core" id="core">Core Enhancements</a></h2>
@ -41,7 +41,7 @@
<dt>Authn/Authz</dt> <dt>Authn/Authz</dt>
<dd>The bundled authentication and authorization modules have <dd>The bundled authentication and authorization modules have
been refactored. The new <code class="module"><a href="../mod/mod_authn_alias.html">mod_authn_alias</a></code> module been refactored. The new <code class="module"><a href="./mod/mod_authn_alias.html">mod_authn_alias</a></code> module
can greatly simplify certain authentication configurations. can greatly simplify certain authentication configurations.
See <a href="#module">module name changes</a>, and See <a href="#module">module name changes</a>, and
<a href="#developer">the developer changes</a> for more <a href="#developer">the developer changes</a> for more
@ -49,10 +49,10 @@
writers.</dd> writers.</dd>
<dt>Caching</dt> <dt>Caching</dt>
<dd><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>, <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>, and <dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code>, and
<code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> have undergone a lot of changes, and <code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code> have undergone a lot of changes, and
are now considered production-quality. <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> are now considered production-quality. <code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code>
has been introduced to clean up <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> has been introduced to clean up <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code>
setups.</dd> setups.</dd>
<dt>Configuration</dt> <dt>Configuration</dt>
@ -62,31 +62,31 @@
can be easily added to the main server config.</dd> can be easily added to the main server config.</dd>
<dt>Graceful stop</dt> <dt>Graceful stop</dt>
<dd>The <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code> and <dd>The <code class="module"><a href="./mod/prefork.html">prefork</a></code>, <code class="module"><a href="./mod/worker.html">worker</a></code> and
<code class="module"><a href="../mod/event.html">event</a></code> MPMs now allow <code class="program"><a href="../programs/httpd.html">httpd</a></code> <code class="module"><a href="./mod/event.html">event</a></code> MPMs now allow <code class="program"><a href="./programs/httpd.html">httpd</a></code>
to be shutdown gracefully via the to be shutdown gracefully via the
<a href="stopping.html#gracefulstop"><code>graceful-stop</code></a> <a href="stopping.html#gracefulstop"><code>graceful-stop</code></a>
signal. The <code class="directive"><a href="../mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> directive signal. The <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> directive
has been added to specify an optional timeout, after which has been added to specify an optional timeout, after which
<code class="program"><a href="../programs/httpd.html">httpd</a></code> will terminate regardless of the status <code class="program"><a href="./programs/httpd.html">httpd</a></code> will terminate regardless of the status
of any requests being served.</dd> of any requests being served.</dd>
<dt>Proxying</dt> <dt>Proxying</dt>
<dd>The new <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> module provides <dd>The new <code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> module provides
load balancing services for <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. load balancing services for <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.
The new <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> module adds support for the The new <code class="module"><a href="./mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> module adds support for the
<code>Apache JServ Protocol version 1.3</code> used by <code>Apache JServ Protocol version 1.3</code> used by
<a href="http://jakarta.apache.org/tomcat/">Apache Tomcat</a>.</dd> <a href="http://jakarta.apache.org/tomcat/">Apache Tomcat</a>.</dd>
<dt>Regular Expression Library Updated</dt> <dt>Regular Expression Library Updated</dt>
<dd>Version 5.0 of the <dd>Version 5.0 of the
<a href="http://www.pcre.org/">Perl Compatible Regular Expression <a href="http://www.pcre.org/">Perl Compatible Regular Expression
Library</a> (PCRE) is now included. <code class="program"><a href="../programs/httpd.html">httpd</a></code> can be Library</a> (PCRE) is now included. <code class="program"><a href="./programs/httpd.html">httpd</a></code> can be
configured to use a system installation of PCRE by passing the configured to use a system installation of PCRE by passing the
<code>--with-pcre</code> flag to configure.</dd> <code>--with-pcre</code> flag to configure.</dd>
<dt>Smart Filtering</dt> <dt>Smart Filtering</dt>
<dd><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> introduces dynamic configuration <dd><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> introduces dynamic configuration
to the output filter chain. It enables filters to be conditionally to the output filter chain. It enables filters to be conditionally
inserted, based on any Request or Response header or environment inserted, based on any Request or Response header or environment
variable, and dispenses with the more problematic dependencies and variable, and dispenses with the more problematic dependencies and
@ -99,14 +99,14 @@
bodies has also been added.</dd> bodies has also been added.</dd>
<dt>Event MPM</dt> <dt>Event MPM</dt>
<dd>The <code class="module"><a href="../mod/event.html">event</a></code> MPM uses a seperate thread to handle <dd>The <code class="module"><a href="./mod/event.html">event</a></code> MPM uses a seperate thread to handle
Keep Alive requests and accepting connections. Keep Alive requests Keep Alive requests and accepting connections. Keep Alive requests
have traditionally required httpd to dedicate a worker to handle it. have traditionally required httpd to dedicate a worker to handle it.
This dedicated worker could not be used again until the Keep Alive This dedicated worker could not be used again until the Keep Alive
timeout was reached.</dd> timeout was reached.</dd>
<dt>SQL Database Support</dt> <dt>SQL Database Support</dt>
<dd><p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code>, together with the apr_dbd framework, <dd><p><code class="module"><a href="./mod/mod_dbd.html">mod_dbd</a></code>, together with the apr_dbd framework,
brings direct SQL support to modules that need it. Supports brings direct SQL support to modules that need it. Supports
connection pooling in threaded MPMs.</p> connection pooling in threaded MPMs.</p>
<p><strong>Windows Users</strong> please note that this is not <p><strong>Windows Users</strong> please note that this is not
@ -115,7 +115,7 @@
</dd> </dd>
</dl> </dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="module" id="module">Module Enhancements</a></h2> <h2><a name="module" id="module">Module Enhancements</a></h2>
@ -123,60 +123,60 @@
<dt>Authn/Authz</dt> <dt>Authn/Authz</dt>
<dd>Modules in the aaa directory have been renamed and offer <dd>Modules in the aaa directory have been renamed and offer
better support for digest authentication. For example, mod_auth better support for digest authentication. For example, mod_auth
is now split into <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> and is now split into <code class="module"><a href="./mod/mod_auth_basic.html">mod_auth_basic</a></code> and
<code class="module"><a href="../mod/mod_auth_file.html">mod_auth_file</a></code>; mod_auth_dbm is now called <code class="module"><a href="./mod/mod_auth_file.html">mod_auth_file</a></code>; mod_auth_dbm is now called
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>; mod_access has been renamed <code class="module"><a href="./mod/mod_authn_dbm.html">mod_authn_dbm</a></code>; mod_access has been renamed
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>. There is also a new <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. There is also a new
<code class="module"><a href="../mod/mod_authn_alias.html">mod_authn_alias</a></code> module for simplifying <code class="module"><a href="./mod/mod_authn_alias.html">mod_authn_alias</a></code> module for simplifying
certain authentication configurations. certain authentication configurations.
</dd> </dd>
<dt><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt> <dt><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd>This module is a port of the 2.0 <dd>This module is a port of the 2.0
<code>mod_auth_ldap</code> module to the 2.2 <code>Authn/Authz</code> <code>mod_auth_ldap</code> module to the 2.2 <code>Authn/Authz</code>
framework. New features include using LDAP attribute values and framework. New features include using LDAP attribute values and
complicated search filters in the complicated search filters in the
<code class="directive"><a href="../mod/core.html#require">Require</a></code> directive.</dd> <code class="directive"><a href="./mod/core.html#require">Require</a></code> directive.</dd>
<dt><code class="module"><a href="../mod/mod_info.html">mod_info</a></code></dt> <dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd>Added a new <code>?config</code> argument which will show <dd>Added a new <code>?config</code> argument which will show
the configuration directives as parsed by Apache, including the configuration directives as parsed by Apache, including
their file name and line number. The module also their file name and line number. The module also
shows the order of all request hooks and additional shows the order of all request hooks and additional
build information, similar to <code>httpd -V</code>.</dd> build information, similar to <code>httpd -V</code>.</dd>
<dt><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></dt> <dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Added a support for <dd>Added a support for
<a href="http://www.ietf.org/rfc/rfc2817.txt">RFC 2817</a>, which <a href="http://www.ietf.org/rfc/rfc2817.txt">RFC 2817</a>, which
allows connections to upgrade from clear text to TLS encryption.</dd> allows connections to upgrade from clear text to TLS encryption.</dd>
<dt><code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code></dt> <dt><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code></dt>
<dd>mod_imap has been renamed to <code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code> to avoid <dd>mod_imap has been renamed to <code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code> to avoid
user confusion.</dd> user confusion.</dd>
</dl> </dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="programs" id="programs">Program Enhancements</a></h2> <h2><a name="programs" id="programs">Program Enhancements</a></h2>
<dl> <dl>
<dt><code class="program"><a href="../programs/httpd.html">httpd</a></code></dt> <dt><code class="program"><a href="./programs/httpd.html">httpd</a></code></dt>
<dd>A new command line option <code>-M</code> has been added that <dd>A new command line option <code>-M</code> has been added that
lists all modules that are loaded based on the current lists all modules that are loaded based on the current
configuration. Unlike the <code>-l</code> option, this list configuration. Unlike the <code>-l</code> option, this list
includes DSOs loaded via <code class="module"><a href="../mod/mod_so.html">mod_so</a></code>.</dd> includes DSOs loaded via <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>.</dd>
<dt><code class="program"><a href="../programs/httxt2dbm.html">httxt2dbm</a></code></dt> <dt><code class="program"><a href="./programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd>A new program used to generate dbm files from text input, <dd>A new program used to generate dbm files from text input,
for use in <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> for use in <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
with the <code>dbm</code> map type.</dd> with the <code>dbm</code> map type.</dd>
</dl> </dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="developer" id="developer">Module Developer Changes</a></h2> <h2><a name="developer" id="developer">Module Developer Changes</a></h2>
<dl> <dl>
<dt><a class="glossarylink" href="../glossary.html#apr" title="see glossary">APR</a> 1.0 API</dt> <dt><a class="glossarylink" href="./glossary.html#apr" title="see glossary">APR</a> 1.0 API</dt>
<dd>Apache 2.2 uses the APR 1.0 API. All deprecated functions and <dd>Apache 2.2 uses the APR 1.0 API. All deprecated functions and
symbols have been removed from <code>APR</code> and symbols have been removed from <code>APR</code> and
@ -206,7 +206,7 @@
<dd>A new hook, <code>test_config</code> has been added to aid <dd>A new hook, <code>test_config</code> has been added to aid
modules that want to execute special code only when the user passes modules that want to execute special code only when the user passes
<code>-t</code> to <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</dd> <code>-t</code> to <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</dd>
<dt>Set Threaded MPM's Stacksize</dt> <dt>Set Threaded MPM's Stacksize</dt>
@ -220,7 +220,7 @@
<dd>In the past, every filter has been responsible for ensuring <dd>In the past, every filter has been responsible for ensuring
that it generates the correct response headers where it affects that it generates the correct response headers where it affects
them. Filters can now delegate common protocol management to them. Filters can now delegate common protocol management to
<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>, using the <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, using the
<code>ap_register_output_filter_protocol</code> or <code>ap_register_output_filter_protocol</code> or
<code>ap_filter_protocol</code> calls.</dd> <code>ap_filter_protocol</code> calls.</dd>
@ -255,10 +255,10 @@
</dl> </dl>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./new_features_2_2.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/new_features_2_2.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ko/./new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> | <a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../pt-br/./new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p> <a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/new_features_2_2.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>new_features_2_2</basename> <basename>new_features_2_2</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

38
docs/manual/new_features_2_4.html.en
View File

@ -6,19 +6,19 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Overview of new features in Apache 2.4 - Apache HTTP Server</title> <title>Overview of new features in Apache 2.4 - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache 2.4</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache 2.4</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./new_features_2_4.html" title="English">&nbsp;en&nbsp;</a></p> <p><span>Available Languages: </span><a href="./en/new_features_2_4.html" title="English">&nbsp;en&nbsp;</a></p>
</div> </div>
<p>This document describes some of the major changes between the <p>This document describes some of the major changes between the
@ -26,36 +26,36 @@
version 2.0, see the <a href="new_features_2_2.html">2.2 new features</a> version 2.0, see the <a href="new_features_2_2.html">2.2 new features</a>
document.</p> document.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#core">Core Enhancements</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Core Enhancements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#module">Module Enhancements</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#module">Module Enhancements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#programs">Program Enhancements</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#programs">Program Enhancements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#developer">Module Developer Changes</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#developer">Module Developer Changes</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="core" id="core">Core Enhancements</a></h2> <h2><a name="core" id="core">Core Enhancements</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="module" id="module">Module Enhancements</a></h2> <h2><a name="module" id="module">Module Enhancements</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="programs" id="programs">Program Enhancements</a></h2> <h2><a name="programs" id="programs">Program Enhancements</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="developer" id="developer">Module Developer Changes</a></h2> <h2><a name="developer" id="developer">Module Developer Changes</a></h2>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./new_features_2_4.html" title="English">&nbsp;en&nbsp;</a></p> <p><span>Available Languages: </span><a href="./en/new_features_2_4.html" title="English">&nbsp;en&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/new_features_2_4.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>new_features_2_4</basename> <basename>new_features_2_4</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

194
docs/manual/sections.html.en
View File

@ -6,21 +6,21 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Configuration Sections - Apache HTTP Server</title> <title>Configuration Sections - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Configuration Sections</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Configuration Sections</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./sections.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/sections.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./sections.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./sections.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>Directives in the <a href="configuring.html">configuration files</a> may apply to the <p>Directives in the <a href="configuring.html">configuration files</a> may apply to the
entire server, or they may be restricted to apply only to particular entire server, or they may be restricted to apply only to particular
@ -28,31 +28,31 @@ directories, files, hosts, or URLs. This document describes how to
use configuration section containers or <code>.htaccess</code> files use configuration section containers or <code>.htaccess</code> files
to change the scope of other configuration directives.</p> to change the scope of other configuration directives.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#types">Types of Configuration Section Containers</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types">Types of Configuration Section Containers</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#file-and-web">Filesystem and Webspace</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Filesystem and Webspace</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">Virtual Hosts</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Virtual Hosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#proxy">Proxy</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#proxy">Proxy</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#whatwhere">What Directives are Allowed?</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">What Directives are Allowed?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mergin">How the sections are merged</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#mergin">How the sections are merged</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="types" id="types">Types of Configuration Section Containers</a></h2> <h2><a name="types" id="types">Types of Configuration Section Containers</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">&lt;Directory&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code></li><li><code class="directive"><a href="../mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code></li><li><code class="directive"><a href="../mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code></li><li><code class="directive"><a href="../mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li></ul></td></tr></table> <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">&lt;Directory&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li></ul></td></tr></table>
<p>There are two basic types of containers. Most containers are <p>There are two basic types of containers. Most containers are
evaluated for each request. The enclosed directives are applied only evaluated for each request. The enclosed directives are applied only
for those requests that match the containers. The <code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code>, <code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>, and for those requests that match the containers. The <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code>, <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>, and
<code class="directive"><a href="../mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code> <code class="directive"><a href="./mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code>
containers, on the other hand, are evaluated only at server startup containers, on the other hand, are evaluated only at server startup
and restart. If their conditions are true at startup, then the and restart. If their conditions are true at startup, then the
enclosed directives will apply to all requests. If the conditions are enclosed directives will apply to all requests. If the conditions are
not true, the enclosed directives will be ignored.</p> not true, the enclosed directives will be ignored.</p>
<p>The <code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> directive <p>The <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> directive
encloses directives that will only be applied if an appropriate encloses directives that will only be applied if an appropriate
parameter is defined on the <code class="program"><a href="../programs/httpd.html">httpd</a></code> command line. For example, parameter is defined on the <code class="program"><a href="./programs/httpd.html">httpd</a></code> command line. For example,
with the following configuration, all requests will be redirected with the following configuration, all requests will be redirected
to another site only if the server is started using to another site only if the server is started using
<code>httpd -DClosedForNow</code>:</p> <code>httpd -DClosedForNow</code>:</p>
@ -63,19 +63,19 @@ Redirect / http://otherserver.example.com/<br />
&lt;/IfDefine&gt; &lt;/IfDefine&gt;
</code></p></div> </code></p></div>
<p>The <code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> <p>The <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>
directive is very similar, except it encloses directives that will directive is very similar, except it encloses directives that will
only be applied if a particular module is available in the server. only be applied if a particular module is available in the server.
The module must either be statically compiled in the server, or it The module must either be statically compiled in the server, or it
must be dynamically compiled and its <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> line must be earlier in the must be dynamically compiled and its <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> line must be earlier in the
configuration file. This directive should only be used if you need configuration file. This directive should only be used if you need
your configuration file to work whether or not certain modules are your configuration file to work whether or not certain modules are
installed. It should not be used to enclose directives that you want installed. It should not be used to enclose directives that you want
to work all the time, because it can suppress useful error messages to work all the time, because it can suppress useful error messages
about missing modules.</p> about missing modules.</p>
<p>In the following example, the <code class="directive"><a href="../mod/mod_mime_magic.html#mimemagicfiles">MimeMagicFiles</a></code> directive will be <p>In the following example, the <code class="directive"><a href="./mod/mod_mime_magic.html#mimemagicfiles">MimeMagicFiles</a></code> directive will be
applied only if <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code> is available.</p> applied only if <code class="module"><a href="./mod/mod_mime_magic.html">mod_mime_magic</a></code> is available.</p>
<div class="example"><p><code> <div class="example"><p><code>
&lt;IfModule mod_mime_magic.c&gt;<br /> &lt;IfModule mod_mime_magic.c&gt;<br />
@ -83,8 +83,8 @@ MimeMagicFile conf/magic<br />
&lt;/IfModule&gt; &lt;/IfModule&gt;
</code></p></div> </code></p></div>
<p>The <code class="directive"><a href="../mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code> <p>The <code class="directive"><a href="./mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code>
directive is very similar to <code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> and <code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>, except it encloses directives that will directive is very similar to <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> and <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>, except it encloses directives that will
only be applied if a particular version of the server is executing. This only be applied if a particular version of the server is executing. This
module is designed for the use in test suites and large networks which have to module is designed for the use in test suites and large networks which have to
deal with different httpd versions and different configurations.</p> deal with different httpd versions and different configurations.</p>
@ -98,13 +98,13 @@ deal with different httpd versions and different configurations.</p>
&lt;/IfVersion&gt; &lt;/IfVersion&gt;
</code></p></div> </code></p></div>
<p><code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code>, <p><code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code>,
<code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>, and the <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>, and the
<code class="directive"><a href="../mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code> <code class="directive"><a href="./mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code>
can apply negative conditions by preceding their test with "!". can apply negative conditions by preceding their test with "!".
Also, these sections can be nested to achieve more complex Also, these sections can be nested to achieve more complex
restrictions.</p> restrictions.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="file-and-web" id="file-and-web">Filesystem and Webspace</a></h2> <h2><a name="file-and-web" id="file-and-web">Filesystem and Webspace</a></h2>
@ -127,11 +127,11 @@ from databases or other locations.</p>
<h3><a name="filesystem" id="filesystem">Filesystem Containers</a></h3> <h3><a name="filesystem" id="filesystem">Filesystem Containers</a></h3>
<p>The <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> <p>The <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>
and <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code> and <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>
directives, along with their <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regex</a> directives, along with their <a class="glossarylink" href="./glossary.html#regex" title="see glossary">regex</a>
counterparts, apply directives to counterparts, apply directives to
parts of the filesystem. Directives enclosed in a <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> section apply to parts of the filesystem. Directives enclosed in a <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> section apply to
the named filesystem directory and all subdirectories of that the named filesystem directory and all subdirectories of that
directory. The same effect can be obtained using <a href="howto/htaccess.html">.htaccess files</a>. For example, in the directory. The same effect can be obtained using <a href="howto/htaccess.html">.htaccess files</a>. For example, in the
following configuration, directory indexes will be enabled for the following configuration, directory indexes will be enabled for the
@ -143,7 +143,7 @@ Options +Indexes<br />
&lt;/Directory&gt; &lt;/Directory&gt;
</code></p></div> </code></p></div>
<p>Directives enclosed in a <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code> section apply to any file with <p>Directives enclosed in a <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code> section apply to any file with
the specified name, regardless of what directory it lies in. the specified name, regardless of what directory it lies in.
So for example, the following configuration directives will, So for example, the following configuration directives will,
when placed in the main section of the configuration file, when placed in the main section of the configuration file,
@ -158,8 +158,8 @@ Deny from all<br />
</code></p></div> </code></p></div>
<p>To address files found in a particular part of the filesystem, the <p>To address files found in a particular part of the filesystem, the
<code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code> and <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code> and
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> sections <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> sections
can be combined. For example, the following configuration will deny can be combined. For example, the following configuration will deny
access to <code>/var/web/dir1/private.html</code>, access to <code>/var/web/dir1/private.html</code>,
<code>/var/web/dir1/subdir2/private.html</code>, <code>/var/web/dir1/subdir2/private.html</code>,
@ -179,8 +179,8 @@ Deny from all<br />
<h3><a name="webspace" id="webspace">Webspace Containers</a></h3> <h3><a name="webspace" id="webspace">Webspace Containers</a></h3>
<p>The <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> <p>The <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
directive and its <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regex</a> counterpart, on directive and its <a class="glossarylink" href="./glossary.html#regex" title="see glossary">regex</a> counterpart, on
the other hand, change the the other hand, change the
configuration for content in the webspace. For example, the following configuration for content in the webspace. For example, the following
configuration prevents access to any URL-path that begins in /private. configuration prevents access to any URL-path that begins in /private.
@ -197,10 +197,10 @@ Deny from all<br />
&lt;/Location&gt; &lt;/Location&gt;
</code></p></div> </code></p></div>
<p>The <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> <p>The <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
directive need not have anything to do with the filesystem. directive need not have anything to do with the filesystem.
For example, the following example shows how to map a particular For example, the following example shows how to map a particular
URL to an internal Apache handler provided by <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>. URL to an internal Apache handler provided by <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>.
No file called <code>server-status</code> needs to exist in the No file called <code>server-status</code> needs to exist in the
filesystem.</p> filesystem.</p>
@ -213,9 +213,9 @@ SetHandler server-status<br />
<h3><a name="wildcards" id="wildcards">Wildcards and Regular Expressions</a></h3> <h3><a name="wildcards" id="wildcards">Wildcards and Regular Expressions</a></h3>
<p>The <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, <p>The <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>,
<code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>, and <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>, and
<code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
directives can each use shell-style wildcard characters as in directives can each use shell-style wildcard characters as in
<code>fnmatch</code> from the C standard library. The character "*" <code>fnmatch</code> from the C standard library. The character "*"
matches any sequence of characters, "?" matches any single character, matches any sequence of characters, "?" matches any single character,
@ -224,9 +224,9 @@ character will not be matched by any wildcard; it must be specified
explicitly.</p> explicitly.</p>
<p>If even more flexible matching is required, each <p>If even more flexible matching is required, each
container has a regular expression (regex) counterpart <code class="directive"><a href="../mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>, <code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>, and <code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> that allow container has a regular expression (regex) counterpart <code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>, and <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> that allow
perl-compatible perl-compatible
<a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expressions</a> <a class="glossarylink" href="./glossary.html#regex" title="see glossary">regular expressions</a>
to be used in choosing the matches. But see the section below on to be used in choosing the matches. But see the section below on
configuration merging to find out how using regex sections will change configuration merging to find out how using regex sections will change
how directives are applied.</p> how directives are applied.</p>
@ -255,11 +255,11 @@ Deny from all<br />
<p>Choosing between filesystem containers and webspace containers is <p>Choosing between filesystem containers and webspace containers is
actually quite easy. When applying directives to objects that reside actually quite easy. When applying directives to objects that reside
in the filesystem always use <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> or <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>. When applying directives to objects in the filesystem always use <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> or <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>. When applying directives to objects
that do not reside in the filesystem (such as a webpage generated from that do not reside in the filesystem (such as a webpage generated from
a database), use <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>.</p> a database), use <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>.</p>
<p>It is important to never use <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> when trying to restrict <p>It is important to never use <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code> when trying to restrict
access to objects in the filesystem. This is because many access to objects in the filesystem. This is because many
different webspace locations (URLs) could map to the same filesystem different webspace locations (URLs) could map to the same filesystem
location, allowing your restrictions to be circumvented. location, allowing your restrictions to be circumvented.
@ -276,14 +276,14 @@ Deny from all<br />
<code>http://yoursite.example.com/dir/</code>. But what if you are on <code>http://yoursite.example.com/dir/</code>. But what if you are on
a case-insensitive filesystem? Then your restriction could be easily a case-insensitive filesystem? Then your restriction could be easily
circumvented by requesting circumvented by requesting
<code>http://yoursite.example.com/DIR/</code>. The <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> directive, in <code>http://yoursite.example.com/DIR/</code>. The <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> directive, in
contrast, will apply to any content served from that location, contrast, will apply to any content served from that location,
regardless of how it is called. (An exception is filesystem links. regardless of how it is called. (An exception is filesystem links.
The same directory can be placed in more than one part of the The same directory can be placed in more than one part of the
filesystem using symbolic links. The <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> directive will follow the symbolic filesystem using symbolic links. The <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> directive will follow the symbolic
link without resetting the pathname. Therefore, for the highest level link without resetting the pathname. Therefore, for the highest level
of security, symbolic links should be disabled with the appropriate of security, symbolic links should be disabled with the appropriate
<code class="directive"><a href="../mod/core.html#options">Options</a></code> directive.)</p> <code class="directive"><a href="./mod/core.html#options">Options</a></code> directive.)</p>
<p>If you are, perhaps, thinking that none of this applies to you <p>If you are, perhaps, thinking that none of this applies to you
because you use a case-sensitive filesystem, remember that there are because you use a case-sensitive filesystem, remember that there are
@ -295,23 +295,23 @@ rule. Putting configuration restrictions in a <code>&lt;Location
to all requests regardless of the specific URL.</p> to all requests regardless of the specific URL.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="virtualhost" id="virtualhost">Virtual Hosts</a></h2> <h2><a name="virtualhost" id="virtualhost">Virtual Hosts</a></h2>
<p>The <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> <p>The <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
container encloses directives that apply to specific hosts. container encloses directives that apply to specific hosts.
This is useful when serving multiple hosts from the same machine This is useful when serving multiple hosts from the same machine
with a different configuration for each. For more information, with a different configuration for each. For more information,
see the <a href="vhosts/">Virtual Host Documentation</a>.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="proxy" id="proxy">Proxy</a></h2> <h2><a name="proxy" id="proxy">Proxy</a></h2>
<p>The <code class="directive"><a href="../mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code> <p>The <code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>
and <code class="directive"><a href="../mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code> and <code class="directive"><a href="./mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code>
containers apply enclosed configuration directives only containers apply enclosed configuration directives only
to sites accessed through <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>'s proxy server to sites accessed through <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>'s proxy server
that match the specified URL. For example, the following configuration that match the specified URL. For example, the following configuration
will prevent the proxy server from being used to access the will prevent the proxy server from being used to access the
<code>cnn.com</code> website.</p> <code>cnn.com</code> website.</p>
@ -322,39 +322,39 @@ Order allow,deny<br />
Deny from all<br /> Deny from all<br />
&lt;/Proxy&gt; &lt;/Proxy&gt;
</code></p></div> </code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="whatwhere" id="whatwhere">What Directives are Allowed?</a></h2> <h2><a name="whatwhere" id="whatwhere">What Directives are Allowed?</a></h2>
<p>To find out what directives are allowed in what types of <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. configuration sections, check the <a href="mod/directive-dict.html#Context">Context</a> of the directive.
Everything that is allowed in Everything that is allowed in
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>
sections is also syntactically allowed in sections is also syntactically allowed in
<code class="directive"><a href="../mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>,
<code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>, <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>,
<code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>,
<code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>, <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>,
<code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>,
<code class="directive"><a href="../mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>, <code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>,
and <code class="directive"><a href="../mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code> and <code class="directive"><a href="./mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code>
sections. There are some exceptions, however:</p> sections. There are some exceptions, however:</p>
<ul> <ul>
<li>The <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> directive <li>The <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> directive
works only in <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> works only in <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>
sections.</li> sections.</li>
<li>The <code>FollowSymLinks</code> and <li>The <code>FollowSymLinks</code> and
<code>SymLinksIfOwnerMatch</code> <code class="directive"><a href="../mod/core.html#options">Options</a></code> work only in <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> sections or <code>SymLinksIfOwnerMatch</code> <code class="directive"><a href="./mod/core.html#options">Options</a></code> work only in <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> sections or
<code>.htaccess</code> files.</li> <code>.htaccess</code> files.</li>
<li>The <code class="directive"><a href="../mod/core.html#options">Options</a></code> directive cannot <li>The <code class="directive"><a href="./mod/core.html#options">Options</a></code> directive cannot
be used in <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code> be used in <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>
and <code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code> and <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>
sections.</li> sections.</li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="mergin" id="mergin">How the sections are merged</a></h2> <h2><a name="mergin" id="mergin">How the sections are merged</a></h2>
@ -365,40 +365,40 @@ are interpreted, it is important to understand how this works.</p>
<p>The order of merging is:</p> <p>The order of merging is:</p>
<ol> <ol>
<li> <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> (except regular expressions) <li> <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> (except regular expressions)
and <code>.htaccess</code> done simultaneously (with and <code>.htaccess</code> done simultaneously (with
<code>.htaccess</code>, if allowed, overriding <code>.htaccess</code>, if allowed, overriding
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>)</li> <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>)</li>
<li><code class="directive"><a href="../mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code> <li><code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>
(and <code>&lt;Directory ~&gt;</code>)</li> (and <code>&lt;Directory ~&gt;</code>)</li>
<li><code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code> and <code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code> done <li><code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code> and <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code> done
simultaneously</li> simultaneously</li>
<li><code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> <li><code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
and <code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> done simultaneously</li> and <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> done simultaneously</li>
</ol> </ol>
<p>Apart from <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, each group is processed in <p>Apart from <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>, each group is processed in
the order that they appear in the configuration files. <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> (group 1 above) the order that they appear in the configuration files. <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> (group 1 above)
is processed in the order shortest directory component to longest. is processed in the order shortest directory component to longest.
So for example, <code>&lt;Directory /var/web/dir&gt;</code> will So for example, <code>&lt;Directory /var/web/dir&gt;</code> will
be processed before <code>&lt;Directory be processed before <code>&lt;Directory
/var/web/dir/subdir&gt;</code>. If multiple <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> sections apply /var/web/dir/subdir&gt;</code>. If multiple <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> sections apply
to the same directory they are processed in the configuration file to the same directory they are processed in the configuration file
order. Configurations included via the <code class="directive"><a href="../mod/core.html#include">Include</a></code> directive will be treated as if order. Configurations included via the <code class="directive"><a href="./mod/core.html#include">Include</a></code> directive will be treated as if
they were inside the including file at the location of the they were inside the including file at the location of the
<code class="directive"><a href="../mod/core.html#include">Include</a></code> directive.</p> <code class="directive"><a href="./mod/core.html#include">Include</a></code> directive.</p>
<p>Sections inside <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> sections <p>Sections inside <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> sections
are applied <em>after</em> the corresponding sections outside are applied <em>after</em> the corresponding sections outside
the virtual host definition. This allows virtual hosts to the virtual host definition. This allows virtual hosts to
override the main server configuration.</p> override the main server configuration.</p>
<p>When the request is served by <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, the <p>When the request is served by <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>, the
<code class="directive"><a href="../mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code> <code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>
container takes the place of the <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> container in the processing container takes the place of the <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> container in the processing
order.</p> order.</p>
<p>Later sections override earlier ones.</p> <p>Later sections override earlier ones.</p>
@ -446,7 +446,7 @@ A<br />
</code></p></div> </code></p></div>
<p>For a more concrete example, consider the following. Regardless of <p>For a more concrete example, consider the following. Regardless of
any access restrictions placed in <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> sections, the <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> section will be any access restrictions placed in <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> sections, the <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code> section will be
evaluated last and will allow unrestricted access to the server. In evaluated last and will allow unrestricted access to the server. In
other words, order of merging is important, so be careful!</p> other words, order of merging is important, so be careful!</p>
@ -468,10 +468,10 @@ Deny from badguy.example.com<br />
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./sections.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/sections.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./sections.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./sections.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/sections.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>sections</basename> <basename>sections</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

66
docs/manual/server-wide.html.en
View File

@ -6,74 +6,74 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Server-Wide Configuration - Apache HTTP Server</title> <title>Server-Wide Configuration - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Server-Wide Configuration</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Server-Wide Configuration</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./server-wide.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/server-wide.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./server-wide.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./server-wide.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This document explains some of the directives provided by <p>This document explains some of the directives provided by
the <code class="module"><a href="../mod/core.html">core</a></code> server which are used to configure the <code class="module"><a href="./mod/core.html">core</a></code> server which are used to configure
the basic operations of the server.</p> the basic operations of the server.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#identification">Server Identification</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#identification">Server Identification</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#locations">File Locations</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#locations">File Locations</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#resource">Limiting Resource Usage</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#resource">Limiting Resource Usage</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="identification" id="identification">Server Identification</a></h2> <h2><a name="identification" id="identification">Server Identification</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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>
<p>The <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code> and <p>The <code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> and
<code class="directive"><a href="../mod/core.html#servertokens">ServerTokens</a></code> directives <code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> directives
control what information about the server will be presented control what information about the server will be presented
in server-generated documents such as error messages. The in server-generated documents such as error messages. The
<code class="directive"><a href="../mod/core.html#servertokens">ServerTokens</a></code> directive <code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> directive
sets the value of the Server HTTP response header field.</p> sets the value of the Server HTTP response header field.</p>
<p>The <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, <p>The <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>,
<code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> and <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> and
<code class="directive"><a href="../mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> <code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
directives are used by the server to determine how to construct directives are used by the server to determine how to construct
self-referential URLs. For example, when a client requests a self-referential URLs. For example, when a client requests a
directory, but does not include the trailing slash in the directory, but does not include the trailing slash in the
directory name, Apache must redirect the client to the full directory name, Apache must redirect the client to the full
name including the trailing slash so that the client will name including the trailing slash so that the client will
correctly resolve relative references in the document.</p> 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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="locations" id="locations">File Locations</a></h2> <h2><a name="locations" id="locations">File Locations</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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/mpm_common.html#lockfile">LockFile</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> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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/mpm_common.html#lockfile">LockFile</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>
<p>These directives control the locations of the various files <p>These directives control the locations of the various files
that Apache needs for proper operation. When the pathname used that Apache needs for proper operation. When the pathname used
does not begin with a slash (/), the files are located relative does not begin with a slash (/), the files are located relative
to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. Be careful to the <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>. Be careful
about locating files in paths which are writable by non-root users. about locating files in paths which are writable by non-root users.
See the <a href="misc/security_tips.html#serverroot">security tips</a> See the <a href="misc/security_tips.html#serverroot">security tips</a>
documentation for more details.</p> documentation for more details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="resource" id="resource">Limiting Resource Usage</a></h2> <h2><a name="resource" id="resource">Limiting Resource Usage</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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> <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><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>
<p>The <code class="directive">LimitRequest</code>* <p>The <code class="directive">LimitRequest</code>*
directives are used to place limits on the amount of resources directives are used to place limits on the amount of resources
@ -87,14 +87,14 @@ the basic operations of the server.</p>
this will control resources used by CGI scripts and SSI exec this will control resources used by CGI scripts and SSI exec
commands.</p> commands.</p>
<p>The <code class="directive"><a href="../mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> <p>The <code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
directive is used with some platforms to control the stack size.</p> directive is used with some platforms to control the stack size.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./server-wide.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/server-wide.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./server-wide.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./server-wide.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/server-wide.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>server-wide</basename> <basename>server-wide</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

86
docs/manual/sitemap.html.en
View File

@ -6,25 +6,25 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Sitemap - Apache HTTP Server</title> <title>Sitemap - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"> <body id="manual-page">
<div id="page-header"> <div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div>
<div id="page-content"><div id="preamble"><h1>Sitemap</h1> <div id="page-content"><div id="preamble"><h1>Sitemap</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./sitemap.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./sitemap.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/sitemap.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./sitemap.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./sitemap.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./sitemap.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This page lists the currently available documents of the <p>This page lists the currently available documents of the
@ -32,21 +32,21 @@
Documentation</a>.</p> Documentation</a>.</p>
</div> </div>
<div id="quickview"><ul id="toc"> <div id="quickview"><ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#release">Release Notes</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#release">Release Notes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using">Using the Apache HTTP Server</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#using">Using the Apache HTTP Server</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#vhosts">Apache Virtual Host documentation</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#vhosts">Apache Virtual Host documentation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#faq">Apache Server Frequently Asked Questions</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#faq">Apache Server Frequently Asked Questions</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssl">Apache SSL/TLS Encryption</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#ssl">Apache SSL/TLS Encryption</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#howto">Guides, Tutorials, and HowTos</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#howto">Guides, Tutorials, and HowTos</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#platform">Platform-specific Notes</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#platform">Platform-specific Notes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#programs">Apache HTTP Server and Supporting Programs</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#programs">Apache HTTP Server and Supporting Programs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#misc">Apache Miscellaneous Documentation</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#misc">Apache Miscellaneous Documentation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#modules">Apache modules</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#modules">Apache modules</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#developer">Developer Documentation</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#developer">Developer Documentation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#index">Glossary and Index</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#index">Glossary and Index</a></li>
</ul> </ul>
</div> </div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"><h2><a name="release" id="release">Release Notes</a></h2> <div class="section"><h2><a name="release" id="release">Release Notes</a></h2>
<ul><li><a href="upgrading.html">Upgrading to 2.2 from 2.0</a></li> <ul><li><a href="upgrading.html">Upgrading to 2.2 from 2.0</a></li>
<li><a href="new_features_2_4.html">New features with Apache 2.4</a></li> <li><a href="new_features_2_4.html">New features with Apache 2.4</a></li>
@ -54,7 +54,7 @@ Documentation</a>.</p>
<li><a href="new_features_2_0.html">New features with Apache 2.0</a></li> <li><a href="new_features_2_0.html">New features with Apache 2.0</a></li>
<li><a href="license.html">Apache License</a></li> <li><a href="license.html">Apache License</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </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 Apache HTTP Server</a></h2> <div class="section"><h2><a name="using" id="using">Using the Apache HTTP Server</a></h2>
<ul><li><a href="install.html">Compiling and Installing Apache</a></li> <ul><li><a href="install.html">Compiling and Installing Apache</a></li>
<li><a href="invoking.html">Starting Apache</a></li> <li><a href="invoking.html">Starting Apache</a></li>
@ -78,7 +78,7 @@ Documentation</a>.</p>
<li><a href="misc/perf-tuning.html">Performance Hints</a></li> <li><a href="misc/perf-tuning.html">Performance Hints</a></li>
<li><a href="misc/rewriteguide.html">URL Rewriting Guide</a></li> <li><a href="misc/rewriteguide.html">URL Rewriting Guide</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </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">Apache Virtual Host documentation</a></h2> <div class="section"><h2><a name="vhosts" id="vhosts">Apache Virtual Host documentation</a></h2>
<ul><li class="separate"><a href="vhosts/">Overview</a></li> <ul><li class="separate"><a href="vhosts/">Overview</a></li>
<li><a href="vhosts/name-based.html">Name-based Virtual Hosts</a></li> <li><a href="vhosts/name-based.html">Name-based Virtual Hosts</a></li>
@ -89,14 +89,14 @@ Documentation</a>.</p>
<li><a href="vhosts/fd-limits.html">File descriptor limitations</a></li> <li><a href="vhosts/fd-limits.html">File descriptor limitations</a></li>
<li><a href="dns-caveats.html">Issues Regarding DNS and Apache</a></li> <li><a href="dns-caveats.html">Issues Regarding DNS and Apache</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"><h2><a name="faq" id="faq">Apache Server Frequently Asked Questions</a></h2> <div class="section"><h2><a name="faq" id="faq">Apache Server Frequently Asked Questions</a></h2>
<ul><li><a href="faq/">Overview</a></li> <ul><li><a href="faq/">Overview</a></li>
<li><a href="faq/background.html">Background Information</a></li> <li><a href="faq/background.html">Background Information</a></li>
<li><a href="faq/support.html">Support</a></li> <li><a href="faq/support.html">Support</a></li>
<li><a href="faq/error.html">Error Messages</a></li> <li><a href="faq/error.html">Error Messages</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </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">Apache SSL/TLS Encryption</a></h2> <div class="section"><h2><a name="ssl" id="ssl">Apache SSL/TLS Encryption</a></h2>
<ul><li class="separate"><a href="ssl/">Overview</a></li> <ul><li class="separate"><a href="ssl/">Overview</a></li>
<li><a href="ssl/ssl_intro.html">SSL/TLS Encryption: An Introduction</a></li> <li><a href="ssl/ssl_intro.html">SSL/TLS Encryption: An Introduction</a></li>
@ -104,7 +104,7 @@ Documentation</a>.</p>
<li><a href="ssl/ssl_howto.html">SSL/TLS Encryption: How-To</a></li> <li><a href="ssl/ssl_howto.html">SSL/TLS Encryption: How-To</a></li>
<li><a href="ssl/ssl_faq.html">SSL/TLS Encryption: FAQ</a></li> <li><a href="ssl/ssl_faq.html">SSL/TLS Encryption: FAQ</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </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">Guides, Tutorials, and HowTos</a></h2> <div class="section"><h2><a name="howto" id="howto">Guides, Tutorials, and HowTos</a></h2>
<ul><li class="separate"><a href="howto/">Overview</a></li> <ul><li class="separate"><a href="howto/">Overview</a></li>
<li><a href="howto/auth.html">Authentication</a></li> <li><a href="howto/auth.html">Authentication</a></li>
@ -113,7 +113,7 @@ Documentation</a>.</p>
<li><a href="howto/htaccess.html">.htaccess files</a></li> <li><a href="howto/htaccess.html">.htaccess files</a></li>
<li><a href="howto/public_html.html">Per-user web directories</a></li> <li><a href="howto/public_html.html">Per-user web directories</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"><h2><a name="platform" id="platform">Platform-specific Notes</a></h2> <div class="section"><h2><a name="platform" id="platform">Platform-specific Notes</a></h2>
<ul><li class="separate"><a href="platform/">Overview</a></li> <ul><li class="separate"><a href="platform/">Overview</a></li>
<li><a href="platform/windows.html">Using Apache with Microsoft <li><a href="platform/windows.html">Using Apache with Microsoft
@ -125,7 +125,7 @@ Microsoft Windows</a></li>
Server on HPUX</a></li> Server on HPUX</a></li>
<li><a href="platform/ebcdic.html">The Apache EBCDIC Port</a></li> <li><a href="platform/ebcdic.html">The Apache EBCDIC Port</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </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">Apache HTTP Server and Supporting Programs</a></h2> <div class="section"><h2><a name="programs" id="programs">Apache HTTP Server and Supporting Programs</a></h2>
<ul><li class="separate"><a href="programs/">Overview</a></li> <ul><li class="separate"><a href="programs/">Overview</a></li>
<li><a href="programs/httpd.html">Manual Page: httpd</a></li> <li><a href="programs/httpd.html">Manual Page: httpd</a></li>
@ -143,12 +143,12 @@ Server on HPUX</a></li>
<li><a href="programs/suexec.html">Manual Page: suexec</a></li> <li><a href="programs/suexec.html">Manual Page: suexec</a></li>
<li><a href="programs/other.html">Other Programs</a></li> <li><a href="programs/other.html">Other Programs</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"><h2><a name="misc" id="misc">Apache Miscellaneous Documentation</a></h2> <div class="section"><h2><a name="misc" id="misc">Apache Miscellaneous Documentation</a></h2>
<ul><li class="separate"><a href="misc/">Overview</a></li> <ul><li class="separate"><a href="misc/">Overview</a></li>
<li><a href="misc/relevant_standards.html">Relevant Standards</a></li> <li><a href="misc/relevant_standards.html">Relevant Standards</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </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">Apache modules</a></h2> <div class="section"><h2><a name="modules" id="modules">Apache modules</a></h2>
<ul><li><a href="mod/module-dict.html">Definitions of terms used to describe Apache modules</a></li> <ul><li><a href="mod/module-dict.html">Definitions of terms used to describe Apache modules</a></li>
<li><a href="mod/directive-dict.html">Definitions of terms used to describe Apache directives</a></li> <li><a href="mod/directive-dict.html">Definitions of terms used to describe Apache directives</a></li>
@ -240,7 +240,7 @@ Server on HPUX</a></li>
<li><a href="mod/mod_version.html">Apache Module mod_version</a></li> <li><a href="mod/mod_version.html">Apache Module mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">Apache Module mod_vhost_alias</a></li> <li><a href="mod/mod_vhost_alias.html">Apache Module mod_vhost_alias</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </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">Developer Documentation</a></h2> <div class="section"><h2><a name="developer" id="developer">Developer Documentation</a></h2>
<ul><li class="separate"><a href="developer/">Overview</a></li> <ul><li class="separate"><a href="developer/">Overview</a></li>
<li><a href="developer/API.html">Apache API notes</a></li> <li><a href="developer/API.html">Apache API notes</a></li>
@ -251,7 +251,7 @@ Server on HPUX</a></li>
<li><a href="developer/request.html">Request Processing in Apache 2.0</a></li> <li><a href="developer/request.html">Request Processing in Apache 2.0</a></li>
<li><a href="developer/filters.html">How Filters Work in Apache 2.0</a></li> <li><a href="developer/filters.html">How Filters Work in Apache 2.0</a></li>
</ul> </ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </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">Glossary and Index</a></h2> <div class="section"><h2><a name="index" id="index">Glossary and Index</a></h2>
<ul><li><a href="glossary.html">Glossary</a></li> <ul><li><a href="glossary.html">Glossary</a></li>
<li><a href="mod/">Module index</a></li> <li><a href="mod/">Module index</a></li>
@ -260,12 +260,12 @@ Server on HPUX</a></li>
</ul> </ul>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./sitemap.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./sitemap.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/sitemap.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./sitemap.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./sitemap.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./sitemap.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/sitemap.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>sitemap</basename> <basename>sitemap</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>de</variant> <variant>de</variant>

108
docs/manual/stopping.html.en
View File

@ -6,23 +6,23 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Stopping and Restarting - Apache HTTP Server</title> <title>Stopping and Restarting - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Stopping and Restarting</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Stopping and Restarting</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./stopping.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./stopping.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/stopping.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./stopping.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./stopping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./stopping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This document covers stopping and restarting Apache on <p>This document covers stopping and restarting Apache on
@ -32,23 +32,23 @@
Console Application</a> for information on how to control Console Application</a> for information on how to control
Apache on those platforms.</p> Apache on those platforms.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#term">Stop Now</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#term">Stop Now</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#graceful">Graceful Restart</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#graceful">Graceful Restart</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#hup">Restart Now</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#hup">Restart Now</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#gracefulstop">Graceful Stop</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">Graceful Stop</a></li>
</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/apachectl.html">apachectl</a></code></li><li><a href="invoking.html">Starting</a></li></ul></div> </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/apachectl.html">apachectl</a></code></li><li><a href="invoking.html">Starting</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="introduction" id="introduction">Introduction</a></h2> <h2><a name="introduction" id="introduction">Introduction</a></h2>
<p>In order to stop or restart Apache, you must send a signal to <p>In order to stop or restart Apache, you must send a signal to
the running <code class="program"><a href="../programs/httpd.html">httpd</a></code> processes. There are two ways to the running <code class="program"><a href="./programs/httpd.html">httpd</a></code> processes. There are two ways to
send the signals. First, you can use the unix <code>kill</code> send the signals. First, you can use the unix <code>kill</code>
command to directly send signals to the processes. You will command to directly send signals to the processes. You will
notice many <code class="program"><a href="../programs/httpd.html">httpd</a></code> executables running on your system, notice many <code class="program"><a href="./programs/httpd.html">httpd</a></code> executables running on your system,
but you should not send signals to any of them except the parent, but you should not send signals to any of them except the parent,
whose pid is in the <code class="directive"><a href="../mod/mpm_common.html#pidfile">PidFile</a></code>. That is to say you whose pid is in the <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>. That is to say you
shouldn't ever need to send signals to any process except the shouldn't ever need to send signals to any process except the
parent. There are four signals that you can send the parent: parent. There are four signals that you can send the parent:
<code><a href="#term">TERM</a></code>, <code><a href="#term">TERM</a></code>,
@ -62,20 +62,20 @@
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div> <div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p>The second method of signaling the <code class="program"><a href="../programs/httpd.html">httpd</a></code> processes <p>The second method of signaling the <code class="program"><a href="./programs/httpd.html">httpd</a></code> processes
is to use the <code>-k</code> command line options: <code>stop</code>, is to use the <code>-k</code> command line options: <code>stop</code>,
<code>restart</code>, <code>graceful</code> and <code>graceful-stop</code>, <code>restart</code>, <code>graceful</code> and <code>graceful-stop</code>,
as described below. These are arguments to the <code class="program"><a href="../programs/httpd.html">httpd</a></code> binary, but we recommend that as described below. These are arguments to the <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary, but we recommend that
you send them using the <code class="program"><a href="../programs/apachectl.html">apachectl</a></code> control script, which you send them using the <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> control script, which
will pass them through to <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p> will pass them through to <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p>
<p>After you have signaled <code class="program"><a href="../programs/httpd.html">httpd</a></code>, you can read about <p>After you have signaled <code class="program"><a href="./programs/httpd.html">httpd</a></code>, you can read about
its progress by issuing:</p> its progress by issuing:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div> <div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>Modify those examples to match your <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> and <code class="directive"><a href="../mod/mpm_common.html#pidfile">PidFile</a></code> settings.</p> <p>Modify those examples to match your <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> and <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> settings.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="term" id="term">Stop Now</a></h2> <h2><a name="term" id="term">Stop Now</a></h2>
@ -88,7 +88,7 @@
children. It may take it several seconds to complete killing off children. It may take it several seconds to complete killing off
its children. Then the parent itself exits. Any requests in its children. Then the parent itself exits. Any requests in
progress are terminated, and no further requests are served.</p> progress are terminated, and no further requests are served.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="graceful" id="graceful">Graceful Restart</a></h2> <h2><a name="graceful" id="graceful">Graceful Restart</a></h2>
@ -108,15 +108,15 @@
directive of the MPMs, so the number of processes and threads directive of the MPMs, so the number of processes and threads
available to serve clients will be maintained at the appropriate available to serve clients will be maintained at the appropriate
values throughout the restart process. Furthermore, it respects values throughout the restart process. Furthermore, it respects
<code class="directive"><a href="../mod/mpm_common.html#startservers">StartServers</a></code> in the <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> in the
following manner: if after one second at least <code class="directive"><a href="../mod/mpm_common.html#startservers">StartServers</a></code> new children have not following manner: if after one second at least <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> new children have not
been created, then create enough to pick up the slack. Hence the been created, then create enough to pick up the slack. Hence the
code tries to maintain both the number of children appropriate for code tries to maintain both the number of children appropriate for
the current load on the server, and respect your wishes with the the current load on the server, and respect your wishes with the
<code class="directive"><a href="../mod/mpm_common.html#startservers">StartServers</a></code> <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
parameter.</p> parameter.</p>
<p>Users of <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> <p>Users of <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
will notice that the server statistics are <strong>not</strong> will notice that the server statistics are <strong>not</strong>
set to zero when a <code>USR1</code> is sent. The code was set to zero when a <code>USR1</code> is sent. The code was
written to both minimize the time in which the server is unable written to both minimize the time in which the server is unable
@ -150,13 +150,13 @@
<p>This still will not <p>This still will not
guarantee that the server will restart correctly. To check the guarantee that the server will restart correctly. To check the
semantics of the configuration files as well as the syntax, you semantics of the configuration files as well as the syntax, you
can try starting <code class="program"><a href="../programs/httpd.html">httpd</a></code> as a non-root user. If there can try starting <code class="program"><a href="./programs/httpd.html">httpd</a></code> as a non-root user. If there
are no errors it will attempt to open its sockets and logs and fail are no errors it will attempt to open its sockets and logs and fail
because it's not root (or because the currently running because it's not root (or because the currently running
<code class="program"><a href="../programs/httpd.html">httpd</a></code> already has those ports bound). If it fails <code class="program"><a href="./programs/httpd.html">httpd</a></code> already has those ports bound). If it fails
for any other reason then it's probably a config file error and the error for any other reason then it's probably a config file error and the error
should be fixed before issuing the graceful restart.</p></div> should be fixed before issuing the graceful restart.</p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="hup" id="hup">Restart Now</a></h2> <h2><a name="hup" id="hup">Restart Now</a></h2>
@ -170,7 +170,7 @@
configuration files, and re-opens any log files. Then it spawns a configuration files, and re-opens any log files. Then it spawns a
new set of children and continues serving hits.</p> new set of children and continues serving hits.</p>
<p>Users of <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> <p>Users of <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
will notice that the server statistics are set to zero when a will notice that the server statistics are set to zero when a
<code>HUP</code> is sent.</p> <code>HUP</code> is sent.</p>
@ -178,7 +178,7 @@
restart is attempted. If your configuration file has errors in it, the restart is attempted. If your configuration file has errors in it, the
restart will not be attempted, and you will receive notification of the restart will not be attempted, and you will receive notification of the
syntax error(s).</div> syntax error(s).</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="gracefulstop" id="gracefulstop">Graceful Stop</a></h2> <h2><a name="gracefulstop" id="gracefulstop">Graceful Stop</a></h2>
@ -189,45 +189,45 @@ syntax error(s).</div>
<p>The <code>WINCH</code> or <code>graceful-stop</code> signal causes <p>The <code>WINCH</code> or <code>graceful-stop</code> signal causes
the parent process to <em>advise</em> the children to exit after the parent process to <em>advise</em> the children to exit after
their current request (or to exit immediately if they're not their current request (or to exit immediately if they're not
serving anything). The parent will then remove its <code class="directive"><a href="../mod/mpm_common.html#pidfile">PidFile</a></code> and cease listening on serving anything). The parent will then remove its <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> and cease listening on
all ports. The parent will continue to run, and monitor children all ports. The parent will continue to run, and monitor children
which are handling requests. Once all children have finalised which are handling requests. Once all children have finalised
and exited or the timeout specified by the <code class="directive"><a href="../mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> has been and exited or the timeout specified by the <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> has been
reached, the parent will also exit. If the timeout is reached, reached, the parent will also exit. If the timeout is reached,
any remaining children will be sent the <code>TERM</code> signal any remaining children will be sent the <code>TERM</code> signal
to force them to exit.</p> to force them to exit.</p>
<p>A <code>TERM</code> signal will immediately terminate the <p>A <code>TERM</code> signal will immediately terminate the
parent process and all children when in the "graceful" state. However parent process and all children when in the "graceful" state. However
as the <code class="directive"><a href="../mod/mpm_common.html#pidfile">PidFile</a></code> will as the <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> will
have been removed, you will not be able to use have been removed, you will not be able to use
<code>apachectl</code> or <code>httpd</code> to send this signal,</p> <code>apachectl</code> or <code>httpd</code> to send this signal,</p>
<div class="note"><p>The <code>graceful-stop</code> signal allows you to run multiple <div class="note"><p>The <code>graceful-stop</code> signal allows you to run multiple
identically configured instances of <code class="program"><a href="../programs/httpd.html">httpd</a></code> at the identically configured instances of <code class="program"><a href="./programs/httpd.html">httpd</a></code> at the
same time. This is a powerful feature when performing graceful same time. This is a powerful feature when performing graceful
upgrades of Apache, however it can also cause deadlocks and race upgrades of Apache, however it can also cause deadlocks and race
conditions with some configurations.</p> conditions with some configurations.</p>
<p>Care has been taken to ensure that on-disk files <p>Care has been taken to ensure that on-disk files
such as the <code class="directive"><a href="../mod/core.html#lockfile">Lockfile</a></code> and <code class="directive"><a href="../mod/mod_cgid.html#scriptsock">ScriptSock</a></code> files contain the server such as the <code class="directive"><a href="./mod/core.html#lockfile">Lockfile</a></code> and <code class="directive"><a href="./mod/mod_cgid.html#scriptsock">ScriptSock</a></code> files contain the server
PID, and should co-exist without problem. However, if a configuration PID, and should co-exist without problem. However, if a configuration
directive, third-party module or persistent CGI utilises any other on-disk directive, third-party module or persistent CGI utilises any other on-disk
lock or state files; care should be taken to ensure that multiple running lock or state files; care should be taken to ensure that multiple running
instances of <code class="program"><a href="../programs/httpd.html">httpd</a></code> do not clobber each others files.</p> instances of <code class="program"><a href="./programs/httpd.html">httpd</a></code> do not clobber each others files.</p>
<p>You should also be wary of other potential race conditions, such as <p>You should also be wary of other potential race conditions, such as
using <code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code> style piped logging. Multiple running using <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> style piped logging. Multiple running
instances of <code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code> attempting to rotate the same instances of <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> attempting to rotate the same
logfiles at the same time may destroy each other's logfiles.</p></div> logfiles at the same time may destroy each other's logfiles.</p></div>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./stopping.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./stopping.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/stopping.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/./stopping.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> | <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../ja/./stopping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./stopping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/stopping.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>stopping</basename> <basename>stopping</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant outdated="yes">de</variant> <variant outdated="yes">de</variant>

80
docs/manual/suexec.html.en
View File

@ -6,21 +6,21 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>suEXEC Support - Apache HTTP Server</title> <title>suEXEC Support - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>suEXEC Support</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>suEXEC Support</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./suexec.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/suexec.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./suexec.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./suexec.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>The <strong>suEXEC</strong> feature provides <p>The <strong>suEXEC</strong> feature provides
@ -39,18 +39,18 @@
and the security issues they present, we highly recommend that and the security issues they present, we highly recommend that
you not consider using suEXEC.</p> you not consider using suEXEC.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#before">Before we begin</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#before">Before we begin</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#model">suEXEC Security Model</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#model">suEXEC Security Model</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#install">Configuring &amp; Installing <li><img alt="" src="./images/down.gif" /> <a href="#install">Configuring &amp; Installing
suEXEC</a></li> suEXEC</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#enable">Enabling &amp; Disabling <li><img alt="" src="./images/down.gif" /> <a href="#enable">Enabling &amp; Disabling
suEXEC</a></li> suEXEC</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#usage">Using suEXEC</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#usage">Using suEXEC</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#debug">Debugging suEXEC</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#debug">Debugging suEXEC</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#jabberwock">Beware the Jabberwock: <li><img alt="" src="./images/down.gif" /> <a href="#jabberwock">Beware the Jabberwock:
Warnings &amp; Examples</a></li> Warnings &amp; Examples</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="before" id="before">Before we begin</a></h2> <h2><a name="before" id="before">Before we begin</a></h2>
@ -98,7 +98,7 @@
enough to use it.</p> enough to use it.</p>
<p>Still with us? Yes? Good. Let's move on!</p> <p>Still with us? Yes? Good. Let's move on!</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="model" id="model">suEXEC Security Model</a></h2> <h2><a name="model" id="model">suEXEC Security Model</a></h2>
@ -348,7 +348,7 @@
configuration, as well as what security risks can be avoided configuration, as well as what security risks can be avoided
with a proper suEXEC setup, see the <a href="#jabberwock">"Beware the Jabberwock"</a> section of this with a proper suEXEC setup, see the <a href="#jabberwock">"Beware the Jabberwock"</a> section of this
document.</p> document.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="install" id="install">Configuring &amp; Installing <h2><a name="install" id="install">Configuring &amp; Installing
suEXEC</a></h2> suEXEC</a></h2>
@ -456,7 +456,7 @@
<p><strong>Setting paranoid permissions</strong><br /> <p><strong>Setting paranoid permissions</strong><br />
Although the suEXEC wrapper will check to ensure that its Although the suEXEC wrapper will check to ensure that its
caller is the correct user as specified with the caller is the correct user as specified with the
<code>--with-suexec-caller</code> <code class="program"><a href="../programs/configure.html">configure</a></code> <code>--with-suexec-caller</code> <code class="program"><a href="./programs/configure.html">configure</a></code>
option, there is option, there is
always the possibility that a system or library call suEXEC uses always the possibility that a system or library call suEXEC uses
before this check may be exploitable on your system. To counter before this check may be exploitable on your system. To counter
@ -471,7 +471,7 @@
Group webgroup<br /> Group webgroup<br />
</code></p></div> </code></p></div>
<p>and <code class="program"><a href="../programs/suexec.html">suexec</a></code> is installed at <p>and <code class="program"><a href="./programs/suexec.html">suexec</a></code> is installed at
"/usr/local/apache2/sbin/suexec", you should run:</p> "/usr/local/apache2/sbin/suexec", you should run:</p>
<div class="example"><p><code> <div class="example"><p><code>
@ -481,13 +481,13 @@
<p>This will ensure that only the group Apache runs as can even <p>This will ensure that only the group Apache runs as can even
execute the suEXEC wrapper.</p> execute the suEXEC wrapper.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="enable" id="enable">Enabling &amp; Disabling <h2><a name="enable" id="enable">Enabling &amp; Disabling
suEXEC</a></h2> suEXEC</a></h2>
<p>Upon startup of Apache, it looks for the file <p>Upon startup of Apache, it looks for the file
<code class="program"><a href="../programs/suexec.html">suexec</a></code> in the directory defined by the <code class="program"><a href="./programs/suexec.html">suexec</a></code> in the directory defined by the
<code>--sbindir</code> option (default is <code>--sbindir</code> option (default is
"/usr/local/apache/sbin/suexec"). If Apache finds a properly "/usr/local/apache/sbin/suexec"). If Apache finds a properly
configured suEXEC wrapper, it will print the following message configured suEXEC wrapper, it will print the following message
@ -506,33 +506,33 @@
restart Apache. Restarting it with a simple HUP or USR1 signal restart Apache. Restarting it with a simple HUP or USR1 signal
will not be enough. </p> will not be enough. </p>
<p>If you want to disable suEXEC you should kill and restart <p>If you want to disable suEXEC you should kill and restart
Apache after you have removed the <code class="program"><a href="../programs/suexec.html">suexec</a></code> file.</p> Apache after you have removed the <code class="program"><a href="./programs/suexec.html">suexec</a></code> file.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="usage" id="usage">Using suEXEC</a></h2> <h2><a name="usage" id="usage">Using suEXEC</a></h2>
<p>Requests for CGI programs will call the suEXEC wrapper only if <p>Requests for CGI programs will call the suEXEC wrapper only if
they are for a virtual host containing a <code class="directive"><a href="../mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> directive or if they are for a virtual host containing a <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> directive or if
they are processed by <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</p> they are processed by <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>.</p>
<p><strong>Virtual Hosts:</strong><br /> One way to use the suEXEC <p><strong>Virtual Hosts:</strong><br /> One way to use the suEXEC
wrapper is through the <code class="directive"><a href="../mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> directive in wrapper is through the <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> directive in
<code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> definitions. By <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> definitions. By
setting this directive to values different from the main server setting this directive to values different from the main server
user ID, all requests for CGI resources will be executed as the user ID, all requests for CGI resources will be executed as the
<em>User</em> and <em>Group</em> defined for that <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>. If this <em>User</em> and <em>Group</em> defined for that <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>. If this
directive is not specified for a <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> then the main server userid directive is not specified for a <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> then the main server userid
is assumed.</p> is assumed.</p>
<p><strong>User directories:</strong><br /> Requests that are <p><strong>User directories:</strong><br /> Requests that are
processed by <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> will call the suEXEC processed by <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> will call the suEXEC
wrapper to execute CGI programs under the userid of the requested wrapper to execute CGI programs under the userid of the requested
user directory. The only requirement needed for this feature to user directory. The only requirement needed for this feature to
work is for CGI execution to be enabled for the user and that the work is for CGI execution to be enabled for the user and that the
script must meet the scrutiny of the <a href="#model">security script must meet the scrutiny of the <a href="#model">security
checks</a> above. See also the checks</a> above. See also the
<code>--with-suexec-userdir</code> <a href="#install">compile <code>--with-suexec-userdir</code> <a href="#install">compile
time option</a>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> time option</a>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="debug" id="debug">Debugging suEXEC</a></h2> <h2><a name="debug" id="debug">Debugging suEXEC</a></h2>
@ -542,7 +542,7 @@
installed the wrapper properly, have a look at this log and the installed the wrapper properly, have a look at this log and the
error_log for the server to see where you may have gone astray.</p> error_log for the server to see where you may have gone astray.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="jabberwock" id="jabberwock">Beware the Jabberwock: <h2><a name="jabberwock" id="jabberwock">Beware the Jabberwock:
Warnings &amp; Examples</a></h2> Warnings &amp; Examples</a></h2>
@ -599,10 +599,10 @@
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./suexec.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/suexec.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./suexec.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./suexec.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/suexec.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>suexec</basename> <basename>suexec</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>

58
docs/manual/upgrading.html.en
View File

@ -6,24 +6,24 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Upgrading to 2.4 from 2.2 - Apache HTTP Server</title> <title>Upgrading to 2.4 from 2.2 - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Upgrading to 2.4 from 2.2</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Upgrading to 2.4 from 2.2</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../de/./upgrading.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/upgrading.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./upgrading.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/upgrading.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./upgrading.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/upgrading.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./upgrading.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> | <a href="./ko/upgrading.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../pt-br/./upgrading.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a> | <a href="./pt-br/upgrading.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a> |
<a href="../ru/./upgrading.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a></p> <a href="./ru/upgrading.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a></p>
</div> </div>
<p>In order to assist folks upgrading, we maintain a document <p>In order to assist folks upgrading, we maintain a document
@ -37,43 +37,43 @@
upgrading document.</a></p> upgrading document.</a></p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#compile-time">Compile-Time Configuration Changes</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#compile-time">Compile-Time Configuration Changes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#run-time">Run-Time Configuration Changes</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#run-time">Run-Time Configuration Changes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#misc">Misc Changes</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#misc">Misc Changes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#third-party">Third Party Modules</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#third-party">Third Party Modules</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="new_features_2_4.html">Overview of new features in </ul><h3>See also</h3><ul class="seealso"><li><a href="new_features_2_4.html">Overview of new features in
Apache 2.4</a></li></ul></div> Apache 2.4</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="compile-time" id="compile-time">Compile-Time Configuration Changes</a></h2> <h2><a name="compile-time" id="compile-time">Compile-Time Configuration Changes</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="run-time" id="run-time">Run-Time Configuration Changes</a></h2> <h2><a name="run-time" id="run-time">Run-Time Configuration Changes</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="misc" id="misc">Misc Changes</a></h2> <h2><a name="misc" id="misc">Misc Changes</a></h2>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="third-party" id="third-party">Third Party Modules</a></h2> <h2><a name="third-party" id="third-party">Third Party Modules</a></h2>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/./upgrading.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> | <p><span>Available Languages: </span><a href="./de/upgrading.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/./upgrading.html" title="English">&nbsp;en&nbsp;</a> | <a href="./en/upgrading.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./upgrading.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/upgrading.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./upgrading.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> | <a href="./ko/upgrading.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../pt-br/./upgrading.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a> | <a href="./pt-br/upgrading.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a> |
<a href="../ru/./upgrading.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a></p> <a href="./ru/upgrading.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/upgrading.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>upgrading</basename> <basename>upgrading</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant outdated="yes">de</variant> <variant outdated="yes">de</variant>

120
docs/manual/urlmapping.html.en
View File

@ -6,55 +6,55 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
--> -->
<title>Mapping URLs to Filesystem Locations - Apache HTTP Server</title> <title>Mapping URLs to Filesystem Locations - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <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-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 href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head> <link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header"> <body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.3</p> <p class="apache">Apache HTTP Server Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div> <img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div> <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
<div id="path"> <div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Mapping URLs to Filesystem Locations</h1> <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Mapping URLs to Filesystem Locations</h1>
<div class="toplang"> <div class="toplang">
<p><span>Available Languages: </span><a href="../en/./urlmapping.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/urlmapping.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./urlmapping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./urlmapping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div> </div>
<p>This document explains how Apache uses the URL of a request <p>This document explains how Apache uses the URL of a request
to determine the filesystem location from which to serve a to determine the filesystem location from which to serve a
file.</p> file.</p>
</div> </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Related Modules and Directives</a></li> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">Related Modules and Directives</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#outside">Files Outside the DocumentRoot</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#outside">Files Outside the DocumentRoot</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#user">User Directories</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#user">User Directories</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirect">URL Redirection</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#redirect">URL Redirection</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#proxy">Reverse Proxy</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#proxy">Reverse Proxy</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Rewriting Engine</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#rewrite">Rewriting Engine</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#notfound">File Not Found</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#notfound">File Not Found</a></li>
</ul></div> </ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="related" id="related">Related Modules and Directives</a></h2> <h2><a name="related" id="related">Related Modules and Directives</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_proxy.html">mod_proxy</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_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><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#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="../mod/mod_speling.html#checkspelling">CheckSpelling</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#errordocument">ErrorDocument</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_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="../mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="../mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</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_alias.html#redirectmatch">RedirectMatch</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#rewritematch">RewriteMatch</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#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table> <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_proxy.html">mod_proxy</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_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><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#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</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#errordocument">ErrorDocument</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_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</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_alias.html#redirectmatch">RedirectMatch</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#rewritematch">RewriteMatch</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#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="documentroot" id="documentroot">DocumentRoot</a></h2> <h2><a name="documentroot" id="documentroot">DocumentRoot</a></h2>
<p>In deciding what file to serve for a given request, Apache's <p>In deciding what file to serve for a given request, Apache's
default behavior is to take the URL-Path for the request (the part default behavior is to take the URL-Path for the request (the part
of the URL following the hostname and port) and add it to the end of the URL following the hostname and port) and add it to the end
of the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> specified of the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> specified
in your configuration files. Therefore, the files and directories in your configuration files. Therefore, the files and directories
underneath the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> underneath the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
make up the basic document tree which will be visible from the make up the basic document tree which will be visible from the
web.</p> web.</p>
<p>For example, if <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> <p>For example, if <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
were set to <code>/var/www/html</code> then a request for were set to <code>/var/www/html</code> then a request for
<code>http://www.example.com/fish/guppies.html</code> would result <code>http://www.example.com/fish/guppies.html</code> would result
in the file <code>/var/www/html/fish/guppies.html</code> being in the file <code>/var/www/html/fish/guppies.html</code> being
@ -62,44 +62,44 @@
<p>Apache is also capable of <a href="vhosts/">Virtual <p>Apache is also capable of <a href="vhosts/">Virtual
Hosting</a>, where the server receives requests for more than one Hosting</a>, where the server receives requests for more than one
host. In this case, a different <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> can be specified for each host. In this case, a different <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> can be specified for each
virtual host, or alternatively, the directives provided by the virtual host, or alternatively, the directives provided by the
module <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> can module <code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code> can
be used to dynamically determine the appropriate place from which be used to dynamically determine the appropriate place from which
to serve content based on the requested IP address or to serve content based on the requested IP address or
hostname.</p> hostname.</p>
<p>The <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> directive <p>The <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> directive
is set in your main server configuration file is set in your main server configuration file
(<code>httpd.conf</code>) and, possibly, once per additional <a href="vhosts/">Virtual Host</a> you create.</p> (<code>httpd.conf</code>) and, possibly, once per additional <a href="vhosts/">Virtual Host</a> you create.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="outside" id="outside">Files Outside the DocumentRoot</a></h2> <h2><a name="outside" id="outside">Files Outside the DocumentRoot</a></h2>
<p>There are frequently circumstances where it is necessary to <p>There are frequently circumstances where it is necessary to
allow web access to parts of the filesystem that are not strictly allow web access to parts of the filesystem that are not strictly
underneath the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Apache offers several underneath the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>. Apache offers several
different ways to accomplish this. On Unix systems, symbolic links different ways to accomplish this. On Unix systems, symbolic links
can bring other parts of the filesystem under the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. For security reasons, can bring other parts of the filesystem under the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>. For security reasons,
Apache will follow symbolic links only if the <code class="directive"><a href="../mod/core.html#options">Options</a></code> setting for the relevant Apache will follow symbolic links only if the <code class="directive"><a href="./mod/core.html#options">Options</a></code> setting for the relevant
directory includes <code>FollowSymLinks</code> or directory includes <code>FollowSymLinks</code> or
<code>SymLinksIfOwnerMatch</code>.</p> <code>SymLinksIfOwnerMatch</code>.</p>
<p>Alternatively, the <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> directive will map any part <p>Alternatively, the <code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code> directive will map any part
of the filesystem into the web space. For example, with</p> of the filesystem into the web space. For example, with</p>
<div class="example"><p><code>Alias /docs /var/web</code></p></div> <div class="example"><p><code>Alias /docs /var/web</code></p></div>
<p>the URL <code>http://www.example.com/docs/dir/file.html</code> <p>the URL <code>http://www.example.com/docs/dir/file.html</code>
will be served from <code>/var/web/dir/file.html</code>. The will be served from <code>/var/web/dir/file.html</code>. The
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> directive <code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code> directive
works the same way, with the additional effect that all content works the same way, with the additional effect that all content
located at the target path is treated as <a class="glossarylink" href="../glossary.html#cgi" title="see glossary">CGI</a> scripts.</p> located at the target path is treated as <a class="glossarylink" href="./glossary.html#cgi" title="see glossary">CGI</a> scripts.</p>
<p>For situations where you require additional flexibility, you <p>For situations where you require additional flexibility, you
can use the <code class="directive"><a href="../mod/mod_alias.html#aliasmatch">AliasMatch</a></code> can use the <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
and <code class="directive"><a href="../mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code> and <code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code>
directives to do powerful <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular directives to do powerful <a class="glossarylink" href="./glossary.html#regex" title="see glossary">regular
expression</a> based matching and substitution. For expression</a> based matching and substitution. For
example,</p> example,</p>
@ -110,13 +110,13 @@
<code>http://example.com/~user/cgi-bin/script.cgi</code> to the <code>http://example.com/~user/cgi-bin/script.cgi</code> to the
path <code>/home/user/cgi-bin/script.cgi</code> and will treat path <code>/home/user/cgi-bin/script.cgi</code> and will treat
the resulting file as a CGI script.</p> the resulting file as a CGI script.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="user" id="user">User Directories</a></h2> <h2><a name="user" id="user">User Directories</a></h2>
<p>Traditionally on Unix systems, the home directory of a <p>Traditionally on Unix systems, the home directory of a
particular <em>user</em> can be referred to as particular <em>user</em> can be referred to as
<code>~user/</code>. The module <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> <code>~user/</code>. The module <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
extends this idea to the web by allowing files under each user's extends this idea to the web by allowing files under each user's
home directory to be accessed using URLs such as the home directory to be accessed using URLs such as the
following.</p> following.</p>
@ -125,7 +125,7 @@
<p>For security reasons, it is inappropriate to give direct <p>For security reasons, it is inappropriate to give direct
access to a user's home directory from the web. Therefore, the access to a user's home directory from the web. Therefore, the
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> directive
specifies a directory underneath the user's home directory specifies a directory underneath the user's home directory
where web files are located. Using the default setting of where web files are located. Using the default setting of
<code>Userdir public_html</code>, the above URL maps to a file <code>Userdir public_html</code>, the above URL maps to a file
@ -144,7 +144,7 @@
alternate string to represent user directories. This functionality alternate string to represent user directories. This functionality
is not supported by mod_userdir. However, if users' home is not supported by mod_userdir. However, if users' home
directories are structured in a regular way, then it is possible directories are structured in a regular way, then it is possible
to use the <code class="directive"><a href="../mod/mod_alias.html#aliasmatch">AliasMatch</a></code> to use the <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
directive to achieve the desired effect. For example, to make directive to achieve the desired effect. For example, to make
<code>http://www.example.com/upages/user/file.html</code> map to <code>http://www.example.com/upages/user/file.html</code> map to
<code>/home/user/public_html/file.html</code>, use the following <code>/home/user/public_html/file.html</code>, use the following
@ -152,7 +152,7 @@
<div class="example"><p><code>AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*) <div class="example"><p><code>AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*)
/home/$1/public_html/$2</code></p></div> /home/$1/public_html/$2</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="redirect" id="redirect">URL Redirection</a></h2> <h2><a name="redirect" id="redirect">URL Redirection</a></h2>
@ -162,9 +162,9 @@
inform the client that the requested content is located at a inform the client that the requested content is located at a
different URL, and instruct the client to make a new request with different URL, and instruct the client to make a new request with
the new URL. This is called <em>redirection</em> and is the new URL. This is called <em>redirection</em> and is
implemented by the <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code> directive. For example, if implemented by the <code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code> directive. For example, if
the contents of the directory <code>/foo/</code> under the the contents of the directory <code>/foo/</code> under the
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> are moved <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> are moved
to the new directory <code>/bar/</code>, you can instruct clients to the new directory <code>/bar/</code>, you can instruct clients
to request the content at the new location as follows:</p> to request the content at the new location as follows:</p>
@ -177,7 +177,7 @@
substituted for <code>/foo/</code>. You can redirect clients to substituted for <code>/foo/</code>. You can redirect clients to
any server, not only the origin server.</p> any server, not only the origin server.</p>
<p>Apache also provides a <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> directive for more <p>Apache also provides a <code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> directive for more
complicated rewriting problems. For example, to redirect requests complicated rewriting problems. For example, to redirect requests
for the site home page to a different site, but leave all other for the site home page to a different site, but leave all other
requests alone, use the following configuration:</p> requests alone, use the following configuration:</p>
@ -190,7 +190,7 @@
<div class="example"><p><code>RedirectMatch temp .* <div class="example"><p><code>RedirectMatch temp .*
http://othersite.example.com/startpage.html</code></p></div> http://othersite.example.com/startpage.html</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="proxy" id="proxy">Reverse Proxy</a></h2> <h2><a name="proxy" id="proxy">Reverse Proxy</a></h2>
@ -214,14 +214,14 @@ ProxyPassReverseCookieDomain internal.example.com public.example.com
ProxyPassReverseCookiePath /foo/ /bar/ ProxyPassReverseCookiePath /foo/ /bar/
</code></p></div> </code></p></div>
<p>The <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> configures <p>The <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> configures
the server to fetch the appropriate documents, while the the server to fetch the appropriate documents, while the
<code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> <code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code>
directive rewrites redirects originating at directive rewrites redirects originating at
<code>internal.example.com</code> so that they target the appropriate <code>internal.example.com</code> so that they target the appropriate
directory on the local server. Similarly, the directory on the local server. Similarly, the
<code class="directive"><a href="../mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code> <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
and <code class="directive"><a href="../mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code> and <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
rewrite cookies set by the backend server.</p> rewrite cookies set by the backend server.</p>
<p>It is important to note, however, that <p>It is important to note, however, that
links inside the documents will not be rewritten. So any absolute links inside the documents will not be rewritten. So any absolute
@ -230,12 +230,12 @@ breaking out of the proxy server and requesting directly from
<code>internal.example.com</code>. A third-party module <code>internal.example.com</code>. A third-party module
<a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a> <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
is available to rewrite links in HTML and XHTML.</p> is available to rewrite links in HTML and XHTML.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="rewrite" id="rewrite">Rewriting Engine</a></h2> <h2><a name="rewrite" id="rewrite">Rewriting Engine</a></h2>
<p>When even more powerful substitution is required, the rewriting <p>When even more powerful substitution is required, the rewriting
engine provided by <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> engine provided by <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
can be useful. The directives provided by this module use can be useful. The directives provided by this module use
characteristics of the request such as browser type or source IP characteristics of the request such as browser type or source IP
address in deciding from where to serve content. In addition, address in deciding from where to serve content. In addition,
@ -245,7 +245,7 @@ is available to rewrite links in HTML and XHTML.</p>
internal redirects (aliases), external redirects, and proxying. internal redirects (aliases), external redirects, and proxying.
Many practical examples employing mod_rewrite are discussed in the Many practical examples employing mod_rewrite are discussed in the
<a href="misc/rewriteguide.html">URL Rewriting Guide</a>.</p> <a href="misc/rewriteguide.html">URL Rewriting Guide</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section"> <div class="section">
<h2><a name="notfound" id="notfound">File Not Found</a></h2> <h2><a name="notfound" id="notfound">File Not Found</a></h2>
@ -261,7 +261,7 @@ is available to rewrite links in HTML and XHTML.</p>
<p>Another common cause of "File Not Found" errors is <p>Another common cause of "File Not Found" errors is
accidental mistyping of URLs, either directly in the browser, accidental mistyping of URLs, either directly in the browser,
or in HTML links. Apache provides the module or in HTML links. Apache provides the module
<code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code> (sic) to help with <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> (sic) to help with
this problem. When this module is activated, it will intercept this problem. When this module is activated, it will intercept
"File Not Found" errors and look for a resource with a similar "File Not Found" errors and look for a resource with a similar
filename. If one such file is found, mod_speling will send an filename. If one such file is found, mod_speling will send an
@ -281,16 +281,16 @@ is available to rewrite links in HTML and XHTML.</p>
<p>If all attempts to locate the content fail, Apache returns <p>If all attempts to locate the content fail, Apache returns
an error page with HTTP status code 404 (file not found). The an error page with HTTP status code 404 (file not found). The
appearance of this page is controlled with the appearance of this page is controlled with the
<code class="directive"><a href="../mod/core.html#errordocument">ErrorDocument</a></code> directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> directive
and can be customized in a flexible manner as discussed in the and can be customized in a flexible manner as discussed in the
<a href="custom-error.html">Custom error responses</a> <a href="custom-error.html">Custom error responses</a>
document.</p> document.</p>
</div></div> </div></div>
<div class="bottomlang"> <div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/./urlmapping.html" title="English">&nbsp;en&nbsp;</a> | <p><span>Available Languages: </span><a href="./en/urlmapping.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../ja/./urlmapping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> | <a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/./urlmapping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p> <a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer"> </div><div id="footer">
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
</body></html> </body></html>

4
docs/manual/urlmapping.xml.meta
View File

@ -2,8 +2,8 @@
<metafile> <metafile>
<basename>urlmapping</basename> <basename>urlmapping</basename>
<path>/./</path> <path>/</path>
<relpath>..</relpath> <relpath>.</relpath>
<variants> <variants>
<variant>en</variant> <variant>en</variant>