X-Git-Url: http://lists.indexdata.com/cgi-bin?a=blobdiff_plain;f=doc%2Flog.xml;h=f8b370a136c94e90c63295522800fffb2df316c7;hb=ad1878b512acc857e086045e1cfe0a1b31034833;hp=e6b9925e12c72dc6d518a8a161d6a66c007a918b;hpb=271eaaa60ec419d64669cf0e9b5753d05365b798;p=metaproxy-moved-to-github.git

diff --git a/doc/log.xml b/doc/log.xml
index e6b9925..f8b370a 100644
--- a/doc/log.xml
+++ b/doc/log.xml
@@ -1,8 +1,10 @@
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" 
     "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd" [
  <!ENTITY copyright SYSTEM "copyright.xml">
+ <!ENTITY % common SYSTEM "common/common.ent">
+     %common;
 ]>
-<!-- $Id: log.xml,v 1.3 2006-04-24 12:50:24 marc Exp $ -->
+<!-- $Id: log.xml,v 1.8 2007-02-17 13:26:12 adam Exp $ -->
 <refentry>
  <refmeta>
   <refentrytitle>log</refentrytitle>
@@ -12,13 +14,108 @@
  
  <refnamediv>
   <refname>log</refname>
-  <refpurpose>logs packages</refpurpose>
+  <refpurpose>Metaproxy Package Logging Module</refpurpose>
  </refnamediv>
  
  <refsect1><title>DESCRIPTION</title>
   <para>
    This filter logs packages sent - and received . 
   </para>
+
+  <para>
+   Configurable values:
+   <variablelist>
+    <varlistentry><term>message</term>
+     <listitem>
+      <para>
+       Specifies a custom message for the log message.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>filename</term>
+     <listitem>
+      <para>
+       Specifies a name of file that log messages is written to.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>category</term>
+     <listitem>
+      <para>
+       Specifies the category of messages to be logged. The category is an
+       XML attribute and value of attribute is a boolean; 
+       <literal>true</literal> for enabled; <literal>false</literal>
+       for disabled.
+       The following category attributes are supported:
+
+   <variablelist>
+    <varlistentry><term>access</term>
+     <listitem>
+      <para>
+       One line log messages inspired by Apache access log entries.
+       This is a brief message stating the request and response.
+       This is enabled by default. All other categories are disabled by
+       default.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>request-apdu</term>
+     <listitem>
+      <para>
+       Z39.50 Request APDU.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>response-apdu</term>
+     <listitem>
+      <para>
+       Z39.50 Response APDU.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>apdu</term>
+     <listitem>
+      <para>
+       Z39.50 APDU (request and response)
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>request-session</term>
+     <listitem>
+      <para>
+       Request session.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>response-session</term>
+     <listitem>
+      <para>
+       Response session.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>session</term>
+     <listitem>
+      <para>
+       Session (request and response)
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry><term>init-options</term>
+     <listitem>
+      <para>
+       Z39.50 Init Request options
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+
+
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
  </refsect1>
  
  <refsect1><title>EXAMPLES</title>
@@ -27,6 +124,8 @@
    <screen><![CDATA[
     <filter type="log">
      <message>B</message>
+     <category access="true"/>
+     <filename>logs/metaproxy.log</filename>
     </filter>
 ]]>
    </screen>
@@ -45,9 +144,17 @@
  &copyright;
 </refentry>
 
-<!-- Keep this Emacs mode comment at the end of the file
+<!-- Keep this comment at the end of the file
 Local variables:
-mode: nxml
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-local-catalogs: nil
+sgml-namecase-general:t
 End:
 -->
-