diff options
Diffstat (limited to 'docs/manual')
| -rw-r--r-- | docs/manual/mod/mod_cgi.xml.ko | 209 | ||||
| -rw-r--r-- | docs/manual/mod/mod_cgid.xml.ko | 74 | ||||
| -rw-r--r-- | docs/manual/mod/mod_charset_lite.xml.ko | 168 | ||||
| -rw-r--r-- | docs/manual/mod/mod_dav.xml.ko | 230 | ||||
| -rw-r--r-- | docs/manual/mod/mod_dav_fs.xml.ko | 65 | ||||
| -rw-r--r-- | docs/manual/mod/mod_deflate.xml.ko | 294 | ||||
| -rw-r--r-- | docs/manual/mod/mod_dir.xml.ko | 76 | ||||
| -rw-r--r-- | docs/manual/mod/mod_disk_cache.xml.ko | 317 | ||||
| -rw-r--r-- | docs/manual/mod/mod_echo.xml.ko | 40 | ||||
| -rw-r--r-- | docs/manual/mod/mod_env.xml.ko | 75 |
10 files changed, 1548 insertions, 0 deletions
diff --git a/docs/manual/mod/mod_cgi.xml.ko b/docs/manual/mod/mod_cgi.xml.ko new file mode 100644 index 0000000000..3934d7806c --- /dev/null +++ b/docs/manual/mod/mod_cgi.xml.ko @@ -0,0 +1,209 @@ +<?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: 1.9 --> +<modulesynopsis metafile="mod_cgi.xml.meta"> + +<name>mod_cgi</name> +<description>CGI 스크립트 실행</description> +<status>Base</status> +<sourcefile>mod_cgi.c</sourcefile> +<identifier>cgi_module</identifier> + +<summary> + <!-- XXX: Should mention Options ExecCGI + is the link to howto/cgi not sufficient? -nd + --> + + <p>서버는 mime type이 <code>application/x-httpd-cgi</code>이거나 + (아파치 1.1 이후) 핸들러가 <code>cgi-script</code>인 모든 + 파일을 CGI 스크립트로 인식하여, 실행하고, 그 결과를 클라이언트에게 + 보낸다. 파일이 <directive module="mod_mime">AddType</directive> + 지시어로 지정한 확장자를 가지거나, <directive + module="mod_alias">ScriptAlias</directive> 디렉토리 안에 + 있으면 CGI로 처리된다.</p> + + <p>서버는 CGI 스크립트를 부를때 <code>DOCUMENT_ROOT</code>라는 + 환경변수를 추가한다. 이 변수는 <directive + module="core">DocumentRoot</directive> 설정값을 가진다.</p> + + <p>아파치에서 CGI 스크립트를 사용하는 방법에 대한 소개는 + <a href="../howto/cgi.html">CGI로 동적내용</a> 투토리얼을 + 참고하라.</p> + + <p>유닉스에서 다중쓰레드 MPM을 사용한다면 이 모듈대신 + <module>mod_cgid</module> 모듈을 사용해야 한다. 사용자 + 입장에서 이 두 모듈은 기본적으로 동일하다.</p> +</summary> + +<seealso><directive module="core">AcceptPathInfo</directive></seealso> +<seealso><directive module="core">Options</directive></seealso> +<seealso><directive module="mod_alias">ScriptAlias</directive></seealso> +<seealso><directive module="mod_mime">AddHandler</directive></seealso> +<seealso><a href="../suexec.html">다른 사용자 ID로 CGI 프로그램 +실행하기</a></seealso> +<seealso><a href="http://hoohoo.ncsa.uiuc.edu/cgi/">CGI 표준</a></seealso> + +<section id="env"><title>CGI 환경변수</title> + <p>서버는 다음과 같은 방법으로 <a + href="http://hoohoo.ncsa.uiuc.edu/cgi/">CGI 표준</a>이 설명하는 + CGI 환경변수를 설정한다:</p> + + <dl> + <dt>PATH_INFO</dt> + + <dd>이 변수는 <directive module="core" + >AcceptPathInfo</directive> 지시어를 직접 <code>off</code>로 + 지정한 경우에만 설정한다. <directive + >AcceptPathInfo</directive>가 없는 경우 서버는 기본적으로 + 경로 정보가 있는 요청에 대해 404 NOT FOUND 오류를 내지만, + <module>mod_cgi</module>는 경로 정보를 (URI에서 스크립트 + 파일명 뒤에 나오는 <code>/more/path/info</code>) 받는다. + <directive>AcceptPathInfo</directive> 지시어를 생략하면 + <module>mod_cgi</module> 요청에 대해서 <directive + module="core">AcceptPathInfo</directive>를 <code>On</code>으로 + 설정한 것과 같다.</dd> + + <dt>REMOTE_HOST</dt> + + <dd>이 변수는 <directive module="core" + >HostnameLookups</directive>가 <code>on</code>이고 (기본값은 + off), 접속한 호스트 주소를 역DNS 검색하여 실제 호스트명을 + 찾은 경우에만 설정한다.</dd> + + <dt>REMOTE_IDENT</dt> + + <dd>이 변수는 <directive module="core" + >IdentityCheck</directive>가 <code>on</code>이고, 접속한 + 호스트가 ident 프로토콜을 지원하는 경우에만 설정한다. + 쉽게 이 값을 속일 수 있기때문에 이 변수의 내용을 믿으면 + 안되고, 클라이언트와 서버 사이에 프록시가 있다면 변수 + 내용이 완전히 무의미함을 주의하라.</dd> + + <dt>REMOTE_USER</dt> + + <dd>CGI 스크립트가 인증을 거쳐야하는 경우에만 설정한다.</dd> + </dl> +</section> + +<section id="cgi-debug"><title>CGI 디버깅</title> + <p>어디에서 잘못 실행되는지 스크립트의 출력을 (표준출력과 + 표준오류) 볼 수 없기때문에 CGI 스크립트는 전통적으로 디버깅하기 + 어려웠다. 아파치 1.2 이후에 추가된 지시어를 사용하면 발생한 + 오류를 자세히 로그에 남길 수 있다.</p> + + <section><title>CGI 로그파일 형식</title> + <p>CGI 오류로그는 정상적으로 실행하지 못한 CGI를 기록한다. + 오류가 발생한 CGI 스크립트는 로그에 여러 줄의 정보를 남긴다. + 첫번째 두 줄은 항상 아래와 같은 형식이다:</p> + + <example> + %% [<var>시간</var>] <var>요청줄</var><br /> + %% <var>HTTP-상태</var> <var>CGI-스크립트-파일명</var> + </example> + + <p>CGI 스크립트를 실행할 수 없는 오류인 경우 로그파일에 + 추가로 두 줄을 더 기록한다:</p> + + <example> + %%error<br /> + <var>오류문</var> + </example> + + <p>스크립트가 (보통 스크립트의 버그때문에) 잘못된 헤더 + 정보를 반환하는 경우, 다음 내용을 로그에 기록한다:</p> + + <example> + %request<br /> + <var>받은 모든 HTTP 헤더</var><br /> + <var>(있다면) POST나 PUT 내용</var><br /> + %response<br /> + <var>CGI 스크립트 출력의 모든 헤더</var><br /> + %stdout<br /> + <var>CGI 표준출력</var><br /> + %stderr<br /> + <var>CGI 표준오류</var><br /> + </example> + + <p>(스크립트가 표준출력이나 표준오류에 아무 내용도 출력하지 + 않았다면 %stdout과 %stderr 부분은 생략될 수 있다).</p> + </section> +</section> + +<directivesynopsis> +<name>ScriptLog</name> +<description>CGI 스크립트 오류로그파일의 위치</description> +<syntax>ScriptLog <var>file-path</var></syntax> +<contextlist><context>server config</context> +<context>virtual host</context></contextlist> +<modulelist><module>mod_cgi</module><module>mod_cgid</module> +</modulelist> + +<usage> + <p><directive>ScriptLog</directive> 지시어는 CGI 스크립트 + 오류로그파일을 지정한다. <directive>ScriptLog</directive>를 + 사용하지않으면 오류로그를 만들지 않는다. 사용하면 아규먼트로 + 지정한 파일에 CGI 오류를 기록한다. 상대경로를 지정하면 + <directive module="core">ServerRoot</directive>에 상대경로로 + 받아들인다. + </p> + + <example><title>예제</title> + ScriptLog logs/cgi_log + </example> + + <p>자식 프로세스를 실행하는 사용자, <em>즉</em> <directive + module="mpm_common">User</directive> 지시어로 지정한 사용자 + 권한으로 로그를 연다. 그래서 그 사용자가 스크립트 로그가 + 있는 디렉토리에 쓰기권한이 있던지, 직접 미리 파일을 만들어서 + 그 사용자에게 쓰기권한을 줘야 한다. 스크립트 로그를 주 로그 + 디렉토리에 둔다면 자식 프로세스를 실행하는 사용자에게 쓰기권한을 + 주기위해 디렉토리 권한을 변경하지 <strong>마라</strong>.</p> + + <p>스크립트 로그는 CGI 스크립트를 작성할때 디버깅을 위한 + 용도이지 서버를 실행하는 동안 계속 사용하기위함이 아님을 + 주의하라. 속도와 효율성면에서 최적화가 안되있고, 설계한 + 목적이외의 방법으로 사용하면 보안상 문제가 될 수 있다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ScriptLogLength</name> +<description>CGI 스크립트 로그파일의 크기 제한</description> +<syntax>ScriptLogLength <var>bytes</var></syntax> +<default>ScriptLogLength 10385760</default> +<contextlist><context>server config</context> +<context>virtual host</context></contextlist> +<modulelist><module>mod_cgi</module><module>mod_cgid</module> +</modulelist> + +<usage> + <p><directive>ScriptLogLength</directive>는 CGI 스크립트 + 로그파일의 크기를 제한한다. CGI 오류가 발생할때마다 (모든 + 요청 헤더, 모든 스크립트 출력 등) 많은 정보가 로그에 + 기록되기때문에 파일이 매우 커질 수 있다. 파일이 무한히 커지는 + 문제를 막기위해 이 지시어를 사용하여 CGI 로그파일의 최대 + 파일크기를 설정한다. 파일의 크기가 설정한 값을 넘으면 더 + 이상 정보를 기록하지않는다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ScriptLogBuffer</name> +<description>스크립트 로그에 기록할 PUT 혹은 POST 요청의 최대량</description> +<syntax>ScriptLogBuffer <var>bytes</var></syntax> +<default>ScriptLogBuffer 1024</default> +<contextlist><context>server config</context> +<context>virtual host</context></contextlist> +<modulelist><module>mod_cgi</module><module>mod_cgid</module> +</modulelist> + +<usage> + <p>큰 내용을 받아서 로그파일이 너무 빨리 커지는 현상을 막기위해 + 파일에 기록할 PUT 혹은 POST 내용의 크기를 제한한다. 기본적으로 + 1024 바이트까지 로그에 기록하지만, 이 지시어를 사용하여 + 수정할 수 있다.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_cgid.xml.ko b/docs/manual/mod/mod_cgid.xml.ko new file mode 100644 index 0000000000..5703f3adaf --- /dev/null +++ b/docs/manual/mod/mod_cgid.xml.ko @@ -0,0 +1,74 @@ +<?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: 1.8 --> +<modulesynopsis metafile="mod_cgid.xml.meta"> + +<name>mod_cgid</name> +<description>외부 CGI 데몬을 사용하여 CGI 스크립트를 실행</description> +<status>Base</status> +<sourcefile>mod_cgid.c</sourcefile> +<identifier>cgid_module</identifier> +<compatibility>유닉스에서 쓰레드를 사용하는 MPMs 전용</compatibility> + +<summary> + <p>아래에서 설명하는 추가된 <directive + module="mod_cgid">ScriptSock</directive> 지시어를 제외하고 + <module>mod_cgid</module>는 <module>mod_cgi</module>와 + 비슷하게 동작한다. <strong>아파치와 CGI에 대한 자세한 설명은 + <module>mod_cgi</module>를 참고하라.</strong></p> + + <p>어떤 유닉스 운영체제의 경우 다중쓰레드 서버에서 프로세스를 + 포크(fork)하면 새로운 프로세스가 부모 프로세스의 모든 쓰레드를 + 복제해야 하므로 부담이 된다. CGI 실행마다 이런 부담을 주지 + 않기위해 <module>mod_cgid</module>는 CGI 스크립트를 실행하는 + 자식 프로세스를 포크하는 외부 데몬을 만든다. 주서버는 이 + 데몬과 유닉스소켓(unix domain socket)을 사용하여 통신한다.</p> + + <p>컴파일할때 다중쓰레드 MPM을 선택하면 기본적으로 + <module>mod_cgi</module> 대신 이 모듈을 사용한다. 사용자 + 입장에서 이 모듈의 설정과 동작은 <module>mod_cgi</module>와 + 동일하다. 유일한 차이점은 cgi 데몬과 통신을 위해 사용할 + 소켓의 이름을 설정하는 <code>ScriptSock</code> 지시어가 + 추가된 점이다.</p> +</summary> + +<seealso><module>mod_cgi</module></seealso> +<seealso><a href="../suexec.html">다른 사용자 ID로 CGI 프로그램 +실행하기</a></seealso> + +<directivesynopsis location="mod_cgi"> +<name>ScriptLog</name> +</directivesynopsis> + +<directivesynopsis location="mod_cgi"> +<name>ScriptLogLength</name> +</directivesynopsis> + +<directivesynopsis location="mod_cgi"> +<name>ScriptLogBuffer</name> +</directivesynopsis> + +<directivesynopsis> +<name>ScriptSock</name> +<description>cgi 데몬과 통신을 위해 사용할 소켓의 이름</description> +<syntax>ScriptSock <var>file-path</var></syntax> +<default>ScriptSock logs/cgisock</default> +<contextlist><context>server config</context> +<context>virtual host</context></contextlist> + +<usage> + <p>이 지시어는 CGI 데몬과 통신을 위해 사용할 소켓의 이름을 + 지정한다. 아파치를 시작한 사용자 (보통 root) 권한으로 소켓을 + 연다. CGI 스크립트와 통신의 보안을 위해 다른 사용자가 소켓이 + 있는 디렉토리에 쓰기권한을 가지지않는 것이 중요하다.</p> + + <example><title>예제</title> + ScriptSock /var/run/cgid.sock + </example> + +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_charset_lite.xml.ko b/docs/manual/mod/mod_charset_lite.xml.ko new file mode 100644 index 0000000000..7ef386a2b8 --- /dev/null +++ b/docs/manual/mod/mod_charset_lite.xml.ko @@ -0,0 +1,168 @@ +<?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: 1.7 --> +<modulesynopsis metafile="mod_charset_lite.xml.meta"> + +<name>mod_charset_lite</name> +<description>문자집합 변환을 지정</description> +<status>Experimental</status> +<sourcefile>mod_charset_lite.c</sourcefile> +<identifier>charset_lite_module</identifier> + +<summary> + <p>이 모듈은 <strong>실험적인</strong> 모듈이고, 주의있게 + 사용해야 한다. 원하는 동작을 하는지 + <module>mod_charset_lite</module> 설정을 시험해봐라.</p> + + <p><module>mod_charset_lite</module>를 사용하여 문서 원본의 + 문자집합과 문서를 클라이언트로 보내기 전에 변환할 문자집합을 + 지정할 수 있다. <module>mod_charset_lite</module>는 직접 + 자료를 변환하지않고 대신 아파치에게 변환하라고 요청한다. + <module>mod_charset_lite</module>는 EBCDIC과 ASCII 환경에서 + 사용할 수 있다. EBCDIC 환경에서 아파치는 보통 아파치 프로세스의 + 코드페이지에서 ISO-8859-1 문자집합으로 문서를 변환한다. + <module>mod_charset_lite</module>를 사용하여 다른 변환을 + 지시할 수 있다. ASCII 환경에서 아파치는 기본적으로 변환을 + 하지 않기때문에, 어떤 변환을 위해서는 + <module>mod_charset_lite</module>가 필요하다.</p> + + <p>이 모듈은 러시아판 아파치의 <code>mod_charset</code>이 + 제공하는 설정의 일부를 제공한다.</p> +</summary> + +<section id="problems"><title>일반적인 문제점</title> + + <section><title>잘못된 문자집합 이름</title> + + <p><module>mod_charset_lite</module>를 사용하는 시스템의 + ARP 번역기능이 <directive + module="mod_charset_lite">CharsetSourceEnc</directive>와 + <directive module="mod_charset_lite">CharsetDefault</directive>의 + 파라미터인 문자집합 이름을 처리할 수 있어야 한다. 문자집합 + 이름은 표준화되지 않았고, http 헤더에 사용하는 값과 항상 + 같지는 않다. 현재 APR은 iconv(3)만을 사용하기때문에, + 다음과 같이 iconv(1) 프로그램을 사용하여 특정 문자집합 + 이름을 사용할 수 있는지 쉽게 알 수 있다:</p> + + <example> + iconv -f charsetsourceenc-value -t charsetdefault-value + </example> + </section> + + <section><title>내용과 변환규칙의 문자집합이 서로 다름</title> + + <p>변환규칙이 상황에 맞지않으면 다음과 같은 여러 방식으로 + 변환이 실패할 수 있다:</p> + + <ul> + <li>변환기능이 실패 반환코드를 반환하고 연결이 끊어질 + 수 있다.</li> + + <li>입력버퍼를 변환하지 못할때 출력버퍼에 대신 특별한 + 문자를 (예, 물음표) 적을 수 있다.</li> + </ul> + </section> +</section> + +<directivesynopsis> +<name>CharsetSourceEnc</name> +<description>파일 원본의 문자집합</description> +<syntax>CharsetSourceEnc <var>charset</var></syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context> +</contextlist> +<override>FileInfo</override> + +<usage> + <p><directive>CharsetSourceEnc</directive> 지시어는 지시어를 + 사용한 위치에 있는 파일들 원본의 문자집합을 지정한다.</p> + + <p><var>charset</var> 아규먼트에는 APR이 지원하는 문자집합 + 이름을 사용해야 한다. 일반적으로 iconv가 지원하는 문자집합을 + 의미한다.</p> + + <example><title>예제</title> + <Directory /export/home/trawick/apacheinst/htdocs/convert><br /> + <indent> + CharsetSourceEnc UTF-16BE<br /> + CharsetDefault ISO-8859-1<br /> + </indent> + </Directory> + </example> + + <p>Solaris 8의 iconv가 이 예제의 문자집합을 지원한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CharsetDefault</name> +<description>변환할 문자집합</description> +<syntax>CharsetDefault <var>charset</var></syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context> +</contextlist> +<override>FileInfo</override> + +<usage> + <p><directive>CharsetDefault</directive> 지시어는 지시어를 + 사용한 위치에 있는 원본을 변환할 문자집합을 지정한다.</p> + + <p><var>charset</var> 아규먼트에는 APR이 지원하는 문자집합 + 이름을 사용해야 한다. 일반적으로 iconv가 지원하는 문자집합을 + 의미한다.</p> + + <example><title>예제</title> + <Directory /export/home/trawick/apacheinst/htdocs/convert><br /> + <indent> + CharsetSourceEnc UTF-16BE<br /> + CharsetDefault ISO-8859-1<br /> + </indent> + </Directory> + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CharsetOptions</name> +<description>문자집합 변환 기능을 설정</description> +<syntax>CharsetOptions <var>option</var> [<var>option</var>] ...</syntax> +<default>CharsetOptions DebugLevel=0 NoImplicitAdd</default> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context> +</contextlist> +<override>FileInfo</override> + +<usage> + <p><directive>CharsetOptions</directive> 지시어는 + <module>mod_charset_lite</module>의 기능을 설정한다. + <var>Option</var>에는 아래 항목들을 사용할 수 있다</p> + + <dl> + <dt><code>DebugLevel=<var>n</var></code></dt> + + <dd><code>DebugLevel</code> 키워드는 + <module>mod_charset_lite</module>가 기록하는 디버그문구의 + 수준을 설정한다. 기본적으로 어떤 것도 기록하지 않는다. + 이는 <code>DebugLevel=0</code>과 같다. 높은 숫자를 사용할수록 + 더 많은 디버그문구를 기록하게되어 서버 성능이 떨어진다. + 숫자값의 실제 의미는 <code>mod_charset_lite.c</code> 앞부분의 + DBGLVL_ 상수 정의를 참고하라.</dd> + + <dt><code>ImplicitAdd | NoImplicitAdd</code></dt> + + <dd><code>ImplicitAdd</code> 키워드는 내용을 변환할 + 문자집합을 지정하면 자동으로 <module>mod_charset_lite</module>를 + 필터에 추가한다. <directive module="mod_mime" + >AddOutputFilter</directive> 지시어로 필터순서를 직접 + 지정한다면, <code>NoImplicitAdd</code>를 사용하여 + <module>mod_charset_lite</module>가 자동으로 필터에 + 추가되지않도록 해야 한다.</dd> + </dl> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_dav.xml.ko b/docs/manual/mod/mod_dav.xml.ko new file mode 100644 index 0000000000..9e8f775995 --- /dev/null +++ b/docs/manual/mod/mod_dav.xml.ko @@ -0,0 +1,230 @@ +<?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: 1.8 --> +<modulesynopsis metafile="mod_dav.xml.meta"> + +<name>mod_dav</name> +<description>Distributed Authoring and Versioning +(<a href="http://www.webdav.org/">WebDAV</a>) 기능</description> +<status>Extension</status> +<sourcefile>mod_dav.c</sourcefile> +<identifier>dav_module</identifier> + +<summary> + <p>이 모듈은 아파치에 <a href="http://www.webdav.org">WebDAV</a> + ('Web-based Distributed Authoring and Versioning') class 1과 + class 2 기능을 추가한다. WebDAV는 원격 웹서버의 자원과 + 콜렉션(collection)을 <transnote>콜렉션은 파일시스템의 디렉토리와 + 같은 개념이다</transnote> 만들고, 옮기고, 복사하고, 지울 + 수 있도록 HTTP 프로토콜을 확장한 것이다.</p> +</summary> +<seealso><directive module="mod_dav_fs">DavLockDB</directive></seealso> +<seealso><directive module="core">LimitXMLRequestBody</directive></seealso> +<seealso><a href="http://www.webdav.org">WebDAV 정보</a></seealso> + +<section id="example"><title>WebDAV 사용하기</title> + <p><module>mod_dav</module>를 사용하려면 <code>httpd.conf</code> + 파일에 아래과 같이 추가한다:</p> + + <example>Dav On</example> + + <p>그러면 <module>mod_dav_fs</module> 모듈이 구현하는 DAV + 파일시스템 제공자(provider)를 사용한다. 그러므로 이 모듈도 + 서버에 같이 컴파일되있거나 <directive + module="mod_so">LoadModule</directive> 지시어로 실행중에 + 읽어들여야 한다.</p> + + <p>또, DAV 잠금(lock) 데이터베이스의 위치를 <code>httpd.conf</code> + 파일의 전역 부분에 <directive + module="mod_dav_fs">DavLockDB</directive> 지시어를 사용하여 + 지정해야 한다:</p> + + <example> + DavLockDB /usr/local/apache2/var/DavLock + </example> + + <p>아파치를 실행하는 <directive + module="mpm_common">User</directive>와 <directive + module="mpm_common" >Group</directive>은 잠금 데이터베이스가 + 있는 디렉토리에 쓰기 권한을 가져야 한다.</p> + + <p>DAV를 사용하는 위치에 접근을 제한하기위해 <directive + module="core" type="section">Location</directive> 지시어 + 안에 <directive module="core" type="section">Limit</directive> + 지시어를 사용할 수 있다. DAV 클라이언트가 한번의 요청에 + 보낼 수 있는 최대 바이트수를 제한하려면 <directive + module="core">LimitXMLRequestBody</directive> 지시어를 사용한다. + "일반적인" <directive module="core">LimitRequestBody</directive> + 지시어는 DAV 요청과 관계없다.</p> + + <example><title>전체 예제</title> + DavLockDB /usr/local/apache2/var/DavLock<br /> + <br /> + <Location /foo><br /> + <indent> + Dav On<br /> + <br /> + AuthType Basic<br /> + AuthName DAV<br /> + AuthUserFile user.passwd<br /> + <br /> + <LimitExcept GET OPTIONS><br /> + <indent> + require user admin<br /> + </indent> + </LimitExcept><br /> + </indent> + </Location><br /> + </example> + + <p><module>mod_dav</module>는 Greg Stein이 만든 <a + href="http://www.webdav.org/mod_dav/">Apache 1.3용 mod_dav</a>를 + 기반으로 만들었다. 모듈에 대한 더 자세한 정보는 그 사이트를 + 참고하라.</p> +</section> + +<section id="security"><title>보안 문제</title> + + <p>DAV를 사용하면 원격 클라이언트가 서버의 파일을 조작할 + 수 있기때문에, <module>mod_dav</module>를 사용하기 전에 + 서버가 안전한지 특별히 관심을 가져야 한다.</p> + + <p>서버에서 DAV가 가능한 위치는 인증으로 보호해야 한다. + HTTP Basic Authentication는 추천하지 않는다. 최소한 + <module>mod_auth_digest</module> 모듈이 제공하는 HTTP Digest + Authentication을 사용해야 한다. 거의 모든 WebDAV 클라이언트는 + 이 인증 방식을 지원한다. 아니면 <a href="../ssl/">SSL</a> + 연결에서 Basic Authentication을 사용할 수도 있다.</p> + + <p><module>mod_dav</module>가 파일을 조작하려면, 아파치를 + 실행하는 <directive module="mpm_common">User</directive>와 + <directive module="mpm_common">Group</directive>은 해당 + 디렉토리와 파일에 쓰기 권한을 가져야 한다. 또, 새로 생성한 + 파일은 <directive module="mpm_common">User</directive>와 + <directive module="mpm_common">Group</directive>이 소유하게 + 된다. 그래서 아무나 이 계정에 접근할 수 없도록 하라. DAV + 저장소는 아파치만 접근할 수 있다고 가정한다. 아파치를 통하지않고 + (예를 들어 FTP나 파일시스템 도구를 사용하여) 파일을 수정함을 + 허용하면 안된다.</p> + + <p><module>mod_dav</module>는 여러 서비스거부 공격의 대상이 + 될 수 있다. <directive + module="core">LimitXMLRequestBody</directive> 지시어를 + 사용하여 큰 DAV 요청을 읽을때 메모리량을 제한할 수 있다. + <directive module="mod_dav">DavDepthInfinity</directive> + 지시어를 사용하여 많은 메모리를 소모하기위한 매우 큰 저장소의 + <code>PROPFIND</code> 요청을 막을 수 있다. 단순히 클라이언트가 + 여러 큰 파일들로 디스크공간을 채우는 서비스거부 공격도 가능하다. + 아파치에서 이를 막을 직접적인 방법은 없다. 그러므로 신뢰하지않는 + 사용자에게 DAV 접근을 허용하지 않도록하라.</p> +</section> + +<section id="complex"><title>복잡한 설정</title> + + <p>일반적인 질문중 하나는 (PHP 스크립트, CGI 스크립트 등) + 동적파일 작업을 위해 <module>mod_dav</module>를 사용하는 + 방법이다. 이는 <code>GET</code> 요청이 파일 내용을 다운로드하지 + 않고 항상 스크립트를 실행하므로 어렵다. 해결방법중 하나는 + 내용에 두개의 URL을 대응하는 것이다. 한 URL은 스크립트를 + 실행하고, 다른 URL로는 파일을 다운로드하여 DAV로 작업할 + 수 있다.</p> + +<example> +Alias /phparea /home/gstein/php_files<br /> +Alias /php-source /home/gstein/php_files<br /> +<Location /php-source> +<indent> + DAV On<br /> + ForceType text/plain<br /> +</indent> +</Location> +</example> + + <p>이 설정에서 <code>http://example.com/phparea</code>는 + PHP 스크립트의 결과를 보여주고, + <code>http://example.com/php-source</code>로는 DAV 클라이언트에서 + 스크립트를 수정할 수 있다.</p> +</section> + +<directivesynopsis> +<name>Dav</name> +<description>WebDAV HTTP 메써드를 시작한다</description> +<syntax>Dav On|Off|<var>provider-name</var></syntax> +<default>Dav Off</default> +<contextlist><context>directory</context></contextlist> + +<usage> + <p>지정한 위치에서 WebDAV HTTP 메써드를 사용하려면 + <directive>Dav</directive> 지시어를 사용한다:</p> + + <example> + <Location /foo><br /> + <indent> + Dav On<br /> + </indent> + </Location> + </example> + + <p><code>On</code> 값은 실제로 <module>mod_dav_fs</module> + 모듈이 제공하는 기본 제공자인 <code>filesystem</code>의 + 별칭이다. 어떤 위치에서 DAV를 시작하면 하위공간에서 DAV를 + 사용안하도록 설정할 수 <em>없음을</em> 주의하라. 완전한 + 설정예는 <a href="#example">위의 절</a>을 참고하라.</p> + + <note type="warning"> + 서버를 안전하게 구성할때까지 WebDAV을 사용하지 마라. 그렇지 + 않으면 누구라도 서버를 통해 파일을 분배할 수 있게 된다. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>DavMinTimeout</name> +<description>서버가 DAV 자원에 대해 유지할 잠금의 최소시간</description> +<syntax>DavMinTimeout <var>seconds</var></syntax> +<default>DavMinTimeout 0</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> + +<usage> + <p>클라이언트가 DAV 자원에 잠금(lock)을 요청할때 서버가 + 알아서 잠금을 제거할 수 있는 시간을 같이 알려줄 수 있다. 이 값은 + 단지 요청일뿐이며, 서버는 클라이언트가 요청한 값을 무시하고 + 클라이언트에게 임의의 시간을 알려줄 수 있다.</p> + + <p><directive>DavMinTimeout</directive> 지시어는 클라이언트에게 + 보낼 최소 잠금 시간을 (초단위) 지정한다. Microsoft Web Folders는 + 기본값으로 120 초를 사용한다. <directive>DavMinTimeout</directive>에 + (600 초와 같이) 더 높은 값을 사용하면 클라이언트가 네트웍 + 지연때문에 잠금을 잃게되는 경우를 줄일 수 있다.</p> + + <example><title>예제</title> + <Location /MSWord><br /> + <indent> + DavMinTimeout 600<br /> + </indent> + </Location> + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>DavDepthInfinity</name> +<description>PROPFIND의 Depth: Infinity 요청을 허가한다</description> +<syntax>DavDepthInfinity on|off</syntax> +<default>DavDepthInfinity off</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> + +<usage> + <p><directive>DavDepthInfinity</directive> 지시어를 사용하면 + 'Depth: Infinity' 헤더를 가진 <code>PROPFIND</code> 요청을 + 허가한다. 이런 요청을 사용하여 서비스거부 공격이 가능하기 + 때문에 기본적으로 허용하지 않는다.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> + + diff --git a/docs/manual/mod/mod_dav_fs.xml.ko b/docs/manual/mod/mod_dav_fs.xml.ko new file mode 100644 index 0000000000..7201b2c07c --- /dev/null +++ b/docs/manual/mod/mod_dav_fs.xml.ko @@ -0,0 +1,65 @@ +<?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: 1.3 --> +<modulesynopsis metafile="mod_dav_fs.xml.meta"> + +<name>mod_dav_fs</name> +<description><module>mod_dav</module>을 위한 파일시스템 제공자</description> +<status>Extension</status> +<sourcefile>mod_dav_fs.c</sourcefile> +<identifier>dav_fs_module</identifier> + +<summary> + <p>이 모듈은 <module>mod_dav</module> 서비스에 <em>필요하다</em>. + <module>mod_dav</module>를 지원하는 모듈로 서버의 파일시스템에 + 있는 자원을 접근할 수 있도록 한다. 이 제공자(provider)의 + 정식명칭은 <code>filesystem</code>이다. <directive + module="mod_dav">Dav</directive> 지시어를 지정하여 + <module>mod_dav</module> 뒷단 제공자를 사용한다:</p> + + <example><title>예제</title> + Dav filesystem + </example> + + <p><code>filesystem</code>이 <module>mod_dav</module>의 + 기본 제공자이므로 대신 <code>On</code>을 사용할 수 있다.</p> +</summary> +<seealso><module>mod_dav</module></seealso> + +<directivesynopsis> +<name>DavLockDB</name> +<description>DAV 잠금 데이터베이스 위치</description> +<syntax>DavLockDB <var>file-path</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>DavLockDB</directive> 지시어는 잠금 데이터베이스의 + 전체 경로를 확장자를 제외하고 지정한다. 절대경로가 아니면 + <directive module="core">ServerRoot</directive>에 상대경로로 + 처리한다. <module>mod_dav_fs</module>는 잠금을 SDBM 데이터베이스에 + 기록한다.</p> + + <!-- XXX: someone should add that tool to the support directory... + The utility <code>modules/dav/util/lockview</code> can be used from + the server to display all locks in a lock database.</p> --> + + <example><title>예제</title> + DavLockDB var/DavLock + </example> + + <p>아파치를 실행하는 <directive module="mpm_common">User</directive>와 + <directive module="mpm_common" >Group</directive>은 잠금 + 데이터베이스가 있는 디렉토리에 쓰기 권한을 가져야 한다. + 보안상 이유로 기존 디렉토리의 권한을 바꾸기보다는 잠금 + 데이터베이스용 디렉토리를 만들어야 한다. 위의 경우 아파치는 + <directive module="core">ServerRoot</directive> 아래 + <code>var/</code> 디렉토리에 서버가 선택한 확장명을 가진 + <code>DavLock</code> 파일을 만든다.</p> + +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_deflate.xml.ko b/docs/manual/mod/mod_deflate.xml.ko new file mode 100644 index 0000000000..70b5edfd06 --- /dev/null +++ b/docs/manual/mod/mod_deflate.xml.ko @@ -0,0 +1,294 @@ +<?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: 1.18 --> +<modulesynopsis metafile="mod_deflate.xml.meta"> + +<name>mod_deflate</name> +<description>내용을 클라이언트로 보내기 전에 압축한다</description> +<status>Extension</status> +<sourcefile>mod_deflate.c</sourcefile> +<identifier>deflate_module</identifier> + +<summary> + <p><module>mod_deflate</module> 모듈은 서버의 출력을 네트웍으로 + 클라이언트에 보내기 전에 압축하는 <code>DEFLATE</code> 출력필터를 + 제공한다.</p> +</summary> +<seealso><a href="../filter.html">필터</a></seealso> + +<section id="recommended"><title>권장하는 설정</title> + <p>급한 사람을 위한 견본 설정이다. 그러나 시간을 가지고 + 아래 자세한 설명을 읽길 바란다!</p> + + <example><title>일부 type만 압축</title> + AddOutputFilterByType DEFLATE text/html text/plain text/xml + </example> + + <example><title>이미지를 제외한 모든 것을 압축</title> + <Location /><br /> + <indent> + # 필터를 추가한다<br /> + SetOutputFilter DEFLATE<br /> + <br /> + # Netscape 4.x에 문제가 있다...<br /> + BrowserMatch ^Mozilla/4 gzip-only-text/html<br /> + <br /> + # Netscape 4.06-4.08에 더 문제가 있다<br /> + BrowserMatch ^Mozilla/4\.0[678] no-gzip<br /> + <br /> + # MSIE은 Netscape라고 자신을 알리지만, 문제가 없다<br /> + BrowserMatch \bMSIE !no-gzip !gzip-only-text/html<br /> + <br /> + # 이미지를 압축하지 않는다<br /> + SetEnvIfNoCase Request_URI \<br /> + <indent> + \.(?:gif|jpe?g|png)$ no-gzip dont-vary<br /> + </indent> + <br /> + # 프록시가 잘못된 내용을 전달하지않도록 한다<br /> + Header append Vary User-Agent env=!dont-vary<br /> + </indent> + </Location> + </example> + +</section> + +<section id="enable"><title>압축하기</title> + + <section id="output"><title>출력 압축</title> + <p><code>DEFLATE</code> <a href="../filter.html">필터</a>가 + 압축을 한다. 다음 지시어는 지시어가 있는 위치의 문서를 + 압축한다:</p> + + <example> + SetOutputFilter DEFLATE + </example> + + <p>모든 내용을 압축하면 처리하지 못하는 브라우저가 있기때문에 + html 파일만을 압축하기위해 (아래 참고) + <code>gzip-only-text/html</code>을 <code>1</code>로 설정할지도 + 모른다. 이를 <em><code>1</code>이 아닌 값으로</em> 설정하면 + 무시한다.</p> + + <p>보통 특별한 MIME type만 압축하려면 <directive module="core" + >AddOutputFilterByType</directive> 지시어를 사용한다. + 다음 설정은 html 파일만을 압축한다:</p> + + <example> + <Directory "/your-server-root/manual"><br /> + <indent> + AddOutputFilterByType DEFLATE text/html<br /> + </indent> + </Directory> + </example> + + <p>압축한 파일을 처리하지 못하는 브라우저에게는 압축하지않고 + 보내길위해 <directive module="mod_setenvif" + >BrowserMatch</directive> 지시어에 <code>no-gzip</code>을 + 설정한다. 최적의 결과를 얻기위해 <code>no-gzip</code>과 + <code>gzip-only-text/html</code>을 같이 사용할 수 있다. + 이 경우 전자가 후자를 무시한다. 위 절의 <a + href="#recommended">설정 예제</a> 일부를 살펴보자:</p> + + <example> + BrowserMatch ^Mozilla/4 gzip-only-text/html<br /> + BrowserMatch ^Mozilla/4\.0[678] no-gzip<br /> + BrowserMatch \bMSIE !no-gzip !gzip-only-text/html + </example> + + <p>먼저 <code>User-Agent</code> 문자열을 보고 Netscape + Navigator 버전 4.x인지 검사한다. 이 버전은 <code>text/html</code>이 + 아닌 type의 압축을 처리하지 못한다. 버전 4.06, 4.07, 4.08은 + html 파일 압축을 처리하는대도 문제가 있다. 그래서 우리는 + 이 경우 deflate 필터를 완전히 사용하지않는다.</p> + + <p>세번째 <directive module="mod_setenvif">BrowserMatch</directive> + 지시어는 Microsoft Internet Explorer가 자신을 "Mozilla/4"로 + 알리지만 압축된 요청을 처리할 수 있기때문에 user agent + 추측을 수정한다. <code>User-Agent</code> 헤더에서 "MSIE" + (<code>\b</code>는 "단어 경계"를 뜻한다) 문자열을 발견하면 + 앞에서 설정한 제약을 푼다.</p> + + <note><title>주의</title> + <code>DEFLATE</code> 필터는 항상 PHP나 SSI와 같은 RESOURCE + 필터 뒤에 들어간다. 또, 내부 하위요청(subrequest)에 영향을 + 주지 않는다. + </note> + </section> + + <section id="input"><title>입력 압축풀기</title> + <p><module>mod_deflate</module> 모듈은 요청의 gzip 압축된 + 내용을 푸는 필터도 제공한다. 이 기능을 사용하려면 다음과 + 같이 <directive module="core">SetInputFilter</directive>나 + <directive module="mod_mime">AddInputFilter</directive>를 + 사용하여 입력필터순서에 <code>DEFLATE</code> 필터를 + 추가해야한다:</p> + + <example> + <Location /dav-area><br /> + <indent> + SetInputFilter DEFLATE<br /> + </indent> + </Location> + </example> + + <p>요청에 <code>Content-Encoding: gzip</code> 헤더가 있다면 + 자동으로 압축된 내용을 푼다. gzip 요청을 할 수 있는 + 브라우저는 드물다. 그러나 어떤 <a + href="http://www.webdav.org">WebDAV</a> 클라이언트와 같은 + 특별한 프로그램은 요청 압축을 지원한다.</p> + + <note type="warning"><title>Content-Length에 대한 주의</title> + <p>요청 내용을 직접 살펴본다면, <em><code>Content-Length</code> + 헤더를 믿지마라!</em> Content-Length 헤더는 클라이언트가 + 보낸 내용의 길이이지, 압축을 푼 결과의 바이트수가 + <em>아니다</em>.</p> + </note> + </section> +</section> + +<section id="proxies"><title>프록시 서버 다루기</title> + + <p><module>mod_deflate</module> 모듈은 프록시가 자신이 캐쉬한 + 응답을 적절한 <code>Accept-Encoding</code> 요청 헤더를 보낸 + 클라이언트에게만 보내도록 <code>Vary: + Accept-Encoding</code> HTTP 응답 헤더를 추가한다. 그래서 + 압축된 내용을 이해할 수 없는 클라이언트에 압축된 내용을 + 보내지않도록 한다.</p> + + <p>예를 들어, <code>User-Agent</code> 헤더 등에 따라 특별히 + 필터 적용을 취소한다면, 프록시에게 이러한 제한을 알려주기위해 + 직접 <code>Vary</code> 헤더에 추가해야 한다. 예를 들어, + 설정이 <code>User-Agent</code>에 따라 <code>DEFLATE</code> + 필터를 추가한다면 다음을 사용한다:</p> + + <example> + Header append Vary User-Agent + </example> + + <p>요청 헤더외의 다른 정보에 (<em>예를 들어</em>, HTTP 버전) + 따라 압축 여부가 결정된다면, <code>Vary</code> 헤더값을 + <code>*</code>로 설정해야 한다. 그러면 표준을 따르는 프록시는 + 캐싱을 하지 않게 된다.</p> + + <example><title>예제</title> + Header set Vary * + </example> +</section> + +<directivesynopsis> +<name>DeflateFilterNote</name> +<description>압축률을 로그에 기록한다</description> +<syntax>DeflateFilterNote [<var>type</var>] <var>notename</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> +<compatibility><var>type</var> is available since Apache 2.0.45</compatibility> + +<usage> + <p><directive>DeflateFilterNote</directive> 지시어는 요청의 + 압축률을 로그에 기록하는 기호를 지정한다. 기호 이름은 지시어로 + 지정한 값이다. 통계를 위해 <a href="../logs.html#accesslog">접근 + 로그</a>에서 기호를 사용할 수 있다.</p> + + <example><title>예제</title> + DeflateFilterNote ratio<br /> + <br /> + LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate<br /> + CustomLog logs/deflate_log deflate + </example> + + <p>로그에서 더 정확한 값을 추출하려면 <var>type</var> 아규먼트로 + 기록할 자료를 선택한다. <var>type</var>는 다음중 하나이다:</p> + + <dl> + <dt><code>Input</code></dt> + <dd>필터 입력스트림의 바이트수를 저장한다.</dd> + + <dt><code>Output</code></dt> + <dd>필터 출력스트림의 바이트수를 저장한다..</dd> + + <dt><code>Ratio</code></dt> + <dd>압축률을 (<code>output/input * 100</code>) 저장한다. + <var>type</var> 아규먼트를 생략하면 사용하는 기본값이다.</dd> + </dl> + + <p>그래서 이렇게 로그에 기록할 수 있다:</p> + + <example><title>정밀한 로그</title> + DeflateFilterNote Input instream<br /> + DeflateFilterNote Output outstream<br /> + DeflateFilterNote Ratio ratio<br /> + <br /> + LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate<br /> + CustomLog logs/deflate_log deflate + </example> +</usage> +<seealso><module>mod_log_config</module></seealso> +</directivesynopsis> + +<directivesynopsis> +<name>DeflateBufferSize</name> +<description>zlib이 한번에 압축할 크기</description> +<syntax>DeflateBufferSize <var>value</var></syntax> +<default>DeflateBufferSize 8096</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>DeflateBufferSize</directive> 지시어는 zlib이 + 한번에 압축할 바이트수를 지정한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>DeflateWindowSize</name> +<description>Zlib 압축 window size</description> +<syntax>DeflateWindowSize <var>value</var></syntax> +<default>DeflateWindowSize 15</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>DeflateWindowSize</directive> 지시어는 zlib + 압축 window size를 (1과 15 사이의 값) 지정한다. 일반적으로 + window size가 클수록 압축률이 증가한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> + +<name>DeflateMemLevel</name> +<description>zlib이 압축할때 사용하는 메모리량</description> +<syntax>DeflateMemLevel <var>value</var></syntax> +<default>DeflateMemLevel 9</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>DeflateMemLevel</directive> 지시어는 zlib이 + 압축할때 얼마만큼 메모리를 사용할지 결정한다. (1과 9 사이의 + 값)</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>DeflateCompressionLevel</name> +<description>출력을 얼만큼 압축하는가</description> +<syntax>DeflateCompressionLevel <var>value</var></syntax> +<default>Zlib's default</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> +<compatibility>This directive is available since Apache 2.0.45</compatibility> + +<usage> + <p><directive>DeflateCompressionLevel</directive> 지시어는 + 사용할 압축수준을 선택한다. 값이 클수록 압축률이 증가하지만, + CPU를 더 많이 사용한다.</p> + <p>(가장 덜 압축) 1과 (가장 많이 압축) 9 사이의 값을 지정한다.</p> +</usage> +</directivesynopsis> + + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_dir.xml.ko b/docs/manual/mod/mod_dir.xml.ko new file mode 100644 index 0000000000..f348fdbc5c --- /dev/null +++ b/docs/manual/mod/mod_dir.xml.ko @@ -0,0 +1,76 @@ +<?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: 1.5 --> +<modulesynopsis metafile="mod_dir.xml.meta"> +<name>mod_dir</name> +<description>"마지막 슬래쉬" 리다이렉션을 제공하고 디렉토리 +index 파일을 서비스한다</description> +<status>Base</status> +<sourcefile>mod_dir.c</sourcefile> +<identifier>dir_module</identifier> + +<summary> + <p>디렉토리의 index는 다음 둘중 한가지 방법으로 제공된다:</p> + + <ul> + <li>사용자가 작성한 보통 <code>index.html</code>이라는 + 파일. <directive module="mod_dir">DirectoryIndex</directive> + 지시어는 이 파일의 이름을 지정한다. <module>mod_dir</module>가 + 이 지시어를 제공한다.</li> + + <li>아니라면 서버가 만든 목록. <module>mod_autoindex</module>가 + 이 기능을 제공한다.</li> + </ul> + <p>두 기능은 서로 별개로 원한다면 자동 index 생성을 완전히 + 없앨 (혹은 교체할) 수 있다.</p> + + <p><code>dirname</code>이 디렉토리라면 서버는 URL + <code>http://servername/foo/dirname</code> 요청을 받으면 + "마지막 슬래쉬" 리다이렉션을 보낸다. 디렉토리에는 마지막 + 슬래쉬가 필요하다. 그래서 <module>mod_dir</module>은 + <code>http://servername/foo/dirname/</code>로 리다이렉션을 + 보낸다.</p> +</summary> + +<directivesynopsis> +<name>DirectoryIndex</name> +<description>클라이언트가 디렉토리를 요청할때 찾아볼 자원 목록</description> +<syntax>DirectoryIndex + <var>local-url</var> [<var>local-url</var>] ...</syntax> +<default>DirectoryIndex index.html</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Indexes</override> + +<usage> + <p><directive>DirectoryIndex</directive> 지시어는 클라이언트가 + 디렉토리명 끝에 /를 붙여서 디렉토리의 index를 요청할때 찾아볼 + 자원 목록을 지정한다. <var>Local-url</var>은 요청한 디렉토리에 + 상대적인 문서의 (%로 인코딩된) URL이다. 보통은 디렉토리에 + 있는 파일명이다. 여러 URL을 지정할 수 있고, 이 경우 서버는 + 첫번째로 찾은 파일을 보낸다. 자원을 찾을 수 없고 + <code>Indexes</code> 옵션을 설정하였다면 서버는 직접 디렉토리 + 목록을 만든다.</p> + + <example><title>예제</title> + DirectoryIndex index.html + </example> + + <p>이 경우 <code>http://myserver/docs/</code>를 요청할때 + <code>http://myserver/docs/index.html</code>이 있으면 이를 + 보내고, 없다면 디렉토리 목록을 보낸다.</p> + + <p>문서가 반드시 디렉토리에 상대적일 필요는 없다.</p> + + <example> + DirectoryIndex index.html index.txt /cgi-bin/index.pl + </example> + + <p>이 경우 디렉토리에 <code>index.html</code>이나 + <code>index.txt</code>가 없으면 CGI 스크립트 + <code>/cgi-bin/index.pl</code>을 실행한다.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_disk_cache.xml.ko b/docs/manual/mod/mod_disk_cache.xml.ko new file mode 100644 index 0000000000..45cb14e7a4 --- /dev/null +++ b/docs/manual/mod/mod_disk_cache.xml.ko @@ -0,0 +1,317 @@ +<?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: 1.7 --> +<modulesynopsis metafile="mod_disk_cache.xml.meta"> + +<name>mod_disk_cache</name> +<description>Content cache storage manager keyed to URIs</description> +<status>Experimental</status> +<sourcefile>mod_disk_cache.c</sourcefile> +<identifier>disk_cache_module</identifier> + +<summary> + <note type="warning"> + 이 모듈은 실험적인 상태이다. 문서는 아직 작업중이다... + </note> + + <p><module>mod_disk_cache</module>는 디스크기반 저장관리자를 + 구현한다. 이 모듈은 기본적으로 <module>mod_proxy</module>와 + 같이 사용한다.</p> + + <p>내용을 URI를 토대로 만든 키로 캐쉬에 저장하고 가져온다. + 접근보호가 된 내용은 캐쉬하지않는다.</p> + + <note><title>주의:</title> + <p><module>mod_disk_cache</module>는 + <module>mod_cache</module>가 필요하다.</p> + </note> +</summary> + +<directivesynopsis> +<name>CacheRoot</name> +<description>캐쉬 파일을 저장할 디렉토리 root</description> +<syntax>CacheRoot <var>directory</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>CacheRoot</directive> 지시어는 디스크에서 + 캐쉬 파일을 저장할 디렉토리를 지정한다. <module + >mod_disk_cache</module> 모듈을 아파치 서버와 같이 컴파일하였거나 + 읽어들인 경우 <em>반드시</em> 이 지시어를 정의해야 한다. + <directive>CacheRoot</directive>에 값이 없으면 설정파일을 + 처리하지 않는다. <directive + module="mod_disk_cache">CacheDirLevels</directive>와 <directive + module="mod_disk_cache">CacheDirLength</directive> 지시어는 + 이 지시어로 지정한 root 디렉토리의 하위디렉토리 구조를 지시한다.</p> + + <example> + CacheRoot c:/cacheroot + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheSize</name> +<description>캐쉬로 사용할 최대 디스크공간 (KByte 단위)</description> +<syntax>CacheSize <var>KBytes</var></syntax> +<default>CacheSize 1000000</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>CacheSize</directive> 지시어는 캐쉬로 사용할 + 디스크공간 크기를 KByte (1024 바이트) 단위로 지정한다. 이 + 지시어는 캐쉬 크기를 제한하지 않는다. 가비지컬랙터가 캐쉬 + 사용량이 설정한 값보다 작게될때까지 파일을 지운다. 항상 + 사용가능한 디스크공간 보다 작은 값을 사용하라.</p> + + <example> + CacheSize 5000000 + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheGcInterval</name> +<description>가비지컬랙터를 실행하는 간격.</description> +<syntax>CacheGcInterval <var>hours</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>CacheGcInterval</directive> 지시어는 카비지컬랙터가 + 디스크공간을 비우는 시간 간격을 시간단위로 지정한다.</p> + <p>함수가 구현되면 더 자세한 내용이 여기 나온다.</p> + + <example> + CacheGcInterval 24<br /> + </example> + + <note type="warning"> + <directive>CacheGcInterval</directive> 지시어는 현재 구현되지 + <em>않았다</em>. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheDirLevels</name> +<description>캐쉬의 하위디렉토리 깊이.</description> +<syntax>CacheDirLevels <var>levels</var></syntax> +<default>CacheDirLevels 3</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>CacheDirLevels</directive> 지시어는 캐쉬의 + 하위디렉토리 깊이를 지정한다. 캐쉬된 자료를 <directive + module="mod_disk_cache">CacheRoot</directive> 디렉토리 + 아래 이 깊이까지 저장한다.</p> + + <note> + <p><directive>CacheDirLevels</directive>와 <directive + module="mod_disk_cache">CacheDirLength</directive>를 + 곱하여 20 보다 크면 안된다.</p> + </note> + + <example> + CacheDirLevels 5 + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheDirLength</name> +<description>하위디렉토리명의 문자개수</description> +<syntax>CacheDirLength <var>length</var></syntax> +<default>CacheDirLength 2</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>CacheDirLength</directive> 지시어는 캐쉬 + 계층구조에서 각 하위디렉토리명의 문자수를 지정한다.</p> + + <note> + <p><directive module="mod_disk_cache">CacheDirLevels</directive>와 + <directive>CacheDirLength</directive>를 곱하여 20 보다 + 크면 안된다.</p> + </note> + + <example> + CacheDirLength 4 + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheExpiryCheck</name> +<description>캐쉬에서 파일을 찾을때 만기시간을 고려할지 여부</description> +<syntax>CacheExpiryCheck On|Off</syntax> +<default>CacheExpiryCheck On</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>함수가 구현되면 더 자세한 내용이 여기 나온다.</p> + + <example> + CacheExpiryCheck Off<br /> + </example> + + <note type="warning"> + <directive>CacheExpiryCheck</directive> 지시어는 현재 + 구현되지 <em>않았다</em>. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheMinFileSize</name> +<description>캐쉬에 저장할 문서의 최소크기 (바이트 단위)</description> +<syntax>CacheMinFileSize <var>bytes</var></syntax> +<default>CacheMinFileSize 1</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>CacheMinFileSize</directive> 지시어는 캐쉬에 + 저장할 문서의 최소크기를 바이트 단위로 지정한다.</p> + + <example> + CacheMinFileSize 64 + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheMaxFileSize</name> +<description>캐쉬에 저장할 문서의 최대크기 (바이트 단위)</description> +<syntax>CacheMaxFileSize <var>bytes</var></syntax> +<default>CacheMaxFileSize 1000000</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>CacheMaxFileSize</directive> 지시어는 캐쉬에 + 저장할 문서의 최대크기를 바이트 단위로 지정한다.</p> + + <example> + CacheMaxFileSize 64000 + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheTimeMargin</name> +<description>문서를 캐쉬할 최소시간 한계</description> +<syntax>CacheTimeMargin <var>?</var></syntax> +<default>CacheTimeMargin ?</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>함수가 구현되면 더 자세한 내용이 여기 나온다.</p> + + <example> + CacheTimeMargin X + </example> + + <note type="warning"> + <directive>CacheTimeMargin</directive> 지시어는 현재 + 구현되지 <em>않았다</em>. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheGcDaily</name> +<description>매일 가비지컬랙터를 실행할 반복 시간 (24시 시계)</description> +<syntax>CacheGcDaily <var>time</var></syntax> +<default>CacheGcDaily ?</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>함수가 구현되면 더 자세한 내용이 여기 나온다.</p> + + <example> + CacheGcDaily 23:59 + </example> + + <note type="warning"> + <directive>CacheGcDaily</directive> 지시어는 현재 구현되지 + <em>않았다</em>. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheGcUnused</name> +<description>URL에 해당하는 참조되지않은 캐쉬파일을 유지할 기간.</description> +<syntax>CacheGcUnused <var>hours</var> <var>url-string</var></syntax> +<default>CacheGcUnused ?</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>함수가 구현되면 더 자세한 내용이 여기 나온다.</p> + + <example> + CacheGcUnused 12 /local_images + </example> + + <note type="warning"> + <directive>CacheGcUnused</directive> 지시어는 현재 구현되지 + <em>않았다</em>. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheGcClean</name> +<description>URL에 해당하는 변하지않은 캐쉬파일을 유지할 시간</description> +<syntax>CacheGcClean <var>hours</var> <var>url-string</var></syntax> +<default>CacheGcClean ?</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>함수가 구현되면 더 자세한 내용이 여기 나온다.</p> + + <example> + CacheGcClean 12 /daily_scripts + </example> + + <note type="warning"> + <directive>CacheGcClean</directive> 지시어는 현재 구현되지 + <em>않았다</em>. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheGcMemUsage</name> +<description>가비지컬랙터가 사용할 최대 메모리량 (kilobyte 단위)</description> +<syntax>CacheGcMemUsage <var>KBytes</var></syntax> +<default>CacheGcMemUsage ?</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>함수가 구현되면 더 자세한 내용이 여기 나온다.</p> + + <example> + CacheGcMemUsage 16 + </example> + + <note type="warning"> + <directive>CacheGcMemUsage</directive> 지시어는 현재 + 구현되지 <em>않았다</em>. + </note> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_echo.xml.ko b/docs/manual/mod/mod_echo.xml.ko new file mode 100644 index 0000000000..cd4a46623c --- /dev/null +++ b/docs/manual/mod/mod_echo.xml.ko @@ -0,0 +1,40 @@ +<?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: 1.4 --> +<modulesynopsis metafile="mod_echo.xml.meta"> + +<name>mod_echo</name> +<description>프로토콜 모듈을 설명하기위한 간단한 echo 서버</description> +<status>Experimental</status> +<sourcefile>mod_echo.c</sourcefile> +<identifier>echo_module</identifier> +<compatibility>Apache 2.0 이후부터</compatibility> + +<summary> + <p>이 모듈은 프로토콜 모듈의 개념을 설명하기위한 예제이다. + 이 모듈은 간단한 echo 서버를 구현한다. 이 서버로 telnet하여 + 무언가를 입력하면, 서버는 입력한 내용이 그대로 반환한다.</p> +</summary> + +<directivesynopsis> + +<name>ProtocolEcho</name> +<description>echo 서버를 키고 끈다</description> +<syntax>ProtocolEcho On|Off</syntax> +<contextlist><context>server config</context> +<context>virtual host</context></contextlist> +<compatibility>ProtocolEcho는 2.0 이후에만 있다.</compatibility> + +<usage> + <p><directive>ProtocolEcho</directive> 지시어는 echo 서버를 + 키고 끈다.</p> + + <example><title>예제</title> + ProtocolEcho On + </example> +</usage> + +</directivesynopsis> +</modulesynopsis> + diff --git a/docs/manual/mod/mod_env.xml.ko b/docs/manual/mod/mod_env.xml.ko new file mode 100644 index 0000000000..731355f8cd --- /dev/null +++ b/docs/manual/mod/mod_env.xml.ko @@ -0,0 +1,75 @@ +<?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: 1.5 --> +<modulesynopsis metafile="mod_env.xml.meta"> + +<name>mod_env</name> +<description>CGI 스크립트나 SSI 페이지에 전달할 환경변수를 +수정한다</description> +<status>Base</status> +<sourcefile>mod_env.c</sourcefile> +<identifier>env_module</identifier> +<summary> + <p>이 모듈은 CGI 스크립트나 SSI 페이지에 전달할 환경변수를 + 조절한다. 웹서버를 시작한 쉘에서 환경변수를 가져올 수 있다. + 아니면 설정과정중에 환경변수를 설정하고 제거할 수 있다.</p> +</summary> +<seealso><a href="../env.html">환경변수</a></seealso> + +<directivesynopsis> +<name>PassEnv</name> +<description>쉘에서 환경변수를 가져온다</description> +<syntax>PassEnv <var>env-variable</var> [<var>env-variable</var>] +...</syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>웹서버를 실행한 쉘의 특정 환경변수를 CGI 스크립트나 + SSI 페이지로 전달한다.</p> + + <example><title>예제</title> + PassEnv LD_LIBRARY_PATH + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>SetEnv</name> +<description>환경변수를 설정한다</description> +<syntax>SetEnv <var>env-variable</var> <var>value</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>CGI 스크립트나 SSI 페이지에 전달할 환경변수를 설정한다.</p> + + <example><title>예제</title> + SetEnv SPECIAL_PATH /foo/bin + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>UnsetEnv</name> +<description>환경변수를 제거한다</description> +<syntax>UnsetEnv <var>env-variable</var> [<var>env-variable</var>] +...</syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>CGI 스크립트나 SSI 페이지에 환경변수를 전달하지 않는다.</p> + + <example><title>예제</title> + UnsetEnv LD_LIBRARY_PATH + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> + |