Fix description of the record_filter, bug 894
[metaproxy-moved-to-github.git] / doc / frontend_net.xml
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN" 
2     "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
3  <!ENTITY copyright SYSTEM "copyright.xml">
4  <!ENTITY % idcommon SYSTEM "common/common.ent">
5      %idcommon;
6 ]>
7 <refentry id="ref-frontend_net">
8  <refentryinfo>
9   <productname>Metaproxy</productname>
10   <info><orgname>Index Data</orgname></info>
11  </refentryinfo>
12
13  <refmeta>
14   <refentrytitle>frontend_net</refentrytitle>
15   <manvolnum>3mp</manvolnum>
16   <refmiscinfo class="manual">Metaproxy Module</refmiscinfo>
17  </refmeta>
18  
19  <refnamediv>
20   <refname>frontend_net</refname>
21   <refpurpose>Metaproxy Network Server module that accepts Z39.50 and
22   HTTP requests</refpurpose>
23  </refnamediv>
24  
25  <refsect1><title>DESCRIPTION</title>
26   <para>
27    This is a frontend module. Listens on one or more ports and
28    sends HTTP/Z39.50 messages to other filters.
29   </para>
30  </refsect1>
31
32  <refsect1><title>CONFIGURATION</title>
33   <para>
34    Element <literal>port</literal> is a repeating element (1 or more). The
35    text content specifies a listening port.
36   </para>
37   <para>
38    Element <literal>threads</literal> is an optional element. The
39    text content specifies number of worker threads for the following
40    filters to use. The default value is 5 (5 worker threads).
41   </para>
42   <para>
43    Element <literal>timeout</literal> is an optional element. The
44    text content is treated as an integer that specifies the session timeout
45    in seconds for a client session (using the frontend net filter). The
46    default value is 300 (5 minutes).
47   </para>
48   <para>
49    Element <literal>connect-max</literal> is an optional element. The
50    text content is treated as an integer that specifies maximum number
51    of TCP sessions from the same original IP. The special value 0 means
52    : no connection limit. This is also the default if this element is omitted.
53   </para>
54  </refsect1>
55  
56  <refsect1><title>EXAMPLES</title>
57   <para>
58    A typical configuration looks like this:
59    <screen><![CDATA[
60     <filter type="frontend_net">
61      <port>@:9000</port>
62      <threads>10</threads>
63     </filter>
64 ]]>
65    </screen>
66   </para>
67  </refsect1> 
68  
69  <refsect1><title>SEE ALSO</title>
70   <para>
71    <citerefentry>
72     <refentrytitle>metaproxy</refentrytitle>
73     <manvolnum>1</manvolnum>
74    </citerefentry>
75   </para>
76  </refsect1>
77  
78  &copyright;
79 </refentry>
80
81 <!-- Keep this comment at the end of the file
82 Local variables:
83 mode: sgml
84 sgml-omittag:t
85 sgml-shorttag:t
86 sgml-minimize-attributes:nil
87 sgml-always-quote-attributes:t
88 sgml-indent-step:1
89 sgml-indent-data:t
90 sgml-parent-document:nil
91 sgml-local-catalogs: nil
92 sgml-namecase-general:t
93 End:
94 -->