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" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p> 19<p class="apache">Apache HTTP Server Version 2.2</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.2</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Apache Module mod_dumpio</h1> 26<div class="toplang"> 27<p><span>Available Languages: </span><a href="/en/mod/mod_dumpio.html" title="English"> en </a> | 28<a href="/ja/mod/mod_dumpio.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> 29</div> 30<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> 31<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr> 32<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>dumpio_module</td></tr> 33<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_dumpio.c</td></tr></table> 34<h3>Summary</h3> 35 36 <p><code>mod_dumpio</code> allows for the logging of 37 all input received by Apache and/or all output sent by 38 Apache to be logged (dumped) to the error.log file. 39 </p> 40 41 <p>The data logging is done right after SSL decoding (for 42 input) and right before SSL encoding (for output). As can 43 be expected, this can produce extreme volumes of data, 44 and should only be used when debugging problems.</p> 45</div> 46<div id="quickview"><h3 class="directives">Directives</h3> 47<ul id="toc"> 48<li><img alt="" src="/images/down.gif" /> <a href="#dumpioinput">DumpIOInput</a></li> 49<li><img alt="" src="/images/down.gif" /> <a href="#dumpiologlevel">DumpIOLogLevel</a></li> 50<li><img alt="" src="/images/down.gif" /> <a href="#dumpiooutput">DumpIOOutput</a></li> 51</ul> 52<h3>Topics</h3> 53<ul id="topics"> 54<li><img alt="" src="/images/down.gif" /> <a href="#enable">Enabling dumpio Support</a></li> 55</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> 56<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 57<div class="section"> 58<h2><a name="enable" id="enable">Enabling dumpio Support</a></h2> 59 60 61 <p>To enable the module, it should be compiled and 62 loaded in to your running Apache configuration. Logging 63 can then be enabled or disabled via the below directives.</p> 64</div> 65<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 66<div class="directive-section"><h2><a name="DumpIOInput" id="DumpIOInput">DumpIOInput</a> <a name="dumpioinput" id="dumpioinput">Directive</a></h2> 67<table class="directive"> 68<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dump all input data to the error log</td></tr> 69<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DumpIOInput On|Off</code></td></tr> 70<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DumpIOInput Off</code></td></tr> 71<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> 72<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr> 73<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dumpio</td></tr> 74<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>DumpIOInput is only available in Apache 2.1.3 and 75later.</td></tr> 76</table> 77 <p>Enable dumping of all input.</p> 78 79 <div class="example"><h3>Example</h3><p><code> 80 DumpIOInput On 81 </code></p></div> 82 83</div> 84<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 85<div class="directive-section"><h2><a name="DumpIOLogLevel" id="DumpIOLogLevel">DumpIOLogLevel</a> <a name="dumpiologlevel" id="dumpiologlevel">Directive</a></h2> 86<table class="directive"> 87<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the logging level of the DumpIO output</td></tr> 88<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DumpIOLogLevel <var>level</var></code></td></tr> 89<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DumpIOLogLevel debug</code></td></tr> 90<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> 91<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr> 92<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dumpio</td></tr> 93<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>DumpIOLogLevel is only available in Apache 2.2.4 and 94later.</td></tr> 95</table> 96 <p>Enable dumping of all output at a specific <code class="directive"><a href="/mod/core.html#loglevel">LogLevel</a></code> level.</p> 97 98 <div class="example"><h3>Example</h3><p><code> 99 DumpIOLogLevel notice 100 </code></p></div> 101 102 <div class="note"><h3>Compatibility</h3>Prior to 2.2.4 <code class="module"><a href="/mod/mod_dumpio.html">mod_dumpio</a></code> 103 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> 104 105</div> 106<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 107<div class="directive-section"><h2><a name="DumpIOOutput" id="DumpIOOutput">DumpIOOutput</a> <a name="dumpiooutput" id="dumpiooutput">Directive</a></h2> 108<table class="directive"> 109<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dump all output data to the error log</td></tr> 110<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DumpIOOutput On|Off</code></td></tr> 111<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DumpIOOutput Off</code></td></tr> 112<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> 113<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr> 114<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dumpio</td></tr> 115<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>DumpIOOutput is only available in Apache 2.1.3 and 116later.</td></tr> 117</table> 118 <p>Enable dumping of all output.</p> 119 120 <div class="example"><h3>Example</h3><p><code> 121 DumpIOOutput On 122 </code></p></div> 123 124</div> 125</div> 126<div class="bottomlang"> 127<p><span>Available Languages: </span><a href="/en/mod/mod_dumpio.html" title="English"> en </a> | 128<a href="/ja/mod/mod_dumpio.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> 129</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 130<script type="text/javascript"><!--//--><![CDATA[//><!-- 131var comments_shortname = 'httpd'; 132var comments_identifier = 'http://httpd.apache.org/docs/2.2/mod/mod_dumpio.html'; 133(function(w, d) { 134 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 135 d.write('<div id="comments_thread"><\/div>'); 136 var s = d.createElement('script'); 137 s.type = 'text/javascript'; 138 s.async = true; 139 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 140 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 141 } 142 else { 143 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 144 } 145})(window, document); 146//--><!]]></script></div><div id="footer"> 147<p class="apache">Copyright 2013 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> 148<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 149if (typeof(prettyPrint) !== 'undefined') { 150 prettyPrint(); 151} 152//--><!]]></script> 153</body></html>