server-wide.html.en revision 30471a4650391f57975f60bbb6e4a90be7b284bf
181e56d8b348d301d615ccf5465ae600fee2867berikabele<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
181e56d8b348d301d615ccf5465ae600fee2867berikabele<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele This file is generated from xml source: DO NOT EDIT
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5a58787efeb02a1c3f06569d019ad81fd2efa06end<title>Server-Wide Configuration - Apache HTTP Server</title>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<script src="/style/scripts/prettify.js" type="text/javascript">
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<link href="/images/favicon.ico" rel="shortcut icon" /></head>
d229f940abfb2490dee17979e9a5ff31b7012eb5rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Server-Wide Configuration</h1>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<p><span>Available Languages: </span><a href="/en/server-wide.html" title="English"> en </a> |
af84459fbf938e508fd10b01cb8d699c79083813takashi<a href="/fr/server-wide.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd<a href="/ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
f3ec420152ca921e4c1ce77782f51b53f659018dnd<a href="/ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/server-wide.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele<p>This document explains some of the directives provided by
7add1372edb1ee95a2c4d1314df4c7567bda7c62jimthe <code class="module"><a href="/mod/core.html">core</a></code> server which are used to configure
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabelethe basic operations of the server.</p>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#identification">Server Identification</a></li>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<li><img alt="" src="/images/down.gif" /> <a href="#locations">File Locations</a></li>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<li><img alt="" src="/images/down.gif" /> <a href="#resource">Limiting Resource Usage</a></li>
709e3a21ba73b8433462959cd56c773454b34441trawick<li><img alt="" src="/images/down.gif" /> <a href="#implementation">Implementation Choices</a></li>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="identification" id="identification">Server Identification</a></h2>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <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>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <p>The <code class="directive"><a href="/mod/core.html#serveradmin">ServerAdmin</a></code> and
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <code class="directive"><a href="/mod/core.html#servertokens">ServerTokens</a></code> directives
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele control what information about the server will be presented
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele in server-generated documents such as error messages. The
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <code class="directive"><a href="/mod/core.html#servertokens">ServerTokens</a></code> directive
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele sets the value of the Server HTTP response header field.</p>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <p>The <code class="directive"><a href="/mod/core.html#servername">ServerName</a></code>,
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <code class="directive"><a href="/mod/core.html#usecanonicalname">UseCanonicalName</a></code> and
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <code class="directive"><a href="/mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele directives are used by the server to determine how to construct
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele self-referential URLs. For example, when a client requests a
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele directory, but does not include the trailing slash in the
dfc515decf0e3a5a980ec4e06af4eb76d4a95440rbowen directory name, httpd must redirect the client to the full
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele name including the trailing slash so that the client will
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele correctly resolve relative references in the document.</p>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="locations" id="locations">File Locations</a></h2>
709e3a21ba73b8433462959cd56c773454b34441trawick <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/core.html#mutex">Mutex</a></code></li><li><code class="directive"><a href="/mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="/mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code></li><li><code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code></li></ul></td></tr></table>
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen <p>These directives control the locations of the various files
dfc515decf0e3a5a980ec4e06af4eb76d4a95440rbowen that httpd needs for proper operation. When the pathname used
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele does not begin with a slash (/), the files are located relative
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim to the <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>. Be careful
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele about locating files in paths which are writable by non-root users.
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele See the <a href="misc/security_tips.html#serverroot">security tips</a>
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele documentation for more details.</p>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="resource" id="resource">Limiting Resource Usage</a></h2>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <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>
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele <p>The <code class="directive">LimitRequest</code>*
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele directives are used to place limits on the amount of resources
dfc515decf0e3a5a980ec4e06af4eb76d4a95440rbowen httpd will use in reading requests from clients. By limiting
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele these values, some kinds of denial of service attacks can be
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele mitigated.</p>
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele <p>The <code class="directive">RLimit</code>* directives
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele are used to limit the amount of resources which can be used by
dfc515decf0e3a5a980ec4e06af4eb76d4a95440rbowen processes forked off from the httpd children. In particular,
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele this will control resources used by CGI scripts and SSI exec
c8e71fab0ea4bc3f8cb07693d6917f6b4644fbdcerikabele commands.</p>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <p>The <code class="directive"><a href="/mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
87ffb6e33f3cbef3b9bb406cc2d27039fa336eaatrawick directive is used with some platforms to control the stack size.</p>
709e3a21ba73b8433462959cd56c773454b34441trawick </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
709e3a21ba73b8433462959cd56c773454b34441trawick<h2><a name="implementation" id="implementation">Implementation Choices</a></h2>
709e3a21ba73b8433462959cd56c773454b34441trawick <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#mutex">Mutex</a></code></li></ul></td></tr></table>
709e3a21ba73b8433462959cd56c773454b34441trawick <p>The <code class="directive">Mutex</code> directive can be used to change
709e3a21ba73b8433462959cd56c773454b34441trawick the underlying implementation used for mutexes, in order to relieve
709e3a21ba73b8433462959cd56c773454b34441trawick functional or performance problems with <a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a>'s
709e3a21ba73b8433462959cd56c773454b34441trawick default choice.</p>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<p><span>Available Languages: </span><a href="/en/server-wide.html" title="English"> en </a> |
af84459fbf938e508fd10b01cb8d699c79083813takashi<a href="/fr/server-wide.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd<a href="/ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
f3ec420152ca921e4c1ce77782f51b53f659018dnd<a href="/ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/server-wide.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>This section is experimental!</strong><br />Comments placed here should not be expected
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohto last beyond the testing phase of this system, nor do we in any way guarantee that we'll read them.</div><div id="disqus_thread" /><script type="text/javascript"><!--//--><![CDATA[//><!--
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohvar lang = 'en';
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohvar disqus_shortname = 'httpd';
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohvar disqus_identifier = window.location.href.replace(/(current|trunk)/, "2.4").replace(/\/[a-z]{2}\//, "/").replace(window.location.protocol, "http:") + '.' + lang;
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohif (disqus_identifier.indexOf("httpd.apache.org") != -1) {
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh (function() {
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh dsq.src = window.location.protocol + '//' + disqus_shortname + '.disqus.com/embed.js';
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh var text = document.createTextNode("Comments have been disabled for offline viewing.");
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh document.getElementById('disqus_thread').appendChild(text);
5effc8b39fae5cd169d17f342bfc265705840014rbowen<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
d229f940abfb2490dee17979e9a5ff31b7012eb5rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
7fec19672a491661b2fe4b29f685bc7f4efa64d4ndif (typeof(prettyPrint) !== undefined) {
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd prettyPrint();