diff --git a/core/docs/Configure-Sems-Ser-HOWTO b/core/docs/Configure-Sems-Ser-HOWTO
deleted file mode 100644
index 0ceea6ef..00000000
--- a/core/docs/Configure-Sems-Ser-HOWTO
+++ /dev/null
@@ -1,1120 +0,0 @@
-***************************
-*  Sems + Ser mini-HOWTO  *
-***************************
-
-
-1. Introduction:
-
-This document describes the configuration of a typical Sems installation. It
-aims at giving Sems users a basic understanding on how Sems works, and how to
-configure Ser to implement some simple scenarios using Sems. The author will
-try to focus on the configuration itself, as the main README allready explains
-how to install Sems itself. Please refer to the Ser documentation if you have
-any problems installing Ser itself.
-
-In this document, it will be asserted that the reader has a basic
-understanding of Linux and SIP (Session Initiation Protocol, RFC 3261). If you
-don't, please try to get more familiar to Linux before continuing reading this
-document. If need more information on SIP, consider downloading iptel.org's
-SIP tutorial (www.iptel.org/sip).
-
-
-2. Getting Ser and Sems to communicate together:
-
-To work properly, Sems needs a working Ser instance, which will be used as
-Sems' SIP stack. They communicate together either through unix socket servers
-or FIFO servers. Each side implements a server, enabling communication in both 
-ways.You will need to configure Ser to use Sems's server, and Sems to use Ser's
-server. If you plan to run more than one Ser instance on the same host,
-be sure to know wich Ser instance you want to connect to Sems (!).
-
-Some people have only one Ser instance. Other users have a dedicated instance
-for Sems. If you don't know what you need, try first with a dedicated
-instance, as the configuration of that instance will be much easier. A sample
-configuration with a single ser instance is given in 3.2. 
-
-
-2.1 Configure Sems to use Ser's Unix socket server:
-
-    - edit Ser's configuration file (default location:
-      /usr/local/etc/ser/ser.cfg) and look for the 'fifo=' configuration
-      parameter. It should look like:
-
-         fifo="/tmp/ser_fifo"
-
-      If the 'fifo' parameter does not exist, add it to the global 
-      section. If you have another value for that parameter, you don't need to
-      change it, just remember it.
-
-    - open Sems's configuration file (default location:
-      /usr/local/etc/sems/sems.conf) and look for the 'ser_fifo_name='
-      parameter. It must have the same value as 'fifo=' in Ser's
-      configuration file, but without quotes. In our example:
-
-         ser_fifo_name=/tmp/ser_fifo
-
-    - then configure the 'socket_name=' parameter. Default value:
-	 
-	 socket_name=/tmp/am_sock
-
-    - then configure the 'send_method=' parameter. Default value:
-         
-	 send_method=fifo
-
-
-FIFO server vs. unix socket server
-----------------------------------
-Under heavy load, especially when many calls are initiated at once, the fifo
-buffer can be too small. Therefore unix sockets can be used to write a request
-from ser to sems. Unix sockets only work in cvs version of both ser and sems.
- 
-examples:
- *  SER -> SEMS : use unix socket 
-  in sems.conf:
-     #fifo_name=/tmp/am_fifo    # fifo not enabled
-     socket_name=/tmp/am_sock   # unix socket enabled
-  in ser.cfg routing: 
-     t_write_unix("/tmp/am_sock", "voicemail")
-
- *  SER -> SEMS : use fifo
-  in sems.conf:
-     fifo_name=/tmp/am_fifo      # fifo enabled
-     #socket_name=/tmp/am_sock   # unix socket not enabled
-  in ser.cfg routing: 
-     t_write_req("/tmp/am_fifo", "voicemail")
-
- *  SEMS -> SER : use fifo
-  in ser.cfg: 
-     fifo="/tmp/ser_fifo"
-  in sems.conf:
-     send_method=fifo
-     ser_fifo_name=/tmp/ser_fifo
-
- *  SEMS -> SER : use unix socket 
-  in ser.cfg: 
-     socket="/tmp/ser_socket"
-  in sems.conf:
-     send_method=unix_socket
-     ser_socket_name=/tmp/ser_socket
-
-2.2 How to redirect a call to sems?
-
-2.2.1 How it works:
-
-So that a caller gets connected to Sems, Ser has to pass every SIP message
-concerning that call to Sems through unix socket (or fifo). Basically, Sems 
-needs to get an INVITE message to begin a call, and a BYE message to terminate 
-that call. Sems must also be aware of CANCELs. ACKs should be absorbed by Ser, 
-as Sems does not need them. Redirecting the messages is a very simple
-operation. You just have to call the t_write_unix() (or t_write_req())
-function from the 'tm' module, which you have to load.
-
-2.2.2 Load Ser's tm module and configure fifo_db:
-
-    - add following line to your ser.cfg in the 'module loading' section:
-
-    loadmodule "/usr/local/lib/ser/modules/tm.so"
-
-    - add following line to your ser.cfg in the 'global configuration
-      parameters' section and change the url according to your database
-      configuration: 
-
-    fifo_db_url="mysql://ser:heslo@localhost/ser"
-
-
-2.2.3 Redirecting SIP messages to Sems:
-
-    - add following lines to your ser.cfg where you need to redirect the call:
-
-      # select messages to redirect:
-      if ( method=="ACK" || method=="INVITE" || method=="BYE" ||
-           method=="CANCEL" ){
-
-	   # switch to stateful mode:
-	   if (!t_newtran()){
-		sl_send_reply("500","could not create transaction");
-		break;
-	   };
-
-	   # prevent timeout on the other side:
-	   t_reply("100","Trying - just wait a minute !");
-	   
-	   if (method=="INVITE"){
-
-		# redirect the call to the 'conference' plug-in
-		# if the URI begin with 100
-		if (uri=~"sip:100.*@") {
-
-		   # assumes that Sems configuration parameter 'socket_name='
-		   # has been set to /tmp/am_sock
-		   if(!t_write_unix("/tmp/am_sock","conference")) {
-		      t_reply("500","error contacting sems");
-		   };
-		   break;
-		};
-
-		# redirect the call to the 'announcement' plug-in
-		# if the URI begin with 200
-		if (uri=~"sip:200.*@") {
-
-		   if(!t_write_unix("/tmp/am_sock","announcement")) {
-		      t_reply("500","error contacting sems");
-		   };
-		   break;
-		};
-
-		# no service number, redirect to voicemail.
-		# do not forget to load AVPs so that voicemail gets the
-		# callee's email address.
-		load_avp("ruri","email",0);
-		if(!t_write_unix("/tmp/am_sock","voicemail")) {
-		    t_reply("500","error contacting sems");
-		};
-		break;
-	   } 
-	   else if (method=="BYE" || method="CANCEL") {
-
-		# Sems should already know which plug-in is handling that
-                # call. "bye" is no plug-in name. It is a reserved name which
-		# tells Sems to terminate the call.
-
-		if(!t_write_unix("/tmp/am_sock","bye")) {
-		    t_reply("500","error contacting sems");
-		};
-	   };
-      };
-
-In more complicated scenario, you could also redirect REFERs to Sems which
-would enable you for example to implement a click-to-dial, or invite other
-users to take part to conference.
-
-
-2.3 Pass email address from ser to sems (for voicemail)
-
-For the voicemail plug-in to work properly, sems has to get the email address
-of the callee. As email adresses are usually stored in a database and ser
-usually already has a db connection, sems uses ser to get the email address.
-
-There are two possibilities to do this: 
- 1. through fifo_db 
-  or 
- 2. with tw_append
-
-2.3.1. Using fifo_db
-
-SEMS can query the database through the fifo. For this, ser must be configured
-to 
- - have a db module loaded (e.g. mysql or textdb)
- - have fifo_db_url.
-
-example configuration with mysql:
-loadmodule "/usr/local/lib/ser/modules/mysql.so"
-fifo_db_url="mysql://ser:heslo@localhost/ser"
-
-example configuration (ser.cfg) with dbtext:
-fifo_db_url="dbtext:///path/to/dbtext/dir"
-loadmodule "/usr/local/lib/ser/modules/dbtext.so"
-note the three slashes if the path is absolute 
-(dbtext:///usr/local/etc/sems/tables) . A sample text file usr_preferences to
-put in /path/to/dbtext/dir would have the following form:
---- usr_preferences file ------------------------------
-username(str,null) domain(str,null) attribute(str,null) value(str,null) type(int,null)
-Alice:mysipdomain.com:email:alice@maildomain.com:2
-Bob:mysipdomain.com:email:bob@anothermailaddress.com:2
--------------------------------------------------------
-
-2.3.2 Using tw_append and avpops 
-
-Arbitrary AVPs (attribute value pairs) can be appended to a request when it is
-written to sems with t_write_req/t_write_unix using tw_append. The AVPs can
-e.g. be loaded from a database before, modified with avpops etc. This only 
-work in cvs version of both ser and sems.
-
-This method is recommended, as it is much more flexible, e.g. the language of
-a user can be stored in the database, and the greeting and voicemail template
-will be selected according to the language, but it is a bit more
-complicated to configure:
-
-# load db module
-loadmodule "/usr/local/lib/ser/modules/mysql.so"
-
-# load avp modules
-loadmodule "modules/avp/avp.so"
-loadmodule "modules/avpops/avpops.so"
-
-# configure avpops db connection
-modparam( "avpops", "avp_url", "mysql://ser:heslo@localhost/ser" )
-modparam( "avpops", "avp_table", "subscriber" )
-modparam( "avpops", "uuid_column", "id" )
-
-# configure aliases, the number doesn't matter as long as there are no collisions)
-modparam( "avpops", "avp_aliases", "email=i:67 ; language=i:68" )
-
-# scheme to access the database
-modparam( "avpops", "db_scheme", 
-	  "email_scheme:table=subscriber;value_col=email_address;value_type=string")
-modparam( "avpops", "db_scheme", 
-	  "language_scheme:table=subscriber;value_col=language;value_type=string")
-
-# configure tm to append this when tw_appent voicemail_headers is used
-modparam("tm", "tw_append",
-	       "voicemail_headers:hdr[User-Agent];P-Email-Address=avp[$email];P-Language=avp[$language]")
-
-# ...
-
-# in route section:
-                        # no service number, redirect to voicemail.
-
-			avp_db_load( "$ruri", "$email/$email_scheme");
-			avp_db_load( "$ruri", "$language/$language_scheme");
-
-			if(!t_write_req("/tmp/am_fifo","voicemail/voicemail_headers")) {
-			   t_reply("500","error contacting sems");
-			};
-			break;
-
-
-This assumes that there is a column 'id', a column 'username', a column 'email_address' and a
-column 'language' in the table named 'subscriber'. dbtext sample file:
------ subscriber  --------------------------------
-id(int,auto) username(str,null) domain(str,null) email_address(str,null) language(str,null)
-1:Alice:iptel.org:alice@mymail.org:english
-2:rco:iptel.org:rco@iptel.org:french
-3:Alex:iptel.org:alex@iptel.org:german
------ subsciber end ------------------------------
-
-
-3. Configuration files used in this HOWTO:
-
-3.1 simple configuration with dedicated ser instance and fifo_db
-
--------------------------- ser.cfg -----------------------------------
-#
-# simple Ser config script to start using Sems.
-#
-
-# ----------- global configuration parameters ------------------------
-
-#debug=3         # debug level (cmd line: -dddddddddd)
-#fork=yes
-#log_stderror=no	# (cmd line: -E)
-
-/* Uncomment these lines to enter debugging mode 
-debug=7
-fork=no
-log_stderror=yes
-*/
-
-check_via=no	# (cmd. line: -v)
-dns=no           # (cmd. line: -r)
-rev_dns=no      # (cmd. line: -R)
-#port=5060
-#children=4
-
-# Configure Ser to create a FIFO server
-fifo="/tmp/ser_sock"
-
-# Configure FIFO DB
-fifo_db_url="mysql://ser:heslo@localhost/ser"
-
-# ------------------ module loading ----------------------------------
-
-loadmodule "/usr/local/lib/ser/modules/mysql.so"
-
-loadmodule "/usr/local/lib/ser/modules/sl.so"
-loadmodule "/usr/local/lib/ser/modules/tm.so"
-loadmodule "/usr/local/lib/ser/modules/rr.so"
-loadmodule "/usr/local/lib/ser/modules/maxfwd.so"
-loadmodule "/usr/local/lib/ser/modules/usrloc.so"
-loadmodule "/usr/local/lib/ser/modules/registrar.so"
-
-# ----------------- setting module-specific parameters ---------------
-
-# -- usrloc params --
-#modparam("usrloc", "db_mode",   0)
-
-# Uncomment this if you want to use SQL database 
-# for persistent storage and comment the previous line
-modparam("usrloc", "db_mode", 2)
-
-# -- rr params --
-# add value to ;lr param to make some broken UAs happy
-modparam("rr", "enable_full_lr", 1)
-
-# -------------------------  request routing logic -------------------
-
-# main routing logic
-
-route{
-
-	# initial sanity checks -- messages with
-	# max_forwards==0, or excessively long requests
-	if (!mf_process_maxfwd_header("10")) {
-		sl_send_reply("483","Too Many Hops");
-		break;
-	};
-	if ( msg:len > max_len ) {
-		sl_send_reply("513", "Message too big");
-		break;
-	};
-
-	# we record-route all messages -- to make sure that
-	# subsequent messages will go through our proxy; that's
-	# particularly good if upstream and downstream entities
-	# use different transport protocol
-	record_route();	
-	# loose-route processing
-	if (loose_route()) {
-		t_relay();
-		break;
-	};
-
-	if (uri==myself) {
-
-	   if (method=="REGISTER") {
-
-	      # make UAs which want to register happy
-	      sl_send_reply("200","OK");
-	      break;
-	   };
-
-	   # switch to statefull mode:
-	   if (!t_newtran()){
-	   	sl_send_reply("500","could not create transaction");
-	   	break;
-	   };
-
-	   if (method=="ACK"){
-		# absorb ACKs
-		break;
-	   };
-
-	   # prevent timeout on the other side:
-	   t_reply("100","Trying - just wait a minute !");
-	   
-	   if (method=="INVITE"){
-
-		# redirect the call to the 'conference' plug-in
-		# if the URI begin with 100
-		if (uri=~"sip:100.*@") {
-
-		   # assumes that Sems configuration parameter 'socket_name='
-		   # has been set to /tmp/am_sock
-		   if(!t_write_unix("/tmp/am_sock","conference")) {
-		      t_reply("500","error contacting sems");
-		   };
-		   break;
-		};
-
-		# redirect the call to the 'announcement' plug-in
-		# if the URI begin with 200
-		if (uri=~"sip:200.*@") {
-
-		   if(!t_write_unix("/tmp/am_sock","announcement")) {
-		      t_reply("500","error contacting sems");
-		   };
-		   break;
-		};
-
-		# no service number, redirect to voicemail.
-		# do not forget to load AVPs so that voicemail gets the
-		# callee's email address.
-		#load_avp("ruri","email",0);
-		if(!t_write_unix("/tmp/am_sock","voicemail")) {
-		    t_reply("500","error contacting sems");
-		};
-		break;
-	   } 
-	   else if (method=="BYE" || method=="CANCEL") {
-
-		# Sems should already know which plug-in is handling that
-                # call. "bye" is no plug-in name. It is a reserved name which
-		# tells Sems to terminate the call.
-
-		if(!t_write_unix("/tmp/am_sock","bye")) {
-		    t_reply("500","error contacting sems");
-		};
-	   };
-	};
-
-	# forward to current uri now; use stateful forwarding; that
-	# works reliably even if we forward from TCP to UDP
-	if (!t_relay()) {
-		sl_reply_error();
-	};
-}
-
--------------------------- ser.cfg end --------------------------------
-
-
--------------------------- sems.conf ----------------------------------
-#
-# sems.conf.sample
-#
-# Sip Express Media Server (sems)
-# 
-# sample configuration file
-# 
-#
-# whitespaces (spaces and tabs) are ignored
-# comments start with a "#" and may be used inline
-# 
-# example: option=value1, value2  # i like this option
-#
-
-##################################
-# global parameters              #
-##################################
-
-# optional parameter: fork={yes|no}
-# 
-# - specifies if sems should run in daemon mode (background)
-#   (fork=no is the same as -E)
-fork=yes
-
-# optional parameter: stderr={yes|no}
-#
-# - debug mode: do not fork and log to stderr
-#   (stderr=yes is the same as -E)
-stderr=no
-
-# optional parameter: loglevel={0|1|2|3}
-#
-# - sets log level (error=0, warning=1, info=2, debug=3)
-#   (same as -D)
-loglevel=1
-
-# optional parameter: ser_fifo_name=<filename>
-#
-# - path and file name of Ser's fifo file (same as -o)
-ser_fifo_name=/tmp/ser_fifo
-
-# optional parameter: socket_name=<filename>
-#
-# - path and file name of our unix socket
-socket_name=/tmp/am_sock
-
-# optional parameter: ser_socket_name=<filename>
-#
-# - path and file name of Ser's unix socket
-ser_socket_name=/tmp/ser_sock
-
-# optional parameter: send_method=<filename>
-#
-# - sets which method will be used to contact Ser:
-#   FIFO or unix socket server.
-# - values: fifo (default), unix_socket
-#
-# - PLEASE NOTE THAT: if you use 'fifo', make sure that
-#   fifo_name and ser_fifo_name have been set. if you use 'unix_socket',
-#   make sure that socket_name and ser_socket_name have been set.
-# 
-send_method=fifo
-
-# optional parameter: plugin_path=<path>
-# 
-# - sets the path to the plug-ins
-# - may be absolute or relative to CWD
-plugin_path=/usr/local/lib/sems/plug-in/
-
-# optional parameter: smtp_server=<hostname>
-#
-# - sets address of smtp server
-smtp_server=localhost
-
-# optional parameter: smtp_port=<port>
-#
-# - sets port of smtp server
-smtp_port=25
-
-# optional parameter: rtp_low_port=<port>
-#
-# - sets port of rtp lowest server
-#rtp_low_port=1024
-
-# optional parameter: rtp_high_port=<port>
-#
-# - sets port of rtp highest server
-#rtp_high_port=65535
-
-##################################
-# module specific parameters     #
-##################################
-
-# sample voicemail configuration (inline)
-config.voicemail=inline
-
-# optional parameter: announce_path=<path>
-# 
-# - sets the path where announce files are searched for
-# - the file to be played is determined the following way:
-#   <announce_path>/<domainname>/<username>.wav
-#   if this file is not available <announce_path>/<default_anounce> is used
-announce_path=/usr/local/lib/sems/audio/
-
-# parameter: default_announce=<filename>
-# 
-# - sets the name of the default announce WAV file
-default_announce=default_en.wav
-
-# parameter: max_record_time=<seconds>
-#
-# - maximum record time
-max_record_time=30
-
-# parameter: email_template=<filename>
-#
-# - email template file
-# 
-# See the README file in <sems-src>/plug-in/voicemail
-# for more information on the syntax used.
-#
-email_template=/usr/local/lib/sems/plug-in/mail.template
-
-# end of configuration section for voicemail module
-config.voicemail=end
-
-
-# sample announcement configuration (inline)
-config.announcement=inline
-
-# optional parameter: announce_path=<path>
-# 
-# - sets the path where announce files are searched for
-announce_path=/usr/local/lib/sems/audio/
-
-# parameter: default_announce=<filename>
-# 
-# - sets the name of the default announce WAV file
-default_announce=default_en.wav
-
-# end of configuration section for announcement module
-config.announcement=end
-
-
-# sample isdngw module configuration (external file)
-# config.isdngw=/etc/isdngw.conf
-
-# sample ivr module configuration (inline)
-config.ivr=inline
-
-#parameter: python_script_path=<full path>
-python_script_path=/etc/ivr
-
-#parameter: python_script_file=<filename>
-python_script_file=example.py
-
-# end of configuration section for ivr module
-config.ivr=end
-
-
-# sample conference configuration (inline)
-config.conference=inline
-
-# parameter: default_announce=<filename>
-#
-# - sets the full pathed name of the default announce WAV file.
-#   Will be played to lonely users.
-default_announce=/usr/local/lib/sems/audio/first_participant.wav
-
-# parameter: join_sound=<filename>
-#
-# - sets the full pathed name of a WAV file
-#   which will be played to conference users 
-#   when a new user joins the conference.
-join_sound=/usr/local/lib/sems/audio/beep.wav
-
-# parameter: drop_sound=<filename>
-#
-# - sets the full pathed name of a WAV file
-#   which will be played to conference users 
-#   when a user drops the conference.
-drop_sound=/usr/local/lib/sems/audio/beep.wav
-
-# end of configuration section for conference module
-config.conference=end
-
-# example configuration for number reader
-config.number_reader=inline
-
-number_path=/usr/local/lib/sems/audio/
-
-prolog_file=welcome_to_number_reader.wav
-
-epilog_file=thanks_calling_number_reader.wav
-
-# end of number_reader configuration
-config.number_reader=end
-
-# add more module configurations here (inline or external):
-#
-# config.mymodule=<filename>
-#  or
-# config.mymodule=inline
-# ...
-# config.mymodule=end
-
--------------------------- sems.conf end ------------------------------
-
-3.2 Single instance ser, using tw_append and avpops
-
-If an INVITE is sent to sems, sems will return a Contact in the form of 
-<plugin_name><user_prefix_separator><local_user>@<localdomain>
-if user_prefix_separator is set in sems.conf .
-e.g. if the following line is present in sems.conf:
- user_prefix_separator=+
-and an INVITE is sent to voicemail plugin for alice@mydomain.com, 
-sems will reply with a Contact header
-Contact: voicemail+alice@mydomain.com
-and all further requests can be routed to that plugin to sems directly.
-
-This configuration uses fifo ser->sems ans sems->ser and dbtext.
-mkdir /usr/local/etc/sems/tables
-and create a file subscriber  there:
------ subscriber  --------------------------------
-id(int,auto) username(str,null) domain(str,null) email_address(str,null) language(str,null)
-1:Alice:iptel.org:alice@mymail.org:english
-2:rco:iptel.org:rco@iptel.org:french
-3:Alex:iptel.org:alex@iptel.org:german
------ subsciber end ------------------------------
-
-
--------------------------- ser.cfg -----------------------------------
-# ----------- global configuration parameters ------------------------
-#debug=3         # debug level (cmd line: -dddddddddd)
-fork=yes
-log_stderror=no	# (cmd line: -E)
-
-/* Uncomment these lines to enter debugging mode 
-debug=7
-fork=no
-log_stderror=yes
-*/
-
-check_via=no	# (cmd. line: -v)
-dns=no           # (cmd. line: -r)
-rev_dns=no      # (cmd. line: -R)
-#port=5060
-#children=4
-
-# Configure Ser to create a FIFO server
-fifo="/tmp/ser_fifo"
-
-# ------------------ module loading ----------------------------------
-loadmodule "/usr/local/lib/ser/modules/dbtext.so"
-
-loadmodule "/usr/local/lib/ser/modules/sl.so"
-loadmodule "/usr/local/lib/ser/modules/tm.so"
-loadmodule "/usr/local/lib/ser/modules/rr.so"
-loadmodule "/usr/local/lib/ser/modules/maxfwd.so"
-loadmodule "/usr/local/lib/ser/modules/usrloc.so"
-loadmodule "/usr/local/lib/ser/modules/registrar.so"
-loadmodule "/usr/local/lib/ser/modules/avp.so"
-loadmodule "/usr/local/lib/ser/modules/avpops.so"
-
-# ----------------- setting module-specific parameters ---------------
-
-# -- usrloc params --
-#modparam("usrloc", "db_mode",   0)
-
-# Uncomment this if you want to use SQL database 
-# for persistent storage and comment the previous line
-#modparam("usrloc", "db_mode", 2)
-
-# -- rr params --
-# add value to ;lr param to make some broken UAs happy
-modparam("rr", "enable_full_lr", 1)
-
-
-modparam( "avpops", "avp_url", "dbtext:///usr/local/etc/sems/tables" )
-modparam( "avpops", "avp_table", "subscriber" )
-modparam( "avpops", "uuid_column", "id" )
-
-modparam( "avpops", "avp_aliases", "email=i:67 ; language=i:68" )
-
-modparam( "avpops", "db_scheme", 
-	  "email_scheme:table=subscriber;value_col=email_address;value_type=string")
-modparam( "avpops", "db_scheme", 
-	  "language_scheme:table=subscriber;value_col=language;value_type=string")
-
-modparam("tm", "tw_append",
-	       "voicemail_headers:hdr[User-Agent];P-Email-Address=avp[$email];P-Language=avp[$language]")
-
-# -------------------------  request routing logic -------------------
-
-# main routing logic
-
-route{
-
-	# initial sanity checks -- messages with
-	# max_forwards==0, or excessively long requests
-	if (!mf_process_maxfwd_header("10")) {
-		sl_send_reply("483","Too Many Hops");
-		break;
-	};
-	if ( msg:len > max_len ) {
-		sl_send_reply("513", "Message too big");
-		break;
-	};
-
-	# we record-route all messages -- to make sure that
-	# subsequent messages will go through our proxy; that's
-	# particularly good if upstream and downstream entities
-	# use different transport protocol
-	record_route();	
-	# loose-route processing
-	if (loose_route()) {
-		t_relay();
-		break;
-	};
-
-	if (uri==myself) {
-
-	   if (method=="REGISTER") {
-
-	      # make UAs which want to register happy
-	      sl_send_reply("200","OK");
-	      break;
-	   };
-
-	   # switch to statefull mode:
-	   if (!t_newtran()){
-	   	sl_send_reply("500","could not create transaction");
-	   	break;
-	   };
-
-	   if (method=="ACK"){
-			# absorb ACKs
-			break;
-	   };
-
-	   # prevent timeout on the other side:
-	   t_reply("100","Trying - just wait a minute !");
-
-	   # forward to sems plugin directly if r_uri is plugin_name+...@...			
-	   if (uri=~"sip:voicemail+*@*") {
-		if(!t_write_req("/tmp/am_fifo","voicemail")){
-			log("could not contact voicemail\n");
-			t_reply("500","could not contact voicemail");
-		};		
-		break;
-	   };
-	
-	   if (uri=~"sip:conference+*@*") {
-		if(!t_write_req("/tmp/am_fifo","conference")){
-			log("could not contact conference\n");
-			t_reply("500","could not contact conference");
-		};		
-		break;
-	   };
-	   
-	   if (uri=~"sip:announcement+*@*") {
-		if(!t_write_req("/tmp/am_fifo","announcement")){
-			log("could not contact announcement\n");
-			t_reply("500","could not contact announcement");
-		};		
-		break;
-	   };
-
-		
-	   if (method=="INVITE"){
-			# redirect the call to the 'conference' plug-in
-			# if the URI begins with 100
-			if (uri=~"sip:100*@") {
-
-			   # assumes that Sems configuration parameter 'socket_name='
-			   # has been set to /tmp/am_fifo
-			   if(!t_write_req("/tmp/am_fifo","conference")) {
-			      t_reply("500","error contacting sems");
-			   };
-			   break;
-			};
-
-			# redirect the call to the 'announcement' plug-in
-			# if the URI begin with 200
-			if (uri=~"sip:200*@") {
-
-			   if(!t_write_req("/tmp/am_fifo","announcement")) {
-			      t_reply("500","error contacting sems");
-			   };
-			   break;
-			};
-
-			# no service number, redirect to voicemail.
-
-			avp_db_load( "$ruri", "$email/$email_scheme");
-			avp_db_load( "$ruri", "$language/$language_scheme");
-
-			if(!t_write_req("/tmp/am_fifo","voicemail/voicemail_headers")) {
-			   t_reply("500","error contacting sems");
-			};
-			break;
-	   };
-	   
-	};
-
-	# forward to current uri now; use stateful forwarding; that
-	# works reliably even if we forward from TCP to UDP
-	if (!t_relay()) {
-		sl_reply_error();
-	};
-}
--------------------------- ser.cfg end -------------------------------
-
--------------------------- sems.conf ---------------------------------
-# $Id: Configure-Sems-Ser-HOWTO,v 1.6 2005/01/05 18:07:23 sayer Exp $
-#
-# sems.conf.sample
-#
-# Sip Express Media Server (sems)
-# 
-# sample configuration file
-# 
-#
-# whitespaces (spaces and tabs) are ignored
-# comments start with a "#" and may be used inline
-# 
-# example: option=value1, value2  # i like this option
-#
-
-##################################
-# global parameters              #
-##################################
-
-# optional parameter: fork={yes|no}
-# 
-# - specifies if sems should run in daemon mode (background)
-#   (fork=no is the same as -E)
-fork=yes
-
-# optional parameter: stderr={yes|no}
-#
-# - debug mode: do not fork and log to stderr
-#   (stderr=yes is the same as -E)
-stderr=no
-
-# optional parameter: loglevel={0|1|2|3}
-#
-# - sets log level (error=0, warning=1, info=2, debug=3)
-#   (same as -D)
-loglevel=1
-
-# optional parameter: fifo_name=<filename>
-#
-# - path and file name of our fifo file (same as -i)
-fifo_name=/tmp/am_fifo
-
-# optional parameter: ser_fifo_name=<filename>
-#
-# - path and file name of Ser's fifo file (same as -o)
-ser_fifo_name=/tmp/ser_fifo
-
-# optional parameter: socket_name=<filename>
-#
-# - path and file name of our unix socket
-#socket_name=/tmp/am_sock
-
-# optional parameter: ser_socket_name=<filename>
-#
-# - path and file name of Ser's unix socket
-#ser_socket_name=/tmp/ser_sock
-
-# optional parameter: send_method=<filename>
-#
-# - sets which method will be used to contact Ser:
-#   FIFO or unix socket server.
-# - values: fifo (default), unix_socket
-#
-# - PLEASE NOTE THAT: if you use 'fifo', make sure that
-#   fifo_name and ser_fifo_name have been set. if you use 'unix_socket',
-#   make sure that socket_name and ser_socket_name have been set.
-# 
-send_method=fifo
-
-# optional parameter: plugin_path=<path>
-# 
-# - sets the path to the plug-ins
-# - may be absolute or relative to CWD
-plugin_path=/usr/local/lib/sems/plug-in/
-
-# return a Contact header <app_name>+user@domain in outgoing requests.
-user_prefix_separator=+
-
-# optional parameter: smtp_server=<hostname>
-#
-# - sets address of smtp server
-smtp_server=localhost
-
-# optional parameter: smtp_port=<port>
-#
-# - sets port of smtp server
-smtp_port=25
-
-# optional parameter: rtp_low_port=<port>
-#
-# - sets port of rtp lowest server
-#rtp_low_port=1024
-
-# optional parameter: rtp_high_port=<port>
-#
-# - sets port of rtp highest server
-#rtp_high_port=65535
-
-##################################
-# module specific parameters     #
-##################################
-
-# sample voicemail configuration (inline)
-config.voicemail=inline
-
-# optional parameter: rec_file_extension=<ext>
-# 
-# - sets the file extension which will be used
-#   to record messages.
-# - example 1: wav
-# - example 2: mp3
-#
-# WARNING: you must compile the mp3 plug-in
-#          in order to use 'mp3' as default
-#          extension. You will need the lame
-#          encoder for that.
-#          See plug-in/mp3/ReadmeMP3.txt for
-#          more information.
-#
-rec_file_extension=wav
-
-# optional parameter: announce_path=<path>
-# 
-# - sets the path where announce files are searched for
-# - the file to be played is searched in the following order:
-#   <announce_path>/<domainname>/<username>.wav
-#   <announce_path>/<domainname>/<language>/<default_announce>
-#   <announce_path>/<domainname>/<default_announce>
-#   <announce_path>/<language>/<default_announce>
-#   <announce_path>/<default_announce>
-#   where <language> is taken from the body of P-Language header
-#   of the request (if any).
-announce_path=/usr/local/lib/sems/audio/
-
-# parameter: default_announce=<filename>
-# 
-# - sets the name of the default announce WAV file
-default_announce=default_en.wav
-
-# parameter: max_record_time=<seconds>
-#
-# - maximum record time
-max_record_time=30
-
-# parameter: accept_delay=<x>
-# 
-# - delays accepting of the call for x seconds
-# - default value is 0
-accept_delay=0
-
-# parameter: email_template_path=<filename>
-#
-# - email templates path
-# 
-# See the README file in <sems-src>/plug-in/voicemail
-# for more information on the syntax used.
-# - template to be used is selected in the following order:
-#   <email_template_path><domain>_<language>.template
-#   <email_template_path><domain>.template
-#   <email_template_path>default_<language>.template
-#   <email_template_path>default.template
-#   where <language> is taken from the body of P-Language header
-# of the request (if any).
-#
-email_template_path=/usr/local/etc/sems
-
-# end of configuration section for voicemail module
-config.voicemail=end
-
-
-# sample announcement configuration (inline)
-config.announcement=inline
-
-# optional parameter: announce_path=<path>
-# 
-# - sets the path where announce files are searched for
-announce_path=/usr/local/lib/sems/audio/
-
-# parameter: default_announce=<filename>
-# 
-# - sets the name of the default announce WAV file
-default_announce=default_en.wav
-
-# end of configuration section for announcement module
-config.announcement=end
-
-
-# sample isdngw module configuration (external file)
-# config.isdngw=/etc/isdngw.conf
-
-# sample ivr module configuration (inline)
-config.ivr=inline
-#
-#
-# The IVR checks for a script with the named of the callee
-# (<local part in r-uri>.py for python, <local part in r-uri>.pl for perl)
-# in the directory <ivr_script_path><domain>, then for 
-# <ivr_script_path><domain><ivr_script_file>. If this is  not found,
-# <ivr_script_path>/<local part in r-uri>.py if searched, 
-# and if this is not found, <ivr_script_path>/<ivr_script_file> is used.
-#
-# So with a call to sayer@iptel.org and
-#ivr_script_path=/etc/ivr and 
-#ivr_script_file=ivr.py
-# these files are checked:
-#/etc/ivr/iptel.org/sayer.py
-#/etc/ivr/iptel.org/ivr.py
-#/etc/ivr/sayer.py
-#/etc/ivr/ivr.py
-#
-  #parameter: ivr_script_path:
-  # path to ivr scripts.
-  # 
-  ivr_script_path=/etc/ivr/
-  # default script file: this will be executed if <user>.py does not exist.
-  #
-  ivr_script_file=ivr.py
-
-  # parameter : tts_caching
-  # 	y or n
-  #       text will be read from waves already synthesized and 
-  #	cached in cache_path 
-  tts_caching=y
-
-  # parameter : tts_cache_path
-  # 	path to cache waves
-  # 	path must exist! 
-  tts_cache_path=/tmp/wavs
-# end of configuration section for ivr module
-config.ivr=end
-
-# sample conference configuration (inline)
-config.conference=inline
-
-# parameter: default_announce=<filename>
-#
-# - sets the full pathed name of the default announce WAV file.
-#   Will be played to lonely users.
-default_announce=/usr/local/lib/sems/audio/first_participant.wav
-
-# end of configuration section for conference module
-config.conference=end
-
-# example configuration for number reader
-config.number_reader=inline
-
-number_path=/usr/local/lib/sems/audio/
-
-prolog_file=welcome_to_number_reader.wav
-
-epilog_file=thanks_calling_number_reader.wav
-
-# end of number_reader configuration
-config.number_reader=end
-
--------------------------- sems.conf end -----------------------------
diff --git a/core/docs/IVR_Documentation.txt b/core/docs/IVR_Documentation.txt
deleted file mode 100644
index fdb74d00..00000000
--- a/core/docs/IVR_Documentation.txt
+++ /dev/null
@@ -1,1226 +0,0 @@
-/*
- * $Id: IVR_Documentation.txt,v 1.7 2005/01/05 17:18:05 sayer Exp $
- * Copyright (C) 2002-2003 Fhg Fokus
- *
- * This file is part of sems, a free SIP media server.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
- */
-
-SEMS plug-in documentation: 
- The Interactive Voice Response (IVR) module
-
- index
-1. Introduction to the new IVR module
-2. Installation
-2.1 Prerequisites
-2.2 adapting the Makefile  
-2.2.1 Script Language
-2.2.2 TTS
-2.2.3 ASTERISK_COMPATIBLE
-2.3 Making the IVR module
-2.4 Run time configuration: sems.conf
-3. General operation
-3.1 How the playlist works
-3.2 Recording
-3.3 How event controlled scripts work
-3.4 Maintaining state in event controlled scripts
-3.5 Text to Speech in the IVR
-3.6 sleep functions
-3.7 redirecting a call (REFER)
-3.8 placing a new call: dialout
-4. Example scripts
-4.1 BeatBox (Python and Perl)
-4.2 Restricted Redirect: ID and PIN verification and redirection 
-4.3 voicemail script: send email from SIP call
-4.4 print call information
-5. IVR Function reference
-6. Troubleshooting & FAQ
-7. Contact the authors
-
-revision history: 
- 05.01.05 ssa added tw_append in 3.7, asterisk_compatible 2.2.3
- 25.10.04 ssa added 3.7 refer 
- 26.10.04 ssa changed 3.7 refer cb parameters
-
-1. Introduction to the new IVR module
-
-The IVR plug-in for SEMS is a general purpose application platform for 
-the Sip Express Media Server SEMS. It can be scripted in either Python 
-or Perl language to control the Media Server, and thus can be used for
-rapid development and deployment of SIP telephony services.
-
-In order to be a platform for the creation of powerful real life 
-applications, the ivr module for SEMS has been rewritten to use a playlist
-and support event controlled operation. For more simple applications,
-sequential script can be used as well.
-
-It is not recommended to mix sequential and event controlled operation 
-though. Especially the sequential functions like ivr.play() may not work 
-as expected.
-
-Perl has been introduced to the IVR module by Richard at Comtel, and can be 
-selected as the scripting language at compile time.
-
-2. Installation
-
-2.1 Prerequisites
-
- * SEMS source distribution
-    There is no binary distribution of the IVR yet, as script language and
-    text to speech support has to be selected at compile time. The current
-    source code for SEMS can be obtained via CVS with the following command:
-    $ cvs -d:pserver:anonymous@cvs.berlios.de:/cvsroot/sems co answer_machine
- 
- * Script interpreter
-   For Python: Python >= ver. 2.2 must be installed. The current release can 
-   be obtained from http://www.python.org , 
-   e.g. http://www.python.org/ftp/python/2.3.4/Python-2.3.4.tar.bz2 .
-   It is recommended to recompile and install Python from the source package.
-   
-   For Perl: The Perl support requires perl version 5.8.0 and above. It's tested 
-   in 5.8.3 in Debian test branch. If you successfully run other configurations, 
-   please give us some feedback so it can be listed here.
-   
- * Text to Speech (TTS), optional
-   If TTS is to be used, the flite speech synthesizer has to be downloaded and 
-   installed, from http://www.speech.cs.cmu.edu/flite/download.html
-   
-2.2 adapting the Makefile  
- 
-Before compiling, the Makefile of the IVR plug-in has to be adapted: Script 
-Language, Text To Speech Support and Paths.
-
-The Makefile for the IVR plug-in is located in answer_machine/plug-in/ivr 
-subdirectory of the SEMS source tree.
-
-2.2.1 Script Language
-
-	SCRIPT = <script language>
-	
-	<script language> can one of [Python, Perl, Perl-].
-	
-  For Python:
-  If Python 2.2 is used, change PYTHON_VERSION:
-  PYTHON_VERSION=2.2   
-  If the Python headers and libraries are located somewhere else then in the 
-  default path ( /usr/include/python2.2 and  /usr/lib/python2.2 ), change 
-  PYTHON_PREFIX, e.g. for SuSE:
-  PYTHON_PREFIX=/usr/local
-  Modules that are by default dynamically loaded, i.e. all modules from 
-  lib-dynload, must be linked statically to the ivr module. If you use e.g. the 
-  time module, add to 
-  PYTHON_DYNLOAD_MODULES = $(PYTHON_LIBDIR)/lib-dynload/time.so	
-  For the mysql module, link _mysql as well 
-  PYTHON_DYNLOAD_MODULES = $(PYTHON_LIBDIR)/lib-dynload/time.so,\
-  $(PYTHON_LIBDIR)/lib-dynload/_mysql.so
-  
-  Perl:
-  Modules that are by default dynamically loaded must be linked statically to the
-  ivr module. To facilitate this, there is the option SCRIPT=Perl- which links 
-  commonly used modules.
-
-2.2.2 TTS
-	If Text to speech is to be used, set
-	TTS = y
-	FLITE_DIR should point to the root of the flite source distribution. 
-
-2.2.3 ASTERISK_COMPATIBLE
-
-  Apparently Asterisk uses the incoming RTP packets as timing source for rtp
-  it sends. The ivr can send empty packets (all zeroes) when it is idle (no
-  media to play) so voice can be recorded if e.g. asterisks pstn-gw is used. 
-  
-  In the Makefile set ASTERISK_COMPATIBLE=y if you want to enable that.
-
-2.3 Making the IVR module
-	'make' in plug-in/ivr directory should make the IVR module. If it was 
-	successfully built, there is answer_machine/lib/apps/ivr.so .
-
-2.4 Run time configuration: sems.conf
-
-  The following section is from the sems.conf sample configuration:
-  
-# sample ivr module configuration (inline)
-config.ivr=inline
-#
-#
-# The IVR checks for a script with the named of the callee
-# (<local part in r-uri>.py for python, <local part in r-uri>.pl for perl)
-# in the directory <ivr_script_path><domain>, then for 
-# <ivr_script_path><domain><ivr_script_file>. If this is  not found,
-# <ivr_script_path>/<local part in r-uri>.py if searched, 
-# and if this is not found, <ivr_script_path>/<ivr_script_file> is used.
-#
-# So with a call to sayer@iptel.org and
-#ivr_script_path=/etc/ivr and 
-#ivr_script_file=ivr.py
-# these files are checked:
-#/etc/ivr/iptel.org/sayer.py
-#/etc/ivr/iptel.org/ivr.py
-#/etc/ivr/sayer.py
-#/etc/ivr/ivr.py
-#
-  #parameter: ivr_script_path:
-  # path to ivr scripts.
-  # 
-  ivr_script_path=/etc/ivr/
-  # default script file: this will be executed if <user>.py does not exist.
-  #
-  ivr_script_file=ivr.py
-
-  # parameter : tts_caching
-  # 	y or n
-  #       text will be read from waves already synthesized and 
-  #	cached in cache_path 
-  tts_caching=y
-
-  # parameter : tts_cache_path
-  # 	path to cache waves
-  # 	path must exist! 
-  tts_cache_path=/tmp/wavs
-# end of configuration section for ivr module
-config.ivr=end
-
-3. General operation
-
-The Python or perl interpreter is embedded in the IVR plug-in. Executing the script 
-by its own (e.g. /usr/bin/python ivr.py ) does not make a lot of sense.
-
-If a call is transferred to the IVR plug-in, it will start a new instance of a script
-interpreter, which searches for the appropriate script (see above, 2.4) and executes 
-it. The script can now play back a file to the user, record the voice of the called,
-collect key inputs, refer the call etc. by calling functions of the ivr module.
-
-Example scripts are given in Python here, for example perl scripts have a look at 
-section 4.
-
-In Python, the ivr module has to be imported first, a simple announcement could look
-like this
--------- simple announcement script
-import ivr
-ivr.play("hello.wav")
---------
-
-When the script finishes, the call is terminated. A call to this script
--------- 10 seconds recording
-import ivr
-ivr.startRecording("recorded.wav")
-ivr.sleep(10)
----------
-will last less then or equal 10 seconds.
-
-3.1 How the playlist works
-
-Files can be added to the playlist, either at the front or at the back, using
-the ivr.enqueueMediaFile(filename, front) function. By default it is assumed 
-that the file should be added to the front of the paylist and played back 
-instantly. If there is a file currently played, its playback is interrupted 
-until the new file is finished, then its playback is continued from the position
-where it was interrupted.
-
-If the playlist should be cleared, e.g. before adding a new file if one doesn't 
-want to have the current file continued after the new file, ivr.emptyMediaQueue() 
-can be called.
-
-3.2 Recording
-
-ivr.startRecording(filename) and ivr.stopRecording() are used to record to a 
-file. If the extension ".mp3" is given and the MP3 file writer plug-in is there, a 
-mp3 file is written. If not, a PCM 16 bit WAV file is written.
-
-3.3 How event controlled scripts work
-In an IVR application, the script programmer often wants the IVR doing 
-something while waiting for e.g. a keypress of the caller. For example a 
-message has to be recorded while the script waits for a keypress by the 
-caller or if the caller did not press "next", "last" or "delete" key within 
-five seconds, the script could play a help message.
-
-The script can register callback functions, which are executed if some event 
-occurs. Namely, these are
-
-onDTMF                key is pressed
-onMediaQueueEmpty     playlist is empty
-onBye                 caller hanged in
-onReferStatus	      status notification of REFER process (see 3.7)
-
-For example these functions can be registered like this:
-  
-  def onDTMF_Func(key):
-  	print "DTMF: ", key
- 
-  def onMQE_Func():
-  	print "Playlist ran out!"
-  
-  def onBye_Func():
-  	print "onBye!"	
-  
-  ivr.setCallback(onDTMF_Func, "onDTMF")
-  ivr.setCallback(onMQE_Func "onMediaQueueEmpty")
-  ivr.setCallback(onBye_Func, "onBye")
-
-Note that the onDTMF callback is (so far) the only one with a parameter, 
-which holds the key pressed.
-
-A simple script that will record 10 seconds or until a key is pressed could 
-look like this:
-
--------- record 10 seconds or until key is pressed
-import ivr
-
-def onDTMF_Func(key):
-	print "DTMF: ", key
-	ivr.stopRecording()
-	ivr.wakeUp()
-	
-ivr.setCallback(onDTMF_Func, "onDTMF")
-ivr.enableDTMFDetection()
-ivr.startRecording("recorded.wav")
-ivr.sleep(10)
----------
-
-Note that indentation (TABs at the beginning of the line) matters in Python language.
-
-If a message should be played at the end, the script could be modified like this:
-
--------- record 10 seconds or until key is pressed, and then play message
-import ivr
-
-def onDTMF_Func(key):
-	print "DTMF: ", key
-	ivr.stopRecording()
-	ivr.wakeUp()
-
-def onMediaQueueEmpty_Func():
-	ivr.wakeUp()
-	
-ivr.setCallback(onDTMF_Func, "onDTMF")
-ivr.setCallback(onMediaQueueEmpty_Func, "onMediaQueueEmpty")
-ivr.enableDTMFDetection()
-ivr.startRecording("recorded.wav")
-ivr.sleep(10)
-ivr.say("Thank you for your message")
-ivr.sleep(40) 
-# sleep until wakeUp
----------
-
-3.4 Maintaining state in event controlled scripts
-
-This script illustrates how to use menus by maintaining state.
-
------ incomplete mailbox script
-import ivr
-
-class IvrState:
-	def __init__(self):
-		self.state = "init_state"
-		
-	def onDTMF(self, key):
-		print "onDTMF, key = ", key
-		if self.state == "init_state":
-			if key == 1:
-				self.state = "next_message"
-				ivr.emptyMediaQueue()
-				ivr.say("the next message:")
-				ivr.enqueueMediaFile(my_message.wav, false)
-				
-			elif key == 2:
-				self.state = "setup_state"
-				ivr.emptyMediaQueue()
-				ivr.say("press one to enter your name, two to leave the setup")
-				
-		if self.state == "setup_state":
-			if key == 1:
-				self.state = "recording_state"
-				ivr.startRecording("myname.wav")
-
-print "IVR"
-print "IVIVI"
-
-s = IvrState()
-
-def onDTMF_m(key):
-	s.onDTMF(key)
-
-ivr.setCallback(onDTMF_m, "onDTMF")
-
-ivr.enableDTMFDetection()
-ivr.say("welcome to your mailbox.");
-ivr.sleep(60)
----------
-
-
-3.5 Text to Speech in the IVR
-
-If the IVR is compiled with flite-TTS enabled, the function ivr.say(message, front) 
-can be called. For example you could write
- ivr.say("This is your mailbox")
-To use Text to Speech, you have to download the flite speech synthesizer and uncomment 
-two lines in the Makefile in the IVR directory. For more information about installing 
-the flite speech synthesizer have a look at answer_machine/plug-in/semstalkflite/Readme.txt .
-
-3.6 sleep functions
-
-The ivr.sleep(n) and ivr.usleep(n) functions can be used to wait n seconds or microseconds,
-or until ivr.wakeUp() is called. Do not call the sleep() and usleep() functions in callbacks!
-ivr.wakeUp() can be used safely in callback functions, e.g. to wake up the script if some 
-event has occured.
-
-3.7 redirecting a call (REFER) 
-
-With the ivr function ivr.redirect(string to_uri) the caller can be redirected
-to a SIP URL. The function call returns the cseq number for the REFER which
-can be used in the script to distinguish the response, if several REFERs are
-made. Depending on the caller, this REFER can be accepted or not, and
-while the call transfer is in progress, the caller sends notifications
-about the status of the redirection via NOTIFY. To enable the script to react
-appropriately to this progress, a callback is introduced: 
-
-onReferStatus(type, cseq, code_subscriptionstate, reason_status)
-
-This callback is used to convey the script _both_ the response to the REFER
-_and_ the notifications given by the caller. The first parameter, "type" holds
-the type of the Status update: "Response" or "Notification". The second
-parameter, cseq (type number), holds the sequence number of the corresponding
-REFER; it is needed to distinguish responses if there is more than one REFER
-in one dialog. The third parameter, "code_subscriptionstate", holds either the
-response code to the REFER, if it is a "Response", or the subscription state
-of the implicit subscription to the REFER status. reason_status for "Response"
-holds the reason string (can be empty), and for "Notification" it is the REFER
-status (i.e. the body of the NOTIFY message).
- 
-Example script (python):
-def onReferStatus(type, cseq, code_subscriptionstate, reason_status):
-	print "onReferStatus... type = " + type
-	if type == "Response":
-		print "cseq = " + str(cseq)
-		print "code = " + str(code_subscriptionstate)
-		print "reason = " + reason
-	else: # assuming "Notification"
-		print "cseq = " + str(cseq)
-		print "SubscriptionState: " + code_subscriptionstate
-		print "Refer Status: " + reason_status + "\n"
-
-ivr.setCallback(onReferStatus, "onReferStatus")
-ivr.say("please wait while your call is being transferred.")
-print "cseq of redirect: "+ str(ivr.redirect("sip:refer2@example.iptel.org"))
-ivr.sleep(20)
-
-Note that the NOTIFY message must be handled correctly in ser routing script
-and sent to sems with t_write_unix (or t_write_req), so SEMS will receive it: 
-
-modparam( "tm", "tw_append",
-   "notify_body:hdr[Event];hdr[Subscription-State];msg[body]")
-
-/* ... */
-// request routing section
-
-	   	if (uri=~"sip:ivr+*@*") {
-                   if (method == "NOTIFY")  {
-                      if(!t_write_unix("/tmp/am_sock","ivr/notify_body")){
-                                log("could not contact ivr\n");
-                                t_reply("500","could not contact ivr");
-                      };
-                   } else {
-                     if(!t_write_unix("/tmp/am_sock","ivr")){
-                        log("could not contact ivr\n");
-                        t_reply("500","could not contact ivr");
-                     };
-                   };
-                   break;
-                };
-
-
-
-3.8 placing a new call: dialout
-
-with the function
- ivr.dialout(string user, string app_name, string uri, string from_user)
-
-A new call will be placed. app_name is the SEMS application that gets the new
-call. If the app_name is "ivr" the ivr will get the new call. It will be made to uri from from_user. 
-
-4. Example applications
-
-4.1 BeatBox (Python and Perl)
-
-This not very useful application (used to test the playlist ;) will maybe illustrate the 
-concepts of playlist and callbacks. Also how to maintain state information using a dialog 
-class is probably useful to script programmers.
-
-The user is greeted with intro.wav . To every key a wav file is associated (0.wav .. 9.wav). 
-If the user enters two times 0 in a row, a different set of files is used (b0.wav .. b11.wav).
-After a maximum of 60 seconds the script hangs up.
-
--- bbox.py ------------------------------------
-import ivr
-import time
-
-class BeatBox:
-	def __init__(self):
-		self.number_path = "/home/ssa/ivr/bbox/numbers/"
-		self.bbox_path  = "/home/ssa/ivr/bbox/"
-		self.lastchar = -1
-		self.bbox_mode = 0
-
-	def onDTMF(self, key):
-		print "onDTMF, key = ", key
-		print "lastchar = ", self.lastchar
-		if self.lastchar == 0 and key == 0 :
-			if not self.bbox_mode :
-				ivr.enqueueMediaFile(self.bbox_path+"enter_bbox.wav")
-			else: 
-				ivr.enqueueMediaFile(self.bbox_path+"left_bbox.wav")
-			self.bbox_mode = not self.bbox_mode
-		if self.bbox_mode:
-			ivr.enqueueMediaFile(self.bbox_path + "b"+str(key) +".wav")
-		else: 
-			ivr.enqueueMediaFile(self.number_path + str(key) +".wav")	
-		self.lastchar = key	
-
-	def onMediaQueueEmpty(self):
-		print "media ran out..."
-		#ivr.enqueueMediaFile(self.bbox_path + "numbers/0.wav")
-print "IVR"
-print "IVIVI"
-
-b = BeatBox()
-
-def onDTMF_m(key):
-	b.onDTMF(key)
-def onMQE_m():
-	b.onMediaQueueEmpty()
-
-ivr.setCallback(onDTMF_m, "onDTMF")
-ivr.setCallback(onMQE_m, "onMediaQueueEmpty")
-ivr.startRecording("/home/ssa/ivr/bbox/recorded/" + ivr.getFrom() + " - " + time.ctime() + ".wav")
-ivr.enableDTMFDetection()
-ivr.enqueueMediaFile("/home/ssa/ivr/bbox/intro.wav")
-ivr.sleep(60)
--- bbox.py - end ------------------------------
-
-Note that in Python every class member function get self as the first parameter,
-and indentation matters (blocks go together with the same amount of tabs).
-
-Also note that a wrapper function (onDTMF_m, onMQE_m) has to be used as 
-callback function, ivr.setCallback(b.onDTMF, "onDTMF") will not work.
-
-Perl demo script:
--- beatbox.pl script ---------------------------------
-#test.pl
-my @keys=();
-use Sys::Syslog qw(:DEFAULT setlogsock);
-
-syslog('info', 'this is the beginning');
-my $wav_path = '/var/spool/openums/prompts/';
-ivr::enableDTMFDetection();
-syslog('info', 'setting DTMF callback: '. ivr::setCallback('on_DTMF', 'onDTMF') );
-syslog('info', 'filling media queue: '. ivr::enqueueMediaFile($wav_path . 'aloha.wav', 0));
-
-ivr::startRecording('/tmp/record' . ivr::getFrom() . '.wav');
-for ($i=0; $i<10; $i++) {
-	$sleep_time = ivr::msleep(5000);
-	syslog('info', 'wake up after sleep '. $sleep_time . ' msec.\n');
-	if ($sleep_time >= 5000) {
-		# look like normal wakeup, no key pressed
-		syslog('info', 'no key pressed after 5 sec');
-	} else {
-		$key = shift (@keys);
-		syslog('info', 'A new key '. $key . " is pressed after $sleep_time msec");
-		ivr::enqueueMediaFile("$wav_path" . $key . '.wav');
-	}
-}
-
-syslog('info', 'this is the end');
-
-sub on_DTMF {
-	push @keys, @_;
-	syslog('info', "callback says: a key @_ is entered");
-	ivr::wakeUp();
-}
--------------------------------------------------
-
-4.2 Restricted Redirect: ID and PIN verification and redirection (Python)
-
-This script asks the caller to enter user ID, PIN and a PSTN number. Before the
-call is redirected to that number, the uid and pin is verified against values 
-read from a cvs text file 
-
--- restricted_redirect.py ----------------------
-#!/usr/bin/env python
-import ivr
-import csv
-
-class IvrDemo:
-	def __init__(self):
-		self.pin = ""
-		self.uid = ""
-		self.pstn_nr = ""
-		self.dialogstate = "enter_uid"
-		self.pinfile = "/usr/local/iptel/conf/pins.csv"
-
-	def onDTMF(self, key):
-		if key < 10:
-			ivr.say(str(key), False)
-		#print("IVR: User DTMF input key = "+str(key))
-		if self.dialogstate == "enter_uid":
-			if key == 11:
-				self.dialogstate = "enter_pin"
-				ivr.say("Now please enter your PIN Number.", False)     
-			else :
-				self.uid += str(key)
-		elif self.dialogstate == "enter_pin":
-			if key == 11:
-				if self.check_pin(self.pin, self.uid):
-					self.dialogstate = "enter_pstn"
-					ivr.say("Your PIN Number is correct. Please enter then number you want to call.", False)
-					print "User entered correct UID/PIN combination "+self.uid+"/"+self.pin
-				else:
-					ivr.say("I am sorry, your PIN is not correct. Please enter you PIN number again.", False)
-					print "User entered wrong UID/PIN combination "+self.uid+"/"+self.pin
-					self.dialogstate = "enter_pin"
-					self.pin = ""
-			else:
-				self.pin += str(key)
-		elif self.dialogstate == "enter_pstn":
-			ivr.emptyMediaQueue()
-			if key == 11:
-				ivr.redirect(self.pstn_nr)
-				self.dialogstate = "waiting_for_redirect"	     
-				ivr.say("You will now be connected to ", False)
-				ivr.say(" " + self.pstn_nr, False)
-				print "Redirecting user to "+self.pstn_nr
-			else :
-				self.pstn_nr += str(key)
-		elif self.dialogstate == "waiting_for_redirect": pass
-			# check if redirect worked
-
-	def check_pin(self, pin, uid):
-		reader = csv.reader(file(self.pinfile))
-		for row in reader:
-			c_uid = ''
-			c_pin = ''
-			for i,v in enumerate(row):
-				if i == 0:
-					c_uid = v
-				elif i == 1:
-					c_pin = v
-			if uid == str(c_uid) and pin == str(c_pin):
-				return True
-		return False
-		
-print "IVR"
-print "IVRIVI - Starting session for "+ ivr.getFrom()
-
-b = IvrDemo()
-
-def onDTMF_m(key):
-	b.onDTMF(key)
-	
-ivr.setCallback(onDTMF_m, "onDTMF")
-ivr.enableDTMFDetection()
-ivr.say("Please enter your User Identification number")
-ivr.sleep(0)
--- restricted_redirect.py -- end ----------------
-
-4.3 voicemail script: send email from SIP call.
-
-The caller can either enter a buddy and her or his email address, or send a 
-voicemail to one of the buddies. Buddies are stored in a CVS file, 
-autocompletion is done if the name of a buddy is only partly entered.
-This script also illustrates how to send a email message with a recorded file 
-attached.
-
--- voicemail.py ---------------------------------
-#!/usr/bin/env python
-#/*
-# *
-# * Copyright (C) 2004 Fhg Fokus and Emil Kroymann <kroymann@informatik.hu-berlin.de>
-# *
-# * This file is part of sems, a free SIP media server.
-# *
-# * sems is free software; you can redistribute it and/or modify
-# * it under the terms of the GNU General Public License as published by
-# * the Free Software Foundation; either version 2 of the License, or
-# * (at your option) any later version
-# *
-# * For a license to use the ser software under conditions
-# * other than those described here, or to purchase support for this
-# * software, please contact iptel.org by e-mail at the following addresses:
-# *    info@iptel.org
-# *
-# * sems is distributed in the hope that it will be useful,
-# * but WITHOUT ANY WARRANTY; without even the implied warranty of
-# * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# * GNU General Public License for more details.
-# *
-# * You should have received a copy of the GNU General Public License 
-# * along with this program; if not, write to the Free Software 
-# * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-#
-#  for smtplib and time, link these modules (see Makefile in plug-in/ivr directory)
-#
-# # put used Python modules from lib-dynload here, e.g. time, mysql etc.
-#PYTHON_DYNLOAD_MODULES = $(PYTHON_LIBDIR)/lib-dynload/time.so \
-#	$(PYTHON_LIBDIR)/lib-dynload/_csv.so \
-#	$(PYTHON_LIBDIR)/lib-dynload/_socket.so \
-#	$(PYTHON_LIBDIR)/lib-dynload/binascii.so \
-#	$(PYTHON_LIBDIR)/lib-dynload/math.so \
-#	$(PYTHON_LIBDIR)/lib-dynload/_random.so \
-#	$(PYTHON_LIBDIR)/lib-dynload/cStringIO.so \
-#
-# */
-
-
-import ivr
-import time
-import csv
-import string
-import smtplib
-# Here are the email pacakge modules we'll need
-from email.MIMEAudio import MIMEAudio
-from email.MIMEMultipart import MIMEMultipart
-
-
-tel_keys = { 
-	1 : ['.','_'],
-	2 : ['a','b','c'],
-	3 : ['d','e','f'],
-	4 : ['g','h','i'],
-	5 : ['j','k','l'],
-	6 : ['m','n','o'],
-	7 : ['p','q','r','s'],
-	8 : ['t','u','v'],
-	9 : ['w','x','y','z'],
-	0 : ['@'] }
-	
-	
-#d = {'key': 'value', 'key1': 'value1'}
-#l = [1,2,3,4]
-
-class ivr_sm:
-	def __init__(self):
-		self.state = 'main_menu'
-		self.last_key = -1
-		self.key_index = 0
-		self.nickname = ''
-		self.email = ''
-		self.timeoutvalue = 0
-		self.have_typed_key = False
-		self.in_session = True
-		self.buddylist = { 'sanchez' : 'sayer@cs.tu-berlin.de', }
-		self.buddyfile = "buddy.csv"
-		self.main_menu_text = "send a voicemail with 1, add a contact with 2, and with 3 I tell you all buddys I know"
-		self.vm_filename = ''
-		self.auto_enter_key_after = 5
-		self.go_back_to_sleep = False
-		
-##########################
-	def onBye(self):
-		self.in_session = False
-		
-	def onDTMF(self, key):
-		print("voicemail script: DTMF, state = %s" % self.state)
-		
-		if self.state == 'main_menu':
-			if key == 1:
-				self.state = 'send_voicemail'
-				self.nickname = ''
-				ivr.emptyMediaQueue()
-				ivr.say("Please enter the buddy you want to send a voicemail to.")
-				self.timeoutvalue = self.auto_enter_key_after
-				ivr.wakeUp()
-			if key == 2: # add contact
-				self.state = 'add_contact_enter_nickname'
-				self.nickname = ''
-				ivr.emptyMediaQueue()
-				ivr.say("Please tell me the nickname of your new contact")
-				self.timeoutvalue = self.auto_enter_key_after
-				ivr.wakeUp()
-			if key == 3: # tell all contacts
-				self.state = 'tell_all_contacts'
-				ivr.emptyMediaQueue()
-				s = "I know "
-				for nick, mailadr in self.buddylist.iteritems():
-					s = s + nick + " with email address " + mailadr + ", and I know "
-				s = s + " you."
-				ivr.say(s)
-    ##############################################
-		elif self.state == 'add_contact_enter_nickname':
-			self.have_typed_key = True
-			self.reinit_autoenter()
-			if key == 11: # finished
-				ivr.say("The nickname is %s, now give me the email address please." % self.nickname )
-				key = -1
-				self.state = 'add_contact_enter_email'
-      
-			elif key == 10: #backspace
-				self.nickname = self.nickname[0:-1]
-				ivr.say(self.nickname)
-				self.last_key = -1
-      	
-			elif key != self.last_key:				
-				if self.last_key == -1:
-					self.last_key = key
-					self.key_index = 0
-					return
-				self.nickname += tel_keys[self.last_key][self.key_index]
-				ivr.say(self.nickname)
-				self.key_index = 0
-				self.last_key = key
-
-			elif key == self.last_key:
-				self.key_index += 1
-				if self.key_index >= len(tel_keys[self.last_key]):
-					self.key_index = 0
-
-    ##############################################
-		elif self.state == 'add_contact_enter_email':
-			self.reinit_autoenter()			
-			self.have_typed_key = True
-			if key == 11: # finished
-				ivr.emptyMediaQueue()
-				self.buddylist[self.nickname]=self.email;
-				print "writing contacts..."
-				writer = csv.writer(file(self.buddyfile, "w"))
-				for nick, mailadr in self.buddylist.iteritems():
-					writer.writerow((nick, mailadr)) 
-				ivr.say("I have added your buddy %s with email address %s. \
-				Now press 1 if you want to send a voicemail and any other key \
-				if you want to go back to the main menu" % (self.nickname, self.email))
-				self.state = 'finished_enter_contact'
-				self.timeoutvalue = 0 # endless
-				ivr.wakeUp()
-        	
-			elif key != self.last_key:
-				if self.last_key == -1:
-					self.last_key = key
-					self.key_index = 0
-					return
-				self.email += tel_keys[self.last_key][self.key_index]
-				ivr.say(self.email)
-				self.last_key = key
-				self.key_index = 0
-
-			elif key == self.last_key:
-				self.key_index += 1
-				if self.key_index >= len(tel_keys[self.last_key]):
-					self.key_index = 0
-		##############################################
-		elif self.state == 'finished_enter_contact':
-			if key == 1:
-				self.init_voicemail()
-			else:
-				self.state = 'main_menu'
-				self.timeoutvalue = 0
-				ivr.wakeUp()
-				ivr.emptyMediaQueue()
-				ivr.say(self.main_menu_text)
-			
-		##############################################
-		elif self.state == 'tell_all_contacts':
-			ivr.emptyMediaQueue()
-			self.return_to_main()
-
-		##############################################
-		elif self.state == 'send_voicemail':
-			self.have_typed_key = True
-			self.reinit_autoenter()
-			if key == 11: # finished
-				self.nickname = self.find_nick(self.nickname)
-				#ivr.say("The nickname is %s." % self.find_nick(self.nickname) )
-				key = -1
-				self.init_voicemail()
-      
-			elif key == 10: #backspace
-				self.nickname = self.nickname[0:-1]
-				ivr.say(self.nickname)
-				self.last_key = -1
-			elif key == 1:				 
-				if len(self.nickname) == 0:
-					ivr.say("You did not tell me who you want to call.")
-				elif len(self.find_nick(self.nickname)) == 0:
-					ivr.say("You asked me if I knew %s, but I don't do." % self.nickname)
-				else:
-					ivr.say("Do you mean %s ?" % self.find_nick(self.nickname) )
-				
-			elif key != self.last_key:				
-				if self.last_key == -1:
-					self.last_key = key
-					self.key_index = 0
-					return
-				self.nickname += tel_keys[self.last_key][self.key_index]
-				s = self.find_nick(self.nickname)
-				if len(s) != 0:
-					ivr.say(s)
-				else:
-					ivr.say("I don't know anyone who starts with: %s" %self.nickname)
-					
-				self.key_index = 0
-				self.last_key = key
-
-			elif key == self.last_key:
-				self.key_index += 1
-				if self.key_index >= len(tel_keys[self.last_key]):
-					self.key_index = 0
-				
-		##############################################
-		elif self.state == 'before_voicemail':
-			if key == 1:
-				ivr.emptyMediaQueue()
-				ivr.say("beep")
-				self.vm_filename = '/home/ssa/ivr/conf/voicemail/rec/'+\
-				str(int(time.time())) + '.mp3'
-				ivr.startRecording(self.vm_filename) 
-				self.state = 'recording_voicemail'
-				
-			elif key == 0:
-				self.return_to_main()
-		##############################################
-		elif self.state == 'recording_voicemail':
-			ivr.stopRecording()
-			ivr.say(('ok, i am sending your message to %s now. Ok, ' % self.nickname)+self.main_menu_text)
-			#ivr.enqueueMediaFile(self.vm_filename)
-			
-			# Create the container (outer) email message.
-			msg = MIMEMultipart()
-			msg['Subject'] = 'voicemail by '+ ivr.getFrom()
-
-			msg['From'] = 'ssa@fokus.fraunhofer.de'
-			msg['To'] = 'ssa@fokus.fraunhofer.de'
-			msg.preamble = 'Hello, this is a voicemail sent by ' + ivr.getFrom() + '.'
-			# Guarantees the message ends in a newline
-			msg.epilogue = ''
-
-			fp = open(self.vm_filename, 'rb')
-			vm_msg = MIMEAudio(fp.read(), _subtype="mp3")
-			fp.close()
-			msg.add_header('Content-Disposition', 'attachment')
-			msg.attach(vm_msg)
-
-			# Send the email via our own SMTP server.
-			s = smtplib.SMTP()
-			s.connect()
-			print "sending mail to "+ self.buddylist[self.nickname]
-			s.sendmail('ssa@fokus.fraunhofer.de', self.buddylist[self.nickname], msg.as_string())
-			s.close() 
-			
-			self.state = 'main_menu'
-			self.timeoutvalue = 0
-			ivr.wakeUp()
-			
-			self.return_to_main()
-		
-	def init_voicemail(self):
-		ivr.emptyMediaQueue()
-		ivr.say("If you are ready to send a voicemail to %s please press 1" % self.nickname)
-		self.state = 'before_voicemail'
-		self.timeoutvalue = 10
-		ivr.wakeUp()
-
-	def return_to_main(self):
-		self.state = 'main_menu'
-		self.timeoutvalue = 0
-		ivr.say(self.main_menu_text)
-		ivr.wakeUp()
-		
-	def find_nick(self, nickpart):
-		foundnick = ''
-		max_same_chars = 0
-		for nick, mailadr in self.buddylist.iteritems():
-			if string.count(nick, nickpart) > max_same_chars:
-				max_same_chars = string.count(nick, nickpart)
-				foundnick = nick
-		return foundnick
-	
-	def reinit_autoenter(self): 
-		#self.timeoutvalue = self.auto_enter_key_after
-		self.go_back_to_sleep = True
-		ivr.wakeUp()
-		
-###########################
-	def timeoutaction(self):
-		print("voicemail script: timeoutaction, state = %s" % self.state)
-		if self.state == 'add_contact_enter_nickname':
-			if self.last_key == -1:
-				return
-			if self.have_typed_key:
-				self.nickname += tel_keys[self.last_key][self.key_index]
-				self.key_index = 0
-				ivr.say(self.nickname)
-				self.last_key = -1
-				self.have_typed_key = False
-			
-		elif self.state == 'send_voicemail':
-			if self.last_key == -1:
-				return
-			if self.have_typed_key:
-				self.nickname += tel_keys[self.last_key][self.key_index]
-				self.key_index = 0
-				ivr.say(self.find_nick(self.nickname))
-				self.last_key = -1
-				self.have_typed_key = False
-
-		if self.state == 'add_contact_enter_email':
-			if self.last_key == -1:
-				return
-			if self.have_typed_key:
-				self.email += tel_keys[self.last_key][self.key_index]
-				self.key_index = 0
-				ivr.say(self.email)
-				self.last_key = -1
-				self.have_typed_key = False
-		
-		if self.state == 'before_voicemail':
-				ivr.say('send a voicemail to %s with 1.' % self.nickname)
-				
-	def mainloop(self):
-		while self.in_session:
-			ivr.sleep(self.timeoutvalue)
-			if self.go_back_to_sleep:
-				self.go_back_to_sleep = False
-			else:
-				self.timeoutaction()
-
-	def onMediaQueueEmpty(self): pass
-
-	def readbuddies(self):
-		print "reading contacts..."
-		reader = csv.reader(file(self.buddyfile))
-		for row in reader:
-			print(row)
-			nick = ''
-			mail = ''
-			for i, v in enumerate(row):
-				if i == 0:
-					nick = v
-				elif i == 1:
-					mail = v
-			self.buddylist[nick] = mail
-
-sm = ivr_sm()
-
-def onDTMF_m(key):
-		sm.onDTMF(key)
-def onMQE_m():
-		sm.onMediaQueueEmpty()
-def onBye_m():
-		sm.onBye()
-	
-sm.buddyfile = "/home/ssa/ivr/conf/voicemail/buddy.csv"
-sm.readbuddies()
-
-ivr.setCallback(onDTMF_m, "onDTMF")
-ivr.setCallback(onMQE_m, "onMediaQueueEmpty")
-ivr.setCallback(onBye_m, "onBye")
-
-ivr.enableDTMFDetection()
-ivr.say("Hello this is the fantastic voice mailer! " + sm.main_menu_text)
-
-sm.mainloop() # 
-#ivr.sleep(0) # endless
--- voicemail.py - end ---------------------------
-
-4.4 print call information
-
-an example script that prints out all information:
------
-print "IVR"
-print "IVRIVI--------     call to "+ivr.getTo()
-print "ivr.getFrom() : " + ivr.getFrom()
-print "ivr.getFromTag() : " + ivr.getFromTag()
-print "ivr.getFromURI() : " + ivr.getFromURI()
-print ""
-print "ivr.getTo() : " + ivr.getTo()
-print "ivr.getToTag() : " + ivr.getToTag()
-print "ivr.getToURI() : " + ivr.getToURI()
-print ""
-print "ivr.getUser() : " + ivr.getUser()
-print "ivr.getEmail() : " + ivr.getEmail()
-print "ivr.getDstIP() : " + ivr.getDstIP()
-print "ivr.getPort() : " + ivr.getPort()
-print "ivr.getCallID() : " + ivr.getCallID()
-print "ivr.getDomain() : " + ivr.getDomain()
-print "ivr.getTime() : " + str(ivr.getTime())
--------
-
-5. IVR Function reference
-It is not recommended to mix the sequential IVR operation with event controlled IVR
-operation ( 2. and 3.). Functions for sequential operations will probably not 
-work as expected.
-
-5.1. informational
-
-* ivr.getTime()
-	returns time as int (seconds from epoch)
-* ivr.getFrom()
-	return From as string
-* ivr.getTo()
-	returns To as string
-* ivr.getFromURI()
-	returns From URI as string
-* ivr.getToURI()
-	returns To URI as string
-* ivr.getDomain()
-	returns Domain as string
-* ivr.getUser()
-	returns the User as string
-* ivr.getEmail()
-	returns the email address if found in serweb tables
-* ivr.getCallID()
-	returns the Call ID
-* ivr.getFromTag()
-	return the from Tag
-* ivr.getToTag()
-	return the To Tag
-* ivr.getPort()
-	return the remote port 
-* ivr.getDstIP()
-	return the destination IP
-
-*ivr.getHeader(string header_name)
-        returns the value of the header with given name. Can not be used to
-        get the headers above (From, To, ...) ! 
-	ex. print ivr.getHeader('remote-party-id') 
-
-see 4.4 for an example script that prints out all information.
-
-5.2. sequential functions as from the old IVR module:
-* ivr.play(string filename)
-	play and wait until the end of the file (queue empty)
-* ivr.record(string filename, int max_rec_time)
-	record up to maximum of max_rec_time secs. If max_rec_time = 0, records until 
-	callee hangs up.
-* int ivr.playAndDetect(string filename)
-	play and wait for the end of the file (queue empty) or keypress
-	returns pressed key or -1 if no key pressed	
-* int ivr.detect([int timeout = 0 (unlimited)])
-	detect until timeout occurs.
-	Parameter: timeout = 0 : int. If omitted, no timeout (endless) is assumed
-
-
-5.3. event controlled operation, new IVR functions:
-// setting callbacks
-* ivr.setCallback(Python_function_pointer cb_function, string cb_name)
-
-  example: 
-  
-  def onDTMF_Func(key):
-  	print "DTMF: ", key
- 
-  def onMQE_Func():
-  	print "Playlist ran out!"
-  
-  def onBye_Func():
-  	print "onBye!"	
-  
-  ivr.setCallback(onDTMF_Func, "onDTMF")
-  ivr.setCallback(onMQE_Func "onMediaQueueEmpty")
-  ivr.setCallback(onBye_Func, "onBye")
-
-
-// Playback and recording 
-* ivr.enqueueMediaFile(string filename [, int front = 1 (default true) ])
-
-Add a file to the playlist.
-examples:
-	ivr.enqueueMediaFile("/tmp/hello.wav")  
-#will be added at the front 
-
-	ivr.enqueueMediaFile("/tmp/hello.wav", 0)  
-# be added to the back of the playlist
-
-* ivr.emptyMediaQueue()
- clear the playlist.
- 
-*ivr.startRecording(string filename)
- start recording to filename. If already recording, record is closed first.
-
-*ivr.stopRecording()
- stop recording. If not recording, does nothing
-
-*ivr.say (string msg [, int front = 1 (default true)] ) 
-	*only available if compiled with flite-Text-to-Speech support (see Makefile)*
-
- do Text to Speech and enqueue (= put in playlist) result.
-
-
-// DTMF functions
-* ivr.enableDTMFDetection
-  be sure to call setCallback(onDTMF_FUNC, "onDTMF") first!
-    
-* ivr.disableDTMFDetection()
- disable DTMF detection permanently (i.e. until the next enableDtmfDetection) 
-
-* ivr. pauseDTMFDetection
- pause DTMF detection temporarily, can be resumed
-* ivr.resumeDTMFDetection
- resume DTMF detection
- 
-
-// bed time
-* ivr.sleep(int n)
-	sleep n seconds or until wakeUp() is called
-* ivr.usleep(int n)
-	sleep n microseconds or until wakeUp() is called
-* ivr.wakeUp()
-	wake sleeping script
-
-// call control
-* int ivr.redirect(string to_uri)
-
-	REFER the caller to to_uri. See section "3.7 redirecting a call
-	(REFER)" for details.
-	return value: cseq of the REFER command.
-
-* ivr.dialout(string user, string app_name, string uri, string from_user)
-
-  	Place a new call, which will be made to uri from from_user. app_name
-	is the SEMS application that gets the new call.
-	
-6. Troubleshooting & FAQ
-
-6.1 Q:"I get unresolved symbol XYZ when I run /usr/bin/python ivr.py"
-    A: the python/perl interpreter is embedded in the ivr plug-in. Read 
-       3. General operation.
-       
-6.2 Q:"I get unresolved symbol XYZ when I do import mysql.so in my script"
-    A:link all modules used from lib-dynload with the ivr modules. if you 
-    use perl, change SCRIPT=Perl to SCRIPT=Perl- , if you use Python, add
-    _mysql.so (and some others) to PYTHON_DYNLOAD_MODULES . See "2.2 
-    Adapting the Makefile".
-    
-6.3 Q:"I do not get the status of a REFER in my script"
-    A:See 3.7 on how to get response and notification of refer method.
-
-6.4 Q:"I cannot record from asterisk pstn-gw when no file is played (media
-       queue empty)."
-    A:see 2.2.3.
-    
-If you encounter any problems or bugs, please write to the sems mailing list ( sems@iptel.org ) 
-or directly me at stefan.sayer@fokus.fraunhofer.de . 
-
-7. Contact the authors
-
- Stefan Sayer can best be reached at mailto:stefan.sayer@fokus.fraunhofer.de or 
- sip:sayer@iptel.org.
- 
- Fraunhofer Institut FOKUS       Email:stefan.sayer@fokus.fraunhofer.de
- Kaiserin-Augusta-Allee 31       Phone: +49 30 3463 7137
- D-10589 Berlin, Germany
- http://www.fokus.fraunhofer.de/research/cc/mobis
-
- Richard can be reached at mailto:richard@o-matrix.org
- 
\ No newline at end of file
diff --git a/doc/Configure-Sems-Ser-HOWTO b/doc/Configure-Sems-Ser-HOWTO
new file mode 100644
index 00000000..ee069d06
--- /dev/null
+++ b/doc/Configure-Sems-Ser-HOWTO
@@ -0,0 +1,264 @@
+***************************
+*  Sems + Ser mini-HOWTO  *
+***************************
+
+
+1. Introduction:
+
+This document describes the configuration of a typical Sems installation. In 
+this document, it will be asserted that the reader has a basic understanding 
+of Linux and SIP (Session Initiation Protocol, RFC 3261). If you don't, 
+please try to get more familiar to Linux before continuing reading this
+document. If need more information on SIP, consider downloading iptel.org's
+SIP tutorial (www.iptel.org/sip).
+
+
+2. Getting Ser and Sems to communicate together:
+
+To work properly, Sems needs a working Ser instance, which will be used as
+Sems' SIP stack. They communicate together through unix socket servers. 
+Each side implements a server, enabling communication in both ways.You 
+will need to configure Ser to use Sems's server, and Sems to use Ser's 
+server. If you plan to run more than one Ser instance on the same host, 
+be sure to know wich Ser instance you want to connect to Sems (!).
+
+Some people have only one Ser instance. Other users have a dedicated instance
+for Sems. If you don't know what you need, try first with a dedicated
+instance, as the configuration of that instance will be much easier. A sample
+configuration with a single ser instance is given in 3.2. 
+
+
+2.1 Configure Sems to use Ser's Unix socket server
+
+
+    - edit Ser's configuration file (default location:
+      /usr/local/etc/ser/ser.cfg) and look for the 'unix_sock=' 
+      configuration parameter. It should look like:
+	 unix_sock="/tmp/ser_sock"
+
+      If the 'unix_sock' parameter does not exist, add it to the global 
+      section. If you have another value for that parameter, you don't need to
+      change it, just remember it.
+
+    - open Sems's configuration file (default location:
+      /usr/local/etc/sems/sems.conf) 
+      - look for the 'ser_socket_name=' parameter. It must have the 
+        same value as 'unix_sock=' in Ser's configuration file, 
+        but without quotes. In our example:
+
+         ser_socket_name=/tmp/ser_sock
+
+      - configure the socket on which sems will get responses from ser:
+
+         reply_socket_name=/tmp/sems_resp_sock
+
+      - then configure SEMS' socket itself, useing the 
+        'socket_name=' parameter in sems.conf. Default value:
+
+	 socket_name=/tmp/sems_sock
+
+
+2.2 How to redirect a call to sems?
+
+2.2.1 How it works:
+
+So that a caller gets connected to Sems, Ser has to pass every SIP message
+concerning that call to Sems through unix socket. Basically, Sems 
+needs to get an INVITE message to begin a call, and a BYE message to terminate 
+that call. Sems must also be aware of CANCELs. ACKs should be absorbed by Ser, 
+as Sems does not need them. If you want SEMS to be aware of DTMF tones sent
+via SIP INFO messagees, they must be passed to SEMS as well. 
+Redirecting the messages is a very simple operation. You just have to 
+call the t_write_unix() function from the 'tm' module, which you have to 
+load. As ser needs to be aware about the transaction of the request, you #
+need to call t_newtran() before writing the request to the socket using 
+t_write_unix.
+
+2.2.2 Load Ser's tm module 
+
+    - add following line to your ser.cfg in the 'module loading' section:
+
+    loadmodule "/usr/local/lib/ser/modules/tm.so"
+
+    configure tm to also pass provisional replies to sems:
+    modparam("tm", "pass_provisional_replies", 1)
+
+2.2.3 Redirecting SIP messages to Sems:
+
+    - add following lines to your ser.cfg where you need to redirect the call:
+
+      # select messages to redirect:
+      if ( method=="ACK" || method=="INVITE" || method=="BYE" ||
+           method=="CANCEL" ){
+
+	   # switch to stateful mode:
+	   if (!t_newtran()){
+		sl_send_reply("500","could not create transaction");
+		break;
+	   };
+
+	   # prevent timeout on the other side:
+	   t_reply("100","Trying - just wait a minute !");
+	   
+	   if (method=="INVITE"){
+
+		# redirect the call to the 'conference' plug-in
+		# if the URI begin with 100
+		if (uri=~"sip:100.*@") {
+
+		   # assumes that Sems configuration parameter 'socket_name='
+		   # has been set to /tmp/am_sock
+		   if(!t_write_unix("/tmp/am_sock","conference")) {
+		      t_reply("500","error contacting sems");
+		   };
+		   break;
+		};
+
+		# redirect the call to the 'announcement' plug-in
+		# if the URI begin with 200
+		if (uri=~"sip:200.*@") {
+
+		   if(!t_write_unix("/tmp/am_sock","announcement")) {
+		      t_reply("500","error contacting sems");
+		   };
+		   break;
+		};
+
+		# no service number, redirect to voicemail.
+		# do not forget to load AVPs so that voicemail gets the
+		# callee's email address.
+		load_avp("ruri","email",0);
+		if(!t_write_unix("/tmp/am_sock","voicemail")) {
+		    t_reply("500","error contacting sems");
+		};
+		break;
+	   } 
+	   else if (method=="BYE" || method="CANCEL") {
+
+		# Sems should already know which plug-in is handling that
+                # call. "bye" is no plug-in name. It is a reserved name which
+		# tells Sems to terminate the call.
+
+		if(!t_write_unix("/tmp/am_sock","bye")) {
+		    t_reply("500","error contacting sems");
+		};
+	   } 
+	   else if (method=="ACK") {
+		# absorb ACKs
+		t_relay();
+	   }
+ 
+      };
+
+In more complicated scenario, you could also redirect REFERs to Sems which
+would enable you for example to implement a click-to-dial, or invite other
+users to take part to conference.
+
+2.3 Passing additional parameters to SEMS: email address for voicemail
+
+Arbitrary AVPs (attribute value pairs) can be appended to a request when it is
+written to sems with t_write_req/t_write_unix using tw_append. The AVPs can
+e.g. be loaded from a database before, modified with avpops etc. 
+
+This is a flexible method, e.g. the language of a user can be stored in the
+database, and the greeting and voicemail template will be selected according
+to the language.
+
+For the voicemail plug-in to work properly, sems has to get the email address
+of the callee. As email adresses are usually stored in a database and ser
+usually already has a db connection, the email address is looked up when the 
+INVITE request is processed and added as extra header 'P-Email-Address' to 
+the request. Then SEMS gets the address from this header.
+
+The relevant parts of the ser configuration then look like this:
+
+# load db module
+loadmodule "/usr/local/lib/ser/modules/mysql.so"
+
+# load avp modules
+loadmodule "modules/avp/avp.so"
+loadmodule "modules/avpops/avpops.so"
+
+# configure avpops db connection
+modparam( "avpops", "avp_url", "mysql://ser:heslo@localhost/ser" )
+modparam( "avpops", "avp_table", "subscriber" )
+modparam( "avpops", "uuid_column", "id" )
+
+# configure aliases, the number doesn't matter as long as there are no collisions)
+modparam( "avpops", "avp_aliases", "email=i:67 ; language=i:68" )
+
+# scheme to access the database
+modparam( "avpops", "db_scheme", 
+	  "email_scheme:table=subscriber;value_col=email_address;value_type=string")
+modparam( "avpops", "db_scheme", 
+	  "language_scheme:table=subscriber;value_col=language;value_type=string")
+
+# configure tm to append this when tw_appent voicemail_headers is used
+modparam("tm", "tw_append",
+	       "voicemail_headers:P-Email-Address=avp[$email];P-Language=avp[$language]")
+
+# ...
+
+# in route section:
+                        # no service number, redirect to voicemail.
+
+			avp_db_load( "$ruri", "$email/$email_scheme");
+			avp_db_load( "$ruri", "$language/$language_scheme");
+
+			if(!t_write_unix("/tmp/sems_sock","voicemail/voicemail_headers")) {
+			   t_reply("500","error contacting sems");
+			};
+			break;
+
+
+This assumes that there is a column 'id', a column 'username', a column 'email_address' and a
+column 'language' in the table named 'subscriber'. dbtext sample file:
+----- subscriber  --------------------------------
+id(int,auto) username(str,null) domain(str,null) email_address(str,null) language(str,null)
+1:Alice:iptel.org:alice@mymail.org:english
+2:rco:iptel.org:rco@iptel.org:french
+3:Alex:iptel.org:alex@iptel.org:german
+----- subsciber end ------------------------------
+
+2.4 Passing SIP INFO messages to SEMS for DTMF 
+
+The same mechanism using tw_append is used to pass the headers content-type, content-length
+and the body of an INFO message to SEMS:
+
+modparam( "tm", "tw_append",
+   "info_append:hdr[Content-Length];hdr[Content-Type];msg[body]")
+...
+
+if (method=="INFO") {
+        if(!t_write_unix("/tmp/sems_sock","sems/info_append")){
+            log("could not contact sems\n");
+            t_reply("500","could not contact media server");
+        };
+} 
+
+2.5 Passing arbitrary parameters to SEMS
+
+For early media announcements (early_announce app) the final reply code
+can be configured from the ser configuration. 
+
+modparam( "avpops", "avp_aliases", "early_code=i:66 ; early_reason=i:67" )
+
+# this is to be appended to the invite
+modparam("tm", "tw_append",
+               "early_headers:P-Final-Reply-Code=avp[$early_code];P-Final-Reply-Reason=avp[$early_reason]")
+
+...
+
+   avp_write("405", "$early_code");
+   avp_write("Prohiboted", "$early_reason");
+
+   if(!t_write_unix("/tmp/sems_sock","early_announce/early_headers")){
+             log("could not contact early_announce\n");
+             t_reply("404","not found");
+   };
+   break;
+
+
+3. Configuration files used in this HOWTO
+
+<tbd>
diff --git a/apps/ann_b2b/Readme b/doc/Readme.ann_b2b
similarity index 100%
rename from apps/ann_b2b/Readme
rename to doc/Readme.ann_b2b
diff --git a/apps/announcement/Readme b/doc/Readme.announcement
similarity index 100%
rename from apps/announcement/Readme
rename to doc/Readme.announcement
diff --git a/apps/conference/Readme b/doc/Readme.conference
similarity index 100%
rename from apps/conference/Readme
rename to doc/Readme.conference
diff --git a/apps/early_announce/Readme b/doc/Readme.early_announce
similarity index 100%
rename from apps/early_announce/Readme
rename to doc/Readme.early_announce
diff --git a/apps/mp3/ReadmeMP3.txt b/doc/Readme.mp3
similarity index 100%
rename from apps/mp3/ReadmeMP3.txt
rename to doc/Readme.mp3
diff --git a/apps/voicemail/README.mail-template b/doc/Readme.voicemail
similarity index 100%
rename from apps/voicemail/README.mail-template
rename to doc/Readme.voicemail