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