server-wide.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142
  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. <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
  5. <!--
  6. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  7. This file is generated from xml source: DO NOT EDIT
  8. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  9. -->
  10. <title>Server-Wide Configuration - Apache HTTP Server Version 2.4</title>
  11. <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12. <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13. <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" />
  14. <script src="./style/scripts/prettify.min.js" type="text/javascript">
  15. </script>
  16. <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  17. <body id="manual-page"><div id="page-header">
  18. <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>
  19. <p class="apache">Apache HTTP Server Version 2.4</p>
  20. <img alt="" src="./images/feather.png" /></div>
  21. <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  22. <div id="path">
  23. <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.4</a></div><div id="page-content"><div id="preamble"><h1>Server-Wide Configuration</h1>
  24. <div class="toplang">
  25. <p><span>Available Languages: </span><a href="./en/server-wide.html" title="English">&nbsp;en&nbsp;</a> |
  26. <a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  27. <a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  28. <a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  29. <a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  30. </div>
  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"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><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><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></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. <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>
  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. <p>The <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>,
  51. <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> and
  52. <code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
  53. directives are used by the server to determine how to construct
  54. self-referential URLs. For example, when a client requests a
  55. directory, but does not include the trailing slash in the
  56. directory name, httpd must redirect the client to the full
  57. name including the trailing slash so that the client will
  58. correctly resolve relative references in the document.</p>
  59. </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  60. <div class="section">
  61. <h2><a name="locations" id="locations">File Locations</a></h2>
  62. <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>
  63. <p>These directives control the locations of the various files
  64. that httpd needs for proper operation. When the pathname used
  65. does not begin with a slash (/), the files are located relative
  66. to the <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>. Be careful
  67. about locating files in paths which are writable by non-root users.
  68. See the <a href="misc/security_tips.html#serverroot">security tips</a>
  69. documentation for more details.</p>
  70. </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  71. <div class="section">
  72. <h2><a name="resource" id="resource">Limiting Resource Usage</a></h2>
  73. <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>
  74. <p>The <code class="directive">LimitRequest</code>*
  75. directives are used to place limits on the amount of resources
  76. httpd will use in reading requests from clients. By limiting
  77. these values, some kinds of denial of service attacks can be
  78. mitigated.</p>
  79. <p>The <code class="directive">RLimit</code>* directives
  80. are used to limit the amount of resources which can be used by
  81. processes forked off from the httpd children. In particular,
  82. this will control resources used by CGI scripts and SSI exec
  83. commands.</p>
  84. <p>The <code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
  85. directive is used with some platforms to control the stack size.</p>
  86. </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  87. <div class="section">
  88. <h2><a name="implementation" id="implementation">Implementation Choices</a></h2>
  89. <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>
  90. <p>The <code class="directive">Mutex</code> directive can be used to change
  91. the underlying implementation used for mutexes, in order to relieve
  92. functional or performance problems with <a class="glossarylink" href="./glossary.html#apr" title="see glossary">APR</a>'s
  93. default choice.</p>
  94. </div></div>
  95. <div class="bottomlang">
  96. <p><span>Available Languages: </span><a href="./en/server-wide.html" title="English">&nbsp;en&nbsp;</a> |
  97. <a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  98. <a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  99. <a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  100. <a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  101. </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&amp;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>
  102. <script type="text/javascript"><!--//--><![CDATA[//><!--
  103. var comments_shortname = 'httpd';
  104. var comments_identifier = 'http://httpd.apache.org/docs/2.4/server-wide.html';
  105. (function(w, d) {
  106. if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
  107. d.write('<div id="comments_thread"><\/div>');
  108. var s = d.createElement('script');
  109. s.type = 'text/javascript';
  110. s.async = true;
  111. s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
  112. (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
  113. }
  114. else {
  115. d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
  116. }
  117. })(window, document);
  118. //--><!]]></script></div><div id="footer">
  119. <p class="apache">Copyright 2017 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>
  120. <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[//><!--
  121. if (typeof(prettyPrint) !== 'undefined') {
  122. prettyPrint();
  123. }
  124. //--><!]]></script>
  125. </body></html>