granicus.if.org Git - apache/blob - docs/manual/server-wide.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>Server-Wide Configuration - Apache HTTP Server</title>
   9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  13 <body id="manual-page"><div id="page-header">
  14 <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>
  15 <p class="apache">Apache HTTP Server Version 2.3</p>
  16 <img alt="" src="./images/feather.gif" /></div>
  17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  18 <div id="path">
  19 <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>
  20 <div class="toplang">
  21 <p><span>Available Languages: </span><a href="./en/server-wide.html" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  23 <a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  24 <a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  25 <a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  26 </div>
  27
  28 <p>This document explains some of the directives provided by
  29 the <code class="module"><a href="./mod/core.html">core</a></code> server which are used to configure
  30 the basic operations of the server.</p>
  31 </div>
  32 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#identification">Server Identification</a></li>
  33 <li><img alt="" src="./images/down.gif" /> <a href="#locations">File Locations</a></li>
  34 <li><img alt="" src="./images/down.gif" /> <a href="#resource">Limiting Resource Usage</a></li>
  35 <li><img alt="" src="./images/down.gif" /> <a href="#implementation">Implementation Choices</a></li>
  36 </ul></div>
  37 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  38 <div class="section">
  39 <h2><a name="identification" id="identification">Server Identification</a></h2>
  40
  41
  42     <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>
  43
  44     <p>The <code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> and
  45     <code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> directives
  46     control what information about the server will be presented
  47     in server-generated documents such as error messages. The
  48     <code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> directive
  49     sets the value of the Server HTTP response header field.</p>
  50
  51     <p>The <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>,
  52     <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> and
  53     <code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
  54     directives are used by the server to determine how to construct
  55     self-referential URLs. For example, when a client requests a
  56     directory, but does not include the trailing slash in the
  57     directory name, httpd must redirect the client to the full
  58     name including the trailing slash so that the client will
  59     correctly resolve relative references in the document.</p>
  60   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  61 <div class="section">
  62 <h2><a name="locations" id="locations">File Locations</a></h2>
  63
  64
  65     <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>
  66
  67     <p>These directives control the locations of the various files
  68     that httpd needs for proper operation. When the pathname used
  69     does not begin with a slash (/), the files are located relative
  70     to the <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>. Be careful
  71     about locating files in paths which are writable by non-root users.
  72     See the <a href="misc/security_tips.html#serverroot">security tips</a>
  73     documentation for more details.</p>
  74   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  75 <div class="section">
  76 <h2><a name="resource" id="resource">Limiting Resource Usage</a></h2>
  77
  78
  79     <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>
  80
  81     <p>The <code class="directive">LimitRequest</code>*
  82     directives are used to place limits on the amount of resources
  83     httpd will use in reading requests from clients. By limiting
  84     these values, some kinds of denial of service attacks can be
  85     mitigated.</p>
  86
  87     <p>The <code class="directive">RLimit</code>* directives
  88     are used to limit the amount of resources which can be used by
  89     processes forked off from the httpd children. In particular,
  90     this will control resources used by CGI scripts and SSI exec
  91     commands.</p>
  92
  93     <p>The <code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
  94     directive is used with some platforms to control the stack size.</p>
  95   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  96 <div class="section">
  97 <h2><a name="implementation" id="implementation">Implementation Choices</a></h2>
  98
  99
 100     <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>
 101
 102     <p>The <code class="directive">Mutex</code> directive can be used to change
 103     the underlying implementation used for mutexes, in order to relieve
 104     functional or performance problems with <a class="glossarylink" href="./glossary.html#apr" title="see glossary">APR</a>'s
 105     default choice.</p>
 106   </div></div>
 107 <div class="bottomlang">
 108 <p><span>Available Languages: </span><a href="./en/server-wide.html" title="English">&nbsp;en&nbsp;</a> |
 109 <a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 110 <a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 111 <a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 112 <a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 113 </div><div id="footer">
 114 <p class="apache">Copyright 2011 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>
 115 <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>
 116 </body></html>