mod_dumpio.xml revision ee5db395bc3723609919edfa96af387eea37c491
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<?xml version="1.0"?>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<!-- $LastChangedRevision: 106803 $ -->
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<!--
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder Copyright 2002-2004 The Apache Software Foundation
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder Licensed under the Apache License, Version 2.0 (the "License");
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder you may not use this file except in compliance with the License.
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder You may obtain a copy of the License at
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder http://www.apache.org/licenses/LICENSE-2.0
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder Unless required by applicable law or agreed to in writing, software
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder distributed under the License is distributed on an "AS IS" BASIS,
3ab1e7a18f3fc3eb004464bc54b7df4483f1f060Christian Maeder WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder See the License for the specific language governing permissions and
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder limitations under the License.
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder-->
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<modulesynopsis metafile="mod_dumpio.xml.meta">
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<name>mod_dumpio</name>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<description>Dumps all I/O to error log as desired.</description>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<status>Extension</status>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<sourcefile>mod_dumpio.c</sourcefile>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<identifier>dumpio_module</identifier>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<summary>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder <p><code>mod_dumpio</code> allows for the logging of
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder all input received by Apache and/or all output sent by
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder Apache to be logged (dumped) to the error.log file.
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder </p>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder <p>The data logging is done right after SSL decoding (for
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder input) and right before SSL encoding (for output). As can
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder be expected, this can produce extreme volumes of data,
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder and should only be used when debugging problems.</p>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder</summary>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
479da8506f391abe070ced2fb93c9759a280fa68Christian Maeder<section id="enable">
479da8506f391abe070ced2fb93c9759a280fa68Christian Maeder <title>Enabling dumpio Support</title>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder <p>To enable the module, it should be compiled and
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder loaded in to your running Apache configuration. Logging
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder can then be enabled or disabled via the below directives.</p>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder</section>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<directivesynopsis>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<name>DumpIOInput</name>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<description>Dump all input data to the error log</description>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<syntax>DumpIOInput On|Off</syntax>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<default>DumpIOInput Off</default>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<contextlist><context>server config</context></contextlist>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<compatibility>DumpIOInput is only available in Apache 2.1.3 and
0015e1756b734b34d4b550318c078f9a0c585611Christian Maederlater.</compatibility>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<usage>
479da8506f391abe070ced2fb93c9759a280fa68Christian Maeder <p>Enable dumping of all input.</p>
c4a8059d0469a85bb58c28ac66729ac19d743d3cChristian Maeder
479da8506f391abe070ced2fb93c9759a280fa68Christian Maeder <example><title>Example</title>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder DumpIOInput On
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder </example>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder</usage>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder</directivesynopsis>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<directivesynopsis>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<name>DumpIOOutput</name>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<description>Dump all output data to the error log</description>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<syntax>DumpIOOutput On|Off</syntax>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<default>DumpIOOutput Off</default>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder<contextlist><context>server config</context></contextlist>
c4a8059d0469a85bb58c28ac66729ac19d743d3cChristian Maeder<compatibility>DumpIOOutput is only available in Apache 2.1.3 and
c4a8059d0469a85bb58c28ac66729ac19d743d3cChristian Maederlater.</compatibility>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<usage>
c4a8059d0469a85bb58c28ac66729ac19d743d3cChristian Maeder <p>Enable dumping of all output.</p>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder <example><title>Example</title>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder DumpIOOutput On
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder </example>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder</usage>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder</directivesynopsis>
479da8506f391abe070ced2fb93c9759a280fa68Christian Maeder</modulesynopsis>
479da8506f391abe070ced2fb93c9759a280fa68Christian Maeder