mod_dumpio.xml revision 30db430cb6aaf0c9c3c1bfe1a6c7ddb7ef8a4efc
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<?xml version="1.0"?>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
bc8fd1b0b1afdf89b8d28eefa8cd74e26ba97986fielding<!-- $LastChangedRevision$ -->
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<!--
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding Licensed to the Apache Software Foundation (ASF) under one or more
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding contributor license agreements. See the NOTICE file distributed with
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding this work for additional information regarding copyright ownership.
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding The ASF licenses this file to You under the Apache License, Version 2.0
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding (the "License"); you may not use this file except in compliance with
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding the License. You may obtain a copy of the License at
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding http://www.apache.org/licenses/LICENSE-2.0
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding Unless required by applicable law or agreed to in writing, software
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding distributed under the License is distributed on an "AS IS" BASIS,
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding See the License for the specific language governing permissions and
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding limitations under the License.
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding-->
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<modulesynopsis metafile="mod_dumpio.xml.meta">
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<name>mod_dumpio</name>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<description>Dumps all I/O to error log as desired.</description>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<status>Extension</status>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<sourcefile>mod_dumpio.c</sourcefile>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<identifier>dumpio_module</identifier>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<summary>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding <p><code>mod_dumpio</code> allows for the logging of
64185f9824e42f21ca7b9ae6c004484215c031a7rbb all input received by Apache and/or all output sent by
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding Apache to be logged (dumped) to the error.log file.
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding </p>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding <p>The data logging is done right after SSL decoding (for
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding input) and right before SSL encoding (for output). As can
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding be expected, this can produce extreme volumes of data,
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding and should only be used when debugging problems.</p>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding</summary>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<section id="enable">
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding <title>Enabling dumpio Support</title>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding <p>To enable the module, it should be compiled and
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding loaded in to your running Apache configuration. Logging
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding can then be enabled or disabled via the below directives.</p>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding</section>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<directivesynopsis>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<name>DumpIOInput</name>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<description>Dump all input data to the error log</description>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<syntax>DumpIOInput On|Off</syntax>
ab2c1c1c83ec91415565da5a71fbc15d9685caa6fielding<default>DumpIOInput Off</default>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<contextlist><context>server config</context></contextlist>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<compatibility>DumpIOInput is only available in Apache 2.1.3 and
0f081398cf0eef8cc7c66a535d450110a92dc8aefieldinglater.</compatibility>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<usage>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding <p>Enable dumping of all input.</p>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding <example><title>Example</title>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding DumpIOInput On
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding </example>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald</usage>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald
dc80439e9fba60c753cd145cb6799409ffea9b71ronald</directivesynopsis>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<directivesynopsis>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<name>DumpIOOutput</name>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<description>Dump all output data to the error log</description>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<syntax>DumpIOOutput On|Off</syntax>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<default>DumpIOOutput Off</default>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<contextlist><context>server config</context></contextlist>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<compatibility>DumpIOOutput is only available in Apache 2.1.3 and
0f081398cf0eef8cc7c66a535d450110a92dc8aefieldinglater.</compatibility>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<usage>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald <p>Enable dumping of all output.</p>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald
dc80439e9fba60c753cd145cb6799409ffea9b71ronald <example><title>Example</title>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding DumpIOOutput On
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding </example>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald</usage>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald
dc80439e9fba60c753cd145cb6799409ffea9b71ronald</directivesynopsis>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald
dc80439e9fba60c753cd145cb6799409ffea9b71ronald<directivesynopsis>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald
dc80439e9fba60c753cd145cb6799409ffea9b71ronald<name>DumpIOLogLevel</name>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald<description>Controls the logging level of the DumpIO output</description>
dc80439e9fba60c753cd145cb6799409ffea9b71ronald<syntax>DumpIOLogLevel <var>level</var></syntax>
c7d0205ec1649076e7742d72a25ac53779768312stoddard<default>DumpIOLogLevel debug</default>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<contextlist><context>server config</context></contextlist>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding<compatibility>DumpIOLogLevel is only available in Apache 2.3.x and
b980ad7fdc218b4855cde9f75a747527f50c554dwrowelater.</compatibility>
b980ad7fdc218b4855cde9f75a747527f50c554dwrowe
694e8dc146faadc46b2455f3bd0998121fc76c5drbb<usage>
c7d0205ec1649076e7742d72a25ac53779768312stoddard <p>Enable dumping of all output at a specific <directive
c7d0205ec1649076e7742d72a25ac53779768312stoddard module="core">LogLevel</directive> level.</p>
29c30db45f6a469017e16b606611e460cc1a1f2caaron
032b8a34c3911bbc5ad5385ca40af65af273bff9wrowe <example><title>Example</title>
e33b627b40578d0166fdb79ce0487f9e46586befgstein DumpIOLogLevel notice
cd9f429ff62d134cdf6ec903c33430c5ebae12f0trawick </example>
cd9f429ff62d134cdf6ec903c33430c5ebae12f0trawick</usage>
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding
e33b627b40578d0166fdb79ce0487f9e46586befgstein</directivesynopsis>
e33b627b40578d0166fdb79ce0487f9e46586befgstein</modulesynopsis>
e33b627b40578d0166fdb79ce0487f9e46586befgstein