docs: cleanup in xml files
authorDaniel-Constantin Mierla <miconda@gmail.com>
Sat, 18 Jun 2011 21:21:41 +0000 (23:21 +0200)
committerDaniel-Constantin Mierla <miconda@gmail.com>
Sat, 18 Jun 2011 21:21:41 +0000 (23:21 +0200)
- useless revision history removed
- docs depend on entities.xml
- updated global entities
- fixed the links to users and devel mailing lists
- fixed the link to tracker

383 files changed:
Makefile.modules
docbook/Makefile
docbook/entities.xml
modules/app_python/README
modules/auth_identity/README
modules/avpops/README
modules/avpops/doc/avpops.xml
modules/blst/README
modules/blst/doc/blst.xml
modules/blst/doc/functions.xml
modules/blst/doc/params.xml
modules/carrierroute/README
modules/carrierroute/doc/carrierroute.xml
modules/cfg_db/README
modules/cfg_db/doc/cfg_db.xml
modules/counters/README
modules/counters/doc/counters.xml
modules/counters/doc/functions.xml
modules/counters/doc/params.xml
modules/counters/doc/rpc.xml
modules/ctl/README
modules/ctl/doc/ctl.xml
modules/ctl/doc/params.xml
modules/ctl/doc/rpc.xml
modules/db_berkeley/README
modules/db_berkeley/doc/db_berkeley.xml
modules/db_berkeley/km_doc/db_berkeley.xml
modules/db_flatstore/README
modules/db_flatstore/doc/db_flatstore.xml
modules/db_flatstore/doc/functions.xml
modules/db_flatstore/doc/params.xml
modules/db_flatstore/km_doc/db_flatstore.xml
modules/db_mysql/README
modules/db_mysql/doc/db_mysql.xml
modules/db_postgres/README
modules/db_postgres/doc/db_postgres.xml
modules/dialplan/README
modules/dialplan/doc/dialplan.xml
modules/dialplan/doc/dialplan_devel.xml
modules/enum/README
modules/enum/doc/enum.xml
modules/iptrtpproxy/README
modules/iptrtpproxy/doc/iptrtpproxy.xml
modules/lcr/README
modules/lcr/doc/lcr.xml
modules/malloc_test/README
modules/malloc_test/doc/functions.xml
modules/malloc_test/doc/malloc_test.xml
modules/malloc_test/doc/params.xml
modules/malloc_test/doc/rpc.xml
modules/matrix/README
modules/matrix/doc/matrix.xml
modules/mediaproxy/README
modules/mediaproxy/doc/mediaproxy.xml
modules/mi_rpc/README
modules/pdb/README
modules/pdb/doc/pdb.xml
modules/peering/README
modules/peering/doc/peering.xml
modules/privacy/doc/privacy.xml
modules/ratelimit/README
modules/ratelimit/doc/ratelimit.xml
modules/rtpproxy/README
modules/rtpproxy/doc/rtpproxy.xml
modules/sanity/README
modules/sanity/doc/functions.xml
modules/sanity/doc/params.xml
modules/sanity/doc/sanity.xml
modules/sdpops/README
modules/sms/README
modules/sms/doc/functions.xml
modules/sms/doc/params.xml
modules/sms/doc/sms.xml
modules/tls/README
modules/tls/doc/certs_howto.xml
modules/tls/doc/functions.xml
modules/tls/doc/history.xml
modules/tls/doc/params.xml
modules/tls/doc/tls.xml
modules/tm/README
modules/tm/doc/api.xml
modules/tm/doc/functions.xml
modules/tm/doc/params.xml
modules/tm/doc/tm.xml
modules/xmlrpc/README
modules/xmlrpc/doc/functions.xml
modules/xmlrpc/doc/params.xml
modules/xmlrpc/doc/xmlrpc.xml
modules_k/acc/README
modules_k/acc/doc/acc.xml
modules_k/alias_db/README
modules_k/alias_db/doc/alias_db.xml
modules_k/auth_db/README
modules_k/auth_db/doc/auth_db.xml
modules_k/auth_diameter/README
modules_k/auth_diameter/doc/auth_diameter.xml
modules_k/auth_radius/README
modules_k/auth_radius/doc/auth_radius.xml
modules_k/benchmark/README
modules_k/benchmark/doc/benchmark.xml
modules_k/call_control/README
modules_k/call_control/doc/call_control.xml
modules_k/cfgutils/README
modules_k/cfgutils/doc/cfgutils.xml
modules_k/cpl-c/README
modules_k/cpl-c/doc/cpl-c.xml
modules_k/db_oracle/README
modules_k/db_oracle/doc/db_oracle.xml
modules_k/db_sqlite/README
modules_k/db_sqlite/doc/db_sqlite.xml
modules_k/db_text/README
modules_k/db_text/doc/db_text.xml
modules_k/db_unixodbc/README
modules_k/db_unixodbc/doc/db_unixodbc.xml
modules_k/dialog/README
modules_k/dialog/doc/dialog.xml
modules_k/dispatcher/README
modules_k/diversion/README
modules_k/diversion/doc/diversion.xml
modules_k/domain/README
modules_k/domain/doc/domain.xml
modules_k/domainpolicy/README
modules_k/domainpolicy/doc/domainpolicy.xml
modules_k/drouting/README
modules_k/drouting/doc/drouting.xml
modules_k/exec/README
modules_k/exec/doc/exec.xml
modules_k/group/README
modules_k/group/doc/group.xml
modules_k/h350/README
modules_k/h350/doc/h350.xml
modules_k/htable/README
modules_k/imc/README
modules_k/imc/doc/imc.xml
modules_k/ldap/README
modules_k/ldap/doc/ldap.xml
modules_k/maxfwd/README
modules_k/maxfwd/doc/maxfwd.xml
modules_k/memcached/README
modules_k/mi_datagram/README
modules_k/mi_datagram/doc/mi_datagram.xml
modules_k/mi_fifo/README
modules_k/mi_fifo/doc/mi_fifo.xml
modules_k/mi_xmlrpc/README
modules_k/mi_xmlrpc/doc/mi_xmlrpc.xml
modules_k/misc_radius/README
modules_k/misc_radius/doc/misc_radius.xml
modules_k/msilo/README
modules_k/msilo/doc/msilo.xml
modules_k/nat_traversal/README
modules_k/nat_traversal/doc/nat_traversal.xml
modules_k/nathelper/README
modules_k/nathelper/doc/nathelper.xml
modules_k/osp/README
modules_k/osp/doc/osp.xml
modules_k/p_usrloc/README
modules_k/p_usrloc/doc/p_usrloc.xml
modules_k/p_usrloc/doc/p_usrloc_devel.xml
modules_k/p_usrloc/doc/p_usrloc_user.xml
modules_k/path/README
modules_k/path/doc/path.xml
modules_k/pdt/README
modules_k/pdt/doc/pdt.xml
modules_k/pdt/pdt.c
modules_k/perl/README
modules_k/perl/doc/perl.xml
modules_k/perl/doc/perl_samples.xml
modules_k/perlvdb/README
modules_k/perlvdb/doc/perlvdb.xml
modules_k/permissions/README
modules_k/permissions/doc/permissions.xml
modules_k/pike/README
modules_k/pike/doc/pike.xml
modules_k/presence/README
modules_k/presence/doc/presence.xml
modules_k/presence_dialoginfo/README
modules_k/presence_dialoginfo/doc/presence_dialoginfo.xml
modules_k/presence_mwi/README
modules_k/presence_mwi/doc/presence_mwi.xml
modules_k/presence_xml/README
modules_k/presence_xml/doc/presence_xml.xml
modules_k/pua/README
modules_k/pua/doc/pua.xml
modules_k/pua_bla/README
modules_k/pua_bla/doc/pua_bla.xml
modules_k/pua_dialoginfo/README
modules_k/pua_dialoginfo/doc/pua_dialoginfo.xml
modules_k/pua_mi/README
modules_k/pua_mi/doc/pua_mi.xml
modules_k/pua_usrloc/README
modules_k/pua_usrloc/doc/pua_usrloc.xml
modules_k/pua_xmpp/README
modules_k/pua_xmpp/doc/pua_xmpp.xml
modules_k/purple/README
modules_k/pv/README
modules_k/qos/README
modules_k/qos/doc/qos.xml
modules_k/regex/README
modules_k/regex/doc/regex.xml
modules_k/registrar/README
modules_k/registrar/doc/registrar.xml
modules_k/rls/README
modules_k/rls/doc/rls.xml
modules_k/rr/README
modules_k/rr/doc/rr.xml
modules_k/rtimer/README
modules_k/seas/README
modules_k/siputils/README
modules_k/siputils/doc/siputils.xml
modules_k/snmpstats/README
modules_k/snmpstats/doc/snmpstats.xml
modules_k/speeddial/README
modules_k/speeddial/doc/speeddial.xml
modules_k/sqlops/README
modules_k/sst/README
modules_k/sst/doc/sst.xml
modules_k/statistics/README
modules_k/statistics/doc/statistics.xml
modules_k/textops/README
modules_k/textops/doc/textops.xml
modules_k/tmx/README
modules_k/uac_redirect/README
modules_k/uac_redirect/doc/uac_redirect.xml
modules_k/uri_db/README
modules_k/uri_db/doc/uri_db.xml
modules_k/userblacklist/README
modules_k/userblacklist/doc/userblacklist.xml
modules_k/usrloc/README
modules_k/usrloc/doc/usrloc.xml
modules_k/xcap_client/README
modules_k/xcap_client/doc/xcap_client.xml
modules_k/xlog/README
modules_k/xlog/doc/xlog.xml
modules_k/xmpp/README
modules_k/xmpp/doc/xmpp.xml
modules_s/acc_syslog/README
modules_s/acc_syslog/doc/acc_syslog.xml
modules_s/acc_syslog/doc/functions.xml
modules_s/acc_syslog/doc/params.xml
modules_s/auth_db/README
modules_s/auth_db/doc/auth_db.xml
modules_s/auth_db/doc/functions.xml
modules_s/auth_db/doc/params.xml
modules_s/auth_radius/README
modules_s/auth_radius/doc/auth_radius.xml
modules_s/auth_radius/doc/functions.xml
modules_s/auth_radius/doc/params.xml
modules_s/avp/README
modules_s/avp/doc/avp.xml
modules_s/avp/doc/functions.xml
modules_s/avp/doc/params.xml
modules_s/avp_db/README
modules_s/avp_db/doc/avp_db.xml
modules_s/avp_db/doc/fifo.xml
modules_s/avp_db/doc/functions.xml
modules_s/avp_db/doc/params.xml
modules_s/avp_radius/README
modules_s/avp_radius/doc/avp_radius.xml
modules_s/avp_radius/doc/functions.xml
modules_s/avp_radius/doc/params.xml
modules_s/bdb/README
modules_s/bdb/doc/bdb.xml
modules_s/cpl-c/README
modules_s/cpl-c/doc/cpl-c.xml
modules_s/cpl-c/doc/functions.xml
modules_s/cpl-c/doc/params.xml
modules_s/db_ops/README
modules_s/db_ops/doc/db_ops.xml
modules_s/dbtext/README
modules_s/dbtext/doc/dbtext.xml
modules_s/dispatcher/README
modules_s/dispatcher/doc/dispatcher.xml
modules_s/dispatcher/doc/fifo.xml
modules_s/dispatcher/doc/functions.xml
modules_s/dispatcher/doc/params.xml
modules_s/domain/README
modules_s/domain/doc/domain.xml
modules_s/domain/doc/fifo.xml
modules_s/domain/doc/functions.xml
modules_s/domain/doc/params.xml
modules_s/exec/README
modules_s/exec/doc/exec.xml
modules_s/exec/doc/functions.xml
modules_s/exec/doc/params.xml
modules_s/gflags/README
modules_s/gflags/doc/fifo.xml
modules_s/gflags/doc/functions.xml
modules_s/gflags/doc/gflags.xml
modules_s/gflags/doc/params.xml
modules_s/gflags/doc/xmlrpc.xml
modules_s/ldap/README
modules_s/ldap/doc/ldap.xml
modules_s/mangler/README
modules_s/mangler/doc/functions.xml
modules_s/mangler/doc/mangler.xml
modules_s/mangler/doc/params.xml
modules_s/maxfwd/README
modules_s/maxfwd/doc/functions.xml
modules_s/maxfwd/doc/maxfwd.xml
modules_s/maxfwd/doc/params.xml
modules_s/msilo/README
modules_s/msilo/doc/functions.xml
modules_s/msilo/doc/msilo.xml
modules_s/msilo/doc/params.xml
modules_s/nathelper/README
modules_s/nathelper/doc/functions.xml
modules_s/nathelper/doc/nathelper.xml
modules_s/nathelper/doc/params.xml
modules_s/options/README
modules_s/options/doc/functions.xml
modules_s/options/doc/options.xml
modules_s/options/doc/params.xml
modules_s/osp/README
modules_s/osp/doc/osp.xml
modules_s/osp/doc/osp_devel.xml
modules_s/osp/doc/osp_faq.xml
modules_s/osp/doc/osp_user.xml
modules_s/pdt/README
modules_s/pdt/doc/fifo.xml
modules_s/pdt/doc/functions.xml
modules_s/pdt/doc/params.xml
modules_s/pdt/doc/pdt.xml
modules_s/pdt/pdt.c
modules_s/permissions/README
modules_s/permissions/doc/functions.xml
modules_s/permissions/doc/params.xml
modules_s/permissions/doc/permissions.xml
modules_s/permissions/doc/xmlrpc.xml
modules_s/pike/README
modules_s/pike/doc/devel.xml
modules_s/pike/doc/functions.xml
modules_s/pike/doc/params.xml
modules_s/pike/doc/pike.xml
modules_s/pike/doc/rpc.xml
modules_s/print/README
modules_s/print/doc/functions.xml
modules_s/print/doc/params.xml
modules_s/print/doc/print.xml
modules_s/registrar/README
modules_s/registrar/doc/functions.xml
modules_s/registrar/doc/params.xml
modules_s/registrar/doc/registrar.xml
modules_s/rr/README
modules_s/rr/doc/functions.xml
modules_s/rr/doc/params.xml
modules_s/rr/doc/rr.xml
modules_s/speeddial/README
modules_s/speeddial/doc/faq.xml
modules_s/speeddial/doc/functions.xml
modules_s/speeddial/doc/params.xml
modules_s/speeddial/doc/speeddial.xml
modules_s/textops/README
modules_s/textops/doc/functions.xml
modules_s/textops/doc/params.xml
modules_s/textops/doc/textops.xml
modules_s/timer/README
modules_s/timer/doc/timer.xml
modules_s/uac/README
modules_s/uac/doc/functions.xml
modules_s/uac/doc/params.xml
modules_s/uac/doc/uac.xml
modules_s/uri/README
modules_s/uri/doc/functions.xml
modules_s/uri/doc/params.xml
modules_s/uri/doc/uri.xml
modules_s/uri_db/README
modules_s/uri_db/doc/functions.xml
modules_s/uri_db/doc/params.xml
modules_s/uri_db/doc/uri_db.xml
modules_s/uri_radius/README
modules_s/uri_radius/doc/functions.xml
modules_s/uri_radius/doc/params.xml
modules_s/uri_radius/doc/uri_radius.xml
modules_s/usrloc/README
modules_s/usrloc/doc/api.xml
modules_s/usrloc/doc/functions.xml
modules_s/usrloc/doc/params.xml
modules_s/usrloc/doc/usrloc.xml
modules_s/xlog/README
modules_s/xlog/doc/api.xml
modules_s/xlog/doc/functions.xml
modules_s/xlog/doc/params.xml
modules_s/xlog/doc/xlog.xml

index 27cd0cd..1e198d6 100644 (file)
@@ -273,7 +273,7 @@ $(share_prefix)/$(share_dir):
 ifneq (,$(wildcard doc/Makefile))
 #doc/Makefile present => we can generate README
 
-README: doc/*.xml
+README: doc/*.xml ../../docbook/entities.xml
        $(MAKE) -C doc $(MOD_NAME).txt
        mv doc/$(MOD_NAME).txt $@
 
index 36c79da..bdd43bf 100644 (file)
@@ -113,7 +113,8 @@ ifeq ($(validate), 0)
        override xsltproc_flags := $(xsltproc_flags) --novalid
 endif
 
-all_deps = Makefile $(docbook_dir)/Makefile $(dep_xsl) $(catalog) $(extra_deps)
+all_deps = Makefile $(docbook_dir)/Makefile $(docbook_dir)/entities.xml \
+                  $(dep_xsl) $(catalog) $(extra_deps)
 
 all: txt
 
index 9af3db6..9bd1679 100644 (file)
@@ -3,23 +3,21 @@
 <!ENTITY fhg "FhG FOKUS">
 <!ENTITY iptel "<ulink url='http://iptel.org'>iptel.org</ulink>">
 
+<!-- Kamailio specific attributes -->
+
 <!ENTITY kamailio "Kamailio">
 <!ENTITY kamailiobinary "kamailio">
 <!ENTITY kamailioname "Kamailio SIP Server Platform">
 <!ENTITY kamailioconfig "kamailio.cfg">
 
-<!ENTITY siprouter "SIP Router">
-<!ENTITY siproutername "SIP Router Project">
-<!ENTITY siprouterconfig "sip-router.cfg">
-
 <!ENTITY kamwiki "http://www.kamailio.org/dokuwiki/">
 <!ENTITY kamwikilink "<ulink url='&kamwiki;'>&kamwiki;</ulink>">
 
 <!ENTITY kamailiohome "http://www.kamailio.org/">
-<!ENTITY kamailiobugs "http://sourceforge.net/tracker/?group_id=139143">
-<!ENTITY kamailiohelp "http://lists.kamailio.org/cgi-bin/mailman/listinfo/team">
-<!ENTITY kamailiousers "http://lists.kamailio.org/cgi-bin/mailman/listinfo/users">
-<!ENTITY kamailiodev "http://lists.kamailio.org/cgi-bin/mailman/listinfo/devel">
+<!ENTITY kamailiobugs "http://sip-router.org/tracker">
+<!ENTITY kamailiohelp "http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users">
+<!ENTITY kamailiousers "http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users">
+<!ENTITY kamailiodev "http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev">
 <!ENTITY kamailiodbdocs "http://www.kamailio.org/docs/db-tables/kamailio-db-devel.html">
 
 <!ENTITY kamailiohomelink "<ulink url='&kamailiohome;'>&kamailiohome;</ulink>">
@@ -29,9 +27,9 @@
 <!ENTITY kamailiodevlink "<ulink url='&kamailiodev;'>&kamailiodev;</ulink>">
 <!ENTITY kamailiodbdocslink "<ulink url='&kamailiodbdocs;'>&kamailiodbdocs;</ulink>">
 
-<!ENTITY kamailiohelpmail "<email>team@lists.kamailio.org</email>">
-<!ENTITY kamailiousersmail "<email>users@lists.kamailio.org</email>">
-<!ENTITY kamailiodevmail "<email>devel@lists.kamailio.org</email>">
+<!ENTITY kamailiohelpmail "<email>sr-users@lists.sip-router.org</email>">
+<!ENTITY kamailiousersmail "<email>sr-users@lists.sip-router.org</email>">
+<!ENTITY kamailiodevmail "<email>sr-dev@lists.sip-router.org</email>">
 
 <!ENTITY ctltool "kamctl">
 <!ENTITY ctltoolrc "kamctlrc">
 <!ENTITY develguide "Developer Guide">
 <!ENTITY faqguide "Frequently Asked Questions">
 
+<!-- SER Specific Attributes -->
+
+<!ENTITY siprouter "SIP Router">
+<!ENTITY siproutername "SIP Router Project">
+<!ENTITY siprouterconfig "sip-router.cfg">
+
 <!ENTITY ser "SER">
 <!ENTITY sername "SIP Express Router">
 <!ENTITY sercmd "sercmd">
 <!ENTITY ctlsocket "ser_ctl">
 
 <!ENTITY serhome "http://iptel.org/ser">
-<!ENTITY serbugs "http://iptel.org/ser/bugs">
-<!ENTITY serusers "http://mail.iptel.org/mailman/listinfo/serusers">
-<!ENTITY serdev "http://mail.iptel.org/mailman/listinfo/serdev">
+<!ENTITY serbugs "http://sip-router.org/tracker">
+<!ENTITY serusers "http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users">
+<!ENTITY serdev "http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev">
 
 <!ENTITY serhomelink "<ulink url='&serhome;'>&serhome;</ulink>">
 <!ENTITY serbugslink "<ulink url='&serbugs;'>&serbugs;</ulink>">
@@ -56,8 +60,8 @@
 <!ENTITY seruserslink "<ulink url='&serusers;'>&serusers;</ulink>">
 <!ENTITY serdevlink "<ulink url='&serdev;'>&serdev;</ulink>">
 
-<!ENTITY serusersmail "<email>serusers@iptel.org</email>">
-<!ENTITY serdevmail "<email>serdev@iptel.org</email>">
+<!ENTITY serusersmail "<email>sr-users@lists.sip-router.org</email>">
+<!ENTITY serdevmail "<email>sr-dev@lists.sip-router.org</email>">
 
 <!ENTITY defaultdb "mysql://openser:openserrw@localhost/openser">
 <!ENTITY defaultrodb "mysql://openserro:openserro@localhost/openser">
@@ -93,6 +97,3 @@
 <!ENTITY rfc3261 "<ulink url='http://www.ietf.org/rfc/rfc3261.txt'>RFC3261</ulink>">
 <!ENTITY rfc822 "<ulink url='http://www.ietf.org/rfc/rfc822.txt'>RFC822</ulink>">
 <!ENTITY rfc2543 "<ulink url='http://www.ietf.org/rfc/rfc2543.txt'>RFC2543</ulink>">
-
-<!ENTITY vsname "Voice Sistem SRL">
-<!ENTITY voicesystem "<ulink url='http://www.voice-system.ro'>voice-system.ro</ulink>">
index 0253212..5000b61 100644 (file)
@@ -6,28 +6,28 @@ Edited by
 
 Maxim Sobolev
 
-   Copyright © 2010 Maxim Sobolev
+   Copyright Â© 2010 Maxim Sobolev
      __________________________________________________________________
 
    Table of Contents
 
    1. Admin Guide
 
-        1.1. Overview
-        1.2. Dependencies
+        1. Overview
+        2. Dependencies
 
-              1.2.1. Kamailio Modules
-              1.2.2. External Libraries or Applications
+              2.1. Kamailio Modules
+              2.2. External Libraries or Applications
 
-        1.3. Exported Parameters
+        3. Exported Parameters
 
-              1.3.1. script_name (string)
-              1.3.2. mod_init_function (string)
-              1.3.3. child_init_method (string)
+              3.1. script_name (string)
+              3.2. mod_init_function (string)
+              3.3. child_init_method (string)
 
-        1.4. Exported Functions
+        4. Exported Functions
 
-              1.4.1. python_exec(method [, mystr])
+              4.1. python_exec(method [, mystr])
 
    List of Examples
 
@@ -38,62 +38,89 @@ Maxim Sobolev
 
 Chapter 1. Admin Guide
 
-1.1. Overview
+   Table of Contents
+
+   1. Overview
+   2. Dependencies
+
+        2.1. Kamailio Modules
+        2.2. External Libraries or Applications
+
+   3. Exported Parameters
+
+        3.1. script_name (string)
+        3.2. mod_init_function (string)
+        3.3. child_init_method (string)
+
+   4. Exported Functions
+
+        4.1. python_exec(method [, mystr])
+
+1. Overview
 
    This module allows executing Python scripts from config file, exporting
    functions to access the SIP message from Python.
 
-1.2. Dependencies
+2. Dependencies
+
+   2.1. Kamailio Modules
+   2.2. External Libraries or Applications
 
-1.2.1. Kamailio Modules
+2.1. Kamailio Modules
 
    The following modules must be loaded before this module:
      * none.
 
-1.2.2. External Libraries or Applications
+2.2. External Libraries or Applications
 
    The following libraries or applications must be installed before
    running Kamailio with this module loaded:
      * python-dev - Python devel library.
 
-1.3. Exported Parameters
+3. Exported Parameters
 
-1.3.1. script_name (string)
+   3.1. script_name (string)
+   3.2. mod_init_function (string)
+   3.3. child_init_method (string)
+
+3.1. script_name (string)
 
    TBD.
 
-   Default value is "/usr/local/etc/sip-router/handler.py".
+   Default value is “/usr/local/etc/sip-router/handler.py”.
 
    Example 1.1. Set script_name parameter
 ...
 modparam("app_python", "script_name", "/usr/local/etc/sip-router/myscript.py")
 ...
 
-1.3.2. mod_init_function (string)
+3.2. mod_init_function (string)
 
    TBD.
 
-   Default value is "mod_init".
+   Default value is “mod_init”.
 
    Example 1.2. Set mod_init_function parameter
 ...
 modparam("app_python", "mod_init_function", "my_mod_init")
 ...
 
-1.3.3. child_init_method (string)
+3.3. child_init_method (string)
 
    TBD.
 
-   Default value is "child_init".
+   Default value is “child_init”.
 
    Example 1.3. Set child_init_method parameter
 ...
 modparam("app_python", "child_init_method", "my_child_init")
 ...
 
-1.4. Exported Functions
+4. Exported Functions
+
+   4.1. python_exec(method [, mystr])
 
-1.4.1. python_exec(method [, mystr])
+4.1.  python_exec(method [, mystr])
 
    TBD.
 
index 592f0aa..a1a078c 100644 (file)
@@ -4,7 +4,7 @@ Gergely Kovacs
 
    Iptel.org
 
-   Copyright © 2007 Iptel.org
+   Copyright Â© 2007 Iptel.org
      __________________________________________________________________
 
    1.1. Overview
@@ -150,7 +150,7 @@ modparam("auth_identity","msg_timeout",600)
 
 1.6. Authorizer service functions
 
-1.6.1. auth_date_proc()
+1.6.1.  auth_date_proc()
 
    If a message, the auth service should authorize, contains Date header
    then this function checks whether it falls in message timeout (set by
@@ -163,7 +163,7 @@ modparam("auth_identity","msg_timeout",600)
 
    No dependencies
 
-1.6.2. auth_add_identity()
+1.6.2.  auth_add_identity()
 
    Assembles digest-string from the message, calculates its SHA1 hash,
    encrypts it with the private key (set by privatekey_path parameter) of
@@ -293,7 +293,7 @@ modparam("auth_identity","accept_pem_certs",1)
 
 1.9. Verifier service functions
 
-1.9.1. vrfy_check_date()
+1.9.1.  vrfy_check_date()
 
    Checks Date header of the incoming message whether falls in validity
    time (set by auth_validity_time parameter)
@@ -302,7 +302,7 @@ modparam("auth_identity","accept_pem_certs",1)
 
    No dependencies
 
-1.9.2. vrfy_get_certificate()
+1.9.2.  vrfy_get_certificate()
 
    Tries to get certificate defined by the value of Identity-info header
    from certificate table (which size is set by certificate_cache_limit
@@ -313,7 +313,7 @@ modparam("auth_identity","accept_pem_certs",1)
 
    No dependencies
 
-1.9.3. vrfy_check_certificate()
+1.9.3.  vrfy_check_certificate()
 
    Checks whether the downloaded certificate is valid (is not expired, its
    subject and the domain part of the URL are the same) and adds it to
@@ -323,7 +323,7 @@ modparam("auth_identity","accept_pem_certs",1)
 
    vrfy_get_certificate() must be called before
 
-1.9.4. vrfy_check_msgvalidity()
+1.9.4.  vrfy_check_msgvalidity()
 
    Assembles digest-string from the message, create SHA1 hash and compares
    it with the decrypted value of Identity header.
@@ -333,7 +333,7 @@ modparam("auth_identity","accept_pem_certs",1)
    vrfy_get_certificate() must be called before and
    vrfy_check_certificate() should be called before
 
-1.9.5. vrfy_check_callid()
+1.9.5.  vrfy_check_callid()
 
    Checks whether the current call's been already processed in validity
    time (set by auth_validity_time) to recognize call replay attacks. If
index a12fd2b..ed017cc 100644 (file)
@@ -10,9 +10,7 @@ Ramona-Elena Modroiu
 
    <ramona@rosdev.ro>
 
-   Copyright © 2004, 2005 voice-system.ro
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2004, 2005 Voice Sistem SRL
      __________________________________________________________________
 
    Table of Contents
index b008525..62b9e70 100644 (file)
        <copyright>
                <year>2004</year>
                <year>2005</year>
-               <holder>&voicesystem;</holder>
+               <holder>Voice Sistem SRL</holder>
        </copyright>
-       <revhistory>
-               <revision>
-                       <revnumber>$Revision$</revnumber>
-                       <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
 
index 74260de..0f884aa 100644 (file)
@@ -5,8 +5,6 @@ Andrei Pelinescu-Onciul
    iptelorg GmbH
 
    Copyright © 2007 iptelorg GmbH
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    1.1. Overview
@@ -28,9 +26,6 @@ Andrei Pelinescu-Onciul
 
 1.2. Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.2.1.  blst_add([timeout])
 
    Adds the source of the current message to the blacklist for timeout
index dc0eee1..a912cae 100644 (file)
            <year>2007</year>
            <holder>iptelorg GmbH</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Blst Module</title>
index 3c80996..458a746 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="blst.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Functions</title>
index 23d9865..9e2c13f 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="textops.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Parameters</title>
index 8c43796..434efe5 100644 (file)
@@ -13,8 +13,6 @@ Henning Westerholt
    1&1 Internet AG
 
    Copyright © 2007 1&1 Internet AG
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index a9f11c4..c96119b 100644 (file)
                <year>2007</year>
                <holder>1&amp;1 Internet AG</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
 
index f8443b1..3653085 100644 (file)
@@ -4,9 +4,7 @@ Tomas Mandys
 
    Iptel.org
 
-   Copyright © 2008 Tomas Mandys
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2008 Tomas Mandys
      __________________________________________________________________
 
    1.1. Overview
index fcd52ad..0ff00a3 100644 (file)
            <year>2008</year>
            <holder>Tomas Mandys</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
 
     </sectioninfo>
 
index 59b3fc6..4073ee2 100644 (file)
@@ -4,9 +4,7 @@ Andrei Pelinescu-Onciul
 
    iptelorg GmbH
 
-   Copyright © 2010 iptelorg GmbH
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2010 iptelorg GmbH
      __________________________________________________________________
 
    1.1. Overview
@@ -37,9 +35,6 @@ Andrei Pelinescu-Onciul
 
 1.2. Parameters
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.2.1. script_counter
 
    Define a new counter that can be used from the script. The declaration
@@ -69,9 +64,6 @@ modparam("counters", "script_cnt_grp_name", "my_counters")
 
 1.3. Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.3.1.  cnt_inc([group.]name)
 
    Increments the counter group.name. The counter must be defined using
@@ -123,9 +115,6 @@ route {
 
 1.4. counters RPC Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.4.1.  cnt.get group counter_name
 
    Get the value of the counter identified by group.counter_name.
index d6241bc..dd9bae3 100644 (file)
                <year>2010</year>
                <holder>iptelorg GmbH</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>Counters Module</title>
index a004872..fbba353 100644 (file)
 
 <section id="cnts.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
         <sectioninfo>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>Functions</title>
index e8b1510..404b818 100644 (file)
@@ -9,12 +9,6 @@
 
 <section id="cnts.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-               <revhistory>
-                       <revision>
-                               <revnumber>$Revision$</revnumber>
-                               <date>$Date$</date>
-                       </revision>
-               </revhistory>
        </sectioninfo>
        <title>Parameters</title>
 
index a01e6bb..b2f3af0 100644 (file)
@@ -9,12 +9,6 @@
 
 <section id="cnts.rpcs" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-               <revhistory>
-                       <revision>
-                               <revnumber>$Revision$</revnumber>
-                               <date>$Date$</date>
-                       </revision>
-               </revhistory>
        </sectioninfo>
        <title>counters RPC Functions</title>
 
index 555fa67..dd31889 100644 (file)
@@ -4,9 +4,7 @@ Andrei Pelinescu-Onciul
 
    iptelorg GmbH
 
-   Copyright © 2009 iptelorg GmbH
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2009 iptelorg GmbH
      __________________________________________________________________
 
    1.1. Overview
@@ -71,9 +69,6 @@ $ sercmd ps
 
 1.3. Parameters
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.3.1. binrpc (string)
 
    Specifies the transport used for the binrpc protocol. The following
@@ -204,9 +199,6 @@ modparam("ctl", "binrpc_struct_max_body_size", 3)
 
 1.4. SIP-router RPC Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.4.1.  ctl.listen
 
    List all the sockets on which the ctl module listens.
index cee4c36..21e2760 100644 (file)
                <year>2009</year>
                <holder>iptelorg GmbH</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>Ctl Module</title>
index 9bda753..3017e8f 100644 (file)
 
 <section id="ctl.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>Parameters</title>
index 07adc14..82b5165 100644 (file)
 
 <section id="ctl.rpcs" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>SIP-router RPC Functions</title>
index 2699c35..346a70f 100644 (file)
@@ -8,10 +8,7 @@ Edited by
 
 Will Quan
 
-   Copyright © 2007 Cisco Systems
-   Revision History
-   Revision $Revision: 846 $ $Date: 2006-05-22 09:15:40 -0500 (Mon, 22 May
-   2006) $
+   Copyright © 2007 Cisco Systems
      __________________________________________________________________
 
    Table of Contents
index d573f04..1cb019e 100644 (file)
            <year>2007</year>
            <holder>Cisco Systems</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision: 846 $</revnumber>
-               <date>$Date: 2006-05-22 09:15:40 -0500 (Mon, 22 May 2006) $</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
     
index 4ed6bcb..6bccfe7 100644 (file)
            <year>2007</year>
            <holder>Cisco Systems</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision: 846 $</revnumber>
-               <date>$Date: 2006-05-22 09:15:40 -0500 (Mon, 22 May 2006) $</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
 
index 6cdab5b..83e9970 100644 (file)
@@ -5,11 +5,17 @@ Jan Janak
    FhG FOKUS
    <jan@iptel.org>
 
-   Copyright © 2004, 2005 FhG FOKUS
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2004, 2005 FhG FOKUS
      __________________________________________________________________
 
+   1.1. Overview
+
+        1.1.1. Rotating Log Files
+
+   1.2. Parameters
+
+        1.2.1. flush (integer)
+
 1.1. Overview
 
    Db_flatstore is one of so-called SIP Router database modules. It does
@@ -82,9 +88,6 @@ sercmd flatstore.rotate
 
 1.2. Parameters
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.2.1. flush (integer)
 
    Enable or disable flushing after each write.
index 77dfeba..13db1a2 100644 (file)
            <year>2005</year>
            <holder>FhG FOKUS</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Db_flatstore Module</title>
index 5cfa5b0..b01042d 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="flatstore.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Functions</title>
index deda40a..d515cc6 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="flatstore.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Parameters</title>
index 34c51bb..99d2de2 100644 (file)
                <year>2005</year>
                <holder>FhG FOKUS</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
        
index 8903191..6e6f474 100644 (file)
@@ -10,7 +10,7 @@ Daniel-Constantin Mierla
 
    <miconda@gmail.com>
 
-   Copyright © 2006 voice-system.ro
+   Copyright © 2006 Voice Sistem SRL
      __________________________________________________________________
 
    Table of Contents
index 7f379b2..adfe356 100644 (file)
@@ -26,7 +26,7 @@
        </authorgroup>
        <copyright>
            <year>2006</year>
-           <holder>&voicesystem;</holder>
+           <holder>Voice Sistem SRL</holder>
        </copyright>
     </bookinfo>
     <toc></toc>
index f5be0af..2e59237 100644 (file)
@@ -9,8 +9,6 @@ Edited by
 Greg Fausak
 
    Copyright © 2003 Greg Fausak
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index 62e229b..f25359e 100644 (file)
            <year>2003</year>
            <holder>Greg Fausak</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
 
index 466d034..27b1d05 100644 (file)
@@ -12,12 +12,9 @@ Edited by
 
 Juha Heinanen
 
-   Copyright © 2007-2008 voice-system.ro
+   Copyright © 2007-2008 Voice Sistem SRL
 
    Copyright © 2008-2010 Juha Heinanen
-   Revision History
-   Revision $Revision: 1.1 $ $Date: 2007/08/30 13:16:22 $
-   Revision $Revision: 1.2 $ $Date: 2008/10/9 15:57 $
      __________________________________________________________________
 
    Table of Contents
@@ -461,7 +458,4 @@ xlog("translated to var $var(y) \n");
 
 Chapter 2. Developer's Guide
 
-   Revision History
-   Revision $Revision: 1.1 $ $Date: 2007/08/30 13:16:22 $
-
    The module does not provide any API to use in other Kamailio modules.
index 64ebe18..ddaf1ab 100644 (file)
@@ -16,7 +16,7 @@
                <author>
                <firstname>Andreea-Ancuta</firstname>
                <surname>Onofrei</surname>
-               <affiliation><orgname>&vsname;</orgname></affiliation>
+               <affiliation><orgname>Voice Sistem SRL</orgname></affiliation>
                <address>
                        <email>team@voice-system.ro</email>
                </address>
        </authorgroup>
        <copyright>
                <year>2007-2008</year>
-               <holder>&voicesystem;</holder>
+               <holder>Voice Sistem SRL</holder>
        </copyright>
        <copyright>
                <year>2008-2010</year>
                <holder>Juha Heinanen</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision: 1.1 $</revnumber>
-               <date>$Date: 2007/08/30 13:16:22 $</date>
-               </revision>
-               <revision>
-               <revnumber>$Revision: 1.2 $</revnumber>
-               <date>$Date: 2008/10/9 15:57 $</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
        
index a5a7394..5a2afa0 100644 (file)
 
 <chapter>
        <chapterinfo>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision: 1.1 $</revnumber>
-               <date>$Date: 2007/08/30 13:16:22 $</date>
-               </revision>
-       </revhistory>
        </chapterinfo>
        <title>Developer's Guide</title>
        <para>
index b29e1c0..a42378f 100644 (file)
@@ -9,8 +9,6 @@ Otmar Lendl
    <lendl@nic.at>
 
    Copyright © 2002, 2003 Juha Heinanen
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index c9f65f7..d13dffa 100644 (file)
            <year>2003</year>
            <holder>Juha Heinanen</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
     
index 4a02c94..9c43df7 100644 (file)
@@ -4,9 +4,7 @@ Tomas Mandys
 
    Iptel.org
 
-   Copyright © 2007 Tomas Mandys
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2007 Tomas Mandys
      __________________________________________________________________
 
    1.1. Overview
index 10cfcc6..1314b3b 100644 (file)
            <year>2007</year>
            <holder>Tomas Mandys</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
 
     </sectioninfo>
 
index 061bb60..9b50e80 100644 (file)
@@ -11,8 +11,6 @@ Juha Heinanen
    <jh@tutpro.com>
 
    Copyright © 2005-2010 Juha Heinanen
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index cd1c1bd..fc7ccf9 100644 (file)
                <year>2005-2010</year>
                <holder>Juha Heinanen</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
 
index a989909..586c47b 100644 (file)
@@ -4,9 +4,7 @@ Andrei Pelinescu-Onciul
 
    iptelorg GmbH
 
-   Copyright © 2010 iptelorg GmbH
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2010 iptelorg GmbH
      __________________________________________________________________
 
    1.1. Overview
@@ -45,9 +43,6 @@ Warning
 
 1.2. Parameters
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.2.1. check_content
 
    When doing the tests, check also for the possibility of the memory
@@ -66,9 +61,6 @@ $ sercmd cfg.set_now_int malloc_test check_content 1
 
 1.3. Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.3.1. mt_mem_alloc(size)
 
    Allocates size bytes.
@@ -99,9 +91,6 @@ mem_free();
 
 1.4. malloc_test RPC Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.4.1.  mt.mem_alloc size [unit]
 
    Allocates the specified number of bytes. unit is optional and can be
index 8b69d02..d3462df 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="malloc_test.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>Functions</title>
index 13c9856..de0a2ea 100644 (file)
                        <year>2010</year>
                        <holder>iptelorg GmbH</holder>
                </copyright>
-               <revhistory>
-                       <revision>
-                       <revnumber>$Revision$</revnumber>
-                       <date>$Date$</date>
-                       </revision>
-               </revhistory>
        </sectioninfo>
 
        <title>malloc_test Module</title>
index 8e894bf..f8d92a8 100644 (file)
@@ -9,12 +9,6 @@
 
 <section id="malloc_test.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-               <revhistory>
-                       <revision>
-                               <revnumber>$Revision$</revnumber>
-                               <date>$Date$</date>
-                       </revision>
-               </revhistory>
        </sectioninfo>
        <title>Parameters</title>
 
index 667450a..7b89cba 100644 (file)
@@ -9,12 +9,6 @@
 
 <section id="malloc_test.rpcs" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-               <revhistory>
-                       <revision>
-                               <revnumber>$Revision$</revnumber>
-                               <date>$Date$</date>
-                       </revision>
-               </revhistory>
        </sectioninfo>
        <title>malloc_test RPC Functions</title>
 
index da70e3c..aa1e3ea 100644 (file)
@@ -12,9 +12,6 @@ Henning Westerholt
    <henning.westerholt@1und1.de>
 
    Copyright © 2008 1&1 Internet AG
-   Revision History
-   Revision $Revision: 4863 $ $Date: 2008-09-05 13:11:33 +0200 (Fri, 05
-                              Sep 2008) $
      __________________________________________________________________
 
    Table of Contents
index 6be135a..844df66 100644 (file)
                <year>2008</year>
                <holder>1&amp;1 Internet AG</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision: 4863 $</revnumber>
-               <date>$Date: 2008-09-05 13:11:33 +0200 (Fri, 05 Sep 2008) $</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
         <xi:include href="matrix_admin.xml"/>
index 56d7e83..5c7ab22 100644 (file)
@@ -11,8 +11,6 @@ Dan Pascu
    <dan@ag-projects.com>
 
    Copyright © 2004 Dan Pascu
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index cdf30be..ca6886e 100644 (file)
     <year>2004</year>
     <holder>Dan Pascu</holder>
   </copyright>
-  <revhistory>
-    <revision>
-    <revnumber>$Revision$</revnumber>
-    <date>$Date$</date>
-    </revision>
-  </revhistory>
   </bookinfo>
   <toc></toc>
 
index 5739c28..620268e 100644 (file)
@@ -11,7 +11,7 @@ Daniel-Constantin Mierla
 
    <miconda@gmail.com>
 
-   Copyright © 2009 http://www.asipto.com
+   Copyright Â© 2009 http://www.asipto.com
      __________________________________________________________________
 
    Table of Contents
index 7948a68..601b688 100644 (file)
@@ -11,10 +11,7 @@ Henning Westerholt
    1&1 Internet AG
    <henning.westerholt@1und1.de>
 
-   Copyright © 2009 1&1 Internet AG
-   Revision History
-   Revision $Revision: 4863 $ $Date: 2008-09-05 13:11:33 +0200 (Fri, 05
-   Sep 2008) $
+   Copyright © 2009 1&1 Internet AG
      __________________________________________________________________
 
    Table of Contents
@@ -116,7 +113,7 @@ Chapter 1. Admin Guide
 
    This is the timeout in milliseconds for the pdb_query function.
 
-   Default value is "50".
+   Default value is “50”.
 
    Example 1.1. Set timeout parameter
 ...
@@ -138,7 +135,7 @@ modparam("pdb", "server", "localhost:10001,host.name:10001,192.168.1.7:10002")
 
    4.1. pdb_query (string query, string dstavp)
 
-4.1. pdb_query (string query, string dstavp)
+4.1.  pdb_query (string query, string dstavp)
 
    Sends the query string to all configured servers and stores the answer
    in dstavp. If it takes more than the configured timeout, false is
@@ -162,7 +159,7 @@ cr_route("$avp(i:82)", "$rd", "$rU", "$rU", "call_id");
    5.2. pdb_activate
    5.3. pdb_deactivate
 
-5.1. pdb_status
+5.1.  pdb_status
 
    Prints the status of the module. This can either be "active" or
    "deactivated".
@@ -172,7 +169,7 @@ cr_route("$avp(i:82)", "$rd", "$rU", "$rU", "call_id");
 kamctl fifo pdb_status
 ...
 
-5.2. pdb_activate
+5.2.  pdb_activate
 
    Activates the module. This is the default after loading the module.
 
@@ -181,7 +178,7 @@ kamctl fifo pdb_status
 kamctl fifo pdb_activate
 ...
 
-5.3. pdb_deactivate
+5.3.  pdb_deactivate
 
    Deactivates the module. No more queries are performed until it is
    activated again. As long as the module is deactivated, the pdb_query
index 082fa91..2dffa9d 100644 (file)
                <year>2009</year>
                <holder>1&amp;1 Internet AG</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision: 4863 $</revnumber>
-               <date>$Date: 2008-09-05 13:11:33 +0200 (Fri, 05 Sep 2008) $</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
 
index ec3d4fe..2d5235a 100644 (file)
@@ -10,10 +10,7 @@ Juha Heinanen
 
    <jh@tutpro.com>
 
-   Copyright © 2008 Juha Heinanen
-   Revision History
-   Revision $Revision: 4261 $ $Date: 2008-05-30 01:03:56 +0200 (Fri, 30
-   Apr 2008) $
+   Copyright © 2008 Juha Heinanen
      __________________________________________________________________
 
    Table of Contents
@@ -119,7 +116,7 @@ Chapter 1. Admin Guide
    This is the location of the configuration file of Radius client
    libraries.
 
-   Default value is "/usr/local/etc/radiusclient-ng/radiusclient.conf".
+   Default value is “/usr/local/etc/radiusclient-ng/radiusclient.conf”.
 
    Example 1.1. radius_config parameter usage
 modparam("peering", "radius_config", "/etc/broker/radiusclient.conf")
@@ -130,7 +127,7 @@ modparam("peering", "radius_config", "/etc/broker/radiusclient.conf")
    sender of SIP Request verifies the request's destination using
    verify_destination() function.
 
-   Default value is the dictionary value of "Sip-Verify-Destination"
+   Default value is the dictionary value of “Sip-Verify-Destination”
    Service-Type.
 
    Example 1.2. verify_destination_service_type parameter usage
@@ -142,7 +139,7 @@ modparam("peering", "verify_destination_service_type", 21)
    receiver of SIP Request verifies the request's source using
    verify_source() function.
 
-   Default value is the dictionary value of "Sip-Verify-Source"
+   Default value is the dictionary value of “Sip-Verify-Source”
    Service-Type.
 
    Example 1.3. verify_source_service_type parameter usage
index df02bfb..1d1651a 100644 (file)
            <year>2008</year>
            <holder>Juha Heinanen</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision: 4261 $</revnumber>
-               <date>$Date: 2008-05-30 01:03:56 +0200 (Fri, 30 Apr 2008) $</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
 
index f9c17ac..ccec0a4 100644 (file)
                <holder>Dimensión Virtual S.L.</holder>
        </copyright>
        <para></para>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
        
index 03c3b71..e4d20dd 100644 (file)
@@ -18,11 +18,9 @@ Edited by
 
 Hendrik Scholz
 
-   Copyright © 2006 Freenet Cityline GmbH
+   Copyright Â© 2006 Freenet Cityline GmbH
 
-   Copyright © 2008-2010 VoIP Embedded Inc.
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2008-2010 VoIP Embedded Inc.
      __________________________________________________________________
 
    Table of Contents
@@ -51,53 +49,33 @@ Hendrik Scholz
               6.1. timer_interval (integer)
               6.2. queue (integer:string)
               6.3. pipe (integer:string:integer)
-              6.4. reply_code (integer)
-              6.5. reply_reason (string)
 
         7. Exported Functions
 
               7.1. rl_check([pvar])
               7.2. rl_check_pipe([pipe_no])
-              7.3. rl_drop([[min ], max])
-
-        8. Exported MI Functions
-
-              8.1. rl_stats
-              8.2. rl_set_pipe
-              8.3. rl_get_pipes
-              8.4. rl_set_queue
-              8.5. rl_get_queues
-              8.6. rl_set_pid
-              8.7. rl_get_pid
-              8.8. rl_push_load
-              8.9. rl_set_dbg
-
-        9. Exported RPC Functions
-
-              9.1. rl.stats
-              9.2. rl.set_pipe
-              9.3. rl.get_pipes
-              9.4. rl.set_queue
-              9.5. rl.get_queues
-              9.6. rl.set_pid
-              9.7. rl.get_pid
-              9.8. rl.push_load
-              9.9. rl.set_dbg
-
-        10. Known limitations
+
+        8. Exported RPC Functions
+
+              8.1. rl.stats
+              8.2. rl.set_pipe
+              8.3. rl.get_pipes
+              8.4. rl.set_queue
+              8.5. rl.get_queues
+              8.6. rl.set_pid
+              8.7. rl.get_pid
+              8.8. rl.push_load
+              8.9. rl.set_dbg
+
+        9. Known limitations
 
    List of Examples
 
    1.1. Set timer_interval parameter
    1.2. Set queue parameter
    1.3. Set pipe parameter
-   1.4. Set reply_code parameter
-   1.5. Set reply_code parameter at runtime
-   1.6. Set reply_reason parameter
-   1.7. Set reply_reason parameter at runtime
-   1.8. rl_check usage
-   1.9. rl_check_pipe usage
-   1.10. rl_drop usage
+   1.4. rl_check usage
+   1.5. rl_check_pipe usage
 
 Chapter 1. Admin Guide
 
@@ -125,40 +103,25 @@ Chapter 1. Admin Guide
         6.1. timer_interval (integer)
         6.2. queue (integer:string)
         6.3. pipe (integer:string:integer)
-        6.4. reply_code (integer)
-        6.5. reply_reason (string)
 
    7. Exported Functions
 
         7.1. rl_check([pvar])
         7.2. rl_check_pipe([pipe_no])
-        7.3. rl_drop([[min ], max])
-
-   8. Exported MI Functions
-
-        8.1. rl_stats
-        8.2. rl_set_pipe
-        8.3. rl_get_pipes
-        8.4. rl_set_queue
-        8.5. rl_get_queues
-        8.6. rl_set_pid
-        8.7. rl_get_pid
-        8.8. rl_push_load
-        8.9. rl_set_dbg
-
-   9. Exported RPC Functions
-
-        9.1. rl.stats
-        9.2. rl.set_pipe
-        9.3. rl.get_pipes
-        9.4. rl.set_queue
-        9.5. rl.get_queues
-        9.6. rl.set_pid
-        9.7. rl.get_pid
-        9.8. rl.push_load
-        9.9. rl.set_dbg
-
-   10. Known limitations
+
+   8. Exported RPC Functions
+
+        8.1. rl.stats
+        8.2. rl.set_pipe
+        8.3. rl.get_pipes
+        8.4. rl.set_queue
+        8.5. rl.get_queues
+        8.6. rl.set_pid
+        8.7. rl.get_pid
+        8.8. rl.push_load
+        8.9. rl.set_dbg
+
+   9. Known limitations
 
 1. Overview
 
@@ -183,7 +146,8 @@ Chapter 1. Admin Guide
 ...
         if (is_method("INVITE|REGISTER|SUBSCRIBE") {
                 if (!rl_check()) {
-                        rl_drop();
+                        append_to_reply("Retry-After: 5\r\n");
+                        sl_send_reply("503","Limiting");
                         exit;
                 };
         };
@@ -294,8 +258,6 @@ Chapter 1. Admin Guide
    6.1. timer_interval (integer)
    6.2. queue (integer:string)
    6.3. pipe (integer:string:integer)
-   6.4. reply_code (integer)
-   6.5. reply_reason (string)
 
 6.1. timer_interval (integer)
 
@@ -360,43 +322,10 @@ modparam("ratelimit", "pipe", "3:FEEDBACK:80")
 modparam("ratelimit", "pipe", "4:NETWORK:10000")
 ...
 
-6.4. reply_code (integer)
-
-   The code of the reply sent by Kamailio while limiting.
-
-   Default value is 503.
-
-   Example 1.4. Set reply_code parameter
-...
-modparam("ratelimit", "reply_code", 505)
-...
-
-   This value cant be modified at runtime using sercmd
-
-   Example 1.5.  Set reply_code parameter at runtime
-sercmd cfg.set_now_int ratelimit reply_code 505
-
-6.5. reply_reason (string)
-
-   The reason of the reply sent by Kamailio while limiting.
-
-   Default value is "Server Unavailable".
-
-   Example 1.6. Set reply_reason parameter
-...
-modparam("ratelimit", "reply_reason", "Limiting")
-...
-
-   This value cant be modified at runtime using sercmd
-
-   Example 1.7.  Set reply_reason parameter at runtime
-sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
-
 7. Exported Functions
 
    7.1. rl_check([pvar])
    7.2. rl_check_pipe([pipe_no])
-   7.3. rl_drop([[min ], max])
 
 7.1.  rl_check([pvar])
 
@@ -417,11 +346,12 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
 
    This function can be used from REQUEST_ROUTE.
 
-   Example 1.8. rl_check usage
+   Example 1.4. rl_check usage
 ...
         # perform queue/pipe match for current method
         if (!rl_check()) {
-                rl_drop();
+                append_to_reply("Retry-After: 5\r\n");
+                sl_send_reply("503","Limiting");
                 exit;
         };
 ...
@@ -429,7 +359,8 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
         # set int pvar to 1
         $var(p) = 1;
         if (!rl_check("$var(p)")) {
-                rl_drop();
+                append_to_reply("Retry-After: 5\r\n");
+                sl_send_reply("503","Limiting");
                 exit;
         };
 ...
@@ -437,7 +368,8 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
         # set str pvar to 1
         $var(p) = "1";
         if (!rl_check("$var(p)") {
-                rl_drop();
+                append_to_reply("Retry-After: 5\r\n");
+                sl_send_reply("503","Limiting");
                 exit;
         };
 ...
@@ -458,206 +390,36 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
 
    This function can be used from REQUEST_ROUTE.
 
-   Example 1.9. rl_check_pipe usage
+   Example 1.5. rl_check_pipe usage
 ...
         # perform queue/pipe match for current method
         if (!rl_check_pipe()) {
-                rl_drop();
+                append_to_reply("Retry-After: 5\r\n");
+                sl_send_reply("503","Limiting");
                 exit;
         };
 ...
         # use pipe no 1 for the current method
         if (!rl_check_pipe("1") {
-                rl_drop();
+                append_to_reply("Retry-After: 5\r\n");
+                sl_send_reply("503","Limiting");
                 exit;
         };
 ...
 
-7.3.  rl_drop([[min ], max])
-
-   For the current request, a "503 - Server Unavailable" reply is sent
-   back. The reply may or may not have a "Retry-After" header. If no
-   parameter is given, there will be no "Retry-After" header. If only the
-   max parameter is given, the reply will contain a "Retry-After: max"
-   header. If both min and max params are given, the reply will contain a
-   "Retry-After: random" header with random being a random value between
-   the given min and max.
-
-   Meaning of the parameters is as follows:
-     * min - the minimum value of "Retry-After" header.
-     * max - the maximum value of "Retry-After" header.
-
-   This function can be used from REQUEST_ROUTE.
-
-   Example 1.10. rl_drop usage
-...
-        if (!rl_check()) {
-                # send back a "503 - Server Unavailable"
-                # with a "Retry-After: 5"
-                rl_drop("5");
-                exit;
-        };
-...
-
-8. Exported MI Functions
-
-   8.1. rl_stats
-   8.2. rl_set_pipe
-   8.3. rl_get_pipes
-   8.4. rl_set_queue
-   8.5. rl_get_queues
-   8.6. rl_set_pid
-   8.7. rl_get_pid
-   8.8. rl_push_load
-   8.9. rl_set_dbg
-
-8.1.  rl_stats
-
-   Lists the parameters and variabiles in the ratelimit module.
-
-   Name: rl_stats
-
-   Parameters: none
-
-   MI FIFO Command Format:
-                :rl_stats:_reply_fifo_file_
-                _empty_line_
-
-8.2.  rl_set_pipe
-
-   Sets the pipe parameters for the given pipe id.
-
-   Name: rl_set_pipe
-
-   Parameters:
-     * pipe_id - pipe id.
-     * pipe_algorithm - the algorithm assigned to the given pipe id.
-     * pipe_limit - the limit assigned to the given pipe id.
-
-   MI FIFO Command Format:
-                :rl_set_pipe:_reply_fifo_file_
-                2
-                RED
-                10
-                _empty_line_
-
-8.3.  rl_get_pipes
-
-   Gets the list of in use pipes.
-
-   Name: rl_get_pipes
-
-   Parameters: none
-
-   MI FIFO Command Format:
-                :rl_get_pipes:_reply_fifo_file_
-                _empty_line_
-
-8.4.  rl_set_queue
-
-   Sets the queue parameters for the given queue id.
-
-   Name: rl_set_queue
-
-   Parameters:
-     * queue_id - queue id.
-     * queue_method - the method assigned to the given queue id.
-     * pipe_id - the pipe id assigned to the given queue id.
-
-   MI FIFO Command Format:
-                :rl_set_queue:_reply_fifo_file_
-                3
-                INVITE
-                2
-                _empty_line_
-
-8.5.  rl_get_queues
-
-   Gets the list of in use queues.
-
-   Name: rl_get_queues
-
-   Parameters: none
-
-   MI FIFO Command Format:
-                :rl_get_queues:_reply_fifo_file_
-                _empty_line_
-
-8.6.  rl_set_pid
-
-   Sets the PID Controller parameters for the Feedback Algorithm.
-
-   Name: rl_set_pid
-
-   Parameters:
-     * ki - the integral parameter.
-     * kp - the proportional parameter.
-     * kd - the derivative parameter.
-
-   MI FIFO Command Format:
-                :rl_set_pid:_reply_fifo_file_
-                0.5
-                0.5
-                0.5
-                _empty_line_
-
-8.7.  rl_get_pid
-
-   Gets the list of in use PID Controller parameters.
-
-   Name: rl_get_pid
-
-   Parameters: none
-
-   MI FIFO Command Format:
-                :rl_get_pid:_reply_fifo_file_
-                _empty_line_
-
-8.8.  rl_push_load
-
-   Force the value of the load parameter. This methos is usefull for
-   testing the Feedback algorithm.
-
-   Name: rl_push_load
-
-   Parameters:
-     * load - the forced value of load (it must be greater then 0.0 and
-       smaller then 1.0).
-
-   MI FIFO Command Format:
-                :rl_push_load:_reply_fifo_file_
-                0.85
-                _empty_line_
-
-8.9.  rl_set_dbg
-
-   This MI function will enable/disable a WARNING debug log exposing the
-   internal counters for each pipe (useful in monitoring the ratelimit
-   internals).
-
-   Name: rl_set_dbg
-
-   Parameters:
-     * dbg - the debug value (0 means disable and 1 means enable).
-
-   MI FIFO Command Format:
-                :rl_set_dbg:_reply_fifo_file_
-                1
-                _empty_line_
-
-9. Exported RPC Functions
+8. Exported RPC Functions
 
-   9.1. rl.stats
-   9.2. rl.set_pipe
-   9.3. rl.get_pipes
-   9.4. rl.set_queue
-   9.5. rl.get_queues
-   9.6. rl.set_pid
-   9.7. rl.get_pid
-   9.8. rl.push_load
-   9.9. rl.set_dbg
+   8.1. rl.stats
+   8.2. rl.set_pipe
+   8.3. rl.get_pipes
+   8.4. rl.set_queue
+   8.5. rl.get_queues
+   8.6. rl.set_pid
+   8.7. rl.get_pid
+   8.8. rl.push_load
+   8.9. rl.set_dbg
 
-9.1.  rl.stats
+8.1.  rl.stats
 
    Lists the parameters and variabiles in the ratelimit module.
 
@@ -668,7 +430,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.stats
 
-9.2.  rl.set_pipe
+8.2.  rl.set_pipe
 
    Sets the pipe parameters for the given pipe id.
 
@@ -682,7 +444,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.set_pipe 2 RED 10
 
-9.3.  rl.get_pipes
+8.3.  rl.get_pipes
 
    Gets the list of in use pipes.
 
@@ -693,7 +455,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.get_pipes
 
-9.4.  rl.set_queue
+8.4.  rl.set_queue
 
    Sets the queue parameters for the given queue id.
 
@@ -707,7 +469,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.set_queue 3 INVITE 2
 
-9.5.  rl.get_queues
+8.5.  rl.get_queues
 
    Gets the list of in use queues.
 
@@ -718,7 +480,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.get_queues
 
-9.6.  rl.set_pid
+8.6.  rl.set_pid
 
    Sets the PID Controller parameters for the Feedback Algorithm.
 
@@ -732,7 +494,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.set_pid 0.5 0.5 0.5
 
-9.7.  rl.get_pid
+8.7.  rl.get_pid
 
    Gets the list of in use PID Controller parameters.
 
@@ -743,7 +505,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.get_pid
 
-9.8.  rl.push_load
+8.8.  rl.push_load
 
    Force the value of the load parameter. This methos is usefull for
    testing the Feedback algorithm.
@@ -757,7 +519,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.push_load 0.85
 
-9.9.  rl.set_dbg
+8.9.  rl.set_dbg
 
    This MI function will enable/disable a WARNING debug log exposing the
    internal counters for each pipe (useful in monitoring the ratelimit
@@ -771,7 +533,7 @@ sercmd cfg.set_now_string ratelimit reply_reason "Limiting"
    RPC Command Format:
                 serctl rl.set_dbg 1
 
-10. Known limitations
+9. Known limitations
 
    The pipes and queues are stored as static vectors, so no more than
    MAX_PIPES/MAX_QUEUES can be added without recompilation.
index 347c58f..387babb 100644 (file)
                <year>2008-2010</year>
                <holder>VoIP Embedded Inc.</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
        
index cc8cdf0..c43a03b 100644 (file)
@@ -26,13 +26,11 @@ Sas Ovidiu
 
    Copyright © 2003-2008 Sippy Software, Inc.
 
-   Copyright © 2005 voice-system.ro
+   Copyright © 2005 Voice Sistem SRL
 
    Copyright © 2009 TuTPro Inc.
 
    Copyright © 2010 VoIPEmbedded Inc.
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
@@ -625,20 +623,20 @@ Chapter 2. Frequently Asked Questions
        First at all check if your question was already answered on one of our
        mailing lists:
          * User Mailing List -
-           http://lists.kamailio.org/cgi-bin/mailman/listinfo/users
+           http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users
          * Developer Mailing List -
-           http://lists.kamailio.org/cgi-bin/mailman/listinfo/devel
+           http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev
 
        E-mails regarding any stable Kamailio release should be sent to
-       <users@lists.kamailio.org> and e-mails regarding development versions
-       should be sent to <devel@lists.kamailio.org>.
+       <sr-users@lists.sip-router.org> and e-mails regarding development
+       versions should be sent to <sr-dev@lists.sip-router.org>.
 
        If you want to keep the mail private, send it to
-       <team@lists.kamailio.org>.
+       <sr-users@lists.sip-router.org>.
 
    2.4.
 
        How can I report a bug?
 
        Please follow the guidelines provided at:
-       http://sourceforge.net/tracker/?group_id=139143.
+       http://sip-router.org/tracker.
index ee06159..d5a15ee 100644 (file)
@@ -64,7 +64,7 @@
        </copyright>
        <copyright>
                <year>2005</year>
-               <holder>&voicesystem;</holder>
+               <holder>Voice Sistem SRL</holder>
        </copyright>
        <copyright>
                <year>2009</year>
                <year>2010</year>
                <holder><ulink url='http://www.voipembedded.com'>VoIPEmbedded Inc.</ulink></holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
        
index 0442064..b733826 100644 (file)
@@ -5,8 +5,6 @@ Nils Ohlmeier
    iptelorg GmbH
 
    Copyright © 2006 iptelorg GmbH
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    1.1. Overview
@@ -71,9 +69,6 @@ Nils Ohlmeier
 
 1.3. Parameters
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.3.1. default_checks (integer)
 
    This parameter determines which of the checks from the sanity module
@@ -133,9 +128,6 @@ modparam("sanity", "autodrop", 1)
 
 1.4. Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.4.1.  sanity_check([msg_checks [, uri_checks]])
 
    This function makes a row of sanity checks over the given SIP request.
index f3cfa85..3a535c2 100644 (file)
 
 <section id="options.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Functions</title>
index f633c8c..08258b8 100644 (file)
 
 <section id="sanity.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Parameters</title>
index 9e3accc..1072a48 100644 (file)
            <year>2006</year>
            <holder>iptelorg GmbH</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Sanity Module</title>
index bf5342f..6ce43ed 100644 (file)
@@ -10,7 +10,7 @@ Daniel-Constantin Mierla
 
    <miconda@gmail.com>
 
-   Copyright © 2011 asipto.com
+   Copyright Â© 2011 asipto.com
      __________________________________________________________________
 
    Table of Contents
index 9696644..b3cca9b 100644 (file)
-
-SMS Module
+1. SMS Module
 
 Bogdan Iancu
 
    FhG FOKUS
 
-Edited by
-
-Bogdan Iancu
-
-   Copyright � 2003 FhG FOKUS
-     _________________________________________________________
-
-   Table of Contents
-   1. User's Guide
-
-        1.1. Overview
-
-              1.1.1. New Features
-              1.1.2. Hardware Requirements
-              1.1.3. Numbering Plan
-              1.1.4. Address Mapping
-
-        1.2. Dependencies
-
-              1.2.1. SER Modules
-              1.2.2. External Libraries or Applications
+   Copyright © 2003 FhG FOKUS
+     __________________________________________________________________
 
-        1.3. Exported Parameters
+   1.1. Overview
 
-              1.3.1. modems (string)
-              1.3.2. networks (string)
-              1.3.3. links (string)
-              1.3.4. default_net (string)
-              1.3.5. max_sms_parts (integer)
-              1.3.6. domain_str (string)
-              1.3.7. use_contact (integer)
-              1.3.8. sms_report_type (integer)
+        1.1.1. Hardware Requirements
+        1.1.2. Numbering Plan
+        1.1.3. Address Mapping
 
-        1.4. Exported Functions
+   1.2. Dependencies
+   1.3. Parameters
 
-              1.4.1. sms_send_msg_to_net(network_name)
-              1.4.2. sms_send_msg()
+        1.3.1. modems (string)
+        1.3.2. networks (string)
+        1.3.3. links (string)
+        1.3.4. default_net (string)
+        1.3.5. max_sms_parts (integer)
+        1.3.6. domain_str (string)
+        1.3.7. use_contact (integer)
+        1.3.8. sms_report_type (integer)
 
-   2. Developer's Guide
-   3. Frequently Asked Questions
+   1.4. Functions
 
-   List of Examples
-   1-1. Set modems parameter
-   1-2. Set networks parameter
-   1-3. Set links parameter
-   1-4. Set default_net parameter
-   1-5. Set max_sms_parts parameter
-   1-6. Set domain_str parameter
-   1-7. Set use_contact parameter
-   1-8. Set sms_report_type parameter
-   1-9. sms_send_msg_to_net usage
-   1-10. sms_send_msg usage
-     _________________________________________________________
-
-Chapter 1. User's Guide
+        1.4.1. sms_send_msg_to_net(network_name)
+        1.4.2. sms_send_msg()
 
 1.1. Overview
 
-   This module provides a way of communication between SIP
-   network (via SIP MESSAGE) and GSM networks (via
-   ShortMessageService). Communication is possible from SIP to
-   SMS and vice versa. The module provides facilities like SMS
-   confirmation--the gateway can confirm to the SIP user if his
-   message really reached its destination as a SMS--or multi-part
-   messages--if a SIP messages is too long it will be split and
+   This module provides a way of communication between SIP network (via
+   SIP MESSAGE) and GSM networks (via ShortMessageService). Communication
+   is possible from SIP to SMS and vice versa. The module provides
+   facilities like SMS confirmation--the gateway can confirm to the SIP
+   user if his message really reached its destination as a SMS--or
+   multi-part messages--if a SIP messages is too long it will be split and
    sent as multiple SMS.
 
-   Errors occurred because of an invalid number or a too long
-   message or because of an internal modem malfunction are
-   reported back to the SIP user via a SIP message containing
-   explanations regarding the error.
-     _________________________________________________________
-
-1.1.1. New Features
-
-   -) July 2007 
-      The SMS module may no extract the URI from SMS body,
-      configuring the URI in the new modems parameters 's' and
-      't'.
-     _________________________________________________________
-
-1.1.2. Hardware Requirements
-
-   The SMS module needs a GSM modem to be able to send/receive
-   the SMS messages. Usually, this kind of modems are externals,
-   linked to the machine via serial cable. The modem can be a
-   dedicated one (as the ones provided by FALCOM) or can be a GSM
-   telephone that has an internal modem (as the latest mobile
-   phones from NOKIA and ERICSSON).
-     _________________________________________________________
-
-1.1.3. Numbering Plan
-
-   The gateway accepts and advertises phone numbers in
-   international format, more specific like: +(international
-   code)(area code)(number). Ex: Germany, D1 = +49 170 5678181
-   Romania, Connex = +40 722 123456 A number in this format is
-   expected to be placed as username into RURI or in the To
-   header. If RURI misses the username, the To header will be
-   consider. Also, the gateway will advertise in this format the
-   username in Contact headers (in SIP replies and requests) and
-   in From headers (in SIP requests).
-     _________________________________________________________
-
-1.1.4. Address Mapping
-
-   To identify the destination number of the SMS, the gateway
-   expects to have a mobile number in username of the SIP
-   destination address (for example sip:+401704678811@iptel.org).
-   For the reverse direction, because the gateway has only one
-   GSM number, the destination SIP address has to be encapsulated
-   into the SMS body. The gateway expects to find a SIP address
-   at the beginning of the SMS body in "sip:user.host" format.
-   Everything before the SIP address will be discarded, the
-   useful text begins exactly after the address (for example
-   SMS="For sip:user@host hello world!!" -> SIP="hello world"), 
-   view configuration for disable this behavior (modems parameters
-   's' y 't'). In order to facilitate replying, the gateway sends 
-   all the SMS messages with a header containing the source SIP 
-   address in the following format: "From sip:user@host (if you 
-   reply DONOT remove it)<new_line>". When an SMS-reply is received 
-   having this header (all of it or truncated at the end), the header
-   will be left out (it will not be in the SIP message). 
-
-     _________________________________________________________
+   Errors occurred because of an invalid number or a too long message or
+   because of an internal modem malfunction are reported back to the SIP
+   user via a SIP message containing explanations regarding the error.
+
+1.1.1. Hardware Requirements
+
+   The SMS module needs a GSM modem to be able to send/receive the SMS
+   messages. Usually, this kind of modems are externals, linked to the
+   machine via serial cable. The modem can be a dedicated one (as the ones
+   provided by FALCOM) or can be a GSM telephone that has an internal
+   modem (as the latest mobile phones from NOKIA and ERICSSON).
+
+1.1.2. Numbering Plan
+
+   The gateway accepts and advertises phone numbers in international
+   format, more specific like: +(international code)(area code)(number).
+   Ex: Germany, D1 = +49 170 5678181 Romania, Connex = +40 722 123456 A
+   number in this format is expected to be placed as username into RURI or
+   in the To header. If RURI misses the username, the To header will be
+   consider. Also, the gateway will advertise in this format the username
+   in Contact headers (in SIP replies and requests) and in From headers
+   (in SIP requests).
+
+1.1.3. Address Mapping
+
+   To identify the destination number of the SMS, the gateway expects to
+   have a mobile number in username of the SIP destination address (for
+   example sip:+401704678811@iptel.org). For the reverse direction,
+   because the gateway has only one GSM number, the destination SIP
+   address has to be encapsulated into the SMS body. The gateway expects
+   to find a SIP address at the beginning of the SMS body in
+   "sip:user.host" format. Everything before the SIP address will be
+   discarded, the useful text begins exactly after the address (for
+   example SMS="For sip:user@host hello world!!" -> SIP="hello world"),
+   view configuration for disable this behavior (modems parameters 's' y
+   't'). In order to facilitate replying, the gateway sends all the SMS
+   messages with a header containing the source SIP address in the
+   following format: "From sip:user@host (if you reply DONOT remove
+   it)<new_line>". When an SMS-reply is received having this header (all
+   of it or truncated at the end), the header will be left out (it will
+   not be in the SIP message).
 
 1.2. Dependencies
 
-1.2.1. SER Modules
-
    The following modules must be loaded before this module:
-
      * tm - Transaction Manager.
-     _________________________________________________________
-
-1.2.2. External Libraries or Applications
-
-   The following libraries or applications must be installed
-   before running SER with this module loaded:
 
-     * None.
-     _________________________________________________________
-
-1.3. Exported Parameters
+1.3. Parameters
 
 1.3.1. modems (string)
 
@@ -159,36 +98,34 @@ list_of_params   = modem_param *( ";" modem_param )
 modem_param      = name "=" value
 
    The following parameters can be used:
-
-     * d=device (mandatory) - Device associated with modem
-       (/dev/ttyS0, /dev/modem, etc.).
+     * d=device (mandatory) - Device associated with modem (/dev/ttyS0,
+       /dev/modem, etc.).
      * p=pin (optional) - SIM PIN - default is NULL.
      * m=mode (optional) - Modem working mode
        ("ASCII","OLD","DIGICOM","NEW"). Default value is "NEW".
-     * c=SMS_Center (optional) - SMS center number for that
-       modem. Default is the SMS center set on the SIM card.
+     * c=SMS_Center (optional) - SMS center number for that modem. Default
+       is the SMS center set on the SIM card.
      * b=baudrate (optional) - Default is 19600.
-     * r=retry (optional) - How many times to try to re-send a
-       SMS that reported error. Default is twice.
-     * l=looping (optional) - Time for modem to wait before
-       performing a new check for incomimg/outgoing SMS/SIP_MSG.
-       Default is 20.
-     * t=to (optional) - uri for sip header TO - default is NULL. 
-     * s=scan (optional) - 0: NOT SCAN uri from body sms, use URI
-                             in t=to.
-                          1: SCAN uri from body sms (normal mode,
-                             default mode, clasic mode)
-                          2: SCAN MIX (both modes), First SCAN
-
-   No default value, the parameter is mandatory. 
-
-   Example 1-1. Set modems parameter
+     * r=retry (optional) - How many times to try to re-send a SMS that
+       reported error. Default is twice.
+     * l=looping (optional) - Time for modem to wait before performing a
+       new check for incomimg/outgoing SMS/SIP_MSG. Default is 20.
+     * t=to (optional) - uri for sip header TO. Default is NULL.
+     * s=scan (optional) - Values: 0: NOT SCAN uri from body sms, use URI
+       in t=to. 1: SCAN uri from body sms (normal mode, default mode,
+       clasic mode) 2: SCAN MIX (both modes), First SCAN Default is 1
+       (SCAN).
+
+Note
+
+   No default value, the parameter is mandatory.
+
+   Example 1. Set modems parameter
 ...
 modparam("sms", "modems", "Nokia[d=/dev/ttyS1;s=0;t=sip:p-cscf@cidra.com.ar]")
-modparam("sms", "modems", "Nokia[d=/dev/ttyS1;b=9600;m=new;l=30]")
+modparam("sms", "modems", "Nokia [d=/dev/ttyS1;b=9600;m=new;l=30] ")
 modparam("sms", "modems", "Nokia[d=/dev/ttyS1];Siemens[d=/dev/ttyS2]")
 ...
-     _________________________________________________________
 
 1.3.2. networks (string)
 
@@ -199,23 +136,23 @@ list_of_params = set_param *( ";" set_param )
 set_param      = name "=" value
 
    The following parameters can be used:
+     * m=msx_sms_per_call (optional) - Maximum number of SMS send /
+       received from that net in one modem loop. Default is 10. This
+       parameter was introduced to avoid starvation.
+       Example of the starvation--a modem can send SMS for more than 1
+       networks. If you have a huge number of SMS for the first network
+       and the number of incoming SIP messages is equal to the sent SMS
+       per same unit of time, the modem will never get to send SMS for the
+       next networks.
 
-     * m=msx_sms_per_call (optional) - Maximum number of SMS send
-       / received from that net in one modem loop. Default is 10.
-       This parameter was introduced to avoid starvation.
-       Example of the starvation--a modem can send SMS for more
-       than 1 networks. If you have a huge number of SMS for the
-       first network and the number of incoming SIP messages is
-       equal to the sent SMS per same unit of time, the modem
-       will never get to send SMS for the next networks.
+Note
 
-   No default value, the parameter is mandatory. 
+   No default value, the parameter is mandatory.
 
-   Example 1-2. Set networks parameter
+   Example 2. Set networks parameter
 ...
 modparam("sms", "networks", "D1 [m=10] ;d2[ m=20]")
 ...
-     _________________________________________________________
 
 1.3.3. links (string)
 
@@ -224,113 +161,100 @@ links_value = modem_assoc *( ";" modem_assoc )
 modem_assoc = modem_name "[" list_of_networks "]"
 list_of_networks = network *( ";" network )
 
-   No default value, the parameter is mandatory. 
+Note
+
+   No default value, the parameter is mandatory.
 
-   Example 1-3. Set links parameter
+   Example 3. Set links parameter
 ...
 modparam("sms", "links", "NOKIA[D1;d2]")
 ...
 
-   The modem NOKIA will send SMS from D1 and D2 net (in this
-   order !). if in a net queue are more then max_sms_per_call SMS
-   the modem will not sleep before starting the next loop !
-   Shortly, if messages are waiting to be sent, the modem will
-   not go in sleep.
-     _________________________________________________________
+   The modem NOKIA will send SMS from D1 and D2 net (in this order !). if
+   in a net queue are more then max_sms_per_call SMS the modem will not
+   sleep before starting the next loop ! Shortly, if messages are waiting
+   to be sent, the modem will not go in sleep.
 
 1.3.4. default_net (string)
 
-   The default network to use. If no one specified, the first
-   defined network is used. This parameter is useful only if the
-   the "sms_send_msg" exported function is used (see Section
-   1.4).
+   The default network to use. If no one specified, the first defined
+   network is used. This parameter is useful only if the "sms_send_msg"
+   exported function is used (see Section 1.4, “Functions”).
 
-   Example 1-4. Set default_net parameter
+   Example 4. Set default_net parameter
 ...
 modparam("sms", "default_net", "D1")
 ...
-     _________________________________________________________
 
 1.3.5. max_sms_parts (integer)
 
-   Shows in how many parts (SMS messages) a SIP message can be
-   split. If exceeded, the SIP message will be sent truncated and
-   the SIP user will get back another message containing the
-   unsent part.
+   Shows in how many parts (SMS messages) a SIP message can be split. If
+   exceeded, the SIP message will be sent truncated and the SIP user will
+   get back another message containing the unsent part.
 
-   Default value is 4. 
+   Default value is 4.
 
-   Example 1-5. Set max_sms_parts parameter
+   Example 5. Set max_sms_parts parameter
 ...
 modparam("sms", "max_sms_parts", 10)
 ...
-     _________________________________________________________
 
 1.3.6. domain_str (string)
 
-   Specify a fake domain name to be used by the gateway. The
-   Contact headers and the From header from request will be
-   construct based on this fake domain name. It's useful when the
-   gateway is transparently hidden behind a proxy/register
-   (located on different machines).
+   Specify a fake domain name to be used by the gateway. The Contact
+   headers and the From header from request will be construct based on
+   this fake domain name. It's useful when the gateway is transparently
+   hidden behind a proxy/register (located on different machines).
 
-   Default is the name of the machine the gateway is running on. 
+   Default is the name of the machine the gateway is running on.
 
-   Example 1-6. Set domain_str parameter
+   Example 6. Set domain_str parameter
 ...
 modparam("sms", "domain_str", "foo.bar")
 ...
-     _________________________________________________________
 
 1.3.7. use_contact (integer)
 
-   If a contact header should be added to the outgoing SIP
-   messages. Even if the SIP draft forbids this, some UAS require
-   it.
+   If a contact header should be added to the outgoing SIP messages. Even
+   if the SIP draft forbids this, some UAS require it.
 
-   Default is 0 (no). 
+   Default is 0 (no).
 
-   Example 1-7. Set use_contact parameter
+   Example 7. Set use_contact parameter
 ...
 modparam("sms", "use_contact", 1)
 ...
-     _________________________________________________________
 
 1.3.8. sms_report_type (integer)
 
-   If the modem should ask for SMS confirmation from the SMS
-   Center. If the SMSC reply with an error code, the gateway will
-   send back to SIP user a SIP message containing the text (or
-   part of it) that couldn't be send. Two report mechanisms are
-   implemented:
-
-     * 1 - the reports are delivered by the GSM device as SMS
-       reports (so far supported only by Nokia modems);
-     * 2 - the reports are delivered as async. CDS responses
-       (supported by almost all modems, except Ericsson).
+   If the modem should ask for SMS confirmation from the SMS Center. If
+   the SMSC reply with an error code, the gateway will send back to SIP
+   user a SIP message containing the text (or part of it) that couldn't be
+   send. Two report mechanisms are implemented:
+     * 1 - the reports are delivered by the GSM device as SMS reports (so
+       far supported only by Nokia modems);
+     * 2 - the reports are delivered as async. CDS responses (supported by
+       almost all modems, except Ericsson).
 
-   Default is 0 (no report). 
+   Default is 0 (no report).
 
-   Example 1-8. Set sms_report_type parameter
+   Example 8. Set sms_report_type parameter
 ...
 modparam("sms", "sms_report_type", 1)
 ...
-     _________________________________________________________
 
-1.4. Exported Functions
+1.4. Functions
 
-1.4.1. sms_send_msg_to_net(network_name)
+1.4.1.  sms_send_msg_to_net(network_name)
 
-   Put the SIP msg in the specified network queue. The function
-   return error if the number encapsulated into SIP message is
-   malformed, if the content_type is incorrect or because of some
-   internal failures.
+   Put the SIP msg in the specified network queue. The function return
+   error if the number encapsulated into SIP message is malformed, if the
+   content_type is incorrect or because of some internal failures.
 
    Meaning of the parameters is as follows:
-
      * network_name - Name of network.
 
-   Example 1-9. sms_send_msg_to_net usage
+   Example 9. sms_send_msg_to_net usage
 ...
 if (sms_send_msg_to_net("D1"))
 {
@@ -348,14 +272,12 @@ if (sms_send_msg_to_net("D1"))
     break;
 };
 ...
-     _________________________________________________________
 
-1.4.2. sms_send_msg()
+1.4.2.  sms_send_msg()
 
-   The same as the previous one, but use the default network
-   queue.
+   The same as the previous one, but use the default network queue.
 
-   Example 1-10. sms_send_msg usage
+   Example 10. sms_send_msg usage
 ...
 if (sms_send_msg_to_net())
 {
@@ -373,41 +295,3 @@ if (sms_send_msg_to_net())
     break;
 };
 ...
-     _________________________________________________________
-
-Chapter 2. Developer's Guide
-
-   Each modem forks its own process for sending /fetching SMS.
-   Communication and queuing between ser working processes and
-   modem processes is done with pipes.
-     _________________________________________________________
-
-Chapter 3. Frequently Asked Questions
-
-   3.1. Where can I find more about SER?
-   3.2. Where can I post a question about this module?
-   3.3. How can I report a bug?
-
-   3.1. Where can I find more about SER?
-
-   Take a look at http://iptel.org/ser.
-
-   3.2. Where can I post a question about this module?
-
-   First at all check if your question was already answered on
-   one of our mailing lists:
-
-     * http://mail.iptel.org/mailman/listinfo/serusers
-     * http://mail.iptel.org/mailman/listinfo/serdev
-
-   E-mails regarding any stable version should be sent to
-   <serusers@iptel.org> and e-mail regarding development versions
-   or CVS snapshots should be send to <serdev@iptel.org>.
-
-   If you want to keep the mail private, send it to
-   <serhelp@iptel.org>.
-
-   3.3. How can I report a bug?
-
-   Please follow the guidelines provided at:
-   http://iptel.org/ser/bugs
index d53bfff..155442c 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="sms.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Functions</title>
index f5d86cf..c56dbe7 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="sms.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Parameters</title>
index f48b3c4..53ab569 100644 (file)
            <year>2003</year>
            <holder>FhG FOKUS</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>SMS Module</title>
index 24fe818..0fa3f37 100644 (file)
@@ -4,9 +4,7 @@ Andrei Pelinescu-Onciul
 
    iptelorg GmbH
 
-   Copyright © 2007 iptelorg GmbH
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2007 iptelorg GmbH
      __________________________________________________________________
 
    1.1. Overview
@@ -207,9 +205,6 @@ make -C modules/tls extra_defs="-DTLS_WR_DEBUG -DTLS_RD_DEBUG"
 
 1.8. Quick Certificate Howto
 
-   Revision History
-   Revision $Revision$ $Date$
-
    There are various ways to create, sign certificates and manage small
    CAs (Certificate Authorities). If you want a GUI, try tinyca
    (http://tinyca.sm-zone.net/), a very nice and small CA management
@@ -342,9 +337,6 @@ Revoking a certificate and using a CRL
 
 1.9. Parameters
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.9.1. tls_method (string)
 
    Sets the SSL/TLS protocol method. Possible values are:
@@ -971,9 +963,6 @@ modparam("tls", "config", "/usr/local/etc/ser/tls.cfg")
 
 1.10. Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.10.1. is_peer_verified()
 
    Returns true if the connection on which the message was received is TLS
@@ -988,9 +977,6 @@ modparam("tls", "config", "/usr/local/etc/ser/tls.cfg")
 
 1.11. History
 
-   Revision History
-   Revision $Revision$ $Date$
-
    This module was put together by Jan Janak <jan@iptel.org> from code
    from the experimental tls core addon
    (http://cvs.berlios.de/cgi-bin/viewcvs.cgi/ser/experimental/tls/), code
index f75461a..9f641bc 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="tls.certs_howto" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
        <title>Quick Certificate Howto</title>
index 5409181..5860cdf 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="textops.functions">
        <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>Functions</title>
index cf42712..f38d27d 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="tls.history">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
        <title>History</title>
index 2d2ec14..63d7eeb 100644 (file)
@@ -9,12 +9,6 @@
 
 <section id="tls.parameters">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Parameters</title>
index d3bb4a9..3eafdfd 100644 (file)
                <year>2007</year>
                <holder>iptelorg GmbH</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>TLS Module</title>
index 4e535bc..82ba505 100644 (file)
@@ -11,8 +11,6 @@ Juha Heinanen
    Copyright © 2003 FhG FOKUS
 
    Copyright © 2008 Juha Heinanen
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    1.1. Overview
@@ -369,9 +367,6 @@ failure_route["serial"]
 
 1.4. Parameters
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.4.1. fr_timer (integer)
 
    Timer which hits if no final reply for a request or ACK for a negative
@@ -1172,9 +1167,6 @@ modparam("tm", "e2e_cancel_reason", 0)
 
 1.5. Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.5.1.  t_relay_to_udp(ip, port), t_relay_to_udp(), t_relay_to_tcp(ip, port)
 t_relay_to_tcp() t_relay_to_tls(ip, port) t_relay_to_tls()
 t_relay_to_sctp(ip, port) t_relay_to_sctp()
@@ -2108,9 +2100,6 @@ opying
 
 1.6. TM Module API
 
-   Revision History
-   Revision $Revision$ $Date$
-
    There are applications which would like to generate SIP transactions
    without too big involvement in SIP stack, transaction management, etc.
    An example of such an application is sending instant messages from a
index ee6e03f..2a627ab 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="tm.api" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>TM Module API</title>
index 6de270a..f2945ea 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="tm.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Functions</title>
index f881af5..9a67b68 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="tm.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
     <sectioninfo>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>Parameters</title>
index d6dcf90..6bc1fa6 100644 (file)
                <year>2008</year>
                <holder>Juha Heinanen</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </sectioninfo>
 
     <title>TM Module</title>
index dcf2ae8..81dcf13 100644 (file)
@@ -3,8 +3,6 @@ Jan Janak
    iptelorg GmbH
 
    Copyright © 2005 iptelorg GmbH
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    1.1. Design Goals
@@ -499,9 +497,6 @@ route[XMLRPC]{
 
 1.5. Parameters
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.5.1. route (string)
 
    Name of the route called for XMLRPC messages.
@@ -608,9 +603,6 @@ modparam("xmlrpc", "url_match", "^/RPC2")
 
 1.6. Functions
 
-   Revision History
-   Revision $Revision$ $Date$
-
 1.6.1.  dispatch_rpc()
 
    This function processes an XMLRPC request, found in the body of the
index adacbac..805e281 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="xmlrpc.functions" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>Functions</title>
index d9bee27..6433d13 100644 (file)
@@ -4,12 +4,6 @@
 
 <section id="xmlrpc.parameters" xmlns:xi="http://www.w3.org/2001/XInclude">
        <sectioninfo>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
        <title>Parameters</title>
index 3e32b86..3a0c785 100644 (file)
                <year>2005</year>
                <holder>iptelorg GmbH</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </sectioninfo>
 
 
index b78ce7b..2460bc7 100644 (file)
@@ -7,7 +7,7 @@ Jiri Kuthan
 
 Bogdan-Andrei Iancu
 
-   voice-system.ro
+   Voice Sistem SRL
    <bogdan@voice-system.ro>
 
 Ramona-Elena Modroiu
@@ -19,14 +19,12 @@ Edited by
 
 Bogdan-Andrei Iancu
 
-   voice-system.ro
+   Voice Sistem SRL
    <bogdan@voice-system.ro>
 
    Copyright © 2002, 2003 FhG FOKUS
 
-   Copyright © 2004, 2006 voice-system.ro
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2004, 2006 Voice Sistem SRL
      __________________________________________________________________
 
    Table of Contents
@@ -974,20 +972,20 @@ Chapter 2. Frequently Asked Questions
        First at all check if your question was already answered on one of our
        mailing lists:
          * User Mailing List -
-           http://lists.kamailio.org/cgi-bin/mailman/listinfo/users
+           http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users
          * Developer Mailing List -
-           http://lists.kamailio.org/cgi-bin/mailman/listinfo/devel
+           http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev
 
        E-mails regarding any stable Kamailio release should be sent to
-       <users@lists.kamailio.org> and e-mails regarding development versions
-       should be sent to <devel@lists.kamailio.org>.
+       <sr-users@lists.sip-router.org> and e-mails regarding development
+       versions should be sent to <sr-dev@lists.sip-router.org>.
 
        If you want to keep the mail private, send it to
-       <team@lists.kamailio.org>.
+       <sr-users@lists.sip-router.org>.
 
    2.6.
 
        How can I report a bug?
 
        Please follow the guidelines provided at:
-       http://sourceforge.net/tracker/?group_id=139143.
+       http://sip-router.org/tracker.
index f0e22fd..b446454 100644 (file)
@@ -22,7 +22,7 @@
                <author>
                <firstname>Bogdan-Andrei</firstname>
                <surname>Iancu</surname>
-               <affiliation><orgname>&voicesystem;</orgname></affiliation>
+               <affiliation><orgname>Voice Sistem SRL</orgname></affiliation>
                <email>bogdan@voice-system.ro</email>
                </author>
                <author>
@@ -34,7 +34,7 @@
                <editor>
                <firstname>Bogdan-Andrei</firstname>
                <surname>Iancu</surname>
-               <affiliation><orgname>&voicesystem;</orgname></affiliation>
+               <affiliation><orgname>Voice Sistem SRL</orgname></affiliation>
                <email>bogdan@voice-system.ro</email>
                </editor>
        </authorgroup>
        <copyright>
                <year>2004</year>
                <year>2006</year>
-               <holder>&voicesystem;</holder>
+               <holder>Voice Sistem SRL</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
 
index a48f3c5..8c18133 100644 (file)
@@ -14,35 +14,35 @@ Daniel-Constantin Mierla
 
    <miconda@gmail.com>
 
-   Copyright © 2005 voice-system.ro
+   Copyright © 2005 Voice Sistem SRL
 
-   Copyright © 2008 asipto.com
-     __________________________________________________________
+   Copyright Â© 2008 asipto.com
+     __________________________________________________________________
 
    Table of Contents
 
    1. Admin Guide
 
-        1.1. Overview
-        1.2. Dependencies
+        1. Overview
+        2. Dependencies
 
-              1.2.1. Kamailio Modules
-              1.2.2. External Libraries or Applications
+              2.1. Kamailio Modules
+              2.2. External Libraries or Applications
 
-        1.3. Exported Parameters
+        3. Exported Parameters
 
-              1.3.1. db_url (str)
-              1.3.2. user_column (str)
-              1.3.3. domain_column (str)
-              1.3.4. alias_user_column (str)
-              1.3.5. alias_domain_column (str)
-              1.3.6. use_domain (int)
-              1.3.7. domain_prefix (str)
-              1.3.8. append_branches (int)
+              3.1. db_url (str)
+              3.2. user_column (str)
+              3.3. domain_column (str)
+              3.4. alias_user_column (str)
+              3.5. alias_domain_column (str)
+              3.6. use_domain (int)
+              3.7. domain_prefix (str)
+              3.8. append_branches (int)
 
-        1.4. Exported Functions
+        4. Exported Functions
 
-              1.4.1. alias_db_lookup(table_name)
+              4.1. alias_db_lookup(table_name)
 
    List of Examples
 
@@ -58,142 +58,176 @@ Daniel-Constantin Mierla
 
 Chapter 1. Admin Guide
 
-1.1. Overview
+   Table of Contents
+
+   1. Overview
+   2. Dependencies
+
+        2.1. Kamailio Modules
+        2.2. External Libraries or Applications
+
+   3. Exported Parameters
+
+        3.1. db_url (str)
+        3.2. user_column (str)
+        3.3. domain_column (str)
+        3.4. alias_user_column (str)
+        3.5. alias_domain_column (str)
+        3.6. use_domain (int)
+        3.7. domain_prefix (str)
+        3.8. append_branches (int)
+
+   4. Exported Functions
 
-   ALIAS_DB module can be used as an alternative for user aliases
-   via usrloc. The main feature is that it does not store all
-   addiacent data as for user location and always uses database
-   for search (no memory caching).
+        4.1. alias_db_lookup(table_name)
 
-   Having no memory caching the speed of search can decrease but
-   the provisioning is easier. With very fast databases like MySQL
-   the speed penalty can be lowered. Also, the search can be
-   performed on different tables in the same script.
+1. Overview
 
-1.2. Dependencies
+   ALIAS_DB module can be used as an alternative for user aliases via
+   usrloc. The main feature is that it does not store all addiacent data
+   as for user location and always uses database for search (no memory
+   caching).
 
-1.2.1. Kamailio Modules
+   Having no memory caching the speed of search can decrease but the
+   provisioning is easier. With very fast databases like MySQL the speed
+   penalty can be lowered. Also, the search can be performed on different
+   tables in the same script.
+
+2. Dependencies
+
+   2.1. Kamailio Modules
+   2.2. External Libraries or Applications
+
+2.1. Kamailio Modules
 
    The following modules must be loaded before this module:
      * database module (mysql, dbtext, ...).
 
-1.2.2. External Libraries or Applications
+2.2. External Libraries or Applications
 
-   The following libraries or applications must be installed
-   before running Kamailio with this module loaded:
+   The following libraries or applications must be installed before
+   running Kamailio with this module loaded:
      * None.
 
-1.3. Exported Parameters
+3. Exported Parameters
 
-1.3.1. db_url (str)
+   3.1. db_url (str)
+   3.2. user_column (str)
+   3.3. domain_column (str)
+   3.4. alias_user_column (str)
+   3.5. alias_domain_column (str)
+   3.6. use_domain (int)
+   3.7. domain_prefix (str)
+   3.8. append_branches (int)
+
+3.1. db_url (str)
 
    Database URL.
 
-   Default value is
-   "mysql://openserro:openserro@localhost/openser".
+   Default value is “mysql://openserro:openserro@localhost/openser”.
 
    Example 1.1. Set db_url parameter
 ...
-modparam("alias_db", "db_url", "dbdriver://username:password@dbhost/dbna
-me")
+modparam("alias_db", "db_url", "dbdriver://username:password@dbhost/dbname")
 ...
 
-1.3.2. user_column (str)
+3.2. user_column (str)
 
    Name of the column storing username.
 
-   Default value is "username".
+   Default value is “username”.
 
    Example 1.2. Set user_column parameter
 ...
 modparam("alias_db", "user_column", "susername")
 ...
 
-1.3.3. domain_column (str)
+3.3. domain_column (str)
 
    Name of the column storing user's domain.
 
-   Default value is "domain".
+   Default value is “domain”.
 
    Example 1.3. Set domain_column parameter
 ...
 modparam("alias_db", "domain_column", "sdomain")
 ...
 
-1.3.4. alias_user_column (str)
+3.4. alias_user_column (str)
 
    Name of the column storing alias username.
 
-   Default value is "alias_username".
+   Default value is “alias_username”.
 
    Example 1.4. Set alias_user_column parameter
 ...
 modparam("alias_db", "alias_user_column", "auser")
 ...
 
-1.3.5. alias_domain_column (str)
+3.5. alias_domain_column (str)
 
    Name of the column storing alias domain.
 
-   Default value is "alias_domain".
+   Default value is “alias_domain”.
 
    Example 1.5. Set alias_domain_column parameter
 ...
 modparam("alias_db", "alias_domain_column", "adomain")
 ...
 
-1.3.6. use_domain (int)
+3.6. use_domain (int)
 
-   Specifies whether to use or not the domain from R-URI when
-   searching for alias. If set to 0, the domain from R-URI is not
-   used, if set to 1 the domain from R-URI is used.
+   Specifies whether to use or not the domain from R-URI when searching
+   for alias. If set to 0, the domain from R-URI is not used, if set to 1
+   the domain from R-URI is used.
 
-   Default value is "0".
+   Default value is “0”.
 
    Example 1.6. Set use_domain parameter
 ...
 modparam("alias_db", "use_domain", 1)
 ...
 
-1.3.7. domain_prefix (str)
+3.7. domain_prefix (str)
 
-   Specifies the prefix to be stripped from the domain in R-URI
-   before doing the search.
+   Specifies the prefix to be stripped from the domain in R-URI before
+   doing the search.
 
-   Default value is "NULL".
+   Default value is “NULL”.
 
    Example 1.7. Set domain_prefix parameter
 ...
 modparam("alias_db", "domain_prefix", "sip.")
 ...
 
-1.3.8. append_branches (int)
+3.8. append_branches (int)
 
-   If the alias resolves to many SIP IDs, the first is replacing
-   the R-URI, the rest are added as branches.
+   If the alias resolves to many SIP IDs, the first is replacing the
+   R-URI, the rest are added as branches.
 
-   Default value is "0" (0 - don't add branches; 1 - add
-   branches).
+   Default value is “0” (0 - don't add branches; 1 - add branches).
 
    Example 1.8. Set append_branches parameter
 ...
 modparam("alias_db", "append_branches", 1)
 ...
 
-1.4. Exported Functions
+4. Exported Functions
+
+   4.1. alias_db_lookup(table_name)
 
-1.4.1.  alias_db_lookup(table_name)
+4.1.  alias_db_lookup(table_name)
 
-   The function takes the R-URI and search to see whether it is an
-   alias or not. If it is an alias for a local user, the R-URI is
-   replaced with user's SIP uri.
+   The function takes the R-URI and search to see whether it is an alias
+   or not. If it is an alias for a local user, the R-URI is replaced with
+   user's SIP uri.
 
-   The function returns TRUE if R-URI is alias and it was replaced
-   by user's SIP uri.
+   The function returns TRUE if R-URI is alias and it was replaced by
+   user's SIP uri.
 
    Meaning of the parameters is as follows:
-     * table_name - the name of the table where to search for
-       alias. It can include pseudo-variables.
+     * table_name - the name of the table where to search for alias. It
+       can include pseudo-variables.
 
    This function can be used from REQUEST_ROUTE, FAILURE_ROUTE.
 
index ed15b26..6b61f72 100644 (file)
@@ -31,7 +31,7 @@
        </authorgroup>
        <copyright>
            <year>2005</year>
-           <holder>&voicesystem;</holder>
+           <holder>Voice Sistem SRL</holder>
        </copyright>
        <copyright>
            <year>2008</year>
index cb6177c..df612bc 100644 (file)
@@ -11,7 +11,7 @@ Jakob Schlyter
 
 Bogdan-Andrei Iancu
 
-   voice-system.ro
+   Voice Sistem SRL
    <bogdan@voice-system.ro>
 
 Daniel-Constantin Mierla
@@ -26,9 +26,7 @@ Jan Janak
 
    Copyright © 2002, 2003 FhG FOKUS
 
-   Copyright © 2005 voice-system.ro
-   Revision History
-   Revision $Revision$ $Date$
+   Copyright © 2005 Voice Sistem SRL
      __________________________________________________________________
 
    Table of Contents
index ba36641..3b270d2 100644 (file)
@@ -26,7 +26,7 @@
                <author>
                <firstname>Bogdan-Andrei</firstname>
                <surname>Iancu</surname>
-               <affiliation><orgname>&voicesystem;</orgname></affiliation>
+               <affiliation><orgname>Voice Sistem SRL</orgname></affiliation>
                <email>bogdan@voice-system.ro</email>
                </author>
                <author>
        </copyright>
        <copyright>
                <year>2005</year>
-               <holder>&voicesystem;</holder>
+               <holder>Voice Sistem SRL</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
 
index 658e807..c47642b 100644 (file)
@@ -8,35 +8,32 @@ Edited by
 
 Elena-Ramona Modroiu
 
-   Copyright © 2003, 2004 FhG FOKUS
-   Revision History
-   Revision $Revision$ $Date: 2008-08-06 12:08:33 +0200
-                              (Mi, 06 Aug 2008) $
-     __________________________________________________________
+   Copyright © 2003, 2004 FhG FOKUS
+     __________________________________________________________________
 
    Table of Contents
 
    1. Admin Guide
 
-        1.1. Overview
-        1.2. Dependencies
+        1. Overview
+        2. Dependencies
 
-              1.2.1. Kamailio Modules
-              1.2.2. External Libraries or Applications
+              2.1. Kamailio Modules
+              2.2. External Libraries or Applications
 
-        1.3. Exported Parameters
+        3. Exported Parameters
 
-              1.3.1. diameter_client_host (string)
-              1.3.2. diameter_client_port (int)
-              1.3.3. use_domain (int)
+              3.1. diameter_client_host (string)
+              3.2. diameter_client_port (int)
+              3.3. use_domain (int)
 
-        1.4. Exported Functions
+        4. Exported Functions
 
-              1.4.1. diameter_www_authorize(realm)
-              1.4.2. diameter_proxy_authorize(realm)
-              1.4.3. diameter_is_user_in(who, group)
+              4.1. diameter_www_authorize(realm)
+              4.2. diameter_proxy_authorize(realm)
+              4.3. diameter_is_user_in(who, group)
 
-        1.5. Installation and Running
+        5. Installation and Running
 
    List of Examples
 
@@ -50,20 +47,40 @@ Elena-Ramona Modroiu
 
 Chapter 1. Admin Guide
 
-1.1. Overview
+   Table of Contents
+
+   1. Overview
+   2. Dependencies
+
+        2.1. Kamailio Modules
+        2.2. External Libraries or Applications
+
+   3. Exported Parameters
+
+        3.1. diameter_client_host (string)
+        3.2. diameter_client_port (int)
+        3.3. use_domain (int)
+
+   4. Exported Functions
 
-   This module implements SIP authentication and authorization
-   with DIAMETER server, namely DIameter Server Client (DISC).
+        4.1. diameter_www_authorize(realm)
+        4.2. diameter_proxy_authorize(realm)
+        4.3. diameter_is_user_in(who, group)
 
-   NOTE: diameter support was developed for DISC (DIameter Server
-   Client project at http://developer.berlios.de/projects/disc/).
-   This project seems to be no longer maintained and DIAMETER
-   specifications were updated in the meantime. Thus, the module
-   is obsolete and needs rework to be usable with opendiameter or
-   other DIAMETER servers.
+   5. Installation and Running
 
-   The digest authentication mechanism is presented in next
-   figure.
+1. Overview
+
+   This module implements SIP authentication and authorization with
+   DIAMETER server, namely DIameter Server Client (DISC).
+
+   NOTE: diameter support was developed for DISC (DIameter Server Client
+   project at http://developer.berlios.de/projects/disc/). This project
+   seems to be no longer maintained and DIAMETER specifications were
+   updated in the meantime. Thus, the module is obsolete and needs rework
+   to be usable with opendiameter or other DIAMETER servers.
+
+   The digest authentication mechanism is presented in next figure.
 
    Example 1.1. Digest Authentication
 ...
@@ -94,73 +111,83 @@ Chapter 1. Admin Guide
 
 ...
 
-1.2. Dependencies
+2. Dependencies
 
-1.2.1. Kamailio Modules
+   2.1. Kamailio Modules
+   2.2. External Libraries or Applications
+
+2.1. Kamailio Modules
 
    The following modules must be loaded before this module:
      * sl - used to send stateless replies.
 
-1.2.2. External Libraries or Applications
+2.2. External Libraries or Applications
 
-   The following libraries or applications must be installed
-   before running Kamailio with this module loaded:
+   The following libraries or applications must be installed before
+   running Kamailio with this module loaded:
      * None.
 
-1.3. Exported Parameters
+3. Exported Parameters
+
+   3.1. diameter_client_host (string)
+   3.2. diameter_client_port (int)
+   3.3. use_domain (int)
 
-1.3.1. diameter_client_host (string)
+3.1. diameter_client_host (string)
 
    Hostname of the machine where the DIAMETER Client is running.
 
-   Default value is "localhost".
+   Default value is “localhost”.
 
    Example 1.2. Set diameter_client_host parameter
 ...
 modparam("auth_diameter", "diameter_client_host", "10.10.10.10")
 ...
 
-1.3.2. diameter_client_port (int)
+3.2. diameter_client_port (int)
 
    Port number where the DIAMETER Client is listening.
 
-   Default value is "3000".
+   Default value is “3000”.
 
    Example 1.3. Set diameter_client_port parameter
 ...
 modparam("auth_diameter", "diameter_client_port", 3000)
 ...
 
-1.3.3. use_domain (int)
+3.3. use_domain (int)
 
-   Specifies whether the domain name part of URI is used when
-   checking the user's privileges.
+   Specifies whether the domain name part of URI is used when checking the
+   user's privileges.
 
-   Default value is "0 (0==false and 1==true )".
+   Default value is “0 (0==false and 1==true )”.
 
    Example 1.4. Set use_domain parameter
 ...
 modparam("auth_diameter", "use_domain", 1)
 ...
 
-1.4. Exported Functions
+4. Exported Functions
+
+   4.1. diameter_www_authorize(realm)
+   4.2. diameter_proxy_authorize(realm)
+   4.3. diameter_is_user_in(who, group)
 
-1.4.1.  diameter_www_authorize(realm)
+4.1.  diameter_www_authorize(realm)
 
    SIP Server checks for authorization having a DIAMETER server in
-   backend. If no credentials are provided inside the SIP request
-   then a challenge is sent back to UAC. If the credentials don't
-   match the ones computed by DISC then "403 Forbidden" is sent
-   back.
+   backend. If no credentials are provided inside the SIP request then a
+   challenge is sent back to UAC. If the credentials don't match the ones
+   computed by DISC then “403 Forbidden” is sent back.
 
    Negative codes may be interpreted as follows:
-     * -5 (generic error) - some generic error occurred and no
-       reply was sent out;
+     * -5 (generic error) - some generic error occurred and no reply was
+       sent out;
      * -3 (stale nonce) - stale nonce;
 
    Meaning of the parameters is as follows:
-     * realm - the realm to be use for authentication and
-       authorization. The string may contain pseudo variables.
+     * realm - the realm to be use for authentication and authorization.
+       The string may contain pseudo variables.
 
    This function can be used from REQUEST_ROUTE.
 
@@ -172,18 +199,17 @@ if(!diameter_www_authorize("siphub.net"))
 };
 ...
 
-1.4.2.  diameter_proxy_authorize(realm)
+4.2.  diameter_proxy_authorize(realm)
 
-   SIP Proxy checks for authorization having a DIAMETER server in
-   backend. If no credentials are provided inside the SIP request
-   then a challenge is sent back to UAC. If the credentials don't
-   match the ones computed by DISC then "403 Forbidden" is sent
-   back. For more about the negative return codes, see the above
-   function.
+   SIP Proxy checks for authorization having a DIAMETER server in backend.
+   If no credentials are provided inside the SIP request then a challenge
+   is sent back to UAC. If the credentials don't match the ones computed
+   by DISC then “403 Forbidden” is sent back. For more about the negative
+   return codes, see the above function.
 
    Meaning of the parameters is as follows:
-     * realm - the realm to be use for authentication and
-       authorization. The string may contain pseudo variables.
+     * realm - the realm to be use for authentication and authorization.
+       The string may contain pseudo variables.
 
    This function can be used from REQUEST_ROUTE.
 
@@ -195,16 +221,15 @@ if(!diameter_proxy_authorize("siphub.net"))
 };
 ...
 
-1.4.3.  diameter_is_user_in(who, group)
+4.3.  diameter_is_user_in(who, group)
 
    The method performs group membership checking with DISC.
 
    Meaning of the parameters is as follows:
-     * who - what header to be used to get the SIP URI that is
-       wanted to be checked being member in a certain group. It
-       can be: "Request-URI", "From", "To" or "Credentials".
-     * group - the group name where to check if the user is part
-       of.
+     * who - what header to be used to get the SIP URI that is wanted to
+       be checked being member in a certain group. It can be:
+       “Request-URI”, “From”, “To” or “Credentials”.
+     * group - the group name where to check if the user is part of.
 
    This function can be used from REQUEST_ROUTE.
 
@@ -216,6 +241,6 @@ if(!diameter_is_user_in("From", "voicemail"))
 };
 ...
 
-1.5. Installation and Running
+5. Installation and Running
 
    Notes about installation and running.
index 47985e1..ef90285 100644 (file)
            <year>2004</year>
            <holder>FhG FOKUS</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
     
index e16e33e..3222d50 100644 (file)
@@ -13,7 +13,7 @@ Stelios Sidiroglou-Douskos
 
 Bogdan-Andrei Iancu
 
-   voice-system.ro
+   Voice Sistem SRL
    <bogdan@voice-system.ro>
 
 Edited by
@@ -24,11 +24,9 @@ Jan Janak
 
    Copyright © 2002, 2003 FhG FOKUS
 
-   Copyright © 2005 voice-system.ro
+   Copyright © 2005 Voice Sistem SRL
 
    Copyright © 2008-2010 Juha Heinanen
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index 13886d7..5ae4e28 100644 (file)
@@ -30,7 +30,7 @@
                <author>
                <firstname>Bogdan-Andrei</firstname>
                <surname>Iancu</surname>
-               <affiliation><orgname>&voicesystem;</orgname></affiliation>
+               <affiliation><orgname>Voice Sistem SRL</orgname></affiliation>
                <email>bogdan@voice-system.ro</email>
                </author>
                <editor>
        </copyright>
        <copyright>
                <year>2005</year>
-               <holder>&voicesystem;</holder>
+               <holder>Voice Sistem SRL</holder>
        </copyright>
        <copyright>
                <year>2008-2010</year>
                <holder>Juha Heinanen</holder>
        </copyright>
        <para></para>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
        
index 7b4a392..f162969 100644 (file)
@@ -15,12 +15,9 @@ Bastian Friedrich
 
    <bastian.friedrich@collax.com>
 
-   Copyright © 2007 Collax GmbH
+   Copyright Â© 2007 Collax GmbH
 
-   Copyright © 2007 Voice System SRL
-   Revision History
-   Revision $Revision: 1.1.1.1 $ $Date: 2007-04-11 14:40:39 +0200 (Mi, 11
-   Apr 2007) $
+   Copyright © 2007 Voice System SRL
      __________________________________________________________________
 
    Table of Contents
@@ -154,7 +151,7 @@ Chapter 1. Admin Guide
        that feature is implemented.
      * 1 - Globally enable benchmarking
 
-   Default value is "0".
+   Default value is “0”.
 
    Example 1.1. Set enable parameter
 ...
@@ -167,7 +164,7 @@ modparam("benchmark", "enable", 1)
    function, but only every n'th call. n is defined through this variable.
    A sensible granularity seems to be 100.
 
-   Default value is "1".
+   Default value is “1”.
 
    Example 1.2. Set granularity parameter
 ...
@@ -185,7 +182,7 @@ modparam("benchmark", "granularity", 500)
      * 3 - L_INFO
      * 4 - L_DBG
 
-   Default value is "3" (L_INFO).
+   Default value is “3” (L_INFO).
 
    Example 1.3. Set loglevel parameter
 ...
@@ -199,16 +196,16 @@ modparam("benchmark", "loglevel", 4)
    4.1. bm_start_timer(name)
    4.2. bm_log_timer(name)
 
-4.1. bm_start_timer(name)
+4.1.  bm_start_timer(name)
 
-   Start timer "name". A later call to "bm_log_timer()" logs this timer..
+   Start timer “name”. A later call to “bm_log_timer()” logs this timer..
 
    Example 1.4. bm_start_timer usage
 ...
 bm_start_timer("test");
 ...
 
-4.2. bm_log_timer(name)
+4.2.  bm_log_timer(name)
 
    This function logs the timer with the given ID. The following data are
    logged:
@@ -216,7 +213,7 @@ bm_start_timer("test");
        equals the granularity variable.
 
      * Last sum is the accumulated duration in the current logging
-       interval (i.e. for the last "granularity" calls).
+       interval (i.e. for the last “granularity” calls).
 
      * Last min is the minimum duration between start/log_timer calls
        during the last interval.
@@ -319,18 +316,18 @@ Chapter 2. Developer Guide
    1.2. bm_start(id)
    1.3. bm_log(id)
 
-1.1. bm_register(name, mode, id)
+1.1.  bm_register(name, mode, id)
 
    This function register a new timer and/or returns the internal ID
    associated with the timer. mode controls the creation of new timer if
    not found. id is to be used by start and log timer functions.
 
-1.2. bm_start(id)
+1.2.  bm_start(id)
 
    This function equals the user-exported function bm_start_timer. The id
    is passed as an integer, though.
 
-1.3. bm_log(id)
+1.3.  bm_log(id)
 
    This function equals the user-exported function bm_log_timer. The id is
    passed as an integer, though.
index 6cbb141..ffe62d1 100644 (file)
            <year>2007</year>
            <holder>Voice System SRL</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision: 1.1.1.1 $</revnumber>
-               <date>$Date: 2007-04-11 14:40:39 +0200 (Mi, 11 Apr 2007) $</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
     
index b4d4fe9..7354c99 100644 (file)
@@ -10,10 +10,7 @@ Dan Pascu
 
    <dan@ag-projects.com>
 
-   Copyright © 2005-2008 Dan Pascu
-   Revision History
-   Revision $Revision: 1 $ $Date: 2008-12-17 13:05:29 +0200 (Wed, 17 Dec
-                           2008) $
+   Copyright © 2005-2008 Dan Pascu
      __________________________________________________________________
 
    Table of Contents
@@ -180,7 +177,7 @@ Chapter 1. Admin Guide
    return a code indicating that there is no limit associated with the
    call, allowing the use of the same configuration without changes.
 
-   Default value is "0".
+   Default value is “0”.
 
    Example 1.1. Setting the disable parameter
 ...
@@ -192,7 +189,7 @@ modparam("call_control", "disable", 1)
    It is the path to the filesystem socket where the callcontrol
    application listens for commands from the module.
 
-   Default value is "/var/run/callcontrol/socket".
+   Default value is “/var/run/callcontrol/socket”.
 
    Example 1.2. Setting the socket_name parameter
 ...
@@ -204,7 +201,7 @@ modparam("call_control", "socket_name", "/var/run/callcontrol/socket")
    How much time (in milliseconds) to wait for an answer from the
    callcontrol application.
 
-   Default value is "500" (ms).
+   Default value is “500” (ms).
 
    Example 1.3. Setting the socket_timeout parameter
 ...
@@ -230,7 +227,7 @@ modparam("call_control", "socket_timeout", 500)
    call based on caller's SIP URI, caller's SIP domain or caller's IP
    address (whichever yields a rate forst, in this order).
 
-   Default value is "$avp(s:signaling_ip)".
+   Default value is “$avp(s:signaling_ip)”.
 
    Example 1.4. Setting the signaling_ip_avp parameter
 ...
@@ -246,7 +243,7 @@ modparam("call_control", "signaling_ip_avp", "$avp(s:signaling_ip)")
    have a different, canonical form in the rating engine computation than
    it has in the ruri.
 
-   Default value is "$avp(s:can_uri)".
+   Default value is “$avp(s:can_uri)”.
 
    Example 1.5. Setting the canonical_uri_avp parameter
 ...
@@ -260,7 +257,7 @@ modparam("call_control", "canonical_uri_avp", "$avp(s:can_uri)")
    by the rating engine as the billing party when finding the rates to
    apply to a given call, otherwise, the caller's URI taken from the From
    field will be used. When set, this AVP should contain a value in the
-   form "user@domain" (no sip: prefix should be used).
+   form “user@domain” (no sip: prefix should be used).
 
    This is useful when a destination diverts a call, thus becoming the new
    caller. In this case the billing party is the diverter and this AVP
@@ -270,7 +267,7 @@ modparam("call_control", "canonical_uri_avp", "$avp(s:can_uri)")
    because B is the billing party in the call not A after the call was
    diverted.
 
-   Default value is "805".
+   Default value is “805”.
 
    Example 1.6. Setting the diverter_avp_id parameter
 ...
index 0665b9b..8ca6019 100644 (file)
     <year>2005-2008</year>
     <holder>Dan Pascu</holder>
   </copyright>
-  <revhistory>
-    <revision>
-    <revnumber>$Revision: 1 $</revnumber>
-    <date>$Date: 2008-12-17 13:05:29 +0200 (Wed, 17 Dec 2008) $</date>
-    </revision>
-  </revhistory>
   </bookinfo>
   <toc></toc>
 
index db8fd9c..4463603 100644 (file)
@@ -26,8 +26,6 @@ Daniel-Constantin Mierla
 
    Copyright © 2007, 2008, 2004 1und1 Internet AG, BASIS AudioNet GmbH,
    Elena-Ramona Modroiu, FhG FOKUS
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index 070efe7..4ad9cb5 100644 (file)
                <holder>Elena-Ramona Modroiu</holder>
                <holder>&fhg;</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
 
index 2b63632..f1a4f79 100644 (file)
@@ -2,62 +2,59 @@ cpl-c Module
 
 Bogdan-Andrei Iancu
 
-   voice-system.ro
+   Voice Sistem SRL
 
 Edited by
 
 Bogdan-Andrei Iancu
 
-   Copyright © 2003 FhG FOKUS
-   Revision History
-   Revision $Revision$ $Date: 2008-08-06 12:08:33 +0200
-                              (Mi, 06 Aug 2008) $
-     __________________________________________________________
+   Copyright © 2003 FhG FOKUS
+     __________________________________________________________________
 
    Table of Contents
 
    1. Admin Guide
 
-        1.1. Overview
-        1.2. Dependencies
+        1. Overview
+        2. Dependencies
 
-              1.2.1. Kamailio Modules
-              1.2.2. External Libraries or Applications
+              2.1. Kamailio Modules
+              2.2. External Libraries or Applications
 
-        1.3. Exported Parameters
+        3. Exported Parameters
 
-              1.3.1. db_url (string)
-              1.3.2. db_table (string)
-              1.3.3. username_column (string)
-              1.3.4. domain_column (string)
-              1.3.5. cpl_xml_column (string)
-              1.3.6. cpl_bin_column (string)
-              1.3.7. cpl_dtd_file (string)
-              1.3.8. log_dir (string)
-              1.3.9. proxy_recurse (int)
-              1.3.10. proxy_route (int)
-              1.3.11. case_sensitive (int)
-              1.3.12. realm_prefix (string)
-              1.3.13. timer_avp (string)
-              1.3.14. lookup_domain (string)
-              1.3.15. lookup_append_branches (int)
-              1.3.16. use_domain (integer)
+              3.1. db_url (string)
+              3.2. db_table (string)
+              3.3. username_column (string)
+              3.4. domain_column (string)
+              3.5. cpl_xml_column (string)
+              3.6. cpl_bin_column (string)
+              3.7. cpl_dtd_file (string)
+              3.8. log_dir (string)
+              3.9. proxy_recurse (int)
+              3.10. proxy_route (int)
+              3.11. case_sensitive (int)
+              3.12. realm_prefix (string)
+              3.13. timer_avp (string)
+              3.14. lookup_domain (string)
+              3.15. lookup_append_branches (int)
+              3.16. use_domain (integer)
 
-        1.4. Exported Functions
+        4. Exported Functions
 
-              1.4.1. cpl_run_script(type,mode)
-              1.4.2. cpl_process_register()
-              1.4.3. cpl_process_register_norpl()
+              4.1. cpl_run_script(type,mode)
+              4.2. cpl_process_register()
+              4.3. cpl_process_register_norpl()
 
-        1.5. Exported MI Functions
+        5. Exported MI Functions
 
-              1.5.1. LOAD_CPL
-              1.5.2. REMOVE_CPL
-              1.5.3. GET_CPL
+              5.1. LOAD_CPL
+              5.2. REMOVE_CPL
+              5.3. GET_CPL
 
-        1.6. Installation and Running
+        6. Installation and Running
 
-              1.6.1. Database setup
+              6.1. Database setup
 
    List of Examples
 
@@ -83,117 +80,179 @@ Bogdan-Andrei Iancu
 
 Chapter 1. Admin Guide
 
-1.1. Overview
+   Table of Contents
 
-   cpl-c modules implements a CPL (Call Processing Language)
-   interpreter. Support for uploading/downloading/removing scripts
-   via SIP REGISTER method is present.
+   1. Overview
+   2. Dependencies
 
-1.2. Dependencies
+        2.1. Kamailio Modules
+        2.2. External Libraries or Applications
 
-1.2.1. Kamailio Modules
+   3. Exported Parameters
 
-   The following modules must be loaded before this module:
-     * any DB module- a DB module for interfacing the DB
-       operations (modules like mysql, postgres, dbtext, etc)
-     * TM (Transaction) module- used for proxying/forking requests
-     * SL (StateLess) module - used for sending stateless reply
-       when responding to REGISTER request or for sending back
-       error responses
-     * USRLOC (User Location) module - used for implementing
-       lookup("registration") tag (adding into location set of the
-       users' contact)
+        3.1. db_url (string)
+        3.2. db_table (string)
+        3.3. username_column (string)
+        3.4. domain_column (string)
+        3.5. cpl_xml_column (string)
+        3.6. cpl_bin_column (string)
+        3.7. cpl_dtd_file (string)
+        3.8. log_dir (string)
+        3.9. proxy_recurse (int)
+        3.10. proxy_route (int)
+        3.11. case_sensitive (int)
+        3.12. realm_prefix (string)
+        3.13. timer_avp (string)
+        3.14. lookup_domain (string)
+        3.15. lookup_append_branches (int)
+        3.16. use_domain (integer)
+
+   4. Exported Functions
+
+        4.1. cpl_run_script(type,mode)
+        4.2. cpl_process_register()
+        4.3. cpl_process_register_norpl()
+
+   5. Exported MI Functions
+
+        5.1. LOAD_CPL
+        5.2. REMOVE_CPL
+        5.3. GET_CPL
 
-1.2.2. External Libraries or Applications
+   6. Installation and Running
 
-   The following libraries or applications must be installed
-   before running Kamailio with this module loaded:
-     * libxml2 and libxml2-devel - on some SO, these to packages
-       are merged into libxml2. This library contains an engine
-       for XML parsing, DTD validation and DOM manipulation.
+        6.1. Database setup
 
-1.3. Exported Parameters
+1. Overview
 
-1.3.1. db_url (string)
+   cpl-c modules implements a CPL (Call Processing Language) interpreter.
+   Support for uploading/downloading/removing scripts via SIP REGISTER
+   method is present.
 
-   A SQL URL have to be given to the module for knowing where the
-   database containing the table with CPL scripts is locates. If
-   required a user name and password can be specified for allowing
-   the module to connect to the database server.
+2. Dependencies
 
-   Default value is "mysql://openser:openserrw@localhost/openser".
+   2.1. Kamailio Modules
+   2.2. External Libraries or Applications
+
+2.1. Kamailio Modules
+
+   The following modules must be loaded before this module:
+     * any DB module- a DB module for interfacing the DB operations
+       (modules like mysql, postgres, dbtext, etc)
+     * TM (Transaction) module- used for proxying/forking requests
+     * SL (StateLess) module - used for sending stateless reply when
+       responding to REGISTER request or for sending back error responses
+     * USRLOC (User Location) module - used for implementing
+       lookup("registration") tag (adding into location set of the users'
+       contact)
+
+2.2. External Libraries or Applications
+
+   The following libraries or applications must be installed before
+   running Kamailio with this module loaded:
+     * libxml2 and libxml2-devel - on some SO, these to packages are
+       merged into libxml2. This library contains an engine for XML
+       parsing, DTD validation and DOM manipulation.
+
+3. Exported Parameters
+
+   3.1. db_url (string)
+   3.2. db_table (string)
+   3.3. username_column (string)
+   3.4. domain_column (string)
+   3.5. cpl_xml_column (string)
+   3.6. cpl_bin_column (string)
+   3.7. cpl_dtd_file (string)
+   3.8. log_dir (string)
+   3.9. proxy_recurse (int)
+   3.10. proxy_route (int)
+   3.11. case_sensitive (int)
+   3.12. realm_prefix (string)
+   3.13. timer_avp (string)
+   3.14. lookup_domain (string)
+   3.15. lookup_append_branches (int)
+   3.16. use_domain (integer)
+
+3.1. db_url (string)
+
+   A SQL URL have to be given to the module for knowing where the database
+   containing the table with CPL scripts is locates. If required a user
+   name and password can be specified for allowing the module to connect
+   to the database server.
+
+   Default value is “mysql://openser:openserrw@localhost/openser”.
 
    Example 1.1. Set db_url parameter
 ...
 modparam("cpl-c","db_url","dbdriver://username:password@dbhost/dbname")
 ...
 
-1.3.2. db_table (string)
+3.2. db_table (string)
 
-   Indicates the name of the table that store the CPL scripts.
-   This table must be locate into the database specified by
-   "db_url" parameter. For more about the format of the CPL table
-   please see the modules/cpl-c/init.mysql file.
+   Indicates the name of the table that store the CPL scripts. This table
+   must be locate into the database specified by “db_url” parameter. For
+   more about the format of the CPL table please see the
+   modules/cpl-c/init.mysql file.
 
-   Default value is "cpl".
+   Default value is “cpl”.
 
    Example 1.2. Set db_table parameter
 ...
 modparam("cpl-c","cpl_table","cpl")
 ...
 
-1.3.3. username_column (string)
+3.3. username_column (string)
 
    Indicates the name of the column used for storing the username.
 
-   Default value is "username".
+   Default value is “username”.
 
    Example 1.3. Set username_column parameter
 ...
 modparam("cpl-c","username_column","username")
 ...
 
-1.3.4. domain_column (string)
+3.4. domain_column (string)
 
    Indicates the name of the column used for storing the domain.
 
-   Default value is "domain".
+   Default value is “domain”.
 
    Example 1.4. Set domain_column parameter
 ...
 modparam("cpl-c","domain_column","domain")
 ...
 
-1.3.5. cpl_xml_column (string)
+3.5. cpl_xml_column (string)
 
-   Indicates the name of the column used for storing the the XML
-   version of the cpl script.
+   Indicates the name of the column used for storing the the XML version
+   of the cpl script.
 
-   Default value is "cpl_xml".
+   Default value is “cpl_xml”.
 
    Example 1.5. Set cpl_xml_column parameter
 ...
 modparam("cpl-c","cpl_xml_column","cpl_xml")
 ...
 
-1.3.6. cpl_bin_column (string)
+3.6. cpl_bin_column (string)
 
-   Indicates the name of the column used for storing the the
-   binary version of the cpl script (compiled version).
+   Indicates the name of the column used for storing the the binary
+   version of the cpl script (compiled version).
 
-   Default value is "cpl_bin".
+   Default value is “cpl_bin”.
 
    Example 1.6. Set cpl_bin_column parameter
 ...
 modparam("cpl-c","cpl_bin_column","cpl_bin")
 ...
 
-1.3.7. cpl_dtd_file (string)
+3.7. cpl_dtd_file (string)
 
-   Points to the DTD file describing the CPL grammar. The file
-   name may include also the path to the file. This path can be
-   absolute or relative (be careful the path will be relative to
-   the starting directory of Kamailio).
+   Points to the DTD file describing the CPL grammar. The file name may
+   include also the path to the file. This path can be absolute or
+   relative (be careful the path will be relative to the starting
+   directory of Kamailio).
 
    This parameter is MANDATORY!
 
@@ -202,28 +261,27 @@ modparam("cpl-c","cpl_bin_column","cpl_bin")
 modparam("cpl-c","cpl_dtd_file","/etc/kamailio/cpl-06.dtd")
 ...
 
-1.3.8. log_dir (string)
+3.8. log_dir (string)
 
    Points to a directory where should be created all the log file
-   generated by the LOG CPL node. A log file per user will be
-   created (on demand) having the name username.log.
+   generated by the LOG CPL node. A log file per user will be created (on
+   demand) having the name username.log.
 
-   If this parameter is absent, the logging will be disabled
-   without generating error on execution.
+   If this parameter is absent, the logging will be disabled without
+   generating error on execution.
 
    Example 1.8. Set log_dir parameter
 ...
 modparam("cpl-c","log_dir","/var/log/kamailio/cpl")
 ...
 
-1.3.9. proxy_recurse (int)
+3.9. proxy_recurse (int)
 
-   Tells for how many time is allow to have recurse for PROXY CPL
-   node If it has value 2, when doing proxy, only twice the proxy
-   action will be re-triggered by a redirect response; the third
-   time, the proxy execution will end by going on REDIRECTION
-   branch. The recurse feature can be disable by setting this
-   parameter to 0
+   Tells for how many time is allow to have recurse for PROXY CPL node If
+   it has value 2, when doing proxy, only twice the proxy action will be
+   re-triggered by a redirect response; the third time, the proxy
+   execution will end by going on REDIRECTION branch. The recurse feature
+   can be disable by setting this parameter to 0
 
    Default value of this parameter is 0.
 
@@ -232,11 +290,11 @@ modparam("cpl-c","log_dir","/var/log/kamailio/cpl")
 modparam("cpl-c","proxy_recurse",2)
 ...
 
-1.3.10. proxy_route (int)
+3.10. proxy_route (int)
 
-   Before doing proxy (forward), a script route can be executed.
-   All modifications made by that route will be reflected only for
-   the current branch.
+   Before doing proxy (forward), a script route can be executed. All
+   modifications made by that route will be reflected only for the current
+   branch.
 
    Default value of this parameter is 0 (none).
 
@@ -245,11 +303,11 @@ modparam("cpl-c","proxy_recurse",2)
 modparam("cpl-c","proxy_route",1)
 ...
 
-1.3.11. case_sensitive (int)
+3.11. case_sensitive (int)
 
-   Tells if the username matching should be perform case sensitive
-   or not. Set it to a non zero value to force a case sensitive
-   handling of usernames.
+   Tells if the username matching should be perform case sensitive or not.
+   Set it to a non zero value to force a case sensitive handling of
+   usernames.
 
    Default value of this parameter is 0.
 
@@ -258,7 +316,7 @@ modparam("cpl-c","proxy_route",1)
 modparam("cpl-c","case_sensitive",1)
 ...
 
-1.3.12. realm_prefix (string)
+3.12. realm_prefix (string)
 
    Defines a prefix for the domain part which should be ignored in
    handling users and scripts.
@@ -270,14 +328,14 @@ modparam("cpl-c","case_sensitive",1)
 modparam("cpl-c","realm_prefix","sip.")
 ...
 
-1.3.13. timer_avp (string)
+3.13. timer_avp (string)
 
-   Full specification (ID, NAME, ALIAS) of the AVP to be used to
-   set the value of the Final Response INVITE timeout - it's used
-   by the TIMEOUT attribute from the PROXY tag.
+   Full specification (ID, NAME, ALIAS) of the AVP to be used to set the
+   value of the Final Response INVITE timeout - it's used by the TIMEOUT
+   attribute from the PROXY tag.
 
-   NOTE: take care and syncronize this value with the similar
-   parameters in TM module.
+   NOTE: take care and syncronize this value with the similar parameters
+   in TM module.
 
    Default value of this parameter is NULL.
 
@@ -286,14 +344,14 @@ modparam("cpl-c","realm_prefix","sip.")
 modparam("cpl-c","timer_avp","$avp(i:14)")
 ...
 
-1.3.14. lookup_domain (string)
+3.14. lookup_domain (string)
 
    Used by lookup tag to indicate where to perform user location.
-   Basically this is the name of the usrloc domain (table) where
-   the user registrations are kept.
+   Basically this is the name of the usrloc domain (table) where the user
+   registrations are kept.
 
-   If set to empty string, the lookup node will be disabled - no
-   user location will be performed.
+   If set to empty string, the lookup node will be disabled - no user
+   location will be performed.
 
    Default value of this parameter is NULL.
 
@@ -302,12 +360,11 @@ modparam("cpl-c","timer_avp","$avp(i:14)")
 modparam("cpl-c","lookup_domain","location")
 ...
 
-1.3.15. lookup_append_branches (int)
+3.15. lookup_append_branches (int)
 
-   Tells if the lookup tag should append branches (to do parallel
-   forking) if user_location lookup returns more than one contact.
-   Set it to a non zero value to enable parallel forking for
-   location lookup tag.
+   Tells if the lookup tag should append branches (to do parallel forking)
+   if user_location lookup returns more than one contact. Set it to a non
+   zero value to enable parallel forking for location lookup tag.
 
    Default value of this parameter is 0.
 
@@ -316,71 +373,71 @@ modparam("cpl-c","lookup_domain","location")
 modparam("cpl-c","lookup_append_branches",1)
 ...
 
-1.3.16. use_domain (integer)
+3.16. use_domain (integer)
 
    Indicates if the domain part of the URI should be used in user
    identification (otherwise only username part will be used).
 
-   Default value is "0 (disabled)".
+   Default value is “0 (disabled)”.
 
    Example 1.16. Set use_domain parameter
 ...
 modparam("cpl-c","use_domain",1)
 ...
 
-1.4. Exported Functions
+4. Exported Functions
+
+   4.1. cpl_run_script(type,mode)
+   4.2. cpl_process_register()
+   4.3. cpl_process_register_norpl()
 
-1.4.1.  cpl_run_script(type,mode)
+4.1.  cpl_run_script(type,mode)
 
-   Starts the execution of the CPL script. The user name is
-   fetched from new_uri or requested uri or from To header -in
-   this order- (for incoming execution) or from FROM header (for
-   outgoing execution). Regarding the stateful/stateless message
-   processing, the function is very flexible, being able to run in
-   different modes (see below the"mode" parameter). Normally this
-   function will end script execution. There is no guaranty that
-   the CPL script interpretation ended when Kamailio script ended
-   also (for the same INVITE ;-)) - this can happen when the CPL
-   script does a PROXY and the script interpretation pause after
-   proxying and it will be resume when some reply is received
-   (this can happen in a different process of SER). If the
-   function returns to script, the SIP server should continue with
-   the normal behavior as if no script existed. When some error is
-   returned, the function itself haven't sent any SIP error reply
-   (this can be done from script).
+   Starts the execution of the CPL script. The user name is fetched from
+   new_uri or requested uri or from To header -in this order- (for
+   incoming execution) or from FROM header (for outgoing execution).
+   Regarding the stateful/stateless message processing, the function is
+   very flexible, being able to run in different modes (see below
+   the"mode" parameter). Normally this function will end script execution.
+   There is no guaranty that the CPL script interpretation ended when
+   Kamailio script ended also (for the same INVITE ;-)) - this can happen
+   when the CPL script does a PROXY and the script interpretation pause
+   after proxying and it will be resume when some reply is received (this
+   can happen in a different process of SER). If the function returns to
+   script, the SIP server should continue with the normal behavior as if
+   no script existed. When some error is returned, the function itself
+   haven't sent any SIP error reply (this can be done from script).
 
    Meaning of the parameters is as follows:
-     * type - which part of the script should be run; set it to
-       "incoming" for having the incoming part of script executed
-       (when an INVITE is received) or to "outgoing" for running
-       the outgoing part of script (when a user is generating an
-       INVITE - call).
-     * mode - sets the interpreter mode as stateless/stateful
-       behavior. The following modes are accepted:
-          + IS_STATELESS - the current INVITE has no transaction
-            created yet. All replies (redirection or deny) will be
-            done is a stateless way. The execution will switch to
-            stateful only when proxy is done. So, if the function
-            returns, will be in stateless mode.
-          + IS_STATEFUL - the current INVITE has already a
-            transaction associated. All signaling operations
-            (replies or proxy) will be done in stateful way.So, if
-            the function returns, will be in stateful mode.
-          + FORCE_STATEFUL - the current INVITE has no transaction
-            created yet. All signaling operations will be done is
-            a stateful way (on signaling, the transaction will be
-            created from within the interpreter). So, if the
-            function returns, will be in stateless mode.
-       HINT: is_stateful is very difficult to manage from the
-       routing script (script processing can continue in stateful
-       mode); is_stateless is the fastest and less resources
-       consumer (transaction is created only if proxying is done),
-       but there is minimal protection against retransmissions
-       (since replies are send stateless); force_stateful is a
-       good compromise - all signaling is done stateful
-       (retransmission protection) and in the same time, if
-       returning to script, it will be in stateless mode (easy to
-       continue the routing script execution)
+     * type - which part of the script should be run; set it to "incoming"
+       for having the incoming part of script executed (when an INVITE is
+       received) or to "outgoing" for running the outgoing part of script
+       (when a user is generating an INVITE - call).
+     * mode - sets the interpreter mode as stateless/stateful behavior.
+       The following modes are accepted:
+          + IS_STATELESS - the current INVITE has no transaction created
+            yet. All replies (redirection or deny) will be done is a
+            stateless way. The execution will switch to stateful only when
+            proxy is done. So, if the function returns, will be in
+            stateless mode.
+          + IS_STATEFUL - the current INVITE has already a transaction
+            associated. All signaling operations (replies or proxy) will
+            be done in stateful way.So, if the function returns, will be
+            in stateful mode.
+          + FORCE_STATEFUL - the current INVITE has no transaction created
+            yet. All signaling operations will be done is a stateful way
+            (on signaling, the transaction will be created from within the
+            interpreter). So, if the function returns, will be in
+            stateless mode.
+       HINT: is_stateful is very difficult to manage from the routing
+       script (script processing can continue in stateful mode);
+       is_stateless is the fastest and less resources consumer
+       (transaction is created only if proxying is done), but there is
+       minimal protection against retransmissions (since replies are send
+       stateless); force_stateful is a good compromise - all signaling is
+       done stateful (retransmission protection) and in the same time, if
+       returning to script, it will be in stateless mode (easy to continue
+       the routing script execution)
 
    This function can be used from REQUEST_ROUTE.
 
@@ -389,26 +446,24 @@ modparam("cpl-c","use_domain",1)
 cpl_run_script("incoming","force_stateful");
 ...
 
-1.4.2.  cpl_process_register()
-
-   This function MUST be called only for REGISTER requests. It
-   checks if the current REGISTER request is related or not with
-   CPL script upload/download/ remove. If it is, all the needed
-   operation will be done. For checking if the REGISTER is CPL
-   related, the function looks fist to "Content-Type" header. If
-   it exists and has a the mime type set to "application/cpl+xml"
-   means this is a CPL script upload/remove operation. The
-   distinction between to case is made by looking at
-   "Content-Disposition" header; id its value is
-   "script;action=store", means it's an upload; if it's
-   "script;action=remove", means it's a remove operation; other
-   values are considered to be errors. If no "Content-Type" header
-   is present, the function looks to "Accept" header and if it
-   contains the "*" or "application/cpl-xml" the request it will
-   be consider one for downloading CPL scripts. The functions
-   returns to script only if the REGISTER is not related to CPL.
-   In other case, the function will send by itself the necessary
-   replies (stateless - using sl), including for errors.
+4.2.  cpl_process_register()
+
+   This function MUST be called only for REGISTER requests. It checks if
+   the current REGISTER request is related or not with CPL script
+   upload/download/ remove. If it is, all the needed operation will be
+   done. For checking if the REGISTER is CPL related, the function looks
+   fist to "Content-Type" header. If it exists and has a the mime type set
+   to "application/cpl+xml" means this is a CPL script upload/remove
+   operation. The distinction between to case is made by looking at
+   "Content-Disposition" header; id its value is "script;action=store",
+   means it's an upload; if it's "script;action=remove", means it's a
+   remove operation; other values are considered to be errors. If no
+   "Content-Type" header is present, the function looks to "Accept" header
+   and if it contains the "*" or "application/cpl-xml" the request it will
+   be consider one for downloading CPL scripts. The functions returns to
+   script only if the REGISTER is not related to CPL. In other case, the
+   function will send by itself the necessary replies (stateless - using
+   sl), including for errors.
 
    This function can be used from REQUEST_ROUTE.
 
@@ -419,14 +474,14 @@ if (method=="REGISTER") {
 }
 ...
 
-1.4.3.  cpl_process_register_norpl()
+4.3.  cpl_process_register_norpl()
 
-   Same as "cpl_process_register" without internally generating
-   the reply. All information (script) is appended to the reply
-   but without sending it out.
+   Same as “cpl_process_register” without internally generating the reply.
+   All information (script) is appended to the reply but without sending
+   it out.
 
-   Main purpose of this function is to allow integration between
-   CPL and UserLocation services via same REGISTER messages.
+   Main purpose of this function is to allow integration between CPL and
+   UserLocation services via same REGISTER messages.
 
    This function can be used from REQUEST_ROUTE.
 
@@ -439,12 +494,16 @@ if (method=="REGISTER") {
 }
 ...
 
-1.5. Exported MI Functions
+5. Exported MI Functions
 
-1.5.1.  LOAD_CPL
+   5.1. LOAD_CPL
+   5.2. REMOVE_CPL
+   5.3. GET_CPL
 
-   For the given user, loads the XML cpl file, compiles it into
-   binary format and stores both format into database.
+5.1.  LOAD_CPL
+
+   For the given user, loads the XML cpl file, compiles it into binary
+   format and stores both format into database.
 
    Name: LOAD_CPL
 
@@ -458,10 +517,10 @@ if (method=="REGISTER") {
                  cpl_filename
                  _empty_line_
 
-1.5.2.  REMOVE_CPL
+5.2.  REMOVE_CPL
 
-   For the given user, removes the entire database record (XML cpl
-   and binary cpl); user with empty cpl scripts are not accepted.
+   For the given user, removes the entire database record (XML cpl and
+   binary cpl); user with empty cpl scripts are not accepted.
 
    Name: REMOVE_CPL
 
@@ -473,7 +532,7 @@ if (method=="REGISTER") {
                  username
                  _empty_line_
 
-1.5.3.  GET_CPL
+5.3.  GET_CPL
 
    For the given user, returns the CPL script in XML format.
 
@@ -487,18 +546,19 @@ if (method=="REGISTER") {
                  username
                  _empty_line_
 
-1.6. Installation and Running
+6. Installation and Running
+
+   6.1. Database setup
 
-1.6.1. Database setup
+6.1. Database setup
 
-   Before running Kamailio with cpl-c, you have to setup the
-   database table where the module will store the CPL scripts. For
-   that, if the table was not created by the installation script
-   or you choose to install everything by yourself you can use the
-   cpc-create.sql SQL script in the database directories in the
-   kamailio/scripts folder as template. Database and table name
-   can be set with module parameters so they can be changed, but
-   the name of the columns must be as they are in the SQL script.
-   You can also find the complete database documentation on the
-   project webpage,
+   Before running Kamailio with cpl-c, you have to setup the database
+   table where the module will store the CPL scripts. For that, if the
+   table was not created by the installation script or you choose to
+   install everything by yourself you can use the cpc-create.sql SQL
+   script in the database directories in the kamailio/scripts folder as
+   template. Database and table name can be set with module parameters so
+   they can be changed, but the name of the columns must be as they are in
+   the SQL script. You can also find the complete database documentation
+   on the project webpage,
    http://www.kamailio.org/docs/db-tables/kamailio-db-devel.html.
index e8f4a95..3b0011d 100644 (file)
@@ -16,7 +16,7 @@
                <author>
                        <firstname>Bogdan-Andrei</firstname>
                        <surname>Iancu</surname>
-                       <affiliation><orgname>&voicesystem;</orgname></affiliation>
+                       <affiliation><orgname>Voice Sistem SRL</orgname></affiliation>
                        <address>
                                <email>bogdan@voice-system.ro</email>
                        </address>
                <year>2003</year>
                <holder>&fhg;</holder>
        </copyright>
-       <revhistory>
-               <revision>
-                       <revnumber>$Revision$</revnumber>
-                       <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
 
index e80820d..400412d 100644 (file)
@@ -18,30 +18,27 @@ Iouri Kharon
 
    <yjh@styx.cabel.net>
 
-   Copyright © 2007,2008 TRUNK MOBILE, INC.
-   Revision History
-   Revision $Revision: 3936 $ $Date: 2008-03-07 13:57:32 +0300
-                              (Fri, 07 Mar 2008) $
-     __________________________________________________________
+   Copyright © 2007,2008 TRUNK MOBILE, INC.
+     __________________________________________________________________
 
    Table of Contents
 
    1. User's Guide
 
-        1.1. Overview
-        1.2. Dependencies
+        1. Overview
+        2. Dependencies
 
-              1.2.1. Kamailio Modules
-              1.2.2. External Libraries or Applications
+              2.1. Kamailio Modules
+              2.2. External Libraries or Applications
 
-        1.3. Exported Parameters
+        3. Exported Parameters
 
-              1.3.1. timeout (fixedpoint)
-              1.3.2. reconnect (fixedpoint)
+              3.1. timeout (fixedpoint)
+              3.2. reconnect (fixedpoint)
 
-        1.4. Exported Functions
-        1.5. Installation
-        1.6. Utility openser_orasel
+        4. Exported Functions
+        5. Installation
+        6. Utility openser_orasel
 
    List of Examples
 
@@ -51,32 +48,54 @@ Iouri Kharon
 
 Chapter 1. User's Guide
 
-1.1. Overview
+   Table of Contents
+
+   1. Overview
+   2. Dependencies
+
+        2.1. Kamailio Modules
+        2.2. External Libraries or Applications
+
+   3. Exported Parameters
+
+        3.1. timeout (fixedpoint)
+        3.2. reconnect (fixedpoint)
 
-   This is a module which provides Oracle connectivity for
-   Kamailio. It implements the DB API defined in Kamailio. If you
-   want to use the nathelper module, or any other modules that
-   calls the get_all_ucontacts API export from usrloc, then you
-   need to set the DORACLE_USRLOC define in the Makefile.defs file
-   before compilation.
+   4. Exported Functions
+   5. Installation
+   6. Utility openser_orasel
 
-1.2. Dependencies
+1. Overview
 
-1.2.1. Kamailio Modules
+   This is a module which provides Oracle connectivity for Kamailio. It
+   implements the DB API defined in Kamailio. If you want to use the
+   nathelper module, or any other modules that calls the get_all_ucontacts
+   API export from usrloc, then you need to set the DORACLE_USRLOC define
+   in the Makefile.defs file before compilation.
+
+2. Dependencies
+
+   2.1. Kamailio Modules
+   2.2. External Libraries or Applications
+
+2.1. Kamailio Modules
 
    The following modules must be loaded before this module:
      * No dependencies on other Kamailio modules.
 
-1.2.2. External Libraries or Applications
+2.2. External Libraries or Applications
+
+   The following libraries or applications must be installed before
+   running Kamailio with this module loaded:
+     * instantclient-sdk-10.2.0.3 - the development headers and libraries
+       of OCI.
 
-   The following libraries or applications must be installed
-   before running Kamailio with this module loaded:
-     * instantclient-sdk-10.2.0.3 - the development headers and
-       libraries of OCI.
+3. Exported Parameters
 
-1.3. Exported Parameters
+   3.1. timeout (fixedpoint)
+   3.2. reconnect (fixedpoint)
 
-1.3.1. timeout (fixedpoint)
+3.1. timeout (fixedpoint)
 
    Timeout value for any operation with BD.
 
@@ -84,8 +103,8 @@ Chapter 1. User's Guide
 
    Default value is 3.0 (3 second).
 
-   If value of timeout parameter set to 0, module use synchronous
-   mode (without timeout).
+   If value of timeout parameter set to 0, module use synchronous mode
+   (without timeout).
 
    Example 1.1. Set timeout parameter
 ...
@@ -97,7 +116,7 @@ modparam("db_oracle", "timeout", 1.5)
 modparam("db_oracle", "timeout", 0)
 ...
 
-1.3.2. reconnect (fixedpoint)
+3.2. reconnect (fixedpoint)
 
    Timeout value for connect (create session) operation.
 
@@ -110,32 +129,29 @@ modparam("db_oracle", "timeout", 0)
 modparam("db_oracle", "reconnect", 0.5)
 ...
 
-1.4. Exported Functions
+4. Exported Functions
 
    No function exported to be used from configuration file.
 
-1.5. Installation
+5. Installation
 
-   Because it dependes on an external library, the oracle module
-   is not compiled and installed by default. You can use one of
-   the next options.
+   Because it dependes on an external library, the oracle module is not
+   compiled and installed by default. You can use one of the next options.
      * - edit the "Makefile" and remove "db_oracle" from
-       "excluded_modules" list. Then follow the standard procedure
-       to install Kamailio: "make all; make install".
-     * - from command line use: 'make all
-       include_modules="db_oracle"; make install
-       include_modules="db_oracle"'.
-
-1.6. Utility openser_orasel
-
-   For working with kamctl script, should be able to print the
-   'query' results to the terminal in a user-readable form. The
-   standard command-line Oracle client (sqlplus) is not quite
-   suitable for this, as it cannot align row width to real
-   (received) data's (it always prints a cell width as described
-   in the db scheme). This problem has been solved by inclusion
-   the utility openser_orasel, which formats printing
+       "excluded_modules" list. Then follow the standard procedure to
+       install Kamailio: "make all; make install".
+     * - from command line use: 'make all include_modules="db_oracle";
+       make install include_modules="db_oracle"'.
+
+6. Utility openser_orasel
+
+   For working with kamctl script, should be able to print the 'query'
+   results to the terminal in a user-readable form. The standard
+   command-line Oracle client (sqlplus) is not quite suitable for this, as
+   it cannot align row width to real (received) data's (it always prints a
+   cell width as described in the db scheme). This problem has been solved
+   by inclusion the utility openser_orasel, which formats printing
    approximately in the same way as the 'mysql' client utility. In
-   addition, this utility known about the "agreements and types"
-   in DB that are used in Kamailio for the work with Oracle and
-   formats printing taking these into account.
+   addition, this utility known about the "agreements and types" in DB
+   that are used in Kamailio for the work with Oracle and formats printing
+   taking these into account.
index ba92fdd..da9ed67 100644 (file)
            <year>2007,2008</year>
            <holder>TRUNK MOBILE, INC.</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision: 3936 $</revnumber>
-               <date>$Date: 2008-03-07 13:57:32 +0300 (Fri, 07 Mar 2008) $</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
 
index 2679f99..20079ad 100644 (file)
@@ -7,8 +7,6 @@ Edited by
 Timo Teräs
 
    Copyright © 2011 Timo Teräs
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index de1c53d..4bd37bf 100644 (file)
            <year>2011</year>
            <holder>Timo Teräs</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
 
index 9c10f61..90b547c 100644 (file)
@@ -11,8 +11,6 @@ Daniel-Constantin Mierla
    <miconda@gmail.com>
 
    Copyright © 2003, 2004 FhG FOKUS
-   Revision History
-   Revision $Revision$ $Date$
      __________________________________________________________________
 
    Table of Contents
index c2187fd..a1b856a 100644 (file)
            <year>2004</year>
            <holder>&fhg;</holder>
        </copyright>
-       <revhistory>
-           <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-           </revision>
-       </revhistory>
     </bookinfo>
     <toc></toc>
     
index 63d3029..5b06de3 100644 (file)
@@ -8,125 +8,152 @@ Edited by
 
 Marco Lorrai
 
-   Copyright © 2005, 2006 Marco Lorrai
-   Revision History
-   Revision $Revision$ $Date: 2008-08-06 12:08:33 +0200
-                              (Mi, 06 Aug 2008) $
-     __________________________________________________________
+   Copyright © 2005, 2006 Marco Lorrai
+     __________________________________________________________________
 
    Table of Contents
 
    1. Admin Guide
 
-        1.1. Overview
-        1.2. Dependencies
+        1. Overview
+        2. Dependencies
 
-              1.2.1. Kamailio Modules
-              1.2.2. External Libraries or Applications
+              2.1. Kamailio Modules
+              2.2. External Libraries or Applications
 
-        1.3. Exported Parameters
+        3. Exported Parameters
 
-              1.3.1. ping_interval (int)
-              1.3.2. auto_reconnect (int)
-              1.3.3. use_escape_common (int)
+              3.1. ping_interval (int)
+              3.2. auto_reconnect (int)
+              3.3. use_escape_common (int)
 
-        1.4. Exported Functions
-        1.5. Installation and Running
+        4. Exported Functions
+        5. Installation and Running
 
-              1.5.1. Installing
-              1.5.2. Configuring and Running
+              5.1. Installing
+              5.2. Configuring and Running
 
    2. Developer Guide
 
    List of Examples
 
-   1.1. Set the "ping_interval" parameter
-   1.2. Set the "auto_reconnect" parameter
-   1.3. Set the "use_escape_common" parameter
+   1.1. Set the “ping_interval” parameter
+   1.2. Set the “auto_reconnect” parameter
+   1.3. Set the “use_escape_common” parameter
 
 Chapter 1. Admin Guide
 
-1.1. Overview
+   Table of Contents
+
+   1. Overview
+   2. Dependencies
+
+        2.1. Kamailio Modules
+        2.2. External Libraries or Applications
+
+   3. Exported Parameters
+
+        3.1. ping_interval (int)
+        3.2. auto_reconnect (int)
+        3.3. use_escape_common (int)
+
+   4. Exported Functions
+   5. Installation and Running
 
-   This module allows to use the unixodbc package with Kamailio.
-   It have been tested with mysql and the odbc connector, but it
-   should work also with other database. The auth_db module works.
+        5.1. Installing
+        5.2. Configuring and Running
 
-   For more information, see the http://www.unixodbc.org/ project
-   web page.
+1. Overview
+
+   This module allows to use the unixodbc package with Kamailio. It have
+   been tested with mysql and the odbc connector, but it should work also
+   with other database. The auth_db module works.
+
+   For more information, see the http://www.unixodbc.org/ project web
+   page.
 
    To see what DB engines can be used via unixodbc, look at
    http://www.unixodbc.org/drivers.html.
 
-1.2. Dependencies
+2. Dependencies
+
+   2.1. Kamailio Modules
+   2.2. External Libraries or Applications
 
-1.2.1. Kamailio Modules
+2.1. Kamailio Modules
 
    The following modules must be loaded before this module:
      * No dependencies on other Kamailio modules.
 
-1.2.2. External Libraries or Applications
+2.2. External Libraries or Applications
 
-   The following libraries or applications must be installed
-   before running Kamailio with this module loaded:
+   The following libraries or applications must be installed before
+   running Kamailio with this module loaded:
      * None.
 
-1.3. Exported Parameters
+3. Exported Parameters
 
-1.3.1. ping_interval (int)
+   3.1. ping_interval (int)
+   3.2. auto_reconnect (int)
+   3.3. use_escape_common (int)
+
+3.1. ping_interval (int)
 
    Sets the ping time interval.
 
-   Default value is "300" seconds.
+   Default value is “300” seconds.
 
-   Example 1.1. Set the "ping_interval" parameter
+   Example 1.1. Set the “ping_interval” parameter
 ...
 modparam("db_unixodbc", "ping_interval", 600)
 ...
 
-1.3.2. auto_reconnect (int)
+3.2. auto_reconnect (int)
 
    Turns on or off the auto_reconnect mode.
 
-   Default value is "1", this means it is enabled.
+   Default value is “1”, this means it is enabled.
 
-   Example 1.2. Set the "auto_reconnect" parameter
+   Example 1.2. Set the “auto_reconnect” parameter
 ...
 modparam("db_unixodbc", "auto_reconnect", 0)
 ...
 
-1.3.3. use_escape_common (int)
+3.3. use_escape_common (int)
 
-   Escape values in query using internal escape_common() function.
-   It escapes single quote ''', double quote '"', backslash '\',
-   and NULL characters.
+   Escape values in query using internal escape_common() function. It
+   escapes single quote ''', double quote '"', backslash '\', and NULL
+   characters.
 
-   You should enable this parameter if you know that the ODBC
-   driver considers the above characters as special (for marking
-   begin and end of a value, escape other characters ...). It
-   prevents against SQL injection.
+   You should enable this parameter if you know that the ODBC driver
+   considers the above characters as special (for marking begin and end of
+   a value, escape other characters ...). It prevents against SQL
+   injection.
 
-   Default value is "0" (0 = disabled; 1 = enabled).
+   Default value is “0” (0 = disabled; 1 = enabled).
 
-   Example 1.3. Set the "use_escape_common" parameter
+   Example 1.3. Set the “use_escape_common” parameter
 ...
 modparam("db_unixodbc", "use_escape_common", 1)
 ...
 
-1.4. Exported Functions
+4. Exported Functions
 
    NONE
 
-1.5. Installation and Running
+5. Installation and Running
+
+   5.1. Installing
+   5.2. Configuring and Running
 
-1.5.1. Installing
+5.1. Installing
 
-   Prerequirement: you should first install unixodbc (or another
-   program that implements the odbc standard, such iodbc), your
-   database, and the right connector. Set the DSN in the odbc.ini
-   file and the connector drivers in the odbcinst.ini file.
+   Prerequirement: you should first install unixodbc (or another program
+   that implements the odbc standard, such iodbc), your database, and the
+   right connector. Set the DSN in the odbc.ini file and the connector
+   drivers in the odbcinst.ini file.
 
-1.5.2. Configuring and Running
+5.2. Configuring and Running
 
    In the openser.conf file, add the line:
 ....
@@ -142,8 +169,8 @@ modparam("auth_db", "calculate_ha1", yes)
 modparam("auth_db", "password_column", "password")
 ....
 
-   and setting the DSN specified in the odbc.ini, inserting this
-   with the url adding this line:
+   and setting the DSN specified in the odbc.ini, inserting this with the
+   url adding this line:
 ....
 modparam("usrloc|auth_db", "db_url",
     "unixodbc://openser:openserrw@localhost/my_dsn")
@@ -151,14 +178,14 @@ modparam("usrloc|auth_db", "db_url",
 
    replacing my_dsn with the correct value.
 
-   HINT: if unixodbc don't want to connect to mysql server, try
-   restarting mysql server with:
+   HINT: if unixodbc don't want to connect to mysql server, try restarting
+   mysql server with:
 shell>safe_mysqld --user=mysql --socket=/var/lib/mysql/mysql.sock
 
-   The connector search the socket in /var/lib/mysql/mysql.sock
-   and not in /tmp/mysql.sock
+   The connector search the socket in /var/lib/mysql/mysql.sock and not in
+   /tmp/mysql.sock
 
 Chapter 2. Developer Guide
 
-   The module implements the Kamailio DB API, in order to be used
-   by other modules.
+   The module implements the Kamailio DB API, in order to be used by other
+   modules.
index 109d275..089e4ab 100644 (file)
                <year>2006</year>
                <holder>Marco Lorrai</holder>
        </copyright>
-       <revhistory>
-               <revision>
-               <revnumber>$Revision$</revnumber>
-               <date>$Date$</date>
-               </revision>
-       </revhistory>
        </bookinfo>
        <toc></toc>
        
index 233e136..74a96df 100644 (file)
@@ -4,13 +4,21 @@ Bogdan-Andrei Iancu
 
    Voice Sistem SRL
 
+Carsten Bock
+
+   ng-voice.com
+
 Edited by
 
 Bogdan-Andrei Iancu
 
-   Copyright © 2006 voice-system.ro
-   Revision History
-   Revision $Revision$ $Date$
+Edited by
+
+Carsten Bock
+
+   Copyright © 2006 Voice Sistem SRL
+
+   Copyright © 2011 Carsten Bock, http://www.ng-voice.com
      __________________________________________________________________
 
    Table of Contents
@@ -61,9 +69,14 @@ Bogdan-Andrei Iancu
               5.32. timeout_column (string)
               5.33. sflags_column (string)
               5.34. toroute_column (string)
-              5.35. profiles_with_value (string)
-              5.36. profiles_no_value (string)
-              5.37. bridge_controller (string)
+              5.35. vars_table_name (string)
+              5.36. vars_h_id_column (string)
+              5.37. vars_h_entry_column (string)
+              5.38. vars_key_column (string)
+              5.39. vars_value_column (string)
+              5.40. profiles_with_value (string)
+              5.41. profiles_no_value (string)
+              5.42. bridge_controller (string)
 
         6. Exported Functions
 
@@ -117,6 +130,7 @@ Bogdan-Andrei Iancu
               10.3. $DLG_lifetime
               10.4. $dlg(...)
               10.5. $dlg_ctx(...)
+              10.6. $dlg_var(key)
 
    2. Developer Guide
 
@@ -162,22 +176,27 @@ Bogdan-Andrei Iancu
    1.32. Set timeout_column parameter
    1.33. Set sflags_column parameter
    1.34. Set toroute_column parameter
-   1.35. Set profiles_with_value parameter
-   1.36. Set profiles_no_value parameter
-   1.37. Set bridge_controller parameter
-   1.38. set_dlg_profile usage
-   1.39. unset_dlg_profile usage
-   1.40. is_in_profile usage
-   1.41. get_profile_size usage
-   1.42. dlg_isflagset usage
-   1.43. dlg_setflag usage
-   1.44. dlg_resetflag usage
-   1.45. dlg_bye usage
-   1.46. dlg_refer usage
-   1.47. dlg_manage usage
-   1.48. dlg_bridge usage
-   1.49. dlg_get usage
-   1.50. is_known_dlg() usage
+   1.35. Set vars_table_name parameter
+   1.36. Set vars_h_id_column parameter
+   1.37. Set vars_h_entry_column parameter
+   1.38. Set vars_key_column parameter
+   1.39. Set vars_value_column parameter
+   1.40. Set profiles_with_value parameter
+   1.41. Set profiles_no_value parameter
+   1.42. Set bridge_controller parameter
+   1.43. set_dlg_profile usage
+   1.44. unset_dlg_profile usage
+   1.45. is_in_profile usage
+   1.46. get_profile_size usage
+   1.47. dlg_isflagset usage
+   1.48. dlg_setflag usage
+   1.49. dlg_resetflag usage
+   1.50. dlg_bye usage
+   1.51. dlg_refer usage
+   1.52. dlg_manage usage
+   1.53. dlg_bridge usage
+   1.54. dlg_get usage
+   1.55. is_known_dlg() usage
 
 Chapter 1. Admin Guide
 
@@ -227,9 +246,14 @@ Chapter 1. Admin Guide
         5.32. timeout_column (string)
         5.33. sflags_column (string)
         5.34. toroute_column (string)
-        5.35. profiles_with_value (string)
-        5.36. profiles_no_value (string)
-        5.37. bridge_controller (string)
+        5.35. vars_table_name (string)
+        5.36. vars_h_id_column (string)
+        5.37. vars_h_entry_column (string)
+        5.38. vars_key_column (string)
+        5.39. vars_value_column (string)
+        5.40. profiles_with_value (string)
+        5.41. profiles_no_value (string)
+        5.42. bridge_controller (string)
 
    6. Exported Functions
 
@@ -283,6 +307,7 @@ Chapter 1. Admin Guide
         10.3. $DLG_lifetime
         10.4. $dlg(...)
         10.5. $dlg_ctx(...)
+        10.6. $dlg_var(key)
 
 1. Overview
 
@@ -386,9 +411,14 @@ Chapter 1. Admin Guide
    5.32. timeout_column (string)
    5.33. sflags_column (string)
    5.34. toroute_column (string)
-   5.35. profiles_with_value (string)
-   5.36. profiles_no_value (string)
-   5.37. bridge_controller (string)
+   5.35. vars_table_name (string)
+   5.36. vars_h_id_column (string)
+   5.37. vars_h_entry_column (string)
+   5.38. vars_key_column (string)
+   5.39. vars_value_column (string)
+   5.40. profiles_with_value (string)
+   5.41. profiles_no_value (string)
+   5.42. bridge_controller (string)
 
 5.1. enable_stats (integer)
 
@@ -823,35 +853,93 @@ modparam("dialog", "sflags_column", "s_flags")
 modparam("dialog", "toroute_column", "timeout_route")
 ...
 
-5.35. profiles_with_value (string)
+5.35. vars_table_name (string)
+
+   If you want to store the variables for a dialog in a database a table
+   name must be specified.
+
+   Default value is “dialog_vars”.
+
+   Example 1.35. Set vars_table_name parameter
+...
+modparam("dialog", "vars_table_name", "my_dialog_vars")
+...
+
+5.36. vars_h_id_column (string)
+
+   The column name in the database to store the dialogs' hash id
+   information (as a reference to the dialog table).
+
+   Default value is “hash_id”.
+
+   Example 1.36. Set vars_h_id_column parameter
+...
+modparam("dialog", "vars_h_id_column", "vars_h_id_name")
+...
+
+5.37. vars_h_entry_column (string)
+
+   The column name in the database to store the dialogs' hash entry
+   information (as a reference to the dialog table).
+
+   Default value is “hash_entry”.
+
+   Example 1.37. Set vars_h_entry_column parameter
+...
+modparam("dialog", "vars_h_entry_column", "vars_h_entry_name")
+...
+
+5.38. vars_key_column (string)
+
+   The column name in the database to store the keys of a va