1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd" [
3 <!ENTITY copyright SYSTEM "copyright.xml">
4 <!ENTITY % common SYSTEM "common/common.ent">
7 <!-- $Id: log.xml,v 1.9 2007-05-09 21:23:08 adam Exp $ -->
8 <refentry id="ref-log">
10 <refentrytitle>log</refentrytitle>
11 <manvolnum>3mp</manvolnum>
12 <refmiscinfo>Metaproxy Module</refmiscinfo>
16 <refname>log</refname>
17 <refpurpose>Metaproxy Package Logging Module</refpurpose>
20 <refsect1><title>DESCRIPTION</title>
22 This filter logs packages sent - and received .
28 <varlistentry><term>message</term>
31 Specifies a custom message for the log message.
35 <varlistentry><term>filename</term>
38 Specifies a name of file that log messages is written to.
42 <varlistentry><term>category</term>
45 Specifies the category of messages to be logged. The category is an
46 XML attribute and value of attribute is a boolean;
47 <literal>true</literal> for enabled; <literal>false</literal>
49 The following category attributes are supported:
52 <varlistentry><term>access</term>
55 One line log messages inspired by Apache access log entries.
56 This is a brief message stating the request and response.
57 This is enabled by default. All other categories are disabled by
62 <varlistentry><term>request-apdu</term>
69 <varlistentry><term>response-apdu</term>
76 <varlistentry><term>apdu</term>
79 Z39.50 APDU (request and response)
83 <varlistentry><term>request-session</term>
90 <varlistentry><term>response-session</term>
97 <varlistentry><term>session</term>
100 Session (request and response)
104 <varlistentry><term>init-options</term>
107 Z39.50 Init Request options
121 <refsect1><title>EXAMPLES</title>
123 A typical configuration looks like this:
127 <category access="true"/>
128 <filename>logs/metaproxy.log</filename>
135 <refsect1><title>SEE ALSO</title>
138 <refentrytitle>metaproxy</refentrytitle>
139 <manvolnum>1</manvolnum>
147 <!-- Keep this comment at the end of the file
152 sgml-minimize-attributes:nil
153 sgml-always-quote-attributes:t
156 sgml-parent-document:nil
157 sgml-local-catalogs: nil
158 sgml-namecase-general:t