home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / CMCD1104.ISO / Software / Complet / Apache / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F278068_mod_info.html.en < prev    next >
Extensible Markup Language  |  2004-02-20  |  7KB  |  117 lines
  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>mod_info - 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>
  14. <div id="page-header">
  15. <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>
  16. <p class="apache">Apache HTTP Server Version 2.0</p>
  17. <img alt="" src="../images/feather.gif" /></div>
  18. <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
  19. <div id="path">
  20. <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.0</a> > <a href="./">Modules</a></div>
  21. <div id="page-content">
  22. <div id="preamble"><h1>Apache Module mod_info</h1>
  23. <div class="toplang">
  24. <p><span>Available Languages: </span><a href="../en/mod/mod_info.html" title="English"> en </a> |
  25. <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
  26. </div>
  27. <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Provides a comprehensive overview of the server
  28. configuration</td></tr>
  29. <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  30. <tr><th><a href="module-dict.html#ModuleIdentifier">ModuleáIdentifier:</a></th><td>info_module</td></tr>
  31. <tr><th><a href="module-dict.html#SourceFile">SourceáFile:</a></th><td>mod_info.c</td></tr></table>
  32. <h3>Summary</h3>
  33.  
  34.     <p>To configure <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, add the following to your
  35.     <code>httpd.conf</code> file.</p>
  36.  
  37.     <div class="example"><p><code>
  38.       <Location /server-info><br />
  39.       <span class="indent">
  40.         SetHandler server-info<br />
  41.       </span>
  42.       </Location>
  43.     </code></p></div>
  44.  
  45.     <p>You may wish to add a 
  46.     <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> 
  47.     clause inside the 
  48.     <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
  49.     directive to limit access to your server configuration 
  50.     information.</p>
  51.  
  52.     <p>Once configured, the server information is obtained by
  53.     accessing <code>http://your.host.dom/server-info</code></p>
  54.  
  55.     <div class="note">
  56.       Note that the configuration files are read by the
  57.       module at run-time, and therefore the display may
  58.       <em>not</em> reflect the running server's active
  59.       configuration if the files have been changed since the server
  60.       was last reloaded. Also, the configuration files must be
  61.       readable by the user as which the server is running (see the
  62.       <code class="directive"><a href="../mod/mpm_common.html#user">User</a></code> directive), or
  63.       else the directive settings will not be listed.
  64.  
  65.       <p>It should also be noted that if
  66.       <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> is compiled into the server, its
  67.       handler capability is available in <em>all</em> configuration
  68.       files, including per-directory files (<em>e.g.</em>,
  69.       <code>.htaccess</code>). This may have security-related
  70.       ramifications for your site.</p>
  71.  
  72.       <p>In particular, this module can leak sensitive information
  73.       from the configuration directives of other Apache modules such as
  74.       system paths, usernames/passwords, database names, etc.  Due to
  75.       the way this module works there is no way to block information
  76.       from it.  Therefore, this module should <strong>only</strong> be
  77.       used in a controlled environment and always with caution.</p>
  78.     </div>
  79. </div>
  80. <div id="quickview"><h3 class="directives">Directives</h3>
  81. <ul id="toc">
  82. <li><img alt="" src="../images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li>
  83. </ul>
  84. </div>
  85.  
  86. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  87. <div class="directive-section"><h2><a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo" id="addmoduleinfo">Directive</a></h2>
  88. <table class="directive">
  89. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds additional information to the module
  90. information displayed by the server-info handler</td></tr>
  91. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddModuleInfo <var>module-name</var> <var>string</var></code></td></tr>
  92. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
  93. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  94. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_info</td></tr>
  95. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Apache 1.3 and above</td></tr>
  96. </table>
  97.     <p>This allows the content of <var>string</var> to be shown as
  98.     HTML interpreted, <strong>Additional Information</strong> for
  99.     the module <var>module-name</var>. Example:</p>
  100.  
  101.     <div class="example"><p><code>
  102.       AddModuleInfo mod_auth.c 'See <a \<br />
  103.       <span class="indent">
  104.         href="http://www.apache.org/docs-2.0/mod/mod_auth.html">\<br />
  105.         http://www.apache.org/docs-2.0/mod/mod_auth.html</a>'
  106.       </span>
  107.     </code></p></div>
  108.  
  109. </div>
  110. </div>
  111. <div class="bottomlang">
  112. <p><span>Available Languages: </span><a href="../en/mod/mod_info.html" title="English"> en </a> |
  113. <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
  114. </div><div id="footer">
  115. <p class="apache">Copyright 1999-2004 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>
  116. <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>
  117. </body></html>