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
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>
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>
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/">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>
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> |
26 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
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>
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>
38 <div class="example"><p><code>
39 <Location /server-info><br />
41 SetHandler server-info<br />
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"><Location></a></code>
48 directive to limit access to your server configuration
51 <div class="example"><p><code>
52 <Location /server-info><br />
54 SetHandler server-info<br />
55 Order deny,allow<br />
57 Allow from yourcompany.com<br />
62 <p>Once configured, the server information is obtained by
63 accessing <code>http://your.host.dom/server-info</code></p>
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.
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>
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>
90 <div id="quickview"><h3 class="directives">Directives</h3>
92 <li><img alt="" src="../images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li>
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>
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>
111 <div class="example"><p><code>
112 AddModuleInfo mod_auth.c 'See <a \<br />
113 <span class="indent">
114 href="http://www.apache.org/docs/2.0/mod/mod_auth.html">\<br />
115 http://www.apache.org/docs/2.0/mod/mod_auth.html</a>'
121 <div class="bottomlang">
122 <p><span>Available Languages: </span><a href="../en/mod/mod_info.html" title="English"> en </a> |
123 <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
124 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </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>