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