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