<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<section id="dispatcher" xmlns:xi="http://www.w3.org/2001/XInclude">
    <sectioninfo>
	<authorgroup>
	    <author>
		<firstname>Daniel-Constantin</firstname>
		<surname>Mierla</surname>
		<affiliation><orgname>FhG FOKUS</orgname></affiliation>
		<address>
		<email>mierla@fokus.fraunhofer.de</email>
		</address>
	    </author>
	</authorgroup>
	<copyright>
	    <year>2004</year>
	    <holder>FhG FOKUS</holder>
	</copyright>
    </sectioninfo>

    <title>Dispatcher Module</title>

    <section id="dispatcher.overview">
	<title>Overview</title>
	<para>
	    This modules implements a dispatcher for destination addresses. It
	    computes hashes over parts of the request and selects an address
	    from a destination set. The selected address is used then as
	    outbound proxy.
	</para>
	<para>
	    The module can be used as a stateless load balancer, having no
	    guarantee of fair distribution.
	</para>
	<para>
		The dispatcher module offers reloads on the fly using sercmd.
	</para>
    </section>

    <xi:include href="params.xml"/>
    <xi:include href="functions.xml"/>
	<xi:include href="fifo.xml"/>

    <section id="dispatcher.install_run">
	<title>Installation And Running</title>

	<example>
	    <title>Destination List File</title>
	    <para>
		Each destination point must be on one line. First token is the set
		id and next is destination address. The set id must be an integer
		value. Destination address must be a valid SIP URI. Empty lines or
		lines starting with "#" are ignored.
	    </para>
	    <programlisting>
<xi:include href="dispatcher.list" parse="text"/>
	    </programlisting>
	</example>

	<example>
	    <title>SER Configuration File</title>
	    <programlisting>
<xi:include href="dispatcher.cfg" parse="text"/>
	    </programlisting>
	</example>
    </section>

</section>