Merge in APR[-util] macros from branches/trunk-buildconf-noapr

[apache] / docs / manual / mod / mod_userdir.xml.ko

<?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: 151408:1745711 (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_userdir.xml.meta">

<name>mod_userdir</name>
<description>»ç¿ëÀÚº° µð·ºÅ丮</description>
<status>Base</status>
<sourcefile>mod_userdir.c</sourcefile>
<identifier>userdir_module</identifier>

<summary>
<p>ÀÌ ¸ðµâÀ» »ç¿ëÇϸé <code>http://example.com/~user/</code> ½ÄÀ¸·Î
»ç¿ëÀÚº° µð·ºÅ丮¿¡ Á¢±ÙÇÒ ¼ö ÀÖ´Ù.</p>
</summary>

<seealso><a href="../urlmapping.html">URLÀ» ÆÄÀϽýºÅÛ¿¡ ´ëÀÀ</a></seealso>
<seealso><a href="../howto/public_html.html">public_html
ÅõÅ丮¾ó</a></seealso>

<directivesynopsis>

<name>UserDir</name>
<description>»ç¿ëÀÚº° µð·ºÅ丮 À§Ä¡</description>
<syntax>UserDir <em>directory-filename</em></syntax>
<default>UserDir public_html</default>
<contextlist><context>server config</context> <context>virtual
host</context></contextlist>

<usage>

    <p><directive>UserDir</directive> Áö½Ã¾î´Â »ç¿ëÀÚÀÇ ¹®¼­¿¡ ´ëÇÑ
¿äûÀ» ¹ÞÀ»¶§ »ç¿ëÀÚ È¨µð·ºÅ丮 ¾È¿¡¼­ »ç¿ëÇÒ ½ÇÁ¦ µð·ºÅ丮¸¦
ÁöÁ¤ÇÑ´Ù. <em>Directory-filename</em>Àº ´ÙÀ½ Áß ÇϳªÀÌ´Ù:</p>

    <ul>
      <li>¾Æ·¡¿Í °°Àº µð·ºÅ丮¸í ȤÀº ÆÐÅÏ.</li>

      <li><code>disabled</code> Å°¿öµå. 
<code>enabled</code> Å°¿öµå·Î (¾Æ·¡ Âü°í) Á÷Á¢ À̸§À» ÁöÁ¤ÇÏÁö ¾Ê¾Ò´Ù¸é
<em>¸ðµç</em> »ç¿ëÀÚ¸í-µð·ºÅ丮 º¯È¯À» ÇÏÁö ¾Ê´Â´Ù.</li>

      <li><code>disabled</code> Å°¿öµå µÚ¿¡ °ø¹éÀ¸·Î ±¸ºÐÇÑ »ç¿ëÀÚ¸í ¸ñ·Ï.
»ç¿ëÀÚ¸íÀÌ <code>enabled</code> ±¸¹®¿¡ ÀÖ´Ù°í ÇÏ´õ¶óµµ, ÀÌ ¸ñ·Ï¿¡
ÀÖ´Â »ç¿ëÀÚ¸íÀº µð·ºÅ丮 º¯È¯À» ÇÏÁö <em>¾Ê´Â´Ù</em>.</li>

      <li><code>enabled</code> Å°¿öµå µÚ¿¡ °ø¹éÀ¸·Î ±¸ºÐÇÑ »ç¿ëÀÚ¸í ¸ñ·Ï.
Àüü disableÀ» »ç¿ëÇÏ°í »ç¿ëÀÚ¸íÀÌ <code>disabled</code> ±¸¹®¿¡
¾ø´õ¶óµµ, »ç¿ëÀÚ¸íÀ» µð·ºÅ丮 º¯È¯ÇÑ´Ù.</li>
    </ul>

    <p><code>Userdir</code> Áö½Ã¾î¿¡ <code>enabled</code>³ª
<code>disabled</code> Å°¿öµå¸¦ »ç¿ëÇÏÁö ¾ÊÀ¸¸é, ¾Æ±Ô¸ÕÆ®¸¦
ÆÄÀϸí ÆÐÅÏÀ¸·Î ó¸®ÇÏ¿© µð·ºÅ丮·Î º¯È¯ÇÑ´Ù.
<code>http://www.foo.com/~bob/one/two.html</code>¿¡ ´ëÇÑ ¿äûÀº
´ÙÀ½°ú °°ÀÌ º¯È¯µÈ´Ù:</p>

<table>
<tr><th>»ç¿ëÇÑ UserDir Áö½Ã¾î</th>
<th>º¯È¯ÇÑ °æ·Î</th></tr>
<tr><td>UserDir public_html</td><td>~bob/public_html/one/two.html</td></tr>
<tr><td>UserDir /usr/web</td><td>/usr/web/bob/one/two.html</td></tr>
<tr><td>UserDir /home/*/www</td><td>/home/bob/www/one/two.html</td></tr>
</table>

    <p>´ÙÀ½ Áö½Ã¾î´Â Ŭ¶óÀ̾ðÆ®¿¡°Ô ¸®´ÙÀÌ·º¼ÇÀ» º¸³½´Ù:</p> 

<table>
<tr><th>»ç¿ëÇÑ UserDir Áö½Ã¾î</th>
<th>º¯È¯ÇÑ °æ·Î</th></tr>
<tr><td>UserDir http://www.foo.com/users</td><td>http://www.foo.com/users/bob/one/two.html</td></tr>
<tr><td>UserDir
http://www.foo.com/*/usr</td><td>http://www.foo.com/bob/usr/one/two.html</td></tr>
<tr><td>UserDir
http://www.foo.com/~*/</td><td>http://www.foo.com/~bob/one/two.html</td></tr>
</table> 

<note>
      <strong>ÀÌ Áö½Ã¾î¸¦ »ç¿ëÇÒ¶§ ÁÖÀÇÇ϶ó; ¿¹¸¦ µé¾î,
<code>"UserDir ./"</code>´Â <code>"/~root"</code>¸¦ ¾Æ¸¶µµ ¹Ù¶÷Á÷ÇÏÁö ¾Ê°Ô
<code>"/"</code>·Î º¯È¯ÇÑ´Ù. ¼³Á¤¿¡ "<code>UserDir
      disabled root</code>"¸¦ Æ÷ÇÔÇÏ±æ °­·ÂÈ÷ ±ÇÇÑ´Ù. ÀÚ¼¼ÇÑ Á¤º¸¸¦ ¾Ë·Á¸é
<directive
      module="core">Directory</directive> Áö½Ã¾î¿Í <a
      href="../misc/security_tips.html">º¸¾È ÆÁ</a>µµ Âü°íÇ϶ó.</strong>
</note>

<p>Ãß°¡ ¿¹Á¦:</p>

<p>¸î¸î »ç¿ëÀÚ¿¡°Ô¸¸ <code>UserDir</code> µð·ºÅ丮¸¦ Çã¿ëÇÑ´Ù¸é,
´ÙÀ½°ú °°´Ù:</p>

<example>
UserDir disabled<br />
UserDir enabled user1 user2 user3
</example>

<p>´ëºÎºÐÀÇ »ç¿ëÀÚ¿¡°Ô <code>UserDir</code> µð·ºÅ丮¸¦ Çã¿ëÇÏ°í
ÀϺθ¸ °ÅºÎÇÑ´Ù¸é, ´ÙÀ½°ú °°´Ù:</p>

<example>
UserDir enabled<br />
UserDir disabled user4 user5 user6
</example>

<p>´Ù¸¥ »ç¿ëÀÚ µð·ºÅ丮¸¦ ÁöÁ¤ÇÒ ¼öµµ ÀÖ´Ù.
´ÙÀ½°ú °°Àº ¸í·É¾î¸¦ »ç¿ëÇÑ´Ù¸é:</p>
<example>
Userdir public_html /usr/web http://www.foo.com/
</example>
<p>http://www.foo.com/~bob/one/two.html ¿äûÀ» Çϸé,
¸ÕÀú ~bob/public_html/one/two.html ÆäÀÌÁö¸¦ ã°í,
/usr/web/bob/one/two.htmlÀ» ãÀº ÈÄ, ¸¶Áö¸·À¸·Î
http://www.foo.com/bob/one/two.htmlÀ¸·Î ¸®´ÙÀÌ·º¼ÇÀ» º¸³½´Ù.</p>
<p>¸®´ÙÀÌ·º¼ÇÀ» »ç¿ëÇÑ´Ù¸é ¸ñ·ÏÀÇ ¸¶Áö¸·¿¡ µÎ¾î¾ß ÇÑ´Ù.
¾ÆÆÄÄ¡´Â ¸®´ÙÀÌ·º¼ÇÀÌ ¼º°øÇß´ÂÁö ¾Ë ¼ö ¾ø±â¶§¹®¿¡, ¸®´ÙÀÌ·º¼ÇÀ»
¸ñ·Ï ¾Õ¿¡ µÎ¸é Ç×»ó ¸®´ÙÀÌ·º¼ÇÀ» »ç¿ëÇÏ°Ô µÈ´Ù.</p>

</usage>

<seealso><a href="../howto/public_html.html">public_html
ÅõÅ丮¾ó</a></seealso>

</directivesynopsis>
</modulesynopsis>