<?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.fifo" xmlns:xi="http://www.w3.org/2001/XInclude">
    <sectioninfo>
    </sectioninfo>

    <title>FIFO Interface</title>

    <para>
	The module allows dumping the current configuration as well as
	dispatcher list reloading via the FIFO interface.
    </para>
    <para>
	There are two FIFO commands to use with dispatcher.
    </para>
    <itemizedlist>
	<listitem>
	    <para>
		dispatcher.dump - dump the current dispatcher sets
	    </para>
	</listitem>
	<listitem>
	    <para>
		dispatcher.reload - reload the dispatcher list text file
	    </para>
	</listitem>
    </itemizedlist>
	<section id="dispatcher.dump">
	<title>Dumping the current configuration</title>
	<para>
		The command dispatcher.dump can be used to dump the currently
		deployed dispatcher list in the SER internal notation.
	</para>
	<example>
		<title>dumping the active dispatcher list</title>
		<programlisting>
# sercmd dispatcher.dump
flags: DI_MAX_SETS: 16 DI_MAX_NODES: 16 DI_MAX_URILEN: 256
Active dispatcher list: 0
Set '0'
  node  0 sip:10.1.1.1:5060
  node  1 sip:10.1.1.2:5060
  node  2 sip:10.1.1.3:5060
  node  3 sip:10.1.1.4:5060
Set '1' is empty
Set '2' is empty
Set '3' is empty
Set '4' is empty
Set '5' is empty
Set '6' is empty
Set '7' is empty
Set '8' is empty
Set '9' is empty
Set '10' is empty
Set '11' is empty
Set '12' is empty
Set '13' is empty
Set '14' is empty
Set '15' is empty

End of dispatcher list
#
		</programlisting>
	</example>
	</section>
	<section id="dispatcher.reload">
	<title>Reloading the dispatcher list</title>
	<para>
		The command dispatcher.reload can be used to update the
		dispatcher list while running SER.	
	</para>
	<example>
		<title>Reloading the dispatcher list</title>
		<programlisting>
# sercmd fifo dispatcher.reload
dispatcher list 1 activated
#
		</programlisting>
	</example>
	</section>
</section>
