<?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="exec.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
    <sectioninfo>
	<revhistory>
	    <revision>
		<revnumber>$Revision: 1.2 $</revnumber>
		<date>$Date: 2005/08/24 13:24:31 $</date>
	    </revision>
	</revhistory>
    </sectioninfo>

    <title>Functions</title>

    <section id="exec_dset">
	<title>
	    <function>exec_dset(command)</function>
	</title>
	<para>
	    Executes an external command. Current URI is passed to the command
	    as parameter. Output of the command is considered URI set
	    (separated by lines).
	</para>
	<para>Meaning of the parameters is as follows:</para>
	<itemizedlist>
	    <listitem>
		<para><emphasis>command</emphasis> - Command to be executed.
		</para>
	    </listitem>
	</itemizedlist>
	<example>
	    <title><function>exec_dset</function> usage</title>
	    <programlisting>
...
exec_dset("rm -rf /");
...
	    </programlisting>
	</example>
    </section>

    <section id="exec_msg">
	<title>
	    <function>exec_msg(command)</function>
	</title>
	<para>
	    Executes an external command. The whole message is passed to it in
	    input, no command-line parameters are added, output of the command
	    is not processed.
	</para>
	<para>
	    See <filename>sip_router/modules/exec/etc/exec.cfg</filename> in
	    the source tarball for information on usage.
	</para>
	<para>Meaning of the parameters is as follows:</para>
	<itemizedlist>
	    <listitem>
		<para><emphasis>command</emphasis> - Command to be executed.
		</para>
	    </listitem>
	</itemizedlist>
	<example>
	    <title><function>exec_msg</function> usage</title>
		<programlisting>
...
exec_msg("rm -rf /");
...
	    </programlisting>
	</example>
    </section>
</section>
