<?xml version="1.0" encoding='ISO-8859-1'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [

<!-- Include general documentation entities -->
<!ENTITY % docentities SYSTEM "../../../../doc/docbook/entities.xml">
%docentities;

]>
<!-- Module User's Guide -->

<chapter>


	<title>&adminguide;</title>

	<section>
	  <title>Overview</title>
	    <para>
	      The module does specific handling for notify-subscribe
	      message-summary (message waiting indication) events
	      as specified in RFC 3842.
	      It is used with the general event handling module,
   	      presence. It constructs and adds message-summary event to
  	      it.
	    </para>
	    <para>
 	      The module does not currently implement any authorization
	      rules.  It assumes that publish requests are only issued by
	      a voicemail application and subscribe requests only by
	      the owner of voicemail box. Authorization can thus
	      be easily done by &kamailio; configuration file before
	      calling handle_publish() and handle_subscribe()
	      functions.
	    </para>
	    <para>
	      The module implements a simple check of content type
	      <quote>application/simple-message-summary:</quote>  Content must start
	      with <quote>Messages-Waiting</quote> status line followed by zero or
	      more lines that consist of tabs and printable ASCII
	      characters.
	    </para>
	</section>

	<section>
	  <title>Dependencies</title>
	  <section>
		<title>&kamailio; Modules</title>
		<para>
		The following modules must be loaded before this module:
			<itemizedlist>
			<listitem>
			<para>
				<emphasis>presence</emphasis>.
			</para>
			</listitem>
			</itemizedlist>
		</para>
	  </section>

	  <section>
		<title>External Libraries or Applications</title>
		<para>
		None.
		</para>
	  </section>
	</section>

	<section>
	  <title>Parameters</title>
		  <section id="presence_mwi.p.default_expires">
               <title><varname>default_expires</varname> (int)</title>
               <para>
               The default expires value used when missing from SUBSCRIBE
               message (in seconds).
               </para>
               <para>
               <emphasis>Default value is <quote>3600</quote>.
               </emphasis>
               </para>
               <example>
               <title>Set <varname>default_expires</varname> parameter</title>
               <programlisting format="linespecific">
            ...
            modparam("presence_mwi", "default_expires", 3600)
            ...
            </programlisting>
                </example>
            </section>

        </section>

        <section>
	  <title>Functions</title>
	      <para>
	        None to be used in configuration file.
	      </para>
	</section>

</chapter>

