server-wide.html.en revision ac082aefa89416cbdc9a1836eaf3bed9698201c8
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess This file is generated from xml source: DO NOT EDIT
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5a58787efeb02a1c3f06569d019ad81fd2efa06end<title>Server-Wide Configuration - Apache HTTP Server</title>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
5a58787efeb02a1c3f06569d019ad81fd2efa06end<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" />
5a58787efeb02a1c3f06569d019ad81fd2efa06end<script src="/style/scripts/prettify.js" type="text/javascript">
52fff662005b1866a3ff09bb6c902800c5cc6dedjerenkrantz<link href="/images/favicon.ico" rel="shortcut icon" /></head>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<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>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
d05d0eb4ae6d2a5e513fc3bf2555ce33da416634nd<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>
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi<p><span>Available Languages: </span><a href="/en/server-wide.html" title="English"> en </a> |
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<a href="/fr/server-wide.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<a href="/ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<a href="/ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
15107611640cec4e666dd7e2e1dee15c270e9e98rbowen<a href="/tr/server-wide.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<p>This document explains some of the directives provided by
60a4b2c422dcbb08a554fb193105c08da592718bpoirierthe <code class="module"><a href="/mod/core.html">core</a></code> server which are used to configure
60a4b2c422dcbb08a554fb193105c08da592718bpoirierthe basic operations of the server.</p>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#identification">Server Identification</a></li>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<li><img alt="" src="/images/down.gif" /> <a href="#locations">File Locations</a></li>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<li><img alt="" src="/images/down.gif" /> <a href="#resource">Limiting Resource Usage</a></li>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<li><img alt="" src="/images/down.gif" /> <a href="#implementation">Implementation Choices</a></li>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<h2><a name="identification" id="identification">Server Identification</a></h2>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <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>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>The <code class="directive"><a href="/mod/core.html#serveradmin">ServerAdmin</a></code> and
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <code class="directive"><a href="/mod/core.html#servertokens">ServerTokens</a></code> directives
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess control what information about the server will be presented
60a4b2c422dcbb08a554fb193105c08da592718bpoirier in server-generated documents such as error messages. The
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code class="directive"><a href="/mod/core.html#servertokens">ServerTokens</a></code> directive
60a4b2c422dcbb08a554fb193105c08da592718bpoirier sets the value of the Server HTTP response header field.</p>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <p>The <code class="directive"><a href="/mod/core.html#servername">ServerName</a></code>,
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code class="directive"><a href="/mod/core.html#usecanonicalname">UseCanonicalName</a></code> and
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code class="directive"><a href="/mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess directives are used by the server to determine how to construct
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess self-referential URLs. For example, when a client requests a
60a4b2c422dcbb08a554fb193105c08da592718bpoirier directory, but does not include the trailing slash in the
60a4b2c422dcbb08a554fb193105c08da592718bpoirier directory name, httpd must redirect the client to the full
60a4b2c422dcbb08a554fb193105c08da592718bpoirier name including the trailing slash so that the client will
60a4b2c422dcbb08a554fb193105c08da592718bpoirier correctly resolve relative references in the document.</p>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<h2><a name="locations" id="locations">File Locations</a></h2>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <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>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <p>These directives control the locations of the various files
60a4b2c422dcbb08a554fb193105c08da592718bpoirier that httpd needs for proper operation. When the pathname used
60a4b2c422dcbb08a554fb193105c08da592718bpoirier does not begin with a slash (/), the files are located relative
60a4b2c422dcbb08a554fb193105c08da592718bpoirier to the <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>. Be careful
60a4b2c422dcbb08a554fb193105c08da592718bpoirier about locating files in paths which are writable by non-root users.
60a4b2c422dcbb08a554fb193105c08da592718bpoirier See the <a href="misc/security_tips.html#serverroot">security tips</a>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier documentation for more details.</p>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<h2><a name="resource" id="resource">Limiting Resource Usage</a></h2>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <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>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier directives are used to place limits on the amount of resources
60a4b2c422dcbb08a554fb193105c08da592718bpoirier httpd will use in reading requests from clients. By limiting
60a4b2c422dcbb08a554fb193105c08da592718bpoirier these values, some kinds of denial of service attacks can be
60a4b2c422dcbb08a554fb193105c08da592718bpoirier mitigated.</p>
1696993fbee984b093ae8b823e3ea3fa80eae486covener <p>The <code class="directive">RLimit</code>* directives
60a4b2c422dcbb08a554fb193105c08da592718bpoirier are used to limit the amount of resources which can be used by
60a4b2c422dcbb08a554fb193105c08da592718bpoirier processes forked off from the httpd children. In particular,
60a4b2c422dcbb08a554fb193105c08da592718bpoirier this will control resources used by CGI scripts and SSI exec
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess commands.</p>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <p>The <code class="directive"><a href="/mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier directive is used with some platforms to control the stack size.</p>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<h2><a name="implementation" id="implementation">Implementation Choices</a></h2>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <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>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier <p>The <code class="directive">Mutex</code> directive can be used to change
60a4b2c422dcbb08a554fb193105c08da592718bpoirier the underlying implementation used for mutexes, in order to relieve
60a4b2c422dcbb08a554fb193105c08da592718bpoirier functional or performance problems with <a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a>'s
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess default choice.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<p><span>Available Languages: </span><a href="/en/server-wide.html" title="English"> en </a> |
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<a href="/fr/server-wide.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<a href="/ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<a href="/ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<a href="/tr/server-wide.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
60a4b2c422dcbb08a554fb193105c08da592718bpoirier<script type="text/javascript"><!--//--><![CDATA[//><!--
60a4b2c422dcbb08a554fb193105c08da592718bpoiriervar comments_shortname = 'httpd';
60a4b2c422dcbb08a554fb193105c08da592718bpoiriervar comments_identifier = 'http://httpd.apache.org/docs/trunk/server-wide.html';
60a4b2c422dcbb08a554fb193105c08da592718bpoirier(function(w, d) {
60a4b2c422dcbb08a554fb193105c08da592718bpoirier if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
60a4b2c422dcbb08a554fb193105c08da592718bpoirier d.write('<div id="comments_thread"><\/div>');
60a4b2c422dcbb08a554fb193105c08da592718bpoirier var s = d.createElement('script');
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
60a4b2c422dcbb08a554fb193105c08da592718bpoirier (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess})(window, document);
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<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>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<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[//><!--
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kessif (typeof(prettyPrint) !== 'undefined') {
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess prettyPrint();