home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2004 May / Gamestar_62_2004-05_dvd.iso / Programy / apache_2.0.48-win32-x86-no_ssl.msi / Data.Cab / F252741_mod_info.xml < prev    next >
Extensible Markup Language  |  2003-04-15  |  3KB  |  87 lines
  1. <?xml version="1.0"?>
  2. <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
  3. <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
  4. <modulesynopsis metafile="mod_info.xml.meta">
  5.  
  6. <name>mod_info</name>
  7. <description>Provides a comprehensive overview of the server
  8. configuration</description>
  9. <status>Extension</status>
  10. <sourcefile>mod_info.c</sourcefile>
  11. <identifier>info_module</identifier>
  12.  
  13. <summary>
  14.     <p>To configure <module>mod_info</module>, add the following to your
  15.     <code>httpd.conf</code> file.</p>
  16.  
  17.     <example>
  18.       <Location /server-info><br />
  19.       <indent>
  20.         SetHandler server-info<br />
  21.       </indent>
  22.       </Location>
  23.     </example>
  24.  
  25.     <p>You may wish to add a 
  26.     <directive type="section" module="core">Limit</directive> 
  27.     clause inside the 
  28.     <directive type="section" module="core">Location</directive>
  29.     directive to limit access to your server configuration 
  30.     information.</p>
  31.  
  32.     <p>Once configured, the server information is obtained by
  33.     accessing <code>http://your.host.dom/server-info</code></p>
  34.  
  35.     <note>
  36.       Note that the configuration files are read by the
  37.       module at run-time, and therefore the display may
  38.       <em>not</em> reflect the running server's active
  39.       configuration if the files have been changed since the server
  40.       was last reloaded. Also, the configuration files must be
  41.       readable by the user as which the server is running (see the
  42.       <directive module="mpm_common">User</directive> directive), or
  43.       else the directive settings will not be listed.
  44.  
  45.       <p>It should also be noted that if
  46.       <module>mod_info</module> is compiled into the server, its
  47.       handler capability is available in <em>all</em> configuration
  48.       files, including per-directory files (<em>e.g.</em>,
  49.       <code>.htaccess</code>). This may have security-related
  50.       ramifications for your site.</p>
  51.  
  52.       <p>In particular, this module can leak sensitive information
  53.       from the configuration directives of other Apache modules such as
  54.       system paths, usernames/passwords, database names, etc.  Due to
  55.       the way this module works there is no way to block information
  56.       from it.  Therefore, this module should <strong>only</strong> be
  57.       used in a controlled environment and always with caution.</p>
  58.     </note>
  59. </summary>
  60.  
  61. <directivesynopsis>
  62. <name>AddModuleInfo</name>
  63. <description>Adds additional information to the module
  64. information displayed by the server-info handler</description>
  65. <syntax>AddModuleInfo <var>module-name</var> <var>string</var></syntax>
  66. <contextlist><context>server config</context><context>virtual host</context>
  67. </contextlist>
  68. <compatibility>Apache 1.3 and above</compatibility>
  69.  
  70. <usage>
  71.     <p>This allows the content of <var>string</var> to be shown as
  72.     HTML interpreted, <strong>Additional Information</strong> for
  73.     the module <var>module-name</var>. Example:</p>
  74.  
  75.     <example>
  76.       AddModuleInfo mod_auth.c 'See <a \<br />
  77.       <indent>
  78.         href="http://www.apache.org/docs-2.0/mod/mod_auth.html">\<br />
  79.         http://www.apache.org/docs-2.0/mod/mod_auth.html</a>'
  80.       </indent>
  81.     </example>
  82. </usage>
  83.  
  84. </directivesynopsis>
  85. </modulesynopsis>
  86.  
  87.