blob: 534cc60c0a6c06c09f4017a16ecc372f501eb1ed [file] [log] [blame]
<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 125277:1702020 (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 />
<indent>
SetHandler server-info<br />
</indent>
&lt;/Location&gt;
</example>
<p>ÀÌ·¸°Ô ¼³Á¤Çϸé
<code>http://your.host.example.com/server-info</code>¿¡
Á¢±ÙÇÏ¿© ¼­¹ö¿¡ ´ëÇÑ Á¤º¸¸¦ º¼ ¼ö ÀÖ´Ù.</p>
</summary>
<section id="security"><title>º¸¾È ¹®Á¦</title>
<p>Çѹø ¼­¹ö°¡ <module>mod_info</module>¸¦ ÀоîµéÀ̸é, µð·ºÅ丮º°
¼³Á¤ÆÄÀÏ(<em>¿¹¸¦ µé¾î</em>, <code>.htaccess</code>)À» Æ÷ÇÔÇÑ
<em>¸ðµç</em> ¼³Á¤ÆÄÀÏ¿¡¼­ ÀÌ Çڵ鷯 ±â´ÉÀ» »ç¿ëÇÒ ¼ö ÀÖ´Ù.
±×·¡¼­ »çÀÌÆ®¿¡ º¸¾È°ü·Ã ¹®Á¦°¡ µÉ ¼ö ÀÖ´Ù.</p>
<p>ƯÈ÷ ÀÌ ¸ðµâÀº ½Ã½ºÅÛ °æ·Î, »ç¿ëÀÚ¸í/¾ÏÈ£, µ¥ÀÌÅͺ£À̽º
À̸§°ú °°ÀÌ ¿©·¯ ¾ÆÆÄÄ¡ ¸ðµâÀÇ ¼³Á¤Áö½Ã¾î¿¡ ±â·ÏÇÑ ¹Î°¨ÇÑ
Á¤º¸¸¦ À¯ÃâÇÒ ¼ö ÀÖ´Ù. ±×·¡¼­ ÀÌ ¸ðµâÀº Ç×»ó ÁÖÀÇÇØ¾ß Çϸç
ÅëÁ¦µÈ ȯ°æ¿¡¼­<strong>¸¸</strong> »ç¿ëÇØ¾ß ÇÑ´Ù.</p>
<p>´ÙÀ½°ú °°ÀÌ <module>mod_authz_host</module>¸¦ »ç¿ëÇÏ¿©
¼­¹ö ¼³Á¤ Á¤º¸¿¡ ´ëÇÑ Á¢±ÙÀ» Á¦ÇÑÇÒ ¼ö ÀÖ´Ù.</p>
<example><title>Á¢±Ù Á¦¾î</title>
&lt;Location /server-info&gt;<br />
<indent>
SetHandler server-info<br />
Order allow,deny<br />
# ÀÚ½ÅÀ¸·Î ºÎÅÍ Á¢±Ù Çã°¡<br />
Allow from 127.0.0.1<br />
# Ãß°¡·Î, ±Ùó¿¡ ÀÖ´Â ¿öÅ©½ºÅ×À̼ÇÀ¸·Î ºÎÅÍ Á¢±Ù Çã°¡<br />
Allow from 192.168.1.17<br />
</indent>
&lt;/Location&gt;
</example>
</section>
<section id="queries"><title>º¸¿©ÁÖ´Â Á¤º¸ ¼±ÅÃÇϱâ</title>
<p>±âº»ÀûÀ¸·Î ¼­¹ö Á¤º¸¿¡´Â »ç¿ëÇÏ´Â ¸ðµâ ¸ñ·Ï°ú ¸ðµâº°·Î
¸ðµâÀÌ ÀÌÇØÇÏ´Â Áö½Ã¾î ¼³¸í, ¸ðµâÀÌ ±¸ÇöÇÑ ÈÅ(hook), ÇöÀç
¼³Á¤¿¡¼­ »ç¿ëÇÑ Áö½Ã¾î Á¤º¸°¡ ÀÖ´Ù.</p>
<p><code>server-info</code> ¿äû¿¡ ÁúÀǹ®ÀÚ¿­À» ºÙ¿©¼­ ¼³Á¤
Á¤º¸¸¦ ´Ù¸£°Ô º¼ ¼ö ÀÖ´Ù. ¿¹¸¦ µé¾î,
<code>http://your.host.example.com/server-info?config</code>´Â
¸ðµç ¼³Á¤Áö½Ã¾î¸¦ º¸¿© ÁØ´Ù.</p>
<dl>
<dt><code>?&lt;module-name&gt;</code></dt>
<dd>¸í½ÃÇÑ ¸ðµâ¿¡ ´ëÇÑ Á¤º¸¸¸</dd>
<dt><code>?config</code></dt>
<dd>¸ðµâº°·Î Á¤·ÄÇÏÁö ¾Ê°í, ¼³Á¤Áö½Ã¾î¸¸</dd>
<dt><code>?hooks</code></dt>
<dd>¸ðµâÀÌ µî·ÏÇÑ ÈÅ(hook) ¸ñ·Ï¸¸</dd>
<dt><code>?list</code></dt>
<dd>»ç¿ëÇÏ´Â ¸ðµâ ¸ñ·Ï¸¸</dd>
<dt><code>?server</code></dt>
<dd>±âº» ¼­¹ö Á¤º¸¸¸</dd>
</dl>
</section>
<section id="limitations"><title>¾Ë·ÁÁø ÇÑ°è</title>
<p><module>mod_info</module>´Â ¿ø·¡ ¼³Á¤ÆÄÀÏÀ» ÀÐÁö ¾Ê°í
ÀÌ¹Ì ÀоîµéÀÎ ¼³Á¤ Á¤º¸¸¦ Âü°íÇÏ¿© Á¤º¸¸¦ º¸¿©ÁØ´Ù. ¼³Á¤À»
ÆĽÌÇÏ´Â ¹æ¹ý¶§¹®¿¡ ´ÙÀ½°ú °°Àº ¸î°¡Áö ÇÑ°è°¡ ÀÖ´Ù.</p>
<ul>
<li>ÆĽÌÇÑ ¼³Á¤ Á¤º¸¿¡ ±â·ÏÇÏÁö ¾Ê°í Áï½Ã ½ÇÇàµÇ´Â Áö½Ã¾î¸¦
º¸¿©ÁÖÁö ¸øÇÑ´Ù. <directive
module="core">ServerRoot</directive>, <directive
module="mod_so">LoadModule</directive>, <directive
module="mod_so">LoadFile</directive>°ú °°Àº Áö½Ã¾î°¡
¿©±â¿¡ ÇØ´çÇÑ´Ù.</li>
<li><directive module="core">Include</directive>, <directive
module="core">&lt;IfModule&gt;</directive>, <directive
module="core">&lt;IfDefine&gt;</directive>°ú °°ÀÌ
¼³Á¤ÆÄÀÏ ÀÚü¸¦ Á¶Á¤ÇÏ´Â Áö½Ã¾î¸¦ º¸¿©ÁÖÁö ¸øÇÑ´Ù.
±×·¯³ª ¾È¿¡ ÀÖ´Â ¼³Á¤Áö½Ã¾î´Â º¸¿©ÁØ´Ù.</li>
<li>ÁÖ¼®À» º¸¿©ÁÖÁö ¸øÇÑ´Ù. (ÇÑ°è¶ó±â º¸´Ù´Â ±â´ÉÀ̶ó°í
»ý°¢ÇÒ ¼ö ÀÖ´Ù.)</li>
<li>(Áö¼ÓÀûÀÎ ¼­¹ö¼³Á¤ÀÌ ¾Æ´Ï±â ¶§¹®¿¡) <code>.htaccess</code>
ÆÄÀÏ¿¡ ÀÖ´Â ¼³Á¤Áö½Ã¾î¸¦ º¸¿©ÁÖÁö ¸øÇÑ´Ù.</li>
<li>º¸Åë <directive module="core">&lt;Directory&gt;</directive>¿Í
°°Àº ¹üÀ§Á¦ÇÑ Áö½Ã¾î´Â º¸¿©ÁÖÁö¸¸,
<module>mod_info</module>´Â ¸¶Ä¡´Â <directive
module="core">&lt;/Directory&gt;</directive>ÀÇ ÁÙ¹øÈ£¸¦
¾Ë ¼ö ¾ø´Ù.</li>
<li><module>mod_perl</module>°ú °°ÀÌ Á¦»ïÀÚ°¡ ¸¸µç ¸ðµâÀÇ
Áö½Ã¾î¸¦ º¸¿©ÁÖÁö ¸øÇÒ ¼ö ÀÖ´Ù.</li>
</ul>
</section>
<directivesynopsis>
<name>AddModuleInfo</name>
<description>¸ðµâ¿¡ ´ëÇÑ Ãß°¡ Á¤º¸¸¦ server-info Çڵ鷯°¡ º¸¿©ÁÖµµ·Ï
Ãß°¡ÇÑ´Ù</description>
<syntax>AddModuleInfo <var>module-name</var> <var>string</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<compatibility>¾ÆÆÄÄ¡ 1.3 ÀÌÈÄ</compatibility>
<usage>
<p><var>module-name</var> ¸ðµâ¿¡ ´ëÇÑ <strong>Ãß°¡ Á¤º¸</strong>·Î
<var>string</var>ÀÇ ³»¿ëÀ» HTML·Î º¸¿©ÁØ´Ù. ¿¹¸¦ µé¾î,</p>
<example>
AddModuleInfo mod_deflate.c 'See &lt;a \<br />
<indent>
href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html"&gt;\<br />
http://www.apache.org/docs/docs/&httpd.docs;/mod/mod_deflate.html&lt;/a&gt;'
</indent>
</example>
</usage>
</directivesynopsis>
</modulesynopsis>