home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / CMCD1104.ISO / Software / Complet / Apache / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F278328_mod_log_config.xml.ko < prev    next >
Extensible Markup Language  |  2004-09-22  |  17KB  |  421 lines

  1. <?xml version="1.0" encoding="EUC-KR" ?>
  2. <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
  3. <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
  4. <!-- English Revision: 1.13.2.14 -->
  5.  
  6. <!--
  7.  Copyright 2002-2004 The Apache Software Foundation
  8.  
  9.  Licensed under the Apache License, Version 2.0 (the "License");
  10.  you may not use this file except in compliance with the License.
  11.  You may obtain a copy of the License at
  12.  
  13.      http://www.apache.org/licenses/LICENSE-2.0
  14.  
  15.  Unless required by applicable law or agreed to in writing, software
  16.  distributed under the License is distributed on an "AS IS" BASIS,
  17.  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18.  See the License for the specific language governing permissions and
  19.  limitations under the License.
  20. -->
  21.  
  22. <modulesynopsis metafile="mod_log_config.xml.meta">
  23.  
  24. <name>mod_log_config</name>
  25. <description>╝¡╣÷╖╬└╟ ┐Σ├╗└╗ ╖╬▒╫┐í ▒Γ╖╧╟╤┤┘</description>
  26. <status>Base</status>
  27. <sourcefile>mod_log_config.c</sourcefile>
  28. <identifier>log_config_module</identifier>
  29.  
  30. <summary>
  31.     <p>└╠ ╕≡╡Γ└║ ┼¼╢≤└╠╛≡╞«└╟ ┐Σ├╗└╗ ╖╬▒╫┐í └┌└»╖╙░╘ ▒Γ╖╧╟╤┤┘.
  32.     └┌╜┼└╠ ┐°╟╧┤┬ ╟ⁿ╜─└╕╖╬ ╖╬▒╫╕ª ▒Γ╖╧╟╥ ╝÷ └╓░φ, ╞─└╧└╠│¬ ┐▄║╬
  33.     ╟┴╖╬▒╫╖Ñ┐í ┴≈┴ó ╖╬▒╫╕ª ║╕│╛ ╝÷╡╡ └╓┤┘. ┴╢░╟└√ ╖╬▒╫╕ª ╗τ┐δ╟╧╕Θ
  34.     ┐Σ├╗└╟ ╝║░▌┐í ╡√╢≤ ┐Σ├╗└╗ ╖╬▒╫┐í ├▀░í╟╧░┼│¬ ┴ª┐▄╟╥ ╝÷ └╓┤┘.</p>
  35.  
  36.     <p>└╠ ╕≡╡Γ└║ ╝╝░í┴÷ ┴÷╜├╛ε╕ª ┴ª░°╟╤┤┘. <directive
  37.     module="mod_log_config">TransferLog</directive>┤┬ ╖╬▒╫╞─└╧└╗
  38.     ╕╕╡Θ░φ, <directive module="mod_log_config">LogFormat</directive>└║
  39.     ┐°╟╧┤┬ ╟ⁿ╜─└╗ ┴ñ╟╧░φ, <directive
  40.     module="mod_log_config">CustomLog</directive>┤┬ ╟╤╣°┐í ╖╬▒╫╞─└╧░·
  41.     ╟ⁿ╜─└╗ ╕≡╡╬ ┴÷┴ñ╟╤┤┘. <directive>TransferLog</directive>┐═
  42.     <directive>CustomLog</directive> ┴÷╜├╛ε╕ª ┐⌐╖»╣° ╗τ┐δ╟╧╕Θ
  43.     ┐Σ├╗└╗ ┐⌐╖» ╞─└╧┐í ▒Γ╖╧╟╥ ╝÷ └╓┤┘.</p>
  44. </summary>
  45. <seealso><a href="../logs.html">╛╞╞──í ╖╬▒╫╞─└╧</a></seealso>
  46.  
  47. <section id="formats"><title>╖╬▒╫ ╟ⁿ╜─ ┴÷┴ñ╟╧▒Γ</title>
  48.  
  49.     <p><directive module="mod_log_config">LogFormat</directive>░·
  50.     <directive module="mod_log_config">CustomLog</directive>
  51.     ┴÷╜├╛ε└╟ ╟ⁿ╜─ ╛╞▒╘╕╒╞«┤┬ ╣«└┌┐¡└╠┤┘. └╠ ╣«└┌┐¡┐í ╡√╢≤ ┐Σ├╗└╗
  52.     ╖╬▒╫╞─└╧┐í ▒Γ╖╧╟╤┤┘. ╣«└┌┐¡┐í┤┬ ╖╬▒╫╞─└╧┐í ▒╫┤δ╖╬ ║╣╗τ╡╟┤┬
  53.     ╣«└┌┐═ ╟α╣┘▓▐░· ┼╟└╗ │¬┼╕│╗┤┬ C└╟ "\n"░· "\t" ┴ª╛ε╣«└┌╕ª
  54.     ╗τ┐δ╟╥ ╝÷ └╓┤┘. ╖╬▒╫╞─└╧┐í ╡√┐╚╟Ñ│¬ ╣Θ╜╜╖í╜¼╕ª ╛▓╖┴╕Θ ╛╒┐í
  55.     ╣▌╡σ╜├ ╣Θ╜╜╖í╜¼╕ª └√╛ε┴α╛▀ ╟╤┤┘.</p>
  56.  
  57.     <p>┐Σ├╗└╟ ╞»┬í└║ ╟ⁿ╜─ ╣«└┌┐¡┐í "<code>%</code>" ┴÷╜├╛ε╕ª
  58.     ╗τ┐δ╟╧┐⌐ ▒Γ╖╧╟╤┤┘. └╠ ┴÷╜├╛ε┤┬ ╖╬▒╫╞─└╧┐í╝¡ ┤┘└╜░· ░░└╠
  59.     ║»░µ╡╚┤┘.</p>
  60.  
  61.     <table border="1" style="zebra">
  62.     <columnspec><column width=".2"/><column width=".8"/></columnspec>
  63.     <tr><th>╟ⁿ╜─ ╣«└┌┐¡</th>
  64.         <th>╝│╕φ</th></tr>
  65.  
  66.     <tr><td><code>%%</code></td>
  67.         <td>╞█╝╛╞« ▒Γ╚ú (<em>╛╞╞──í 2.0.44 └╠╚─</em>)</td></tr>
  68.  
  69.     <tr><td><code>%...a</code></td>
  70.         <td>┐°░▌ IP-┴╓╝╥</td></tr>
  71.  
  72.     <tr><td><code>%...A</code></td>
  73.         <td>(╝¡╣÷) IP-┴╓╝╥</td></tr>
  74.  
  75.     <tr><td><code>%...B</code></td>
  76.         <td>HTTP ╟∞┤⌡╕ª ┴ª┐▄╟╤ └ⁿ╝█ ╣┘└╠╞«╝÷.</td></tr>
  77.  
  78.     <tr><td><code>%...b</code></td>
  79.         <td>HTTP ╟∞┤⌡╕ª ┴ª┐▄╟╤ └ⁿ╝█ ╣┘└╠╞«╝÷. CLF ╟ⁿ╜─░· ░░└╠
  80.         └ⁿ╝█╟╤ │╗┐δ└╠ ╛°┤┬ ░µ┐∞ 0 ┤δ╜┼ '<code>-</code>'░í │¬┐┬┤┘.</td></tr>
  81.  
  82.     <tr><td><code>%...{<var>Foobar</var>}C</code></td>
  83.         <td>╝¡╣÷░í ╝÷╜┼╟╤ ┐Σ├╗┐í╝¡ <var>Foobar</var> ─φ┼░└╟
  84.         │╗┐δ.</td></tr>
  85.  
  86.     <tr><td><code>%...D</code></td>
  87.         <td>┐Σ├╗└╗ ├│╕«╟╧┤┬╡Ñ ░╔╕░ ╜├░ú (╕╢└╠┼⌐╖╬├╩ ┤▄└º).</td></tr>
  88.  
  89.     <tr><td><code>%...{<var>FOOBAR</var>}e</code></td>
  90.         <td>╚»░µ║»╝÷ <var>FOOBAR</var>└╟ │╗┐δ</td></tr>
  91.  
  92.     <tr><td><code>%...f</code></td>
  93.         <td>╞─└╧╕φ</td></tr>
  94.  
  95.     <tr><td><code>%...h</code></td>
  96.         <td>┐°░▌ ╚ú╜║╞«</td></tr>
  97.  
  98.     <tr><td><code>%...H</code></td>
  99.         <td>┐Σ├╗ ╟┴╖╬┼Σ─▌</td></tr>
  100.  
  101.     <tr><td><code>%...{<var>Foobar</var>}i</code></td>
  102.         <td>╝¡╣÷░í ╝÷╜┼╟╤ ┐Σ├╗┐í╝¡ <code><var>Foobar</var>:</code>
  103.         ╟∞┤⌡└╟ │╗┐δ.</td></tr>
  104.  
  105.     <tr><td><code>%...l</code></td>
  106.         <td>(└╓┤┘╕Θ identd░í ┴ª░°╟╤) ┐°░▌ ╖╬▒╫└╬╕φ.
  107.         <directive
  108.         module="mod_ident">IdentityCheck</directive>░í
  109.         <code>On</code>└╠ ╛╞┤╧╕Θ ╗⌐▒Γ▒Γ╚ú╕ª ▒Γ╖╧╟╤┤┘.</td></tr>
  110.  
  111.     <tr><td><code>%...m</code></td>
  112.         <td>┐Σ├╗ ╕▐╜ß╡σ</td></tr>
  113.  
  114.     <tr><td><code>%...{<var>Foobar</var>}n</code></td>
  115.         <td>┤┘╕Ñ ╕≡╡Γ└╠ ▒Γ╖╧╟╤ <var>Foobar</var> │δ╞«(note)
  116.         │╗┐δ.</td></tr>
  117.  
  118.     <tr><td><code>%...{<var>Foobar</var>}o</code></td>
  119.         <td>└└┤Σ└╟ <code><var>Foobar</var>:</code> ╟∞┤⌡ │╗┐δ.</td></tr>
  120.  
  121.     <tr><td><code>%...p</code></td>
  122.         <td>┐Σ├╗└╗ ╝¡║±╜║╟╧┤┬ ╝¡╣÷└╟ ┴ñ▒╘ ╞≈╞«</td></tr>
  123.  
  124.     <tr><td><code>%...P</code></td>
  125.         <td>┐Σ├╗└╗ ╝¡║±╜║╟╧┤┬ └┌╜─└╟ ╟┴╖╬╝╝╜║ ID.</td></tr>
  126.  
  127.     <tr><td><code>%...{<var>format</var>}P</code></td>
  128.         <td>┐Σ├╗└╗ ╝¡║±╜║╟╧┤┬ └┌╜─└╟ ╟┴╖╬╝╝╜║ ID ╚ñ└║ ╛▓╖╣╡σ
  129.         ID. format┐í┤┬ <code>pid</code>┐═ <code>tid</code>░í
  130.         ░í┤╔╟╧┤┘. (<em>╛╞╞──í 2.0.46 └╠╚─</em>)
  131.         </td></tr>
  132.  
  133.     <tr><td><code>%...q</code></td>
  134.         <td>┴·└╟╣«└┌┐¡ (┴·└╟╣«└┌┐¡└╠ └╓┤┘╕Θ ╛╒┐í <code>?</code>╕ª
  135.         ║┘└╠░φ, ╛°┤┘╕Θ ║≤ ╣«└┌┐¡)</td></tr>
  136.  
  137.     <tr><td><code>%...r</code></td>
  138.         <td>┐Σ├╗└╟ ├╣╣°┬░ ┴┘</td></tr>
  139.  
  140.     <tr><td><code>%...s</code></td>
  141.         <td>╗≤┼┬(status). │╗║╬ ╕«┤┘└╠╖║╝╟╡╚ ┐Σ├╗└╟ ░µ┐∞ *┐°╖í*
  142.         ┐Σ├╗└╟ ╗≤┼┬└╠┤┘. ├╓┴╛ ┐Σ├╗└╟ ╗≤┼┬┤┬ <code>%...>s</code>.</td></tr>
  143.  
  144.     <tr><td><code>%...t</code></td>
  145.         <td>common log format ╜├░ú ╟ⁿ╜─(╟Ñ┴╪ ┐╡╛ε ╟ⁿ╜─)└╟ ╜├░ú</td></tr>
  146.  
  147.     <tr><td><code>%...{<var>format</var>}t</code></td>
  148.         <td><code>strftime(3)</code> ╟ⁿ╜─ format└╟ ╜├░ú. (┴÷┐¬╜├░ú└╧
  149.         ╝÷ └╓└╜)</td></tr>
  150.  
  151.     <tr><td><code>%...T</code></td>
  152.         <td>┐Σ├╗└╗ ├│╕«╟╧┤┬╡Ñ ░╔╕░ ╜├░ú (├╩ ┤▄└º).</td></tr>
  153.  
  154.     <tr><td><code>%...u</code></td>
  155.         <td>┐°░▌ ╗τ┐δ└┌ (auth░í ┴ª░°╟╧╕τ, ╗≤┼┬(<code>%s</code>)░í
  156.         401└╬ ░µ┐∞ └╠╗≤╟╤ ░¬└╗ │¬┐├ ╝÷ └╓└╜)</td></tr>
  157.  
  158.     <tr><td><code>%...U</code></td>
  159.         <td>┴·└╟╣«└┌┐¡└╗ ┴ª┐▄╟╤ ┐Σ├╗ URL ░µ╖╬.</td></tr>
  160.  
  161.     <tr><td><code>%...v</code></td>
  162.         <td>┐Σ├╗└╗ ╝¡║±╜║╟╤ ╝¡╣÷└╟ ┴ñ▒╘ <directive
  163.         module="core">ServerName</directive>.</td></tr>
  164.  
  165.     <tr><td><code>%...V</code></td>
  166.         <td><directive module="core">UseCanonicalName</directive>
  167.         ╝│┴ñ┐í ╡√╕Ñ ╝¡╣÷╕φ.</td></tr>
  168.  
  169.     <tr><td><code>%...X</code></td>
  170.         <td>└└┤Σ└╗ ╕╢├╞└╗╢º ┐¼░ß ╗≤┼┬.
  171.  
  172.         <table>
  173.         <columnspec><column width=".2"/><column width=".6"/></columnspec>
  174.         <tr><td><code>X</code> =</td>
  175.             <td>└└┤Σ└╗ ╕╢─í▒Γ └ⁿ┐í ┐¼░ß└╠ ▓≈╛ε┴│┤┘.</td></tr>
  176.         <tr><td><code>+</code> =</td>
  177.             <td>└└┤Σ└╗ ║╕│╜╚─┐í╡╡ ┐¼░ß└╠ ╗∞╛╞└╓┤┘(keep alive).</td></tr>
  178.         <tr><td><code>-</code> = </td>
  179.             <td>└└┤Σ└╗ ║╕│╜╚─ ┐¼░ß└╠ ▓≈╛ε┴│┤┘.</td></tr>
  180.         </table>
  181.  
  182.         <p>(╛╞╞──í 1.3 ╚─╣▌ ╣÷└ⁿ┐í╝¡ └╠ ┴÷╜├╛ε┤┬
  183.         <code>%...c</code>┐┤┴÷╕╕, └ⁿ┼δ└√└╬ ssl
  184.         <code>%...{<var>var</var>}c</code> ╣«╣²░· ░π├─╝¡
  185.         ║»░µ╟▀┤┘.)</p></td></tr>
  186.  
  187.     <tr><td><code>%...I</code></td>
  188.         <td>┐Σ├╗░· ╟∞┤⌡╕ª ╞≈╟╘╟╤ ╝÷╜┼ ╣┘└╠╞«╝÷╖╬ 0└╧ ╝÷ ╛°┤┘.
  189.         └╠╕ª ╗τ┐δ╟╧╖┴╕Θ <module>mod_logio</module>░í ╟╩┐Σ╟╧┤┘.</td></tr>
  190.  
  191.     <tr><td><code>%...O</code></td>
  192.         <td>╟∞┤⌡╕ª ╞≈╟╘╟╤ ╝█╜┼ ╣┘└╠╞«╝÷╖╬ 0└╧ ╝÷ ╛°┤┘. └╠╕ª
  193.         ╗τ┐δ╟╧╖┴╕Θ <module>mod_logio</module>░í ╟╩┐Σ╟╧┤┘.</td></tr>
  194.     </table>
  195.  
  196.     <p>"<var>...</var>"┐í┤┬ (<em>┐╣╕ª ╡Θ╛ε</em>,
  197.     <code>"%h %u %r %s %b"</code>) ╛╞╣½░═╡╡ ╛°░┼│¬, ╟╫╕±└╗ ╞≈╟╘╟╥
  198.     ┴╢░╟└╠ │¬┐┬┤┘ (┴╢░╟└╗ ╕╕┴╖╟╧┴÷ ╛╩└╕╕Θ └┌╕«┐í "-"╕ª ▒Γ╖╧╟╤┤┘).
  199.     ┴╢░╟└║ ╛╒┐í "!"╕ª ║┘└╠░┼│¬ ╛╚║┘└╬ HTTP ╗≤┼┬─┌╡σ ╕±╖╧└╕╖╬
  200.     └█╝║╟╤┤┘. ┐╣╕ª ╡Θ╛ε, "%400,501{User-agent}i"┤┬ 400 (Bad
  201.     Request) ┐└╖∙┐═ 501 (Not Implemented) ┐└╖∙└╧╢º╕╕
  202.     <code>User-agent:</code>╕ª ╖╬▒╫┐í │▓▒Γ░φ,
  203.     "%!200,304,302{Referer}i"┤┬ ┴ñ╗≤└√└╬ ╗≤┼┬░í <em>╛╞┤╤</em>
  204.     ╕≡╡τ ┐Σ├╗┐í ┤δ╟╪ <code>Referer:</code>╕ª ╖╬▒╫┐í │▓▒Σ┤┘.</p>
  205.  
  206.     <p>╝÷┴ñ└┌ "<"┐═ ">"┤┬ │╗║╬ ╕«┤┘└╠╖║╝╟╡╚ ┐Σ├╗┐í╝¡ ░ó░ó
  207.     ├│└╜ ┐Σ├╗└╗ ╕╗╟╥┴÷ ╕╢┴÷╕╖ ┐Σ├╗└╗ ╕╗╟╥┴÷ ╝▒┼├╟╤┤┘. ▒Γ║╗└√└╕╖╬
  208.     <code>%s, %U, %T, %D, %r</code>└║ ├│└╜ ┐Σ├╗└╗ ║╕░φ, │¬╕╙┴÷
  209.     <code>%</code> ┴÷╜├╛ε┤┬ ╕╢┴÷╕╖ ┐Σ├╗└╗ ║╗┤┘. ▒╫╖í╝¡
  210.     <code>%>s</code>┤┬ ┐Σ├╗└╟ ╕╢┴÷╕╖ ╗≤┼┬(status)╕ª ▒Γ╖╧╟╧░φ,
  211.     <code>%<u</code>┤┬ └╬┴⌡└╕╖╬ ║╕╚ú╟╧┴÷ ╛╩┤┬ └┌┐°└╕╖╬ │╗║╬
  212.     ╢≤┤┘└╠╖║╝╟╡╚ ░µ┐∞┐í╡╡ ├│└╜┐í └╬┴⌡╟╤ ╗τ┐δ└┌╕ª ▒Γ╖╧╟╤┤┘.</p>
  213.  
  214.     <p>2.0.46 └╠└ⁿ└╟ httpd 2.0 ╣÷└ⁿ└║ <code>%...r</code>,
  215.     <code>%...i</code>, <code>%...o</code>└╟ ░ß░· ╣«└┌┐¡└╗ ▒╫┤δ╖╬
  216.     ╡╬╛·┤┘. └╠└»┤┬ Common Log Format└╟ ┐Σ▒╕╗τ╟╫└╗ ╡√╕ú▒Γ└º╟╪╝¡┐┤┤┘.
  217.     ┴∩, ┼¼╢≤└╠╛≡╞«░í ┴ª╛ε╣«└┌╕ª ╖╬▒╫┐í ┴²╛ε│╓└╗ ╝÷ └╓▒Γ╢º╣«┐í
  218.     ╖╬▒╫╞─└╧└╗ ▒╫┤δ╖╬ ┤┘╖Ω ╢º┤┬ ┴╢╜╔╟╪╛▀ ╟╤┤┘.</p>
  219.  
  220.     <p>║╕╛╚╗≤ └╠└»╖╬ 2.0.46║╬┼═ ├Γ╖┬╟╥ ╝÷ ╛°┤┬ ╣«└┌│¬ ┤┘╕Ñ ╞»╝÷╣«└┌╕ª
  221.     <code>\x<var>hh</var></code>╖╬ ╟Ñ╟÷╟╤┤┘. ┐⌐▒Γ╝¡ <var>hh</var>┤┬
  222.     ╟╪┤τ ╣┘└╠╞«└╟ 16┴°╝÷ ╟Ñ╟÷└╗ │¬┼╕│╜┤┘. └╠ ▒╘─ó└╟ ┐╣┐▄┤┬ ╣Θ╜╜╖í╜¼╕ª
  223.     ╛╒┐í ║┘└╠┤┬ <code>"</code>┐═ <code>\</code>, ▒╫╕«░φ C╛≡╛ε
  224.     ╟ⁿ╜─└╟ ░°╣Θ╣«└┌╡Θ(<code>\n</code>, <code>\t</code> ╡ε)└╠┤┘.</p>
  225.  
  226.     <p>└╧╣▌└√└╕╖╬ ╕╣└╠ ╗τ┐δ╟╧┤┬ ╖╬▒╫ ╟ⁿ╜─└║ ┤┘└╜░· ░░┤┘.</p>
  227.  
  228.     <dl>
  229.       <dt>Common Log Format (CLF)</dt>
  230.       <dd><code>"%h %l %u %t \"%r\" %>s %b"</code></dd>
  231.  
  232.       <dt>░í╗≤╚ú╜║╞« ┴ñ║╕╕ª ╞≈╟╘╟╤ Common Log Format</dt>
  233.       <dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd>
  234.  
  235.       <dt>NCSA extended/combined ╖╬▒╫ ╟ⁿ╜─</dt>
  236.       <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
  237.       \"%{User-agent}i\""</code></dd>
  238.  
  239.       <dt>Referer ╖╬▒╫ ╟ⁿ╜─</dt>
  240.       <dd><code>"%{Referer}i -> %U"</code></dd>
  241.  
  242.       <dt>Agent (║Ω╢≤┐∞└·) ╖╬▒╫ ╟ⁿ╜─</dt>
  243.       <dd><code>"%{User-agent}i"</code></dd>
  244.     </dl>
  245.  
  246.     <p>┐Σ├╗└╗ ╝¡║±╜║╟╧┤┬ ╝¡╣÷└╟ ┴ñ▒╘ <directive
  247.     module="core">ServerName</directive>░· <directive
  248.     module="mpm_common">Listen</directive>└║ ░ó░ó <code>%v</code>┐═
  249.     <code>%p</code>╕ª ╗τ┐δ╟╤┤┘. ╖╬▒╫║╨╝« ╟┴╖╬▒╫╖Ñ└╠ ╜╟┴ª╖╬ ┐Σ├╗└╗
  250.     ╝¡║±╜║╟╧┤┬ ╚ú╜║╞«╕ª ╛╦▒Γ└º╟╪ ░í╗≤╚ú╜║╞« ├ú▒Γ ╛╦░φ╕«┴≥└╗
  251.     ░í┴· ╟╩┐Σ╛°╡╡╖╧ └╠╡Θ ░¬└║ <directive
  252.     module="core">UseCanonicalName</directive> ╝│┴ñ░· ╣½░ⁿ╟╧┤┘.</p>
  253. </section>
  254.  
  255. <section id="security"><title>║╕╛╚╗≤ ░φ╖┴╟╥ ┴í</title>
  256.     <p>╝¡╣÷╕ª ╜├└█╟╧┤┬ ╗τ┐δ└┌┐▄┐í ┤┘╕Ñ ╗τ┐δ└┌░í ╖╬▒╫╞─└╧└╗ └·└σ╟╧┤┬
  257.     ╡≡╖║┼Σ╕«┐í ╛▓▒Γ ▒╟╟╤└╗ ░í┴·╢º ┐╓ ║╕╛╚┐í ╣«┴ª░í ╗²▒Γ┤┬┴÷
  258.     <a href="../misc/security_tips.html#serverroot">║╕╛╚ ╞┴</a>
  259.     ╣«╝¡╕ª ┬ⁿ░φ╟╧╢≤.</p>
  260. </section>
  261.  
  262. <directivesynopsis>
  263. <name>CookieLog</name>
  264. <description>─φ┼░╕ª ╖╬▒╫┐í │▓▒Γ▒Γ└º╟╪ ╗τ┐δ╟╥ ╞─└╧╕φ└╗ ╝│┴ñ╟╤┤┘</description>
  265. <syntax>CookieLog <var>filename</var></syntax>
  266. <contextlist><context>server config</context><context>virtual host</context>
  267. </contextlist>
  268. <compatibility>└╠ ┴÷╜├╛ε┤┬ ╗τ┐δ╡╟┴÷ ╛╩┤┬┤┘.</compatibility>
  269.  
  270. <usage>
  271.     <p><directive>CookieLog</directive> ┴÷╜├╛ε┤┬ ─φ┼░╕ª ╖╬▒╫┐í
  272.     │▓▒Γ▒Γ└º╟╪ ╗τ┐δ╟╥ ╞─└╧╕φ└╗ ╝│┴ñ╟╤┤┘. ╞─└╧╕φ└║ <directive
  273.     module="core">ServerRoot</directive>┐í ╗≤┤δ░µ╖╬└╠┤┘. └╠
  274.     ┴÷╜├╛ε┤┬ <code>mod_cookies</code>┐═ ╚ú╚»└╗ └º╟╪ ╞≈╟╘╟▀└╗╗╙,
  275.     ╜╟┴ª ╗τ┐δ╡╟┴÷ ╛╩┤┬┤┘.</p>
  276. </usage>
  277. </directivesynopsis>
  278.  
  279. <directivesynopsis>
  280. <name>CustomLog</name>
  281. <description>╖╬▒╫╞─└╧ └╠╕º░· ╟ⁿ╜─└╗ ┴÷┴ñ╟╤┤┘</description>
  282. <syntax>CustomLog  <var>file</var>|<var>pipe</var>
  283. <var>format</var>|<var>nickname</var>
  284. [env=[!]<var>environment-variable</var>]</syntax>
  285. <contextlist><context>server config</context><context>virtual host</context>
  286. </contextlist>
  287.  
  288. <usage>
  289.     <p>╝¡╣÷░í ┐Σ├╗└╗ ╖╬▒╫┐í │▓▒µ╢º <directive>CustomLog</directive>
  290.     ┴÷╜├╛ε╕ª ╗τ┐δ╟╤┤┘. ╖╬▒╫ ╟ⁿ╜─└╗ ┴÷┴ñ╟╧░φ, ╚»░µ║»╝÷╕ª ╗τ┐δ╟╧┐⌐
  291.     ┐Σ├╗└╟ ╞»┬í┐í ╡√╢≤ ╝▒┼├└√└╕╖╬ ╖╬▒╫╕ª │▓▒µ ╝÷╡╡ └╓┤┘.</p>
  292.  
  293.     <p>╖╬▒╫╕ª ▒Γ╖╧╟╥ └σ╝╥╕ª ┴÷┴ñ╟╧┤┬ ├╣╣°┬░ ╛╞▒╘╕╒╞«┐í┤┬ ┤┘└╜
  294.     ╡╤┴▀ ╟╧│¬╕ª ╗τ┐δ╟╤┤┘.</p>
  295.  
  296.     <dl>
  297.       <dt><var>file</var></dt>
  298.       <dd><directive module="core">ServerRoot</directive>┐í
  299.       ╗≤┤δ└√└╬ ╞─└╧╕φ.</dd>
  300.  
  301.       <dt><var>pipe</var></dt>
  302.       <dd>╞─└╠╟┴╣«└┌ "<code>|</code>"╡┌┐í ╖╬▒╫ ┴ñ║╕╕ª ╟Ñ┴╪└╘╖┬└╕╖╬
  303.       ╣▐└╗ ╟┴╖╬▒╫╖Ñ ░µ╖╬╕ª └√┤┬┤┘.
  304.  
  305.       <note type="warning"><title>║╕╛╚:</title>
  306.       <p>╟┴╖╬▒╫╖Ñ└╗ ╗τ┐δ╟╤┤┘╕Θ ╟┴╖╬▒╫╖Ñ└║ └Ñ╝¡╣÷╕ª ╜├└█╟╤ ╗τ┐δ└┌
  307.       ▒╟╟╤└╕╖╬ ╜╟╟α╡╚┤┘. ╝¡╣÷╕ª root╖╬ ╜├└█╟╤┤┘╕Θ ╟┴╖╬▒╫╖Ñ╡╡
  308.       root╖╬ ╜╟╟α╟╧╣╟╖╬ ╟┴╖╬▒╫╖Ñ└╠ ╛╚└ⁿ╟╤┴÷ ╚«└╬╟╧╢≤.</p>
  309.       </note>
  310.       <note type="warning"><title>┴╓└╟</title>
  311.         <p>└»┤╨╜║░í ╛╞┤╤ ╟├╖í╞√┐í╝¡ ╞─└╧░µ╖╬╕ª └╘╖┬╟╥╢º ╟├╖í╞√└╠
  312.         ╣Θ╜╜╖í╜¼╕ª ╗τ┐δ╟╧┤⌡╢≤╡╡ ╣▌╡σ╜├ ╜╜╖í╜¼╕ª ╗τ┐δ╟╪╛▀ ╟╤┤┘.
  313.         └╧╣▌└√└╕╖╬ ╝│┴ñ╞─└╧┐í╝¡┤┬ ╟╫╗≤ ╜╜╖í╜¼╕ª ╗τ┐δ╟╧┤┬ ░═└╠
  314.         ┴┴┤┘.</p>
  315.       </note></dd>
  316.     </dl>
  317.  
  318.     <p>╡╬╣°┬░ ╛╞▒╘╕╒╞«┤┬ ╖╬▒╫╞─└╧┐í ▒Γ╖╧╟╥ │╗┐δ└╗ ┴÷┴ñ╟╤┤┘.
  319.     └ⁿ┐í <directive module="mod_log_config">LogFormat</directive>└╕╖╬
  320.     ┴ñ└╟╟╤ <var>nickname</var>└╗ ╗τ┐δ╟╧░┼│¬ ┴≈┴ó <a
  321.     href="#formats">╖╬▒╫ ╟ⁿ╜─</a> └²┐í╝¡ ╝│╕φ╟╤ <var>format</var>
  322.     ╣«└┌┐¡└╗ ╗τ┐δ╟╥ ╝÷ └╓┤┘.</p>
  323.  
  324.     <p>┐╣╕ª ╡Θ╛ε, ┤┘└╜ ╡╬ ┴÷╜├╛ε┤┬ ╢╚░░└║ └╧└╗ ╟╤┤┘.</p>
  325.  
  326.     <example>
  327.       # ╟ⁿ╜─ ║░─¬└╗ ╗τ┐δ╟╤ CustomLog<br />
  328.       LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
  329.       CustomLog logs/access_log common<br />
  330.       <br />
  331.       # ┴≈┴ó ╟ⁿ╜─ ╣«└┌┐¡└╗ ╗τ┐δ╟╤ CustomLog<br />
  332.       CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"
  333.     </example>
  334.  
  335.     <p>╝╝╣°┬░ ╛╞▒╘╕╒╞«┤┬ ╛°╛ε╡╡ ╡╟╕τ, ╞»┴ñ ╝¡╣÷ ╚»░µ║»╝÷ └»╣½┐í
  336.     ╡√╢≤ ┐Σ├╗└╗ ╖╬▒╫┐í ▒Γ╖╧╟╥┴÷ ┐⌐║╬╕ª ░ß┴ñ╟╤┤┘. ┐Σ├╗┐í ┴÷┴ñ╟╤
  337.     <a href="../env.html">╚»░µ║»╝÷</a>░í ┴ñ└╟╡╟└╓┤┘╕Θ (╚ñ└║
  338.     '<code>env=!<var>name</var></code>'╕ª ╗τ┐δ╟╤ ░µ┐∞ ╛°┤┘╕Θ)
  339.     ┐Σ├╗└╗ ╖╬▒╫┐í ▒Γ╖╧╟╤┤┘.</p>
  340.  
  341.     <p><module>mod_setenvif</module>│¬ <module>mod_rewrite</module>
  342.     ╕≡╡Γ└╗ ╗τ┐δ╟╧┐⌐ ┐Σ├╗║░╖╬ ╚»░µ║»╝÷╕ª ╝│┴ñ╟╥ ╝÷ └╓┤┘. ┐╣╕ª
  343.     ╡Θ╛ε, ╝¡╣÷░í GIF ▒╫╕▓┐í ┤δ╟╤ ╕≡╡τ ┐Σ├╗└╗ ┴╓╝¡╣÷ ╖╬▒╫░í ╛╞┤╤
  344.     ┤┘╕Ñ ╖╬▒╫╞─└╧┐í ▒Γ╖╧╟╧╖┴╕Θ,</p>
  345.     
  346.     <example>
  347.       SetEnvIf Request_URI \.gif$ gif-image<br />
  348.       CustomLog gif-requests.log common env=gif-image<br />
  349.       CustomLog nongif-requests.log common env=!gif-image
  350.     </example>
  351. </usage>
  352. </directivesynopsis>
  353.  
  354. <directivesynopsis>
  355. <name>LogFormat</name>
  356. <description>╖╬▒╫╞─└╧┐í ╗τ┐δ╟╥ ╟ⁿ╜─└╗ ▒Γ╝·╟╤┤┘</description>
  357. <syntax>LogFormat <var>format</var>|<var>nickname</var>
  358. [<var>nickname</var>]</syntax>
  359. <default>LogFormat "%h %l %u %t \"%r\" %>s %b"</default>
  360. <contextlist><context>server config</context><context>virtual host</context>
  361. </contextlist>
  362.  
  363. <usage>
  364.     <p>└╠ ┴÷╜├╛ε┤┬ ┴ó▒┘ ╖╬▒╫╞─└╧└╟ ╟ⁿ╜─└╗ ┴÷┴ñ╟╤┤┘.</p>
  365.  
  366.     <p><directive>LogFormat</directive> ┴÷╜├╛ε┤┬ ╡╬░í┴÷ ╟ⁿ╜─└╕╖╬
  367.     ╗τ┐δ╟╤┤┘. ├╣╣°┬░ ╟ⁿ╜─└║ ╛╞▒╘╕╒╞«╕ª ╟╤░│╕╕ ╗τ┐δ╟╧┐⌐ ┤┘└╜
  368.     <directive>TransferLog</directive> ┴÷╜├╛ε╡Θ└╠ ╗τ┐δ╟╥ ╖╬▒╫
  369.     ╟ⁿ╜─└╗ ┴÷┴ñ╟╤┤┘. └╠ ╛╞▒╘╕╒╞«┐í └º└╟ <a href="#formats">╖╬▒╫
  370.     ╟ⁿ╜─ ┴÷┴ñ╟╧▒Γ</a> └²┐í╝¡ ╝│╕φ╟╤ <var>format</var>└╗ ┴≈┴ó
  371.     ╗τ┐δ╟╧░┼│¬, ┤┘└╜┐í ╝│╕φ╟╥ <directive>LogFormat</directive>
  372.     ┴÷╜├╛ε╖╬ ╣╠╕« ┴ñ└╟╟╤ (╖╬▒╫ ╟ⁿ╜─└╗ ┴÷─¬╟╧┤┬) <var>nickname</var>└╗
  373.     ╗τ┐δ╟╥ ╝÷ └╓┤┘.</p>
  374.  
  375.     <p><directive>LogFormat</directive> ┴÷╜├╛ε└╟ ╡╬╣°┬░ ╟ⁿ╜─└║
  376.     <var>format</var>░· <var>nickname</var>└╗ ┐¼░ß╟╤┤┘. ▒╫╖»╕Θ
  377.     ╡┌┐í╝¡ ╗τ┐δ╟╧┤┬ <directive>LogFormat</directive>└╠│¬ <directive
  378.     module="mod_log_config">CustomLog</directive> ┴÷╜├╛ε┐í ╣▌║╣╟╪╝¡
  379.     ╟ⁿ╜─ ╣«└┌┐¡└╗ ╕≡╡╬ └╘╖┬╟╧┤┬ ┤δ╜┼ <var>nickname</var>└╗ ╗τ┐δ╟╥
  380.     ╝÷ └╓┤┘. ║░─¬└╗ ┴ñ└╟╟╧┤┬ <directive>LogFormat</directive>
  381.     ┴÷╜├╛ε┤┬ <strong>└╠ ┐▄┐í┤┬ ╛╞╣½ ▒Γ┤╔└╗ ╟╧┴÷ ╛╩┤┬┤┘</strong>.
  382.     ┴∩, ║░─¬<em>╕╕</em>└╗ ┴ñ└╟╟╧╕τ, ╜╟┴ª╖╬ ╟ⁿ╜─└╗ └√┐δ╟╧░┼│¬
  383.     ╟ⁿ╜─└╗ ▒Γ║╗░¬└╕╖╬ ╕╕╡Θ┴÷ ╛╩┤┬┤┘. ▒╫╖»╣╟╖╬ ┤┘└╜┐í │¬┐└┤┬
  384.     <directive module="mod_log_config">TransferLog</directive>
  385.     ┴÷╜├╛ε┐í ┐╡╟Γ└╗ ┴╓┴÷ ╛╩┤┬┤┘. ╢╟,
  386.     <directive>LogFormat</directive>└║ ║░─¬└╕╖╬ ┤┘╕Ñ ║░─¬└╗
  387.     ┴ñ└╟╟╥ ╝÷ └╓┤┘. ║░─¬ └╠╕º┐í┤┬ ╞█╝╛╞« ▒Γ╚ú(<code>%</code>)╕ª
  388.     ╗τ┐δ╟╥ ╝÷ ╛°└╜└╗ ┴╓└╟╟╧╢≤.</p>
  389.  
  390.     <example><title>┐╣┴ª</title>
  391.       LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common
  392.     </example>
  393. </usage>
  394. </directivesynopsis>
  395.  
  396. <directivesynopsis>
  397. <name>TransferLog</name>
  398. <description>╖╬▒╫╞─└╧ └º─í╕ª ╝│┴ñ╟╤┤┘</description>
  399. <syntax>TransferLog <var>file</var>|<var>pipe</var></syntax>
  400. <contextlist><context>server config</context><context>virtual host</context>
  401. </contextlist>
  402.  
  403. <usage>
  404.     <p>└╠ ┴÷╜├╛ε┤┬ <directive
  405.     module="mod_log_config">CustomLog</directive> ┴÷╜├╛ε┐═ ╛╞▒╘╕╒╞«┐═
  406.     ▒Γ┤╔└╠ ║±╜┴╟╧┴÷╕╕, ╖╬▒╫ ╟ⁿ╜─└╗ ┴≈┴ó ┴÷┴ñ╟╧░┼│¬ ┐Σ├╗└╗ ┴╢░╟┐í
  407.     ╡√╢≤ ╖╬▒╫┐í │▓▒µ ╝÷ ╛°┤┘. ┤δ╜┼ ░í└σ ├╓▒┘ ╗τ┐δ╟╤ (║░─¬└╗
  408.     ┴ñ└╟╟╧┴÷ ╛╩└║) <directive
  409.     module="mod_log_config">LogFormat</directive> ┴÷╜├╛ε░í ┴÷┴ñ╟╤
  410.     ╖╬▒╫ ╟ⁿ╜─└╗ ╗τ┐δ╟╤┤┘. ╣╠╕« ╟ⁿ╜─└╗ ┴÷┴ñ╟╧┴÷ ╛╩╛╥┤┘╕Θ Common
  411.     Log Format└╗ ╗τ┐δ╟╤┤┘.</p>
  412.  
  413.     <example><title>┐╣┴ª</title>
  414.       LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""<br />
  415.       TransferLog logs/access_log
  416.     </example>
  417. </usage>
  418. </directivesynopsis>
  419.  
  420. </modulesynopsis>
  421.