mod_log_config.xml.ko revision 031b91a62d25106ae69d4693475c79618dd5e884
0N/A<?xml version="1.0" encoding="EUC-KR" ?>
1472N/A<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
0N/A<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>
0N/A<!-- English Revision: 105989:395228 (outdated) -->
0N/A
0N/A<!--
0N/A Licensed to the Apache Software Foundation (ASF) under one or more
0N/A contributor license agreements. See the NOTICE file distributed with
0N/A this work for additional information regarding copyright ownership.
0N/A The ASF licenses this file to You under the Apache License, Version 2.0
0N/A (the "License"); you may not use this file except in compliance with
0N/A the License. You may obtain a copy of the License at
0N/A
0N/A http://www.apache.org/licenses/LICENSE-2.0
0N/A
0N/A Unless required by applicable law or agreed to in writing, software
0N/A distributed under the License is distributed on an "AS IS" BASIS,
0N/A WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1472N/A See the License for the specific language governing permissions and
1472N/A limitations under the License.
1472N/A-->
0N/A
0N/A<modulesynopsis metafile="mod_log_config.xml.meta">
0N/A
0N/A<name>mod_log_config</name>
0N/A<description>�������� ��û�� �α׿� ����Ѵ�</description>
0N/A<status>Base</status>
0N/A<sourcefile>mod_log_config.c</sourcefile>
0N/A<identifier>log_config_module</identifier>
0N/A
0N/A<summary>
0N/A <p>�� ����� Ŭ���̾�Ʈ�� ��û�� �α׿� �����Ӱ� ����Ѵ�.
0N/A �ڽ��� ���ϴ� ������� �α׸� ����� �� �ְ�, �����̳� �ܺ�
0N/A ���α׷��� ���� �α׸� ���� ���� �ִ�. ������ �α׸� ����ϸ�
0N/A ��û�� ���ݿ� ��� ��û�� �α׿� �߰��ϰų� ������ �� �ִ�.</p>
0N/A
0N/A <p>�� ����� ������ ���þ �����Ѵ�. <directive
0N/A module="mod_log_config">TransferLog</directive>�� �������
0N/A �����, <directive module="mod_log_config">LogFormat</directive>��
0N/A ���ϴ� ����� ���ϰ�, <directive
0N/A module="mod_log_config">CustomLog</directive>�� �ѹ� �α����ϰ�
0N/A ����� ��� �����Ѵ�. <directive>TransferLog</directive>��
0N/A <directive>CustomLog</directive> ���þ ������ ����ϸ�
0N/A ��û�� ���� ���Ͽ� ����� �� �ִ�.</p>
0N/A</summary>
0N/A<seealso><a href="/logs.html">����ġ �α�����</a></seealso>
0N/A
0N/A<section id="formats"><title>�α� ��� �����ϱ�</title>
0N/A
0N/A <p><directive module="mod_log_config">LogFormat</directive>��
0N/A <directive module="mod_log_config">CustomLog</directive>
0N/A ���þ��� ��� �ƱԸ�Ʈ�� ���ڿ��̴�. �� ���ڿ��� ��� ��û��
0N/A �α����Ͽ� ����Ѵ�. ���ڿ����� �α����Ͽ� �״�� ����Ǵ�
0N/A ���ڿ� ��ٲް� ���� ��Ÿ���� C�� "\n"�� "\t" ����ڸ�
0N/A ����� �� �ִ�. �α����Ͽ� ���ǥ�� �齽������ ������ �տ�
0N/A �ݵ�� �齽������ ������ �Ѵ�.</p>
0N/A
0N/A <p>��û�� Ư¡�� ��� ���ڿ��� "<code>%</code>" ���þ
0N/A ����Ͽ� ����Ѵ�. �� ���þ�� �α����Ͽ��� ������ ����
0N/A ����ȴ�.</p>
0N/A
0N/A <table border="1" style="zebra">
0N/A <columnspec><column width=".2"/><column width=".8"/></columnspec>
0N/A <tr><th>���&nbsp;���ڿ�</th>
0N/A <th>����</th></tr>
0N/A
0N/A <tr><td><code>%%</code></td>
0N/A <td>�ۼ�Ʈ ��ȣ</td></tr>
0N/A
0N/A <tr><td><code>%...a</code></td>
0N/A <td>��� IP-�ּ�</td></tr>
0N/A
0N/A <tr><td><code>%...A</code></td>
0N/A <td>(����) IP-�ּ�</td></tr>
0N/A
0N/A <tr><td><code>%...B</code></td>
0N/A <td>HTTP ����� ������ ��� ����Ʈ��.</td></tr>
0N/A
0N/A <tr><td><code>%...b</code></td>
0N/A <td>HTTP ����� ������ ��� ����Ʈ��. CLF ��İ� ����
0N/A ����� ������ ��� ��� 0 ��� '<code>-</code>'�� ���´�.</td></tr>
0N/A
0N/A <tr><td><code>%...{<var>Foobar</var>}C</code></td>
0N/A <td>������ ������ ��û���� <var>Foobar</var> ��Ű��
0N/A ����.</td></tr>
0N/A
0N/A <tr><td><code>%...D</code></td>
0N/A <td>��û�� ó���ϴµ� �ɸ� �ð� (����ũ���� ����).</td></tr>
0N/A
0N/A <tr><td><code>%...{<var>FOOBAR</var>}e</code></td>
0N/A <td>ȯ�溯�� <var>FOOBAR</var>�� ����</td></tr>
0N/A
0N/A <tr><td><code>%...f</code></td>
0N/A <td>���ϸ�</td></tr>
0N/A
0N/A <tr><td><code>%...h</code></td>
0N/A <td>��� ȣ��Ʈ</td></tr>
0N/A
0N/A <tr><td><code>%...H</code></td>
0N/A <td>��û ��������</td></tr>
0N/A
0N/A <tr><td><code>%...{<var>Foobar</var>}i</code></td>
0N/A <td>������ ������ ��û���� <code><var>Foobar</var>:</code>
0N/A ����� ����.</td></tr>
0N/A
0N/A <tr><td><code>%...l</code></td>
0N/A <td>(�ִٸ� identd�� ������) ��� �α��θ�.
0N/A <module>mod_ident</module>�� �ְ� <directive
0N/A module="mod_ident">IdentityCheck</directive>��
0N/A <code>On</code>�� �ƴϸ� �����ȣ�� ����Ѵ�.</td></tr>
0N/A
0N/A <tr><td><code>%...m</code></td>
0N/A <td>��û �޽��</td></tr>
0N/A
0N/A <tr><td><code>%...{<var>Foobar</var>}n</code></td>
0N/A <td>�ٸ� ����� ����� <var>Foobar</var> ��Ʈ(note)
0N/A ����.</td></tr>
0N/A
0N/A <tr><td><code>%...{<var>Foobar</var>}o</code></td>
0N/A <td>������ <code><var>Foobar</var>:</code> ��� ����.</td></tr>
0N/A
0N/A <tr><td><code>%...p</code></td>
0N/A <td>��û�� �����ϴ� ������ ���� ��Ʈ</td></tr>
0N/A
0N/A <tr><td><code>%...P</code></td>
0N/A <td>��û�� �����ϴ� �ڽ��� ���μ��� ID.</td></tr>
0N/A
0N/A <tr><td><code>%...{<var>format</var>}P</code></td>
0N/A <td>��û�� �����ϴ� �ڽ��� ���μ��� ID Ȥ�� ������
0N/A ID. format���� <code>pid</code>�� <code>tid</code>��
0N/A �����ϴ�.
0N/A </td></tr>
0N/A
0N/A <tr><td><code>%...q</code></td>
0N/A <td>���ǹ��ڿ� (���ǹ��ڿ��� �ִٸ� �տ� <code>?</code>��
0N/A ���̰�, ��ٸ� �� ���ڿ�)</td></tr>
0N/A
0N/A <tr><td><code>%...r</code></td>
0N/A <td>��û�� ù��° ��</td></tr>
0N/A
0N/A <tr><td><code>%...s</code></td>
0N/A <td>����(status). ���� �����̷��ǵ� ��û�� ��� *��*
0N/A ��û�� �����̴�. ���� ��û�� ���´� <code>%...&gt;s</code>.</td></tr>
0N/A
0N/A <tr><td><code>%...t</code></td>
0N/A <td>common log format �ð� ���(ǥ�� ���� ���)�� �ð�</td></tr>
0N/A
0N/A <tr><td><code>%...{<var>format</var>}t</code></td>
0N/A <td><code>strftime(3)</code> ��� format�� �ð�. (�����ð���
0N/A �� ����)</td></tr>
0N/A
0N/A <tr><td><code>%...T</code></td>
0N/A <td>��û�� ó���ϴµ� �ɸ� �ð� (�� ����).</td></tr>
0N/A
0N/A <tr><td><code>%...u</code></td>
0N/A <td>��� ����� (auth�� �����ϸ�, ����(<code>%s</code>)��
0N/A 401�� ��� �̻��� ���� ���� �� ����)</td></tr>
0N/A
0N/A <tr><td><code>%...U</code></td>
0N/A <td>���ǹ��ڿ��� ������ ��û URL ���.</td></tr>
0N/A
0N/A <tr><td><code>%...v</code></td>
0N/A <td>��û�� ������ ������ ���� <directive
0N/A module="core">ServerName</directive>.</td></tr>
0N/A
0N/A <tr><td><code>%...V</code></td>
0N/A <td><directive module="core">UseCanonicalName</directive>
0N/A ������ �� ������.</td></tr>
0N/A
0N/A <tr><td><code>%...X</code></td>
0N/A <td>������ �������� ���� ����.
0N/A
0N/A <table>
0N/A <columnspec><column width=".2"/><column width=".6"/></columnspec>
0N/A <tr><td><code>X</code> =</td>
0N/A <td>������ ��ġ�� �� ������ ��������.</td></tr>
0N/A <tr><td><code>+</code> =</td>
0N/A <td>������ �����Ŀ��� ������ ����ִ�(keep alive).</td></tr>
0N/A <tr><td><code>-</code> = </td>
0N/A <td>������ ������ ������ ��������.</td></tr>
0N/A </table>
0N/A
0N/A <p>(����ġ 1.3 �Ĺ� ���� �� ���þ��
0N/A <code>%...c</code>������, �������� ssl
0N/A <code>%...{<var>var</var>}c</code> ����� ���ļ�
0N/A �����ߴ�.)</p></td></tr>
0N/A
0N/A <tr><td><code>%...I</code></td>
0N/A <td>��û�� ����� ������ ���� ����Ʈ���� 0�� �� ���.
0N/A �̸� ����Ϸ��� <module>mod_logio</module>�� �ʿ��ϴ�.</td></tr>
0N/A
0N/A <tr><td><code>%...O</code></td>
0N/A <td>����� ������ �۽� ����Ʈ���� 0�� �� ���. �̸�
0N/A ����Ϸ��� <module>mod_logio</module>�� �ʿ��ϴ�.</td></tr>
0N/A </table>
0N/A
0N/A <p>"<var>...</var>"���� (<em>���� ���</em>,
0N/A <code>"%h %u %r %s %b"</code>) �ƹ��͵� ��ų�, �׸��� ������
0N/A ������ ���´� (������ �������� ������ �ڸ��� "-"�� ����Ѵ�).
0N/A ������ �տ� "!"�� ���̰ų� �Ⱥ��� HTTP �����ڵ� �������
0N/A �ۼ��Ѵ�. ���� ���, "%400,501{User-agent}i"�� 400 (Bad
0N/A Request) ����� 501 (Not Implemented) �����϶���
0N/A <code>User-agent:</code>�� �α׿� �����,
0N/A "%!200,304,302{Referer}i"�� �������� ���°� <em>�ƴ�</em>
0N/A ��� ��û�� ���� <code>Referer:</code>�� �α׿� �����.</p>
0N/A
0N/A <p>������ "&lt;"�� "&gt;"�� ���� �����̷��ǵ� ��û���� ����
0N/A ó�� ��û�� ������ ������ ��û�� ������ �����Ѵ�. �⺻������
0N/A <code>%s, %U, %T, %D, %r</code>�� ó�� ��û�� ����, ������
0N/A <code>%</code> ���þ�� ������ ��û�� ����. �׷���
0N/A <code>%&gt;s</code>�� ��û�� ������ ����(status)�� ����ϰ�,
0N/A <code>%&lt;u</code>�� �������� ��ȣ���� �ʴ� �ڿ����� ����
0N/A ����̷��ǵ� ��쿡�� ó���� ������ ����ڸ� ����Ѵ�.</p>
0N/A
0N/A <p>2.0.46 ������ httpd 2.0 ������ <code>%...r</code>,
0N/A <code>%...i</code>, <code>%...o</code>�� ��� ���ڿ��� �״��
�ξ��. ������ Common Log Format�� �䱸������ ������ؼ�����.
��, Ŭ���̾�Ʈ�� ����ڸ� �α׿� ������ �� �ֱ⶧����
�α������� �״�� �ٷ� ���� �����ؾ� �Ѵ�.</p>
<p>���Ȼ� ������ 2.0.46���� ����� �� ��� ���ڳ� �ٸ� Ư�����ڸ�
<code>\x<var>hh</var></code>�� ǥ���Ѵ�. ���⼭ <var>hh</var>��
�ش� ����Ʈ�� 16��� ǥ���� ��Ÿ����. �� ��Ģ�� ���ܴ� �齽������
�տ� ���̴� <code>"</code>�� <code>\</code>, �׸��� C���
����� ��鹮�ڵ�(<code>\n</code>, <code>\t</code> ��)�̴�.</p>
<p>�Ϲ������� ���� ����ϴ� �α� ����� ������ ����.</p>
<dl>
<dt>Common Log Format (CLF)</dt>
<dd><code>"%h %l %u %t \"%r\" %&gt;s %b"</code></dd>
<dt>����ȣ��Ʈ ������ ������ Common Log Format</dt>
<dd><code>"%v %h %l %u %t \"%r\" %&gt;s %b"</code></dd>
<dt>NCSA extended/combined �α� ���</dt>
<dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
\"%{User-agent}i\""</code></dd>
<dt>Referer �α� ���</dt>
<dd><code>"%{Referer}i -&gt; %U"</code></dd>
<dt>Agent (������) �α� ���</dt>
<dd><code>"%{User-agent}i"</code></dd>
</dl>
<p>��û�� �����ϴ� ������ ���� <directive
module="core">ServerName</directive>�� <directive
module="mpm_common">Listen</directive>�� ���� <code>%v</code>��
<code>%p</code>�� ����Ѵ�. �α׺м� ���α׷��� ������ ��û��
�����ϴ� ȣ��Ʈ�� �˱����� ����ȣ��Ʈ ã�� �˰?����
���� �ʿ��� �̵� ���� <directive
module="core">UseCanonicalName</directive> ������ �����ϴ�.</p>
</section>
<section id="security"><title>���Ȼ� ����� ��</title>
<p>������ �����ϴ� ����ڿܿ� �ٸ� ����ڰ� �α������� �����ϴ�
���丮�� ���� ������ ���� �� ���ȿ� ������ ������
<a href="/misc/security_tips.html#serverroot">���� ��</a>
������ ����϶�.</p>
</section>
<directivesynopsis>
<name>CookieLog</name>
<description>��Ű�� �α׿� ��������� ����� ���ϸ��� �����Ѵ�</description>
<syntax>CookieLog <var>filename</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<compatibility>�� ���þ�� ������ �ʴ´�.</compatibility>
<usage>
<p><directive>CookieLog</directive> ���þ�� ��Ű�� �α׿�
��������� ����� ���ϸ��� �����Ѵ�. ���ϸ��� <directive
module="core">ServerRoot</directive>�� ������̴�. ��
���þ�� <code>mod_cookies</code>�� ȣȯ�� ���� ����������,
���� ������ �ʴ´�.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CustomLog</name>
<description>�α����� �̸��� ����� �����Ѵ�</description>
<syntax>CustomLog <var>file</var>|<var>pipe</var>
<var>format</var>|<var>nickname</var>
[env=[!]<var>environment-variable</var>]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>������ ��û�� �α׿� ���涧 <directive>CustomLog</directive>
���þ ����Ѵ�. �α� ����� �����ϰ�, ȯ�溯���� ����Ͽ�
��û�� Ư¡�� ��� ���������� �α׸� ���� ���� �ִ�.</p>
<p>�α׸� ����� ��Ҹ� �����ϴ� ù��° �ƱԸ�Ʈ���� ����
���� �ϳ��� ����Ѵ�.</p>
<dl>
<dt><var>file</var></dt>
<dd><directive module="core">ServerRoot</directive>��
������� ���ϸ�.</dd>
<dt><var>pipe</var></dt>
<dd>���������� "<code>|</code>"�ڿ� �α� ������ ǥ���Է�����
���� ���α׷� ��θ� ��´�.
<note type="warning"><title>����:</title>
<p>���α׷��� ����Ѵٸ� ���α׷��� �������� ������ �����
�������� ����ȴ�. ������ root�� �����Ѵٸ� ���α׷���
root�� �����ϹǷ� ���α׷��� �������� Ȯ���϶�.</p>
</note>
<note type="warning"><title>����</title>
<p>���н��� �ƴ� �÷��� ���ϰ�θ� �Է��Ҷ� �÷�����
�齽������ ����ϴ��� �ݵ�� �������� ����ؾ� �Ѵ�.
�Ϲ������� �������Ͽ����� �׻� �������� ����ϴ� ����
����.</p>
</note></dd>
</dl>
<p>�ι�° �ƱԸ�Ʈ�� �α����Ͽ� ����� ������ �����Ѵ�.
�� <directive module="mod_log_config">LogFormat</directive>����
������ <var>nickname</var>�� ����ϰų� ���� <a
href="#formats">�α� ���</a> �� ������ <var>format</var>
���ڿ��� ����� �� �ִ�.</p>
<p>���� ���, ���� �� ���þ�� �Ȱ��� ���� �Ѵ�.</p>
<example>
# ��� ���� ����� CustomLog<br />
LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
CustomLog logs/access_log common<br />
<br />
# ���� ��� ���ڿ��� ����� CustomLog<br />
CustomLog logs/access_log "%h %l %u %t \"%r\" %&gt;s %b"
</example>
<p>����° �ƱԸ�Ʈ�� �� �Ǹ�, Ư�� ���� ȯ�溯�� ������
��� ��û�� �α׿� ������� ���θ� �����Ѵ�. ��û�� ������
<a href="/env.html">ȯ�溯��</a>�� ���ǵ��ִٸ� (Ȥ��
'<code>env=!<var>name</var></code>'�� ����� ��� ��ٸ�)
��û�� �α׿� ����Ѵ�.</p>
<p><module>mod_setenvif</module>�� <module>mod_rewrite</module>
����� ����Ͽ� ��û���� ȯ�溯���� ������ �� �ִ�. ����
���, ������ GIF �׸��� ���� ��� ��û�� �ּ��� �αװ� �ƴ�
�ٸ� �α����Ͽ� ����Ϸ���,</p>
<example>
SetEnvIf Request_URI \.gif$ gif-image<br />
CustomLog gif-requests.log common env=gif-image<br />
CustomLog nongif-requests.log common env=!gif-image
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LogFormat</name>
<description>�α����Ͽ� ����� ����� ����Ѵ�</description>
<syntax>LogFormat <var>format</var>|<var>nickname</var>
[<var>nickname</var>]</syntax>
<default>LogFormat "%h %l %u %t \"%r\" %>s %b"</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>�� ���þ�� ���� �α������� ����� �����Ѵ�.</p>
<p><directive>LogFormat</directive> ���þ�� �ΰ��� �������
����Ѵ�. ù��° ����� �ƱԸ�Ʈ�� �Ѱ��� ����Ͽ� ����
<directive>TransferLog</directive> ���þ���� ����� �α�
����� �����Ѵ�. �� �ƱԸ�Ʈ�� ���� <a href="#formats">�α�
��� �����ϱ�</a> �� ������ <var>format</var>�� ����
����ϰų�, ������ ������ <directive>LogFormat</directive>
���þ�� �̸� ������ (�α� ����� ��Ī�ϴ�) <var>nickname</var>��
����� �� �ִ�.</p>
<p><directive>LogFormat</directive> ���þ��� �ι�° �����
<var>format</var>�� <var>nickname</var>�� �����Ѵ�. �׷���
�ڿ��� ����ϴ� <directive>LogFormat</directive>�̳� <directive
module="mod_log_config">CustomLog</directive> ���þ �ݺ��ؼ�
��� ���ڿ��� ��� �Է��ϴ� ��� <var>nickname</var>�� �����
�� �ִ�. ��Ī�� �����ϴ� <directive>LogFormat</directive>
���þ�� <strong>�� �ܿ��� �ƹ� ����� ���� �ʴ´�</strong>.
��, ��Ī<em>��</em>�� �����ϸ�, ������ ����� ����ϰų�
����� �⺻������ ������ �ʴ´�. �׷��Ƿ� ������ ������
<directive module="mod_log_config">TransferLog</directive>
���þ ������ ���� �ʴ´�. ��,
<directive>LogFormat</directive>�� ��Ī���� �ٸ� ��Ī��
������ �� �ִ�. ��Ī �̸����� �ۼ�Ʈ ��ȣ(<code>%</code>)��
����� �� ������ �����϶�.</p>
<example><title>����</title>
LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost_common
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>TransferLog</name>
<description>�α����� ��ġ�� �����Ѵ�</description>
<syntax>TransferLog <var>file</var>|<var>pipe</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>�� ���þ�� <directive
module="mod_log_config">CustomLog</directive> ���þ�� �ƱԸ�Ʈ��
����� ���������, �α� ����� ���� �����ϰų� ��û�� ���ǿ�
��� �α׿� ���� �� ���. ��� ���� �ֱ� ����� (��Ī��
�������� ����) <directive
module="mod_log_config">LogFormat</directive> ���þ ������
�α� ����� ����Ѵ�. �̸� ����� �������� �ʾҴٸ� Common
Log Format�� ����Ѵ�.</p>
<example><title>����</title>
LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""<br />
TransferLog logs/access_log
</example>
</usage>
</directivesynopsis>
</modulesynopsis>