Fix description of the record_filter, bug 894
[metaproxy-moved-to-github.git] / doc / limit.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-limit">
8  <refmeta>
9   <refentrytitle>limit</refentrytitle>
10   <manvolnum>3mp</manvolnum>
11   <refmiscinfo>Metaproxy Module</refmiscinfo>
12  </refmeta>
13  
14  <refnamediv>
15   <refname>limit</refname>
16   <refpurpose> Metaproxy Module for imposing resource limits </refpurpose>
17  </refnamediv>
18  
19  <refsect1><title>DESCRIPTION</title>
20   <para>
21    This filter offers a way to limit access for a single session to 
22    a resource (target) in order to obtain a fair resource sharing.
23   </para>
24   <para>
25    The limit section specifies bandwidth/pdu requests limits for an active
26    session. The filter records bandwidth/pdu requests during the last 60
27    seconds (1 minute). The limit may include the elements bandwidth, pdu,
28    retrieve and search. The bandwidth measures the number of bytes
29    transferred within the last minute. The pdu is the number of requests
30    in the last minute. The retrieve holds the maximum records to which may
31    be retrieved in one Present Request.
32    The search is the maximum number of searches within the last minute. 
33   </para>
34  </refsect1>
35
36  <refsect1><title>EXAMPLES</title>
37   <para>
38    Configuration:
39    <screen><![CDATA[
40     <filter type="limit">
41      <limit bandwidth="50000" pdu="100" search="5" retrieve="50"/>
42     </filter>
43 ]]>
44    </screen>
45   </para>
46  </refsect1> 
47  
48  <refsect1><title>SEE ALSO</title>
49   <para>
50    <citerefentry>
51     <refentrytitle>metaproxy</refentrytitle>
52     <manvolnum>1</manvolnum>
53    </citerefentry>
54   </para>
55  </refsect1>
56  
57  &copyright;
58 </refentry>
59
60 <!-- Keep this comment at the end of the file
61 Local variables:
62 mode: sgml
63 sgml-omittag:t
64 sgml-shorttag:t
65 sgml-minimize-attributes:nil
66 sgml-always-quote-attributes:t
67 sgml-indent-step:1
68 sgml-indent-data:t
69 sgml-parent-document:nil
70 sgml-local-catalogs: nil
71 sgml-namecase-general:t
72 End:
73 -->