mod_info.xml revision e942c741056732f50da2074b36fe59805d370650
181e56d8b348d301d615ccf5465ae600fee2867berikabele<?xml version="1.0"?>
181e56d8b348d301d615ccf5465ae600fee2867berikabele<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<modulesynopsis>
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd
ca0e3098838c1f9aa77bcdfc3df99cf9aa0f9383slive<name>mod_info</name>
ca0e3098838c1f9aa77bcdfc3df99cf9aa0f9383slive<description>Provides a comprehensive overview of the server
ca0e3098838c1f9aa77bcdfc3df99cf9aa0f9383sliveconfiguration</description>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<status>Extension</status>
96ad5d81ee4a2cc66a4ae19893efc8aa6d06fae7jailletc<sourcefile>mod_info.c</sourcefile>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<identifier>info_module</identifier>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen
2e545ce2450a9953665f701bb05350f0d3f26275nd<summary>
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen <p>To configure <module>mod_info</module>, add the following to your
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <code>httpd.conf</code> file.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<example>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd&lt;Location /server-info&gt;<br />
7add1372edb1ee95a2c4d1314df4c7567bda7c62jimSetHandler server-info<br />
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim&lt;/Location&gt;<br />
5a58787efeb02a1c3f06569d019ad81fd2efa06end</example>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <p>You may wish to add a
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <directive module="core">&lt;Limit&gt;</directive>
af84459fbf938e508fd10b01cb8d699c79083813takashi clause inside the
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd <directive module="core">&lt;location&gt;</directive>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun directive to limit access to your server configuration
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung information.</p>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <p>Once configured, the server information is obtained by
7d37d896e4bce35ac213fededef06aff2d2f25d7rbowen accessing <code>http://your.host.dom/server-info</code></p>
7d37d896e4bce35ac213fededef06aff2d2f25d7rbowen
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen <note>
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen Note that the configuration files are read by the
ce71a46e27f6e2ae210e1f925545aa6e4f74db74jsl module at run-time, and therefore the display may
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen <em>not</em> reflect the running server's active
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen configuration if the files have been changed since the server
ca0e3098838c1f9aa77bcdfc3df99cf9aa0f9383slive was last reloaded. Also, the configuration files must be
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen readable by the user as which the server is running (see the
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen <directive module="mpm_common">User</directive> directive), or
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen else the directive settings will not be listed.
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen
5f48875017569cc7610b17d852c44e02684d9d5aerikabele <p>It should also be noted that if
5f48875017569cc7610b17d852c44e02684d9d5aerikabele <module>mod_info</module> is compiled into the server, its
5f48875017569cc7610b17d852c44e02684d9d5aerikabele handler capability is available in <em>all</em> configuration
5a58787efeb02a1c3f06569d019ad81fd2efa06end files, including <em>per</em>-directory files (<em>e.g.</em>,
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <code>.htaccess</code>). This may have security-related
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim ramifications for your site.</p>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim </note>
5a58787efeb02a1c3f06569d019ad81fd2efa06end</summary>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim
5a58787efeb02a1c3f06569d019ad81fd2efa06end<directivesynopsis>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<name>AddModuleInfo</name>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim<description>Allows additional information to be added to the module
7add1372edb1ee95a2c4d1314df4c7567bda7c62jiminformation displayed by the server-info handler</description>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<syntax>AddModuleInfo <em>module-name string</em></syntax>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh<contextlist><context>server config</context> <context>virtual
7add1372edb1ee95a2c4d1314df4c7567bda7c62jimhost</context></contextlist>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<compatibility>Apache 1.3 and above</compatibility>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen<usage>
ca0e3098838c1f9aa77bcdfc3df99cf9aa0f9383slive <p>This allows the content of <em>string</em> to be shown as
7d37d896e4bce35ac213fededef06aff2d2f25d7rbowen HTML interpreted, <strong>Additional Information</strong> for
7d37d896e4bce35ac213fededef06aff2d2f25d7rbowen the module <em>module-name</em>. Example:</p>
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen
ca0e3098838c1f9aa77bcdfc3df99cf9aa0f9383slive<example>
e884f58207082fa2136d5fc86635c31252338948erikabeleAddModuleInfo mod_auth.c 'See &lt;A HREF="http://www.apache.org/docs/mod/mod_auth.html"&gt;http://www.apache.org/docs/mod/mod_auth.html&lt;/A&gt;'
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen</example>
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen</usage>
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen</directivesynopsis>
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen</modulesynopsis>
ca0e3098838c1f9aa77bcdfc3df99cf9aa0f9383slive
57d0156f7bbd9ea3a72342cf9912aba61d118702rbowen