<?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.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
    <sectioninfo>
	<revhistory>
	    <revision>
		<revnumber>$Revision: 1.3 $</revnumber>
		<date>$Date: 2006/05/30 21:24:27 $</date>
	    </revision>
	</revhistory>
    </sectioninfo>

    <title>Parameters</title>

    <section id="list_file">
	<title><varname>list_file</varname> (string)</title>
	<para>
	    Path to the file with destination sets.
	</para>
	<para>
	    <emphasis>
		Default value is "/etc/ser/dispatcher.list" or
		"/usr/local/etc/ser/dispatcher.list".
	    </emphasis>
	</para>
	<example>
	    <title>Set the "list_file" parameter</title>
	    <programlisting>
...
modparam("dispatcher", "list_file", "/var/run/ser/dispatcher.list")
...
	    </programlisting>
	</example>
    </section>

    <section id="force_dst">
	<title><varname>force_dst</varname> (int)</title>
	<para>
	    If set to 1, force overwriting of destination address when that is
	    already set.
	</para>
	<para>
	    <emphasis>
		Default value is "0".
	    </emphasis>
	</para>
	<example>
	    <title>Set the "force_dst" parameter</title>
	    <programlisting>
...
modparam("dispatcher", "force_dst", 1)
...
	    </programlisting>
	</example>
    </section>

    <section id="flags">
	<title><varname>flags</varname> (int)</title>
	<para>
	    Various flags that affect the hashing behaviour.  For now only the
	    flag 1 and 2 are defined. If flag 1 is set only the username part of
	    the uri will be used when computing an uri based hash. If flag 2 is
	    set the username part of the uri will be used and if no username 
	    part is present the hostname part will be used. If no flags are
	    set the username, hostname and port will be used The port is used
	    only if different from 5060 (normal sip uri) or 5061 (in the sips
	    case).
	</para>
	<para>
	    <emphasis>
		Default value is "0".
	    </emphasis>
	</para>
	<example>
	    <title>Set the "flags" parameter</title>
<programlisting>
...
modparam("dispatcher", "flags", 1)
...
	    </programlisting>
	</example>
    </section>

</section>
