New Module -- mod_logio.

This adds the ability to log the bytes sent and
received for each request

Submitted by:	Bojan Smojver <bojan@rexursive.com>
Reviewed by:	Justin & Ian


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@97000 13f79535-47bb-0310-9956-ffa450edef68

5 files changed, 82 insertions, 1 deletions

diff --git a/docs/conf/httpd-std.conf.in b/docs/conf/httpd-std.conf.in
index be7063cf70..a055fdced8 100644
--- a/docs/conf/httpd-std.conf.in
+++ b/docs/conf/httpd-std.conf.in
@@ -479,6 +479,9 @@ LogFormat "%h %l %u %t \"%r\" %>s %b" common
 LogFormat "%{Referer}i -> %U" referer
 LogFormat "%{User-agent}i" agent
 
+# You need to enable mod_logio.c to use %I and %O
+#LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
+
 #
 # The location and format of the access logfile (Common Logfile Format).
 # If you do not define any access logfiles within a <VirtualHost>
diff --git a/docs/conf/httpd-win.conf b/docs/conf/httpd-win.conf
index 09aeab5a68..0f54df71e2 100644
--- a/docs/conf/httpd-win.conf
+++ b/docs/conf/httpd-win.conf
@@ -406,6 +406,9 @@ LogFormat "%h %l %u %t \"%r\" %>s %b" common
 LogFormat "%{Referer}i -> %U" referer
 LogFormat "%{User-agent}i" agent
 
+# You need to enable mod_logio.c to use %I and %O
+#LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
+
 #
 # The location and format of the access logfile (Common Logfile Format).
 # If you do not define any access logfiles within a <VirtualHost>
diff --git a/docs/manual/mod/mod_log_config.html.en b/docs/manual/mod/mod_log_config.html.en
index a35990ddf5..e2184dd246 100644
--- a/docs/manual/mod/mod_log_config.html.en
+++ b/docs/manual/mod/mod_log_config.html.en
@@ -138,6 +138,16 @@ be in strftime(3) format. (potentially localized)</td></tr>
 this conflicted with the historical ssl %...{var}c syntax.)</div>
 </td></tr>
 
+<tr><td>%...I:</td>          
+<td>Bytes received, including request and headers, cannot be zero. You need to
+enable <code class="module"><a
+href="../mod/mod_logio.html">mod_logio</a></code> to use this.</td></tr>
+
+<tr><td>%...O:</td>          
+<td>Bytes sent, including headers, cannot be zero. You need to enable <code
+class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> to use
+this.</td></tr>
+
 </table>
 
     <p>The "..." can be nothing at all (<em>e.g.</em>, <code>"%h %u
@@ -352,4 +362,4 @@ host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
    TransferLog logs/access_log
 </code></p></div>
 
-</div></div><div id="footer"><p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p><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></body></html>
\ No newline at end of file
+</div></div><div id="footer"><p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p><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></body></html>
diff --git a/docs/manual/mod/mod_log_config.xml b/docs/manual/mod/mod_log_config.xml
index 86fce8d575..b5412c0676 100644
--- a/docs/manual/mod/mod_log_config.xml
+++ b/docs/manual/mod/mod_log_config.xml
@@ -143,6 +143,14 @@ be in strftime(3) format. (potentially localized)</td></tr>
 this conflicted with the historical ssl %...{var}c syntax.)</note>
 </td></tr>
 
+<tr><td>%...I:</td>
+<td>Bytes received, including request and headers, cannot be zero. You need to
+enable <module>mod_logio</module> to use this.</td></tr>
+
+<tr><td>%...O:</td>
+<td>Bytes sent, including headers, cannot be zero. You need to enable
+<module>mod_logio</module> to use this.</td></tr>
+
 </table>
 
     <p>The "..." can be nothing at all (<em>e.g.</em>, <code>"%h %u
diff --git a/docs/manual/mod/mod_logio.xml b/docs/manual/mod/mod_logio.xml
new file mode 100644
index 0000000000..7d1d817082
--- /dev/null
+++ b/docs/manual/mod/mod_logio.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+<modulesynopsis>
+
+<name>mod_logio</name>
+<description>Logging of input and output bytes per request</description>
+<status>Base</status>
+<sourcefile>mod_logio.c</sourcefile>
+<identifier>logio_module</identifier>
+
+<summary>
+
+    <p>This module provides the logging of input and output number of
+    bytes received/sent per request. The numbers reflect the actual bytes
+    as received on the network, which then takes into account the
+    headers and bodies of requests and responses. The counting is done
+    before SSL/TLS on input and after SSL/TLS on output, so the numbers
+    will correctly reflect any changes made by encryption.</p>
+
+    <p>This module requires <module>mod_log_config</module>.</p>
+
+</summary>
+
+<seealso><a href="../logs.html">Apache Log Files</a></seealso>
+
+<section id="formats">
+<title>Custom Log Formats</title>
+
+    <p>This modules adds two new logging directives. The characteristics of the
+    request itself are logged by placing "%" directives in the format string,
+    which are replaced in the log file by the values as follows:</p>
+
+<table>
+
+<tr><td>%...I:</td>
+<td>Bytes received, including request and headers, cannot be zero.</td></tr>
+
+<tr><td>%...O:</td>
+<td>Bytes sent, including headers, cannot be zero.</td></tr>
+
+</table>
+
+    <p>Usually, the functionality is used like this:</p>
+
+    <dl>
+
+      <dt>Combined I/O log format:</dt>
+
+      <dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
+      \"%{User-agent}i\" %I %O"</code></dd>
+
+    </dl>
+
+</section>
+
+</modulesynopsis>