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 / F278304_mod_file_cache.xml.ko < prev    next >
Extensible Markup Language  |  2004-07-09  |  8KB  |  190 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.3.2.5 -->
  5.  
  6. <!--
  7.  Copyright 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_file_cache.xml.meta">
  23.  
  24. <name>mod_file_cache</name>
  25. <description>╕▐╕≡╕«┐í ┴ñ└√ ╞─└╧╡Θ└╗ ─│╜¼</description>
  26. <status>Experimental</status>
  27. <sourcefile>mod_file_cache.c</sourcefile>
  28. <identifier>file_cache_module</identifier>
  29.  
  30. <summary>
  31.  
  32.     <note type="warning">
  33.       └╠ ╕≡╡Γ└║ ┴╢╜╔╟╪╝¡ ╗τ┐δ╟╪╛▀ ╟╤┤┘. <module>mod_file_cache</module>╕ª
  34.       ╗τ┐δ╟╧┐⌐ ╗τ└╠╞«╕ª ╛√╕┴└╕╖╬ ╕╕╡Θ▒Γ ╜▒▒Γ╢º╣«┐í └╠ ╣«╝¡╕ª
  35.       ▓─▓─╚≈ └╨▒µ ╣┘╢⌡┤┘.
  36.     </note>
  37.  
  38.     <p>░┼└╟ ║»╟╧┴÷ ╛╩░φ └┌┴╓ ┐Σ├╗╡╟┤┬ ╞─└╧└╗ <em>─│╜¼</em>┐í
  39.     └·└σ╟╧┐⌐ ╝¡╣÷ ║╬╟╧╕ª ┴┘└╧ ╝÷ └╓┤┘. <module>mod_file_cache</module>┤┬
  40.     └┌┴╓ ┐Σ├╗╡╟┤┬ <em>┴ñ└√</em> ╞─└╧└╗ ╡╬░í┴÷ ╣µ╜─└╕╖╬ ─│╜¼┐í
  41.     └·└σ╟╤┤┘. ╝│┴ñ ┴÷╜├╛ε╕ª ╗τ┐δ╟╧┐⌐ <module>mod_file_cache</module>░í
  42.     ╞─└╧└╗ ┐¡░φ(open) <code>mmap()</code>╟╥┴÷ ╛╞┤╧╕Θ ╞─└╧└╗
  43.     ┐¡░φ <em>╞─└╧ ╟┌╡Θ</em>└╗ └·└σ╟╥┴÷ ░ß┴ñ╟╤┤┘. ╡╬ ╣µ╜─ ╕≡╡╬
  44.     ╞─└╧└╗ ╝¡║±╜║╟╧▒Γ└º╟╪ ╟╩┐Σ╟╤ └█╛≈└╟ └╧║╬╕ª (╞»╚≈ ╞─└╧ └╘├Γ╖┬
  45.     └█╛≈) ╞─└╧└╗ ┐Σ├╗╟╥ ╢º╕╢┤┘ ╕┼╣° ╟╧┤┬ ┤δ╜┼ ╝¡╣÷░í ╜├└█╟╥╢º
  46.     ╟╤╣°╕╕ ╟╧┐⌐ ╝¡╣÷ ║╬╟╧░í ░¿╝╥╟╤┤┘.</p>
  47.  
  48.     <p>┴╓└╟: └╠ ╣µ╣²└║ CGI ╟┴╖╬▒╫╖Ñ└╠│¬ ╞»║░╟╤ │╗┐δ╟┌╡Θ╖»╕ª
  49.     ┼δ╟╪ ╝¡║±╜║╟╧┤┬ ╞─└╧└╟ ╝¡║±╜║ ╝╙╡╡╕ª │⌠└╧ ╝÷ ╛°┤┘. └╠ ╣µ╣²└║
  50.     ║╕┼δ ╛╞╞──í core │╗┐δ╟┌╡Θ╖»░í ╝¡║±╜║╟╧┤┬ └╧╣▌╞─└╧┐í╕╕
  51.     └√┐δ╡╚┤┘.</p>
  52.  
  53.     <p>└╠ ╕≡╡Γ└║ ╛╞╞──í 1.3┐í └╓┤┬ <code>mod_mmap_static</code>
  54.     ╕≡╡Γ└╟ ▒Γ┤╔└╗ ╚«└σ╟╤ ░ß░·┤┘.</p>
  55. </summary>
  56.  
  57. <section id="using"><title>mod_file_cache ╗τ┐δ╟╧▒Γ</title>
  58.  
  59.     <p><module>mod_file_cache</module>┤┬ ┴╓╝¡╣÷ ╝│┴ñ┐í╝¡ <directive
  60.     module="mod_file_cache">MMapFile</directive>░· <directive
  61.     module="mod_file_cache">CacheFile</directive> ┴÷╜├╛ε╕ª ╗τ┐δ╟╧┐⌐
  62.     ╝│┴ñ╟╤ ┴ñ└√ ╞─└╧╡Θ└╗ ─│╜¼┐í └·└σ╟╤┤┘.</p>
  63.  
  64.     <p>╕≡╡τ ╟├╖í╞√└╠ ╡╬ ┴÷╜├╛ε╕ª ╕≡╡╬ ┴÷┐°╟╧┤┬ ░═└║ ╛╞┤╧┤┘.
  65.     ┐╣╕ª ╡Θ╛ε, └⌐╡╡┐∞┴ε┐δ ╛╞╞──í┤┬ ╟÷└τ <directive
  66.     module="mod_file_cache">MMapStatic</directive> ┴÷╜├╛ε╕ª
  67.     ┴÷┐°╟╧┴÷ ╛╩┴÷╕╕, AIX ░░└║ ┤┘╕Ñ ╟├╖í╞√└║ ╡╤ ╕≡╡╬╕ª ┴÷┐°╟╤┤┘.
  68.     ┴÷┐°╟╧┴÷╛╩┤┬ ┴÷╜├╛ε╕ª ╗τ┐δ╟╥ ░µ┐∞ ╝¡╣÷ ┐└╖∙ ╖╬▒╫┐í ┐└╖∙╣«└╗
  69.     │▓▒Σ┤┘. ┴÷┐°╟╧┴÷╛╩┤┬ ┴÷╜├╛ε╕ª ╗τ┐δ╟╪╡╡ ╝¡╣÷┤┬ ╡┐└█╟╧┴÷╕╕
  70.     ╞─└╧└╗ ─│╜¼┐í └·└σ╟╧┴÷ ╛╩┤┬┤┘. ╡╬ ┴÷╜├╛ε╕ª ╕≡╡╬ ┴÷┐°╟╧┤┬
  71.     ╟├╖í╞√└╗ ╗τ┐δ╟╤┤┘╕Θ ╛ε╢▓ ╣µ╜─└╠ ┤⌡ ┴┴└║┴÷ ╜╟╟Φ╟╪║╕╢≤.</p>
  72.  
  73.     <section><title>MMapFile ┴÷╜├╛ε</title>
  74.  
  75.       <p><module>mod_file_cache</module>└╟ <directive
  76.       module="mod_file_cache">MMapFile</directive> ┴÷╜├╛ε┤┬
  77.       ╝│┴ñ╟╤ ┴ñ└√ ╞─└╧╡Θ└╗ <code>mmap()</code> ╜├╜║┼█╚ú├Γ└╗
  78.       ╗τ┐δ╟╧┐⌐ ╕▐╕≡╕«┐í ┤δ└└╟╤┤┘. ├╓╜┼ └»┤╨╜║╖∙ ┐ε┐╡├╝┴ª╢≤╕Θ
  79.       ║╕┼δ └╠ ╜├╜║┼█╚ú├Γ└╠ └╓┴÷╕╕, ╛°┤┬ ┐ε┐╡├╝┴ª╡╡ └╓┤┘. ╢╟,
  80.       <code>mmap()</code>╟╥ ╝÷ └╓┤┬ ╞─└╧ ┼⌐▒Γ┐═ ░│╝÷╕ª ╜├╜║┼█└╠
  81.       ┴ª╟╤╟╥ ╝÷ └╓└╕╣╟╖╬ ╣╠╕« ╜╟╟Φ╟╪║╕┤┬ ░═└╠ ┴┴┤┘.</p>
  82.  
  83.       <p>╝¡╣÷┤┬ ╜├└█╟╥╢º┐═ └τ╜├└█╟╥╢º╕╕ <code>mmap()</code>╟╤┤┘.
  84.       ▒╫╖í╝¡ ╞─└╧╜├╜║┼█┐í╝¡ ╟╪┤τ ╞─└╧┴▀ ╟╧│¬╢≤╡╡ ║»░µ╡╟╕Θ ╝¡╣÷╕ª
  85.       └τ╜├└█<em>╟╪╛▀</em> ╟╤┤┘ (<a href="../stopping.html">┴▀┤▄░·
  86.       └τ╜├└█</a> ╣«╝¡ ┬ⁿ░φ). ┤┘╜├ ╕╗╟╪╝¡ ╞─└╧└╠ ║»░µ╡╟╛·┤┬╡Ñ
  87.       ╝¡╣÷╕ª └τ╜├└█╟╧┴÷ ╛╩└╕╕Θ ┐╧└ⁿ╚≈ └╠╗≤╟╧░╘ ┐Σ├╗└╗ ╝¡║±╜║╟╥┴÷╡╡
  88.       ╕≡╕Ñ┤┘. └╠└ⁿ ╞─└╧└╗ ┴÷┐∞░φ(unlink) ▒╫ └┌╕«┐í ╗⌡╖╬┐ε ╞─└╧└╗
  89.       ╕╕╡Θ┤┬ ╣µ╜─└╕╖╬ ╞─└╧└╗ ╝÷┴ñ╟╪╛▀ ╟╤┤┘. <code>rdist</code>│¬
  90.       <code>mv</code>┐═ ░░└║ ┤δ┤┘╝÷└╟ ╡╡▒╕░í └╠╖▒ ╣µ╜─└╕╖╬ ╡┐└█╟╤┤┘.
  91.       ╕┼╣° ├▀░í╖╬ ║╥╟╩┐Σ╟╤ <code>stat()</code> ░╦╗τ░í ╟╩┐Σ╟╧░φ
  92.       └╘├Γ╖┬ ░¿╝╥╢≤┤┬ ┐°╖í └╟╡╡┐í ╣▌╟╧▒Γ╢º╣«┐í └╠ ╕≡╡Γ└║ ╞─└╧└╟
  93.       ║»╚¡╕ª ╣½╜├╟╤┤┘.</p>
  94.     </section>
  95.  
  96.     <section><title>CacheFile ┴÷╜├╛ε</title>
  97.  
  98.       <p><module>mod_file_cache</module>└╟ <directive
  99.       module="mod_file_cache">CacheFile</directive> ┴÷╜├╛ε┤┬
  100.       ╝│┴ñ ┴÷╜├╛ε┐í ┐¡░┼╟╤ ╞─└╧(░· ╞─└╧╡Θ)└╗ ┐¡╛ε╝¡ ╞─└╧└╟
  101.       <em>╟┌╡Θ(handle)</em> ╚ñ└║ <em>╞─└╧ ▒Γ╝·└┌(file descriptor)</em>╕ª
  102.       ─│╜¼┐í └·└σ╟╤┤┘. ╞─└╧└╗ ┐Σ├╗╟╧╕Θ ╝¡╣÷┤┬ ─│╜¼┐í╝¡ ╟┌╡Θ└╗
  103.       ├ú╛╞╝¡ ╝╥─╧ API <code>sendfile()</code>┐í (└⌐╡╡┐∞┴ε┐í╝¡┤┬
  104.       <code>TransmitFile()</code>) │╤▒Σ┤┘.</p>
  105.  
  106.       <!-- XXX
  107.       <p>Insert more details about sendfile API...</p>
  108.       -->
  109.  
  110.       <p>╝¡╣÷┤┬ ╜├└█╟╥╢º┐═ └τ╜├└█╟╥╢º╕╕ ╞─└╧ ╟┌╡Θ└╗ ─│╜¼╟╤┤┘.
  111.       ▒╫╖í╝¡ ╞─└╧╜├╜║┼█┐í╝¡ ─│╜¼╟╤ ╞─└╧┴▀ ╟╧│¬╢≤╡╡ ║»░µ╡╟╕Θ
  112.       ╝¡╣÷╕ª └τ╜├└█<em>╟╪╛▀</em> ╟╤┤┘ (<a
  113.       href="../stopping.html">┴▀┤▄░· └τ╜├└█</a> ╣«╝¡ ┬ⁿ░φ).
  114.       ┤┘╜├ ╕╗╟╪╝¡ ╞─└╧└╠ ║»░µ╡╟╛·┤┬╡Ñ ╝¡╣÷╕ª └τ╜├└█╟╧┴÷ ╛╩└╕╕Θ
  115.       ┐╧└ⁿ╚≈ └╠╗≤╟╧░╘ ┐Σ├╗└╗ ╝¡║±╜║╟╥┴÷╡╡ ╕≡╕Ñ┤┘. └╠└ⁿ ╞─└╧└╗
  116.       ┴÷┐∞░φ(unlink) ▒╫ └┌╕«┐í ╗⌡╖╬┐ε ╞─└╧└╗ ╕╕╡σ┤┬ ╣µ╜─└╕╖╬
  117.       ╞─└╧└╗ ╝÷┴ñ╟╪╛▀ ╟╤┤┘. <code>rdist</code>│¬ <code>mv</code>┐═
  118.       ░░└║ ┤δ┤┘╝÷└╟ ╡╡▒╕░í └╠╖▒ ╣µ╜─└╕╖╬ ╡┐└█╟╤┤┘.</p>
  119.     </section>
  120.  
  121.     <note><title>┴╓└╟</title>
  122.       <p>╡≡╖║┼Σ╕«└╟ ╕≡╡τ ╞─└╧└╗ └τ▒═└√└╕╖╬ ─│╜¼┐í └·└σ╟╧┤┬ ┴÷╜├╛ε┤┬
  123.       ╛°┤┘. ┤δ╜┼ ┤┘└╜░· ░░└╠ ╟╪║╕╢≤... <directive
  124.       module="core">Include</directive> ┴÷╜├╛ε╕ª ┬ⁿ░φ╟╧┐⌐ ┤┘└╜░·
  125.       ░░└║ ╕φ╖╔╛ε╕ª ╜╟╟α╟╤┤┘:</p>
  126.  
  127.       <example>
  128.         find /www/htdocs -type f -print \<br />
  129.         | sed -e 's/.*/mmapfile &/' > /www/conf/mmap.conf
  130.       </example>
  131.     </note>
  132. </section>
  133.  
  134. <directivesynopsis>
  135. <name>MMapFile</name>
  136. <description>╜├└█╜├ ┐⌐╖» ╞─└╧└╗ ╕▐╕≡╕«┐í ┤δ└└╟╤┤┘</description>
  137. <syntax>MMapFile <var>file-path</var> [<var>file-path</var>] ...</syntax>
  138. <contextlist><context>server config</context></contextlist>
  139.  
  140. <usage>
  141.     <p><directive>MMapFile</directive> ┴÷╜├╛ε┤┬ ╝¡╣÷░í ╜├└█╟╥╢º
  142.     (░°╣Θ└╕╖╬ ▒╕║╨╟╤ ╛╞▒╘╕╒╞«╖╬ ┴÷┴ñ╟╤) ┐⌐╖» ╞─└╧└╗ ╕▐╕≡╕«┐í
  143.     ┤δ└└╟╤┤┘(map). ╝¡╣÷ ┴╛╖ß╜├ └┌╡┐└╕╖╬ ┤δ└└└╗ ╟¼┤┘(unmap).
  144.     ╞─└╧╜├╜║┼█┐í╝¡ ╞─└╧└╠ ║»░µ╡╟╕Θ ╞─└╧╡Θ└╗ ┤┘╜├
  145.     <code>mmap()</code>╟╧▒Γ└º╟╪ ├╓╝╥╟╤ ╝¡╣÷┐í <code>HUP</code>└╠│¬
  146.     <code>USR1</code> ╜├▒╫│╬└╗ ║╕│╗╛▀ ╟╤┤┘.</p>
  147.  
  148.     <p><var>file-path</var> ╛╞▒╘╕╒╞«╕ª ┴╢╜╔╟╪╢≤. ╛╞▒╘╕╒╞«┤┬
  149.     ╛╞╞──í└╟ URL-╞─└╧╕φ ║»╚» ╟┌╡Θ╖»░í ╕╕╡τ ╞─└╧╜├╜║┼█ ░µ╖╬┐═
  150.     ┴ñ╚«╚≈ └╧─í╟╪╛▀ ╟╤┤┘. ╟╤╣° ┤⌡ ║╥╟╩┐Σ╟╤ <code>stat()</code>
  151.     ╜├╜║┼█╚ú├Γ└╠ ╟╩┐Σ╟╧▒Γ╢º╣«┐í inode│¬ ╜╔║╝╕╡┼⌐ <em>╡ε</em>└╗
  152.     ░µ╖╬╕ª ┴÷┴ñ╟╥ ╝÷ ╛°┤┘. └╠ ╕≡╡Γ└║ <module>mod_alias</module>│¬
  153.     <module>mod_rewrite</module>╖╬ └τ└█╝║╟╤ ╞─└╧╕φ└╗ ┤┘╖Ω ╝÷
  154.     └╓▒Γ╡╡ ╛°▒Γ╡╡ ╟╧┤┘.</p>
  155.  
  156.     <example><title>┐╣┴ª</title>
  157.       MMapFile /usr/local/apache/htdocs/index.html
  158.     </example>
  159. </usage>
  160. </directivesynopsis>
  161.  
  162. <directivesynopsis>
  163. <name>CacheFile</name>
  164. <description>╜├└█╜├ ┐⌐╖» ╞─└╧ ╟┌╡Θ└╗ ─│╜¼╟╤┤┘</description>
  165. <syntax>CacheFile <var>file-path</var> [<var>file-path</var>] ...</syntax>
  166. <contextlist><context>server config</context></contextlist>
  167.  
  168. <usage>
  169.     <p><directive>CacheFile</directive> ┴÷╜├╛ε┤┬ ╝¡╣÷░í ╜├└█╟╥╢º
  170.     ┐⌐╖» ╞─└╧└╗ ┐¡░φ(open) ╞─└╧╡Θ└╟ ╟┌╡Θ└╗ ─│╜¼┐í └·└σ╟╤┤┘.
  171.     ╝¡╣÷ ┴╛╖ß╜├ └┌╡┐└╕╖╬ ─│╜¼╟╤ ╞─└╧└╟ ╟┌╡Θ└╗ ┤▌┤┬┤┘(close).
  172.     ╞─└╧╜├╜║┼█┐í╝¡ ╞─└╧└╠ ║»░µ╡╟╕Θ ╞─└╧└╗ ┤┘╜├ ─│╜¼╟╧▒Γ└º╟╪
  173.     ╝¡╣÷╕ª └τ╜├└█╟╪╛▀ ╟╤┤┘.</p>
  174.  
  175.     <p><var>file-path</var> ╛╞▒╘╕╒╞«╕ª ┴╢╜╔╟╪╢≤. ╛╞▒╘╕╒╞«┤┬
  176.     ╛╞╞──í└╟ URL-╞─└╧╕φ ║»╚» ╟┌╡Θ╖»░í ╕╕╡τ ╞─└╧╜├╜║┼█ ░µ╖╬┐═
  177.     ┴ñ╚«╚≈ └╧─í╟╪╛▀ ╟╤┤┘. ╟╤╣° ┤⌡ ║╥╟╩┐Σ╟╤ <code>stat()</code>
  178.     ╜├╜║┼█╚ú├Γ└╠ ╟╩┐Σ╟╧▒Γ╢º╣«┐í inode│¬ ╜╔║╝╕╡┼⌐ <em>╡ε</em>└╗
  179.     ░µ╖╬╕ª ┴÷┴ñ╟╥ ╝÷ ╛°┤┘. └╠ ╕≡╡Γ└║ <module>mod_alias</module>│¬
  180.     <module>mod_rewrite</module>╖╬ └τ└█╝║╟╤ ╞─└╧╕φ└╗ ┤┘╖Ω ╝÷
  181.     └╓▒Γ╡╡ ╛°▒Γ╡╡ ╟╧┤┘.</p>
  182.  
  183.     <example><title>┐╣┴ª</title>
  184.       CacheFile /usr/local/apache/htdocs/index.html
  185.     </example>
  186. </usage>
  187. </directivesynopsis>
  188.  
  189. </modulesynopsis>
  190.