granicus.if.org Git - apache/blob - docs/manual/mod/mod_dumpio.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_dumpio - Apache HTTP Server</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  16 <p class="apache">Apache HTTP Server Version 2.3</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Apache Module mod_dumpio</h1>
  23 <div class="toplang">
  24 <p><span>Available Languages: </span><a href="../en/mod/mod_dumpio.html" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../ja/mod/mod_dumpio.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
  26 </div>
  27 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Dumps all I/O to error log as desired.</td></tr>
  28 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  29 <tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>dumpio_module</td></tr>
  30 <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_dumpio.c</td></tr></table>
  31 <h3>Summary</h3>
  32
  33     <p><code>mod_dumpio</code> allows for the logging of
  34     all input received by Apache and/or all output sent by
  35     Apache to be logged (dumped) to the error.log file.
  36     </p>
  37
  38     <p>The data logging is done right after SSL decoding (for
  39     input) and right before SSL encoding (for output). As can
  40     be expected, this can produce extreme volumes of data,
  41     and should only be used when debugging problems.</p>
  42 </div>
  43 <div id="quickview"><h3 class="directives">Directives</h3>
  44 <ul id="toc">
  45 <li><img alt="" src="../images/down.gif" /> <a href="#dumpioinput">DumpIOInput</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#dumpiologlevel">DumpIOLogLevel</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#dumpiooutput">DumpIOOutput</a></li>
  48 </ul>
  49 <h3>Topics</h3>
  50 <ul id="topics">
  51 <li><img alt="" src="../images/down.gif" /> <a href="#enable">Enabling dumpio Support</a></li>
  52 </ul></div>
  53 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  54 <div class="section">
  55 <h2><a name="enable" id="enable">Enabling dumpio Support</a></h2>
  56
  57
  58     <p>To enable the module, it should be compiled and
  59     loaded in to your running Apache configuration. Logging
  60     can then be enabled or disabled via the below directives.</p>
  61 </div>
  62 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  63 <div class="directive-section"><h2><a name="DumpIOInput" id="DumpIOInput">DumpIOInput</a> <a name="dumpioinput" id="dumpioinput">Directive</a></h2>
  64 <table class="directive">
  65 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dump all input data to the error log</td></tr>
  66 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DumpIOInput On|Off</code></td></tr>
  67 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DumpIOInput Off</code></td></tr>
  68 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
  69 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  70 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dumpio</td></tr>
  71 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>DumpIOInput is only available in Apache 2.1.3 and
  72 later.</td></tr>
  73 </table>
  74     <p>Enable dumping of all input.</p>
  75
  76     <div class="example"><h3>Example</h3><p><code>
  77       DumpIOInput On
  78     </code></p></div>
  79
  80 </div>
  81 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  82 <div class="directive-section"><h2><a name="DumpIOLogLevel" id="DumpIOLogLevel">DumpIOLogLevel</a> <a name="dumpiologlevel" id="dumpiologlevel">Directive</a></h2>
  83 <table class="directive">
  84 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the logging level of the DumpIO output</td></tr>
  85 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DumpIOLogLevel <var>level</var></code></td></tr>
  86 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DumpIOLogLevel debug</code></td></tr>
  87 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
  88 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  89 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dumpio</td></tr>
  90 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>DumpIOLogLevel is only available in Apache 2.2.4 and
  91 later.</td></tr>
  92 </table>
  93     <p>Enable dumping of all output at a specific <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> level.</p>
  94
  95     <div class="example"><h3>Example</h3><p><code>
  96       DumpIOLogLevel notice
  97     </code></p></div>
  98
  99     <div class="note"><h3>Compatibility</h3>Prior to 2.2.4 <code class="module"><a href="../mod/mod_dumpio.html">mod_dumpio</a></code>
 100     would only dump to the log when <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> was set to <code>debug</code></div>
 101
 102 </div>
 103 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 104 <div class="directive-section"><h2><a name="DumpIOOutput" id="DumpIOOutput">DumpIOOutput</a> <a name="dumpiooutput" id="dumpiooutput">Directive</a></h2>
 105 <table class="directive">
 106 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dump all output data to the error log</td></tr>
 107 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DumpIOOutput On|Off</code></td></tr>
 108 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DumpIOOutput Off</code></td></tr>
 109 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
 110 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 111 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dumpio</td></tr>
 112 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>DumpIOOutput is only available in Apache 2.1.3 and
 113 later.</td></tr>
 114 </table>
 115     <p>Enable dumping of all output.</p>
 116
 117     <div class="example"><h3>Example</h3><p><code>
 118       DumpIOOutput On
 119     </code></p></div>
 120
 121 </div>
 122 </div>
 123 <div class="bottomlang">
 124 <p><span>Available Languages: </span><a href="../en/mod/mod_dumpio.html" title="English">&nbsp;en&nbsp;</a> |
 125 <a href="../ja/mod/mod_dumpio.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
 126 </div><div id="footer">
 127 <p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 128 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
 129 </body></html>