<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
<!-- English Revision: 97155:421174 (outdated) -->

<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You under the Apache License, Version 2.0
 (the "License"); you may not use this file except in compliance with
 the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="mod_info.xml.meta">

<name>mod_info</name>
<description>サーバの設定の包括的な概観を提供する</description>
<status>Extension</status>
<sourcefile>mod_info.c</sourcefile>
<identifier>info_module</identifier>


<summary>

    <p><module>mod_info</module> を設定するには、以下を <code>httpd.conf</code>
    ファイルに加えます。</p>

<example>
&lt;Location /server-info&gt;<br />
SetHandler server-info<br />
&lt;/Location&gt;<br />
</example>

    <p>サーバ設定の情報へのアクセスを制限するために、
    <directive type="section" module="core">Location</directive>
    ディレクティブの中に <directive type="section" module="core">Limit</directive>
    節を入れるとよいかもしれません。</p>

    <p>一旦設定すると、<code>http://your.host.dom/server-info</code>
    をアクセスすることでサーバの情報を得られるようになります。</p>

    <note>
      <p>このモジュールは実行時に設定ファイルを読み込みます。
      サーバの設定ファイルが最後にサーバに読み込まれた後に変更されている
      場合には、表示されている内容は実行されているサーバの設定を反映して
      <em>いない</em>かもしれないことに注意してください。
      また、設定ファイルはサーバが実行されているユーザの権限で
      読み込み許可が与えられている必要があります
      (<directive module="mpm_common">User</directive>
      ディレクティブを参照してください)。
      でなければ、ディレクティブの設定は表示されません。</p>

      <p><module>mod_info</module>
      がサーバに組み込まれている場合は、ディレクトリ<em>毎</em>のファイル
      (例えば、<code>.htaccess</code>) を含むすべての設定ファイルで
      ハンドラを使用可能であるということにも注意してください。
      これは、あなたのサイトではセキュリティに関連した問題があるかもしれません。
      </p>

      <p>特に、このモジュールはシステムパス、ユーザ名/パスワード、
      データベース名など、他の Apache モジュールの設定ディレクティブから
      セキュリティ上微妙な情報を漏らす可能性があります。
      このモジュールの動作方法のせいで、情報の流出を防ぐ方法はありません。
      ですから、このモジュールはちゃんとアクセスが制御された環境で、
      注意して使ってください。</p>
    </note>
</summary>

<directivesynopsis>
<name>AddModuleInfo</name>
<description>server-info ハンドラにより表示されるモジュールの情報に
追加の情報を付け加える</description>
<syntax>AddModuleInfo <em>module-name string</em></syntax>
<contextlist><context>server config</context>
<context>virtual host</context></contextlist>
<compatibility>Apache 1.3 以降</compatibility>

<usage>
    <p>これは、<em>string</em> の内容がモジュール <em>module-name</em>
    の<strong>追加情報</strong> として HTML
    として解釈され、表示されるようにします。例:</p>

<example>
  AddModuleInfo mod_authn_file.c 'See &lt;a \<br />
  <indent>
    href="http://www.apache.org/docs/&httpd.docs;/mod/mod_authn_file.html"&gt;\<br />
    http://www.apache.org/docs/&httpd.docs;/mod/mod_authn_file.html&lt;/a&gt;'
  </indent>
</example>
</usage>

</directivesynopsis>
</modulesynopsis>

