1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 4 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 5 6<html xmlns="http://www.w3.org/1999/xhtml"> 7 <head> 8 <meta name="generator" content="HTML Tidy, see www.w3.org" /> 9 10 <title>Apache module mod_info</title> 11 </head> 12 <!-- Background white, links blue (unvisited), navy (visited), red (active) --> 13 14 <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" 15 vlink="#000080" alink="#FF0000"> 16 <div align="CENTER"> 17 <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" /> 18 19 <h3>Apache HTTP Server Version 1.3</h3> 20 </div> 21 22 23 <h1 align="CENTER">Module mod_info</h1> 24 25 <p>This module provides a comprehensive overview of the server 26 configuration including all installed modules and directives in 27 the configuration files.</p> 28 29 <p><a href="module-dict.html#Status" 30 rel="Help"><strong>Status:</strong></a> Extension<br /> 31 <a href="module-dict.html#SourceFile" 32 rel="Help"><strong>Source File:</strong></a> mod_info.c<br /> 33 <a href="module-dict.html#ModuleIdentifier" 34 rel="Help"><strong>Module Identifier:</strong></a> 35 info_module<br /> 36 <a href="module-dict.html#Compatibility" 37 rel="Help"><strong>Compatibility:</strong></a> Available in 38 Apache 1.1 and later.</p> 39 40 <h2>Directives</h2> 41 42 <ul> 43 <li><a href="#addmoduleinfo">AddModuleInfo</a></li> 44 </ul> 45 46 <h2>Using mod_info</h2> 47 48 <p>To configure it, add the following to your 49 <code>access.conf</code> file.</p> 50<pre> 51<Location /server-info> 52SetHandler server-info 53</Location> 54</pre> 55 You may wish to add a <a 56 href="core.html#limit"><Limit></a> clause inside the <a 57 href="core.html#location">location</a> directive to limit 58 access to your server configuration information. 59 60 <p>Once configured, the server information is obtained by 61 accessing <tt>http://your.host.dom/server-info</tt></p> 62 63 <blockquote> 64 <p><strong>Note that the configuration files are read by the 65 module at run-time, and therefore the display may 66 <em>not</em> reflect the running server's active 67 configuration if the files have been changed since the server 68 was last reloaded. Also, the configuration files must be 69 readable by the user as which the server is running (see the 70 <a href="core.html#user"><samp>User</samp></a> directive), or 71 else the directive settings will not be listed.</strong></p> 72 73 <p><strong>It should also be noted that if 74 <samp>mod_info</samp> is compiled into the server, its 75 handler capability is available in <em>all</em> configuration 76 files, including <em>per</em>-directory files (<em>e.g.</em>, 77 <samp>.htaccess</samp>). This may have security-related 78 ramifications for your site.</strong></p> 79 80 <p>In particular, this module can leak sensitive information 81 from the configuration directives of other Apache modules such as 82 system paths, usernames/passwords, database names, etc. Due to 83 the way this module works there is no way to block information 84 from it. Therefore, this module should ONLY be used in a controlled 85 environment and always with caution.</p> 86 87 </blockquote> 88 <hr /> 89 90 <h2><a id="addmoduleinfo" 91 name="addmoduleinfo">AddModuleInfo</a></h2> 92 <a href="directive-dict.html#Syntax" 93 rel="Help"><strong>Syntax:</strong></a> AddModuleInfo 94 <em>module-name string</em><br /> 95 <a href="directive-dict.html#Context" 96 rel="Help"><strong>Context:</strong></a> server config, virtual 97 host<br /> 98 <a href="directive-dict.html#Status" 99 rel="Help"><strong>Status:</strong></a> Extension<br /> 100 <a href="directive-dict.html#Module" 101 rel="Help"><strong>Module:</strong></a> mod_info<br /> 102 <a href="directive-dict.html#Compatibility" 103 rel="Help"><strong>Compatibility:</strong></a> Apache 1.3 and 104 above 105 106 <p>This allows the content of <em>string</em> to be shown as 107 HTML interpreted, <strong>Additional Information</strong> for 108 the module <em>module-name</em>. Example:</p> 109 110 <blockquote> 111<pre> 112AddModuleInfo mod_auth.c 'See <A HREF="http://www.apache.org/docs/mod/mod_auth.html">http://www.apache.org/docs/mod/mod_auth.html</A>' 113</pre> 114 </blockquote> 115 <hr /> 116 117 <h3 align="CENTER">Apache HTTP Server Version 1.3</h3> 118 <a href="./"><img src="../images/index.gif" alt="Index" /></a> 119 <a href="../"><img src="../images/home.gif" alt="Home" /></a> 120 121 </body> 122</html> 123 124 125 126
