Merge pull request #3 from AndreyRybkin/master
authorDaniel-Constantin Mierla <miconda@gmail.com>
Sat, 3 Jan 2015 20:14:24 +0000 (21:14 +0100)
committerDaniel-Constantin Mierla <miconda@gmail.com>
Sat, 3 Jan 2015 20:14:24 +0000 (21:14 +0100)
usrloc_dmq: add module for usrloc sync via dmq

464 files changed:
.travis.yml [new file with mode: 0644]
Makefile.defs
README
action.c
action.h
async_task.c
async_task.h
atomic_ops.c
atomic_ops.h
atomic_ops_init.h
basex.c
basex.h
bit_count.c
bit_count.h
bit_scan.c
bit_scan.h
bit_test.h
cfg_core.c
cfg_core.h
cfg_parser.c
cfg_parser.h
char_msg_val.h
clist.h
comp_defs.h
compiler_opt.h
config.h
core_cmd.c
core_cmd.h
core_stats.h
counters.c
counters.h
crc.c
crc.h
daemonize.c
daemonize.h
data_lump.c
data_lump.h
data_lump_rpl.c
data_lump_rpl.h
dns_cache.c
dns_cache.h
dns_func.c
dns_func.h
dns_wrappers.h
doc/rpc/Makefile
doc/rpc/kamailio_rpc.txt [moved from doc/rpc/ser_rpc.txt with 94% similarity]
doc/rpc/kamailio_rpc.xml [moved from doc/rpc/ser_rpc.xml with 96% similarity]
dprint.c
dprint.h
dset.c
dset.h
dst_blacklist.c
dst_blacklist.h
endianness.c
endianness.h
error.c
error.h
events.c
events.h
examples/pcscf/kamailio.cfg
fastlock.h
fix_lumps.h
flags.c
flags.h
forward.c
forward.h
futexlock.h
globals.h
hash_func.c
hash_func.h
hashes.h
id.c
id.h
io_wait.c
io_wait.h
ip_addr.c
ip_addr.h
kstats_types.h
lib/README
lib/doxygen.cfg
lib/kcore/cmpapi.c
lib/kcore/cmpapi.h
lib/kcore/faked_msg.c
lib/kcore/faked_msg.h
lib/kcore/kstats_wrapper.c
lib/kcore/kstats_wrapper.h
lib/kcore/parse_privacy.c
lib/kcore/parse_privacy.h
lib/kcore/parse_sst.c
lib/kcore/parse_sst.h
lib/kcore/radius.h
lib/kcore/regexp.c
lib/kcore/regexp.h
lib/kcore/statistics.c
lib/kcore/statistics.h
lib/kcore/strcommon.c
lib/kcore/strcommon.h
lib/srdb1/db.c
lib/srutils/README
lib/srutils/shautils.c
lib/srutils/shautils.h
lib/srutils/srjson.c
lib/srutils/srjson.h
lib/srutils/sruid.c
lib/srutils/sruid.h
lib/srutils/tmrec.c
list.h
local_timer.c
local_timer.h
lock_alloc.h
lock_ops.c
lock_ops.h
lock_ops_init.h
locking.h
lump_struct.h
lvalue.c
lvalue.h
main.c
md5utils.c
md5utils.h
mod_fix.c
mod_fix.h
modparam.c
modparam.h
modules/acc/acc.c
modules/auth_db/README
modules/auth_db/authdb_mod.c
modules/auth_db/authorize.c
modules/auth_db/authorize.h
modules/auth_db/doc/auth_db_admin.xml
modules/cdp/authstatemachine.c
modules/cfgutils/README
modules/cfgutils/cfgutils.c
modules/cfgutils/doc/cfgutils.xml
modules/cfgutils/doc/cfgutils_admin.xml
modules/counters/counters.c
modules/db_flatstore/README
modules/db_flatstore/doc/db_flatstore.xml
modules/db_mysql/Makefile
modules/db_postgres/README
modules/db_postgres/doc/db_postgres_admin.xml
modules/db_postgres/km_dbase.c
modules/db_postgres/km_pg_con.c
modules/db_postgres/pg_con.c
modules/db_postgres/pg_mod.c
modules/db_postgres/pg_mod.h
modules/db_text/README
modules/db_text/dbt_api.c
modules/db_text/dbt_base.c
modules/db_text/dbt_file.c
modules/db_text/dbt_lib.c
modules/db_text/dbt_lib.h
modules/db_text/dbt_res.c
modules/db_text/dbtext.c
modules/db_text/doc/db_text.xml
modules/db_text/doc/db_text_admin.xml
modules/dialog/dialog.c
modules/dialog/dlg_profile.c
modules/dialog/dlg_profile.h
modules/dialog/dlg_var.c
modules/dialog/dlg_var.h
modules/dialplan/README
modules/dialplan/dialplan.c
modules/dialplan/doc/dialplan.xml
modules/dialplan/doc/dialplan_admin.xml
modules/dispatcher/README
modules/dispatcher/dispatch.c
modules/dispatcher/dispatch.h
modules/dispatcher/dispatcher.c
modules/dispatcher/doc/dispatcher.xml
modules/dispatcher/doc/dispatcher_admin.xml
modules/dnssec/dnssec_func.c
modules/dnssec/dnssec_func.h
modules/dnssec/dnssec_mod.c
modules/evapi/README
modules/evapi/doc/evapi_admin.xml
modules/exec/exec_hf.c
modules/ims_icscf/registration.c
modules/ims_isc/checker.c
modules/ims_isc/mod.c
modules/ims_isc/third_party_reg.c
modules/ims_isc/third_party_reg.h
modules/ims_qos/doc/ims_qos_admin.xml
modules/ims_qos/mod.c
modules/ims_qos/rx_aar.c
modules/ims_qos/rx_authdata.c
modules/ims_qos/rx_authdata.h
modules/ims_registrar_scscf/lookup.c
modules/ims_registrar_scscf/registrar_notify.c
modules/ims_registrar_scscf/save.c
modules/ims_usrloc_pcscf/udomain.c
modules/ims_usrloc_pcscf/usrloc.c
modules/ims_usrloc_pcscf/usrloc.h
modules/ims_usrloc_scscf/impurecord.c
modules/ims_usrloc_scscf/subscribe.c
modules/ims_usrloc_scscf/udomain.c
modules/ims_usrloc_scscf/usrloc_db.c
modules/kazoo/kazoo.c
modules/mangler/README
modules/mangler/doc/mangler_functions.xml
modules/mangler/doc/mangler_params.xml
modules/nat_traversal/nat_traversal.c
modules/nathelper/README
modules/nathelper/doc/nathelper_admin.xml
modules/nathelper/nathelper.c
modules/presence/README
modules/presence/doc/presence_admin.xml
modules/presence/hash.c
modules/presence/presence.c
modules/presence/subscribe.c
modules/pua/send_publish.c
modules/pua_dialoginfo/README
modules/pua_dialoginfo/doc/pua_dialoginfo_admin.xml
modules/pua_dialoginfo/pua_dialoginfo.c
modules/pv/README
modules/pv/doc/pv_admin.xml
modules/registrar/README
modules/registrar/doc/registrar.xml
modules/registrar/doc/registrar_admin.xml
modules/registrar/lookup.c
modules/registrar/path.c
modules/registrar/save.c
modules/registrar/sip_msg.c
modules/siptrace/siptrace.c
modules/siputils/README
modules/siputils/checks.c
modules/siputils/checks.h
modules/siputils/doc/siputils_admin.xml
modules/siputils/siputils.c
modules/snmpstats/alarm_checks.c
modules/snmpstats/alarm_checks.h
modules/snmpstats/hashTable.c
modules/snmpstats/hashTable.h
modules/snmpstats/interprocess_buffer.c
modules/snmpstats/interprocess_buffer.h
modules/snmpstats/kamailioNet.c
modules/snmpstats/kamailioNet.h
modules/snmpstats/kamailioNetConfig.c
modules/snmpstats/kamailioServer.c
modules/snmpstats/kamailioServer.h
modules/snmpstats/snmpMIBNotifications.c
modules/snmpstats/snmpMIBNotifications.h
modules/snmpstats/snmpObjects.c
modules/snmpstats/snmpObjects.h
modules/snmpstats/snmpSIPCommonObjects.c
modules/snmpstats/snmpSIPCommonObjects.h
modules/snmpstats/snmpSIPContactTable.c
modules/snmpstats/snmpSIPContactTable.h
modules/snmpstats/snmpSIPMethodSupportedTable.c
modules/snmpstats/snmpSIPMethodSupportedTable.h
modules/snmpstats/snmpSIPPortTable.c
modules/snmpstats/snmpSIPPortTable.h
modules/snmpstats/snmpSIPRegUserLookupTable.c
modules/snmpstats/snmpSIPRegUserLookupTable.h
modules/snmpstats/snmpSIPRegUserTable.c
modules/snmpstats/snmpSIPRegUserTable.h
modules/snmpstats/snmpSIPServerObjects.c
modules/snmpstats/snmpSIPServerObjects.h
modules/snmpstats/snmpSIPStatusCodesTable.c
modules/snmpstats/snmpSIPStatusCodesTable.h
modules/snmpstats/snmpstats.c
modules/snmpstats/snmpstats.h
modules/snmpstats/snmpstats_globals.h
modules/snmpstats/sub_agent.c
modules/snmpstats/sub_agent.h
modules/snmpstats/utilities.c
modules/snmpstats/utilities.h
modules/statistics/statistics.c
modules/statistics/stats_funcs.c
modules/statistics/stats_funcs.h
modules/statsd/Makefile [new file with mode: 0644]
modules/statsd/README [new file with mode: 0644]
modules/statsd/doc/Makefile [new file with mode: 0644]
modules/statsd/doc/statsd.xml [new file with mode: 0644]
modules/statsd/doc/statsd_admin.xml [new file with mode: 0644]
modules/statsd/lib_statsd.c [new file with mode: 0644]
modules/statsd/statsd.c [new file with mode: 0644]
modules/stun/config.c
modules/stun/config.h
modules/stun/kam_stun.c
modules/stun/kam_stun.h
modules/stun/stun_mod.c
modules/tls/README
modules/tls/doc/params.xml
modules/tls/tls_config.c
modules/tls/tls_domain.c
modules/tls/tls_domain.h
modules/tls/tls_init.c
modules/tm/README
modules/tm/callid.c
modules/tm/callid.h
modules/tm/config.c
modules/tm/config.h
modules/tm/defs.h
modules/tm/dlg.c
modules/tm/dlg.h
modules/tm/doc/params.xml
modules/tm/h_table.c
modules/tm/h_table.h
modules/tm/lock.c
modules/tm/lock.h
modules/tm/lw_parser.c
modules/tm/lw_parser.h
modules/tm/rpc_uac.c
modules/tm/rpc_uac.h
modules/tm/select.c
modules/tm/select.h
modules/tm/sip_msg.c
modules/tm/sip_msg.h
modules/tm/t_append_branches.c
modules/tm/t_append_branches.h
modules/tm/t_cancel.c
modules/tm/t_cancel.h
modules/tm/t_fifo.c
modules/tm/t_fifo.h
modules/tm/t_funcs.c
modules/tm/t_funcs.h
modules/tm/t_fwd.c
modules/tm/t_fwd.h
modules/tm/t_hooks.c
modules/tm/t_hooks.h
modules/tm/t_lookup.c
modules/tm/t_lookup.h
modules/tm/t_msgbuilder.c
modules/tm/t_msgbuilder.h
modules/tm/t_reply.c
modules/tm/t_reply.h
modules/tm/t_serial.c
modules/tm/t_serial.h
modules/tm/t_stats.c
modules/tm/t_stats.h
modules/tm/t_suspend.c
modules/tm/t_suspend.h
modules/tm/test.c
modules/tm/timer.c
modules/tm/timer.h
modules/tm/tm.c
modules/tm/tm_load.c
modules/tm/tm_load.h
modules/tm/uac.c
modules/tm/uac.h
modules/tm/ut.h
modules/tmx/README
modules/tmx/doc/tmx_admin.xml
modules/tmx/t_var.c
modules/tmx/tmx_pretran.c
modules/userblacklist/README
modules/userblacklist/doc/userblacklist.xml
modules/userblacklist/doc/userblacklist_admin.xml
modules/userblacklist/doc/userblacklist_db.xml [deleted file]
modules/usrloc/dlist.c
modules/usrloc/dlist.h
modules/usrloc/hslot.c
modules/usrloc/hslot.h
modules/usrloc/ucontact.c
modules/usrloc/ucontact.h
modules/usrloc/udomain.c
modules/usrloc/udomain.h
modules/usrloc/ul_callback.c
modules/usrloc/ul_callback.h
modules/usrloc/ul_mi.c
modules/usrloc/ul_mi.h
modules/usrloc/ul_mod.c
modules/usrloc/ul_mod.h
modules/usrloc/ul_rpc.c
modules/usrloc/ul_rpc.h
modules/usrloc/urecord.c
modules/usrloc/urecord.h
modules/usrloc/usrloc.c
modules/usrloc/usrloc.h
modules/usrloc/utime.c
modules/usrloc/utime.h
modules/utils/functions.c
modules/utils/utils.h
modules/xhttp/README
modules/xhttp/doc/xhttp_admin.xml
modules/xlog/README
modules/xlog/doc/xlog_admin.xml
msg_translator.c
msg_translator.h
name_alias.h
nonsip_hooks.c
nonsip_hooks.h
onsend.h
pass_fd.c
pass_fd.h
pkg/kamailio/centos/6/kamailio.spec
pkg/kamailio/deb/build_deps.sh [new file with mode: 0755]
pkg/kamailio/deb/build_travis.sh [new file with mode: 0755]
poll_types.h
ppcfg.c
ppcfg.h
proxy.c
proxy.h
pt.c
pt.h
pv_core.c
pv_core.h
pvapi.c
pvapi.h
pvar.h
qvalue.c
qvalue.h
rad_dict.h
raw_listener.c
raw_listener.h
raw_sock.c
raw_sock.h
re.c
re.h
receive.c
receive.h
resolve.c
resolve.h
route.c
route.h
route_struct.c
route_struct.h
rpc.h
rpc_lookup.c
rpc_lookup.h
rvalue.c
rvalue.h
sched_yield.h
script_cb.c
script_cb.h
sctp_core.c
sctp_core.h
select.c
select.h
select_buf.c
select_buf.h
select_core.c
select_core.h
ser_time.h
shm_init.c
shm_init.h
signals.c
sip_msg_clone.c
sock_ut.c
socket_info.c
sr_compat.c
sr_module.c
stats.c
str.c
str_list.c
stun.c
switch.c
tcp_main.c
tcp_options.c
tcp_read.c
tcp_stats.c
timer.c
timer_proc.c
tls_hooks.c
tsend.c
udp_server.c
usr_avp.c
ut.c
utils/kamctl/dbtext/kamailio/dialplan
utils/kamctl/dbtext/kamailio/subscriber
utils/kamctl/kamctl
ver.c
xavp.c

diff --git a/.travis.yml b/.travis.yml
new file mode 100644 (file)
index 0000000..d5b76b0
--- /dev/null
@@ -0,0 +1,17 @@
+language: c
+compiler:
+  - gcc
+  - clang
+before_install:
+  - sudo apt-get update -qq
+  - sudo apt-get install -y gdebi-core
+  - sudo pkg/kamailio/deb/build_deps.sh precise $TRAVIS_BUILD_DIR
+script: ./pkg/kamailio/deb/build_travis.sh
+notifications:
+  irc:
+    channels:
+      - "chat.freenode.net#Kamailio"
+    on_success: change
+    on_failure: always
+  email:
+    - sr-dev@lists.sip-router.org
index f05c3e6..cceda7c 100644 (file)
@@ -165,7 +165,7 @@ INSTALL_FLAVOUR=$(FLAVOUR)
 VERSION = 4
 PATCHLEVEL = 3
 SUBLEVEL =  0
-EXTRAVERSION = -dev1
+EXTRAVERSION = -dev2
 
 # memory manager switcher
 # 0 - f_malloc (fast malloc)
diff --git a/README b/README
index 92816b1..4c554b0 100644 (file)
--- a/README
+++ b/README
@@ -81,7 +81,7 @@ Kamailio is the result of a merge of the code base and years of experience from
 both developer teams. In release 4.0, during the spring of 2013, the
 merger of the products was completed and a unified product was released.
 
-See http://www.sip-router.org/ for the story of SER, OpenSER/Kamailio and kamailio.org.
+See http://www.kamailio.org/ for the story of SER, OpenSER/Kamailio and kamailio.org.
 
 V. Obtaining Help
 =================
index 2e58034..cf3aab8 100644 (file)
--- a/action.c
+++ b/action.c
@@ -1,22 +1,15 @@
-
 /*
- * $Id$
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * ---------
- *  2003-02-28  scratchpad compatibility abandoned (jiri)
- *  2003-01-29  removed scratchpad (jiri)
- *  2003-03-19  fixed set* len calculation bug & simplified a little the code
- *              (should be a little faster now) (andrei)
- *              replaced all mallocs/frees w/ pkg_malloc/pkg_free (andrei)
- *  2003-04-01  Added support for loose routing in forward (janakj)
- *  2003-04-12  FORCE_RPORT_T added (andrei)
- *  2003-04-22  strip_tail added (jiri)
- *  2003-10-02  added SET_ADV_ADDR_T & SET_ADV_PORT_T (andrei)
- *  2003-10-29  added FORCE_TCP_ALIAS_T (andrei)
- *  2004-11-30  added FORCE_SEND_SOCKET_T (andrei)
- *  2005-12-12  return & drop/exit differentiation (andrei)
- *  2005-12-19  select framework (mma)
- *  2006-04-12  updated *_send() calls to use a struct dest_info (andrei)
- *  2006-07-27  dns cache and dns based send address failover support (andrei)
- *  2006-12-06  on popular request last_retcode set also by module functions
- *              (andrei)
- *  2007-06-14  run_actions & do_action need a ctx or handle now, no more
- *               static vars (andrei)
- *  2008-11-18  support for variable parameter module functions (andrei)
- *  2008-12-03  use lvalues/rvalues for assignments (andrei)
- *  2008-12-17  added UDP_MTU_TRY_PROTO_T (andrei)
- *  2009-05-04  switched IF_T to rval_expr (andrei)
- *  2009-09-15  added SET_{FWD,RPL}_NO_CONNECT, SET_{FWD,RPL}_CLOSE (andrei)
- *  2010-06-01  special hack/support for fparam fixups so that they can handle
- *               variable RVEs (andrei)
  */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Config file actions
  * \ingroup core
  * Module: \ref core
  */
@@ -932,8 +897,8 @@ int do_action(struct run_act_ctx* h, struct action* a, struct sip_msg* msg)
 
                                if (a->type==SET_USERPASS_T) tmp=0;
                                else tmp=uri.passwd.s;
-                               /* passwd */
-                               if (tmp){
+                               /* passwd - keep it only if user is set */
+                               if (user && tmp){
                                        len=uri.passwd.len; if(crt+len+1>end) goto error_uri;
                                        *crt=':'; crt++;
                                        memcpy(crt,tmp,len);crt+=len;
index f8a30f6..5af9276 100644 (file)
--- a/action.h
+++ b/action.h
@@ -1,22 +1,14 @@
 /*
- * $Id$
- *
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -28,7 +20,7 @@
 
 /*!
  * \file
- * \brief SIP-router core ::
+ * \brief SIP-router core :: Actions
  * \ingroup core
  * Module: \ref core
  */
index 63a7809..fcbb631 100644 (file)
@@ -1,7 +1,7 @@
 /**
  * Copyright (C) 2014 Daniel-Constantin Mierla (asipto.com)
  *
- * This file is part of Extensible SIP Router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
+/*!
+* \file
+* \brief Kamailio core :: Asynchronus tasks
+* \ingroup core
+* Module: \ref core
+*/
 
 #include <stdio.h>
 #include <unistd.h>
index 4c317a1..321ad06 100644 (file)
@@ -1,7 +1,7 @@
-/**
+/*
  * Copyright (C) 2014 Daniel-Constantin Mierla (asipto.com)
  *
- * This file is part of Extensible SIP Router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
 
+/** Kamailio core :: Aync tasks
+ * @ingroup core
+ * Module: core
+ */
 
 #ifndef _ASYNC_TASK_H_
 #define _ASYNC_TASK_H_
index e631f9f..82394d8 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2006 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- *  atomic operations init
- */
-/* 
- * History:
- * --------
- *  2006-03-08  created by andrei
- *  2007-05-11  added lock_set support (andrei)
- */
+
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief SIP-router core :: atomic operations init
  * \ingroup core
  * Module: \ref core
  */
index c2c0249..b757bdc 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2006 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
 
 /*!
  * \file
- * \brief SIP-router core :: Atomic operations and memory barriers
+ * \brief Kamailio core :: Atomic operations and memory barriers
+ * Copyright (C) 2006 iptelorg GmbH
  * \ingroup core
  * Module: \ref core
  * See \ref atomic
  */
 
-/*
+/**
  * \page atomicops  Atomic operations and memory barriers
  *
  *  WARNING: atomic ops do not include memory barriers
index c254c31..a66389e 100644 (file)
@@ -1,16 +1,14 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2006 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -22,7 +20,9 @@
 
 /*!
  * \file
- * \brief SIP-router core :: atomic_ops init functions
+ * \brief Kamailio core :: atomic_ops init functions
+ *
+ * Copyright (C) 2006 iptelorg GmbH
  *
  * \ingroup core
  * Module: \ref core
  * Needed for lock intializing if no native asm locks are available
  *  for the current arch./compiler combination, see \ref atomic_ops.c
  */
-/* 
- * History:
- * --------
- *  2006-03-30  created by andrei
- */
 
 #ifndef __atomic_ops_init_h
 #define __atomic_ops_init_h
diff --git a/basex.c b/basex.c
index 472c254..4a49478 100644 (file)
--- a/basex.c
+++ b/basex.c
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * convert/decode to/from ascii using various bases
  *
  * Copyright (C) 2008 iptelorg GmbH
  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
- */
-/*
+ *
  * Defines:
  *  BASE64_LOOKUP_TABLE - use small lookup tables for conversions (faster
  *                         in general)
- *
- * History:
- * --------
- *  2008-06-11  created by andrei
  */
 /*!
  * \file
- * \brief SIP-router core :: convert/decode to/from ascii using various bases
+ * \brief Kamailio core :: convert/decode to/from ascii using various bases
  * \ingroup core
  * Module: \ref core
  */
diff --git a/basex.h b/basex.h
index dc42530..f2d95d2 100644 (file)
--- a/basex.h
+++ b/basex.h
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * convert/decode to/from ascii using various bases
  *
  * Copyright (C) 2008 iptelorg GmbH
@@ -22,6 +20,7 @@
  * \file
  * \brief SIP-router core :: convert/decode to/from ascii using various bases
  *
+ * Copyright (C) 2008 iptelorg GmbH
  * \ingroup core
  *
  * Module: \ref core
index faef43c..5a60cf9 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2010 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  *
- * History
- * -------
- *  2010-04-26 Initial version (Miklos)
+ */
+/*!
+ * \file 
+ * \brief Kamailio core ::
+ * \ingroup core
+ * Module: \ref core
  */
 
 #include "bit_count.h"
index 6e7f62c..65f7202 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2010 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  *
- * History
- * -------
- *  2010-04-26 Initial version (Miklos)
  */
 
-/* Implements the bit counting function:
+/** Kamailio core ::  Implements the bit counting function:
+ * Copyright (C) 2010 iptelorg GmbH
+ * @ingroup core
+ * Module: core
+ *
  *   int bit_count(unsigned int u)
  *   Returns the number of bits in u.
  */
 
+
 #ifndef _BIT_COUNT_H
 #define _BIT_COUNT_H
 
index 24b5219..66066c6 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2007 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- *  bit scan operations, see bit_scan.h.
- */
-/* 
- * History:
- * --------
- *  2007-06-23  created by andrei
- */
+
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core ::  bit scan operations, see bit_scan.h.
  * \ingroup core
  * Module: \ref core
  */
index 6745bd7..3e690b5 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2007 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
@@ -17,7 +15,9 @@
  */
 /*!
  * \file
- * \brief SIP-router core :: bit scan operations
+ * \brief Kamailio core :: bit scan operations
+ *
+ * Copyright (C) 2007 iptelorg GmbH
  * \ingroup core
  * Module: \ref core
  *
index 9f83215..7745c04 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2010 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  *
- * History
- * -------
- *  2010-04-26 Initial version (Miklos)
- *  2011-01-05 bit_test_and_reset added (Miklos)
  */
 
-/* Bit test functions:
+/** Kamailio core :: Bit test functions
+ * @ingroup core
+ * Module: core
+ *
+ * Bit test functions:
  *  - int bit_test(int offset, unsigned int *addr)
  *      Returns the bit found at offset position 
  *      in a bitstring pointed by addr.
index f38e628..98a9c01 100644 (file)
@@ -1,16 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2007 iptelorg GmbH
  *
- * This file is part of SIP-router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * SIP-router is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * SIP-router is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History
- * -------
- *  2007-12-03 Initial version (Miklos)
- *  2008-01-31  added DNS resolver parameters (Miklos)
  */
-/** core runtime config.
+
+/** Kamailio core :: core runtime config.
  * @file cfg_core.c
  * @ingroup core
  * Module: @ref core
index 21e3759..f7db8d0 100644 (file)
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2007 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
+ *
+ */
+
+/** Kamailio core :: runtime configuration variables
+ * @file cfg_core.h
+ * @ingroup core
+ *
+ * Module: @ref core
+ *
  * HOWTO:
  *     If you need a new configuration variable within the core, put it into
  *     struct cfg_goup_core, and define it in cfg_core.c:core_cfg_def array.
  *     cfg_core.c:default_core_cfg
  *     Include this header file in your source code, and retrieve the
  *     value with cfg_get(core, core_cfg, variable_name).
- *
- * History
- * -------
- *  2007-12-03 Initial version (Miklos)
- */
-/** core runtime config.
- * @file cfg_core.h
- * @ingroup core
- *
- * Module: @ref core
  */
 
 
index d764709..5b3cc12 100644 (file)
@@ -1,18 +1,17 @@
 /*
- * $Id$
  * Standalone Configuration File Parser
  *
  * Copyright (C) 2008 iptelorg GmbH
  * Written by Jan Janak <jan@iptel.org>
  *
- * This file is part of SER, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * SER is free software; you can redistribute it and/or modify it under the
+ * Kamailio is free software; you can redistribute it and/or modify it under the
  * terms of the GNU General Public License as published by the Free Software
  * Foundation; either version 2 of the License, or (at your option) any later
  * version.
  *
- * SER is distributed in the hope that it will be useful, but WITHOUT ANY
+ * Kamailio is distributed in the hope that it will be useful, but WITHOUT ANY
  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
  * details.
@@ -23,7 +22,8 @@
  */
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Standalone Configuration File Parser
+ * \author Jan Janak <jan@iptel.org>
  * \ingroup core
  *
  * Module: \ref core
index 13e95b8..9e711bf 100644 (file)
@@ -1,18 +1,17 @@
 /*
- * $Id$
  * Standalone Configuration File Parser
  *
  * Copyright (C) 2008 iptelorg GmbH
  * Written by Jan Janak <jan@iptel.org>
  *
- * This file is part of SER, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * SER is free software; you can redistribute it and/or modify it under the
+ * Kamailio is free software; you can redistribute it and/or modify it under the
  * terms of the GNU General Public License as published by the Free Software
  * Foundation; either version 2 of the License, or (at your option) any later
  * version.
  *
- * SER is distributed in the hope that it will be useful, but WITHOUT ANY
+ * Kamailio is distributed in the hope that it will be useful, but WITHOUT ANY
  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
  * details.
@@ -25,6 +24,7 @@
 /*!
  * \file
  * \brief SIP-router core :: Standalone Configuration File Parser
+ * Written by Jan Janak <jan@iptel.org>
  *
  * \ingroup core
  * Module: \ref core
index 9565617..4d6887d 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2010 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- * char_msg_val.h
- */
-/*
- * History:
- * --------
- *  2010-02-10  moved from parser/msg_parser.h and added tag only mode
- *               by default (andrei)
-*/
+
 /** compute the characteristic value of a message.
  * @file
  * @ingroup core
- */
-/* Defines:
+ * \author andrei
+ *
+ * Defines:
  *  BRANCH_INCLUDE_FROMTO_BODY - if defined the old (pre 3.1) mode of
  *   including the full from & to bodies will be used (instead of only the
  *   tags).
diff --git a/clist.h b/clist.h
index 6f42b4f..2f1f8b5 100644 (file)
--- a/clist.h
+++ b/clist.h
@@ -1,18 +1,16 @@
 /*
- * $Id$
- *
  * circular list maintenance macros
  *
  * Copyright (C) 2005 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
 
 /*!
  * \file
- * \brief SIP-router core :: circular list maintenance macros
+ * \brief Kamailio core :: circular list maintenance macros
  *
+ * \author andrei
  * \ingroup core
  * Module: \ref core
  */
 
-/* History:
- * --------
- *  2005-08-08  created by andrei
- */
 
 #ifndef _clist_h
 #define _clist_h
index 28d5c0b..158baa1 100644 (file)
@@ -1,16 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-
-/*! \brief compatibility defs for emergency roll-back if things do not work ;
+/*!
+ * \file
+ * \brief Kamailio core :: compatibility defs for emergency roll-back if things do not work 
+ *      
+ * \ingroup core 
+ * Module: \ref core                    
+ *  
  * if that happens:
  *     - a) define PRESERVE_ZT (affects most of parser)
  *     - b) define DONT_REMOVE_ZT (affects first line)
index 3a90297..b784249 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- * 
  * Copyright (C) 2007 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
@@ -18,8 +16,9 @@
 
 /*!
  * \file
- * \brief SIP-router core :: Compiler specific optimizations
+ * \brief Kamailio core :: Compiler specific optimizations
  * \see \ref CompilerOptions
+ * \auth Andrei
  *
  * \ingroup core
  * Module: \ref core
 \endverbatim
  */
 
-/* 
- * History:
- * --------
- *  2007-05-14  created by andrei
- */
-
 #ifndef __compiler_opt_h
 #define __compiler_opt_h
 
index 23880a0..a3f3e1e 100644 (file)
--- a/config.h
+++ b/config.h
@@ -1,16 +1,14 @@
 /*
- *  $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of SIP-router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * SIP-router is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * SIP-router is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * --------
- * 2003-04-05  DEFAULT_*_URL introduced (jiri)
- * 2003-07-04  fixed SRV lookup prefix for TLS/sips (andrei)
- * 2005-04-25  MAX_BRANCH_PARAM_LEN too small, fixed (andrei)
- *
  */
 
 /*!
  * \file
  * \brief SIP-router core :: Configuration options
+ * \author jiri, andrei
  *
  * These settings are settable by the user before compilation
  *
index afa4cf5..51d88ee 100644 (file)
@@ -1,16 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2005 iptelorg GmbH
  *
- * This file is part of SIP-router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * SIP-router is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * SIP-router is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -20,7 +18,7 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
 
-/** core rpcs.
+/** Kamailio Core :: core rpcs.
  * @file core_cmd.c
  * @ingroup core
  */
index 4e092d2..fd71ef3 100644 (file)
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2005 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -27,7 +20,7 @@
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Register RPC
  * \ingroup core
  * Module: \ref core
  */
index 4a65fd9..603f304 100644 (file)
  * they won't do anything).
  * @file
  * @ingroup core
+ * @author andrei
  */
  
-/*
- * History:
- * --------
- *  2010-02-01  initial version (andrei)
-*/
-
 #ifndef __core_stats_h
 #define __core_stats_h
 
index 3bfe542..06c0c6f 100644 (file)
  * @ingroup: core
  */
 
-/*
- * History:
- * --------
- *  2010-08-06  initial version (andrei)
- *  2010-08-24  counters can be used (inc,add) before prefork_init (andrei)
-*/
-
 #include "counters.h"
 #include "str_hash.h"
 #include "str.h"
index 9fd7c32..35a36cf 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2010 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
@@ -15,7 +13,8 @@
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/** counter/stats.
+/** Kamailio core :: counter/stats.
+ * @author andrei
  * @file counters.h
  * @ingroup:  core
  *
  *  4. get a counter value (the handle can be obtained like above)
  *    val = counter_get(h);
  */
-/*
- * History:
- * --------
- *  2010-08-06  initial version (andrei)
-*/
 
 #ifndef __counters_h
 #define __counters_h
diff --git a/crc.c b/crc.c
index 7d63cad..4628463 100644 (file)
--- a/crc.c
+++ b/crc.c
@@ -1,18 +1,16 @@
 /*
- * $Id$
- *
  *  Crc - 32 + 16 BIT ANSI X3.66 + CCITT CRC checksum files
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of SIP-router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * SIP-router is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * SIP-router is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -23,7 +21,7 @@
  */
 /*!
  * \file
- * \brief SIP-router core ::  Crc - 32 + 16 BIT ANSI X3.66 + CCITT CRC checksum files
+ * \brief Kamailio core ::  Crc - 32 + 16 BIT ANSI X3.66 + CCITT CRC checksum files
  * \ingroup core
  *
  * Module: \ref core
diff --git a/crc.h b/crc.h
index 1318e27..a52348f 100644 (file)
--- a/crc.h
+++ b/crc.h
@@ -1,4 +1,3 @@
-/* $Id$*/
 
 #ifndef _CRC_H_
 #define _CRC_H_
index ef8a46c..919ad44 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- * 
- * History:
- * --------
- *  2004-02-20  removed from ser main.c into its own file (andrei)
- *  2004-03-04  moved setuid/setgid in do_suid() (andrei)
- *  2004-03-25  added increase_open_fds & set_core_dump (andrei)
- *  2004-05-03  applied pgid patch from janakj
- *  2007-06-07  added mlock_pages (no swap) support (andrei)
-  *             added set_rt_prio() (andrei)
- */
+
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Daemon init
  * \ingroup core
  * Module: \ref core
  */
@@ -452,9 +440,11 @@ int do_suid()
        struct passwd *pw;
        
        if (gid){
-               if(setgid(gid)<0){
-                       LM_CRIT("cannot change gid to %d: %s\n", gid, strerror(errno));
-                       goto error;
+               if(gid!=getgid()) {
+                       if(setgid(gid)<0){
+                               LM_CRIT("cannot change gid to %d: %s\n", gid, strerror(errno));
+                               goto error;
+                       }
                }
        }
        
@@ -463,14 +453,16 @@ int do_suid()
                        LM_CRIT("user lookup failed: %s\n", strerror(errno));
                        goto error;
                }
-               if(initgroups(pw->pw_name, pw->pw_gid)<0){
-                       LM_CRIT("cannot set supplementary groups: %s\n", 
+               if(uid!=getuid()) {
+                       if(initgroups(pw->pw_name, pw->pw_gid)<0){
+                               LM_CRIT("cannot set supplementary groups: %s\n", 
                                                        strerror(errno));
-                       goto error;
-               }
-               if(setuid(uid)<0){
-                       LM_CRIT("cannot change uid to %d: %s\n", uid, strerror(errno));
-                       goto error;
+                               goto error;
+                       }
+                       if(setuid(uid)<0){
+                               LM_CRIT("cannot change uid to %d: %s\n", uid, strerror(errno));
+                               goto error;
+                       }
                }
        }
 
index efae0d9..148c96c 100644 (file)
@@ -1,5 +1,4 @@
 /*
- * $Id$
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
+/*!
+ * \file
+ * \brief SIP-router core :: Daemonize
+ * \author andrei
+ *      
+ * \ingroup core 
+ * Module: \ref core                    
+ *  
  * 
- * History:
- * --------
- *  2004-02-20  created by andrei
- *  2007-06-07  added mem_lock_pages() (andrei)
- *  2010-08-19  send status via pipe code derived from 9167c1 (ibc) (andrei)
  */
 
 #ifndef _daemonize_h
index 5faee6f..a47ae5a 100644 (file)
@@ -1,16 +1,14 @@
-/* $Id$
- *
- *
+/*
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of SIP-router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * SIP-router is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * SIP-router is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * --------
- *  2003-01-19  support for duplication lump lists added (jiri)
- *  2003-03-31  added subst lumps --they expand in ip addr, port a.s.o (andrei)
- *  2003-04-01  added conditional lump support functions (andrei)
- *  2003-10-20  anchor_lump & del_lump will automatically choose the lump list
- *              based on  msg->eoh comparisons (andrei)
- *  2003-10-28  added extra checks (paranoia) for {anchor,del}_lump (andrei)
- *  2005-03-24  the type of type attribute changed to enum _hdr_types_t (janakj)
  */
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Data lumps
  * \ingroup core
  * Module: \ref core
  */
index 9dcfd2d..4050332 100644 (file)
@@ -1,18 +1,16 @@
 /*
- * $Id$
- *
  * adding/removing headers or any other data chunk from a message
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
 
-/* History:
- * --------
- *  2003-01-29  s/int/enum ... more convenient for gdb (jiri)
- *  2003-03-31  added subst lumps -- they expand in ip addr, port a.s.o (andrei)
- *  2003-04-01  added opt (condition) lumps (andrei)
- *  2003-04-02  added more subst lumps: SUBST_{SND,RCV}_ALL  
- *              => ip:port;transport=proto (andrei)
- *  2005-03-22  the type of type attribute changed to enum _hdr_types_t (janakj)
- *
- */
-
 /*!
  * \file
  * \brief SIP-router core :: Data_lumps
+ * \author jiri, andrei, janakj
+ * adding/removing headers or any other data chunk from a message
  * \ingroup core
  * Module: \ref core
  */
index c5231e5..6ce77f8 100644 (file)
@@ -1,22 +1,14 @@
 /*
- * $Id$
- *
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * 2002-02-14 : created by bogdan
- * 2003-09-11 : lump_rpl type added - LUMP_RPL_BODY & LUMP_RPL_HDR (bogdan)
- * 2003-11-11 : build_lump_rpl merged into add_lump_rpl; types -> flags ;
- *              flags LUMP_RPL_NODUP and LUMP_RPL_NOFREE added (bogdan)
- * 2006-10-16   add_lump_rpl2 added: same as the old add_lump_rpl, but
- *               returns a lump_rpl**, making a specific lump removal much
- *               more easy (andrei)
  */
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Data lump handling
  * \ingroup core
  * Module: \ref core
  */
index 4db3211..b7cac0b 100644 (file)
@@ -1,17 +1,14 @@
 /*
- * $Id$
- *
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * 2002-02-14 : created by bogdan
- * 2003-09-11 : lump_rpl type added - LUMP_RPL_BODY & LUMP_RPL_HDR (bogdan)
- * 2003-11-11 : build_lump_rpl merged into add_lump_rpl; type removed;
- *              flags LUMP_RPL_BODY, LUMP_RPL_NODUP and LUMP_RPL_NOFREE
- *              added (bogdan)
- * 2006-10-16   add_lump_rpl2 added: same as the old add_lump_rpl, but
- *               returns a lump_rpl**, making a specific lump removal much
- *               more easy (andrei)
  */
 
 /*!
  * \file
  * \brief SIP-router core :: Data lumps
+ * \author bogdan, andrei
  * \ingroup core
  * Module: \ref core
  */
index 285c6ad..8dd56cd 100644 (file)
@@ -1,23 +1,16 @@
 /*
- * $Id$
- *
  * resolver related functions
  *
  * Copyright (C) 2006 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/* History:
- * --------
- *  2006-07-13  created by andrei
- *  2006-10-06  port fix (andrei)
- *  2007-06-14  dns iterate through A & AAAA records fix (andrei)
- *  2007-06-15  srv rr weight based load balancing support (andrei)
- *  2007-06-16  naptr support (andrei)
- *  2008-07-18  DNS watchdog support -- can be used to inform the core
- *              that the DNS servers are down (Miklos)
- *  2008-07-25  various rpc commands to manipulate the content
- *             of the cache (Miklos)
- *  2007-07-30  DNS cache measurements added (Gergo)
- *  2007-08-17  dns_cache_del_nonexp config option is introduced (Miklos)
- *  2008-02-04  DNS cache options are adapted for the configuration
- *             framework (Miklos)
- *  2008-02-11  dns_cache_init cfg parameter is introduced (Miklos)
- *  2008-10-17  fixed srv continue with 0 hostname (when falling back to
-                  aaaa) (andrei)
- *  2009-03-30  TXT record support, more rpcs (andrei)
- *  2009-03-30  EBL record support (andrei)
- *  2009-04-01  PTR record support (andrei)
- */
+
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: DNS cache handling
  * \ingroup core
  * Module: \ref core
  */
@@ -2808,7 +2780,11 @@ struct hostent* dns_naptr_sip_resolvehost(str* name, unsigned short* port,
        char origproto;
        str srv_name;
 
-       origproto=*proto;
+       if(proto) {
+               origproto=*proto;
+       } else {
+               origproto=PROTO_NONE;
+       }
        he=0;
        if (dns_hash==0){ /* not init => use normal, non-cached version */
                LM_WARN("called before dns cache initialization\n");
@@ -2848,7 +2824,7 @@ struct hostent* dns_naptr_sip_resolvehost(str* name, unsigned short* port,
                dns_hash_put(e);
        }
 naptr_not_found:
-       *proto = origproto;
+       if(proto) *proto = origproto;
        he = no_naptr_srv_sip_resolvehost(name,port,proto);
        /* fallback all the way down to A/AAAA */
        if (he==0) {
index b697b7c..5de8c88 100644 (file)
@@ -1,18 +1,16 @@
 /*
- * $Id$
- *
  * resolver/dns related functions, dns cache and failover
  *
  * Copyright (C) 2006 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
 
-/* History:
- * --------
- *  2006-07-13  created by andrei
- *  2007-06-16  naptr support (andrei)
- *  2007-07-30  DNS cache measurements added (Gergo)
- */
 
 /**
  * @file
  * @brief SIP-router core :: resolver/dns related functions, dns cache and failover
+ * @author andrei
  * @ingroup core
  * Module: @ref core
  */
index da2ce7b..7875457 100644 (file)
@@ -1,7 +1,5 @@
 
 /* 
- * $Id$
- * 
  * Copyright (C) 2013  mariuszbi@gmail.com
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- * DNS wrappers
+/*!
+ * \file 
+ * \brief Kamailio core :: DNS wrappers
+ * \author mariuszbi@gmail.com
+ * \ingroup core
+ * Module: \ref core
  */
-/*
- * History:
- * --------
- *  2013-03 initial version (marius)
-*/
 
 #include "dns_func.h"
 
index 623c3b8..2ed8022 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2013 mariuszbi@gmail.com
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- * DNS Wrapper functions 
+/*!
+ * \file
+ * \brief Kamailio core :: DNS wrapper functions
+ * \author mariuszbi@gmail.com
+ *      
+ * \ingroup core 
+ * Module: \ref core                    
+ *  
+ *
  */
-/*
- * History:
- * --------
- *  2013-03  initial version (marius)
-*/
 
 #ifndef DNS_FUNC_H
 #define DNS_FUNC_H
index d71c882..7833af1 100644 (file)
@@ -1,23 +1,16 @@
 /*
- * $Id$
- *
  * resolver related functions
  *
  * Copyright (C) 2006 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/* History:
- * --------
- *  2006-07-23  created by andrei
- */
 
 /**
  * @file
  * @brief SIP-router core :: resolver related functions
+ * @author andrei
  * @ingroup core
  * Module: @ref core
  */
@@ -42,7 +32,6 @@
 #define __dns_wrappers_h
 
 struct hostent* dns_resolvehost(char* name);
-struct hostent* dns_sip_resolvehost(str* name, unsigned short* port,
-                                                                               char* proto);
+struct hostent* dns_sip_resolvehost(str* name, unsigned short* port, char* proto);
 
 #endif
index 0c39088..6dbb8f9 100644 (file)
@@ -1,4 +1,4 @@
-docs = ser_rpc.xml
+docs = kamailio_rpc.xml
 docbook_dir = ../../docbook
 
 include $(docbook_dir)/Makefile
similarity index 94%
rename from doc/rpc/ser_rpc.txt
rename to doc/rpc/kamailio_rpc.txt
index 06b8044..a9b2aec 100644 (file)
@@ -1,4 +1,4 @@
-1. RPC Control Interface
+1. The Kamailio RPC Control Interface
      __________________________________________________________________
 
    1.1. Overview of Operation
@@ -31,8 +31,8 @@
    The RPC (Remote Procedure Call) interface is an interface for
    communicating with external applications. Using it an external
    application can call a function or procedure that will be executed
-   inside SIP Server (SER or Kamailio). Function parameters are supported
-   as well as returning multiple values as results.
+   inside Kamailio. Function parameters are supported as well as returning
+   multiple values as results.
 
    By itself RPC consists of two APIs, one for defining RPC functions in a
    transport independent way (called the rpc module api) and one for
@@ -65,9 +65,9 @@
 1.2. Module API
 
    Each module can export RPC functions just like it can export parameters
-   and functions to be called from the script. Whenever SIP server
-   receives an RPC request, it will search through the list of exported
-   RPC functions and the function with matching name will be executed. A
+   and functions to be called from the script. Whenever Kamailio receives
+   an RPC request, it will search through the list of exported RPC
+   functions and the function with matching name will be executed. A
    couple of essential RPC functions are also embedded into the SIP server
    core.
 
    describes functions of the API that can be used to build the result
    value that will be sent in the reply to the caller.
 
-   The whole RPC API is described in header file sip_router/rpc.h. This
-   file defines the set of functions that must be implemented by RPC
-   transport modules, as described in Section 1.4, "Implementing New
-   Transports", prototypes of RPC functions and structures used for the
-   communication between RPC transport modules and ordinary modules
-   exporting RPC functions.
+   The whole RPC API is described in header file kamailio/rpc.h. This file
+   defines the set of functions that must be implemented by RPC transport
+   modules, as described in Section 1.4, "Implementing New Transports",
+   prototypes of RPC functions and structures used for the communication
+   between RPC transport modules and ordinary modules exporting RPC
+   functions.
 
 1.2.1. RPC Functions
 
@@ -117,7 +117,7 @@ typedef void (*rpc_function_t)(rpc_t* rpc, void* ctx);
    function with "_doc" suffix.
 
    Each module containing RPC functions has to export all the RPC
-   functions to SIP server core in order to make them visible to the RPC
+   functions to the Kamailio core in order to make them visible to the RPC
    transport modules. The export process involves a rpc_export_t structure
    (either by itself or in an array):
 typedef struct rpc_export {
@@ -131,7 +131,7 @@ ription */
    The flags attribute of the rpc_export structure is reserved for future
    use and is currently unused.
 
-   There are several ways of exporting the RPC functions to the SIP server
+   There are several ways of exporting the RPC functions to the Kamailio
    core:
      * register a null terminated array of rpc_export_t structures using
        the rpc_register_array() function (defined in rpc_lookup.h), from
@@ -159,9 +159,9 @@ rpc_export_t ul_rpc[] = {
      * register RPCs one by one using the rpc_register_function() (defined
        in rpc_lookup.h), from the module init function.
      * register a null terminated array of rpc_export_t structures using
-       the SIP server module interface SER_MOD_INTERFACE (specific for SER
-       flavour). For this purpose, the module_exports structure of SIP
-       server module API contains a new attribute called rpc_methods:
+       the Kamailio module interface SER_MOD_INTERFACE For this purpose,
+       the module_exports structure of the Kamailio module API contains a
+       new attribute called rpc_methods:
 struct module_exports {
     char* name;                 /* null terminated module name */
     cmd_export_t* cmds;         /* null terminated array of the exported command
@@ -198,19 +198,19 @@ struct module_exports exports = {
 
 Note
        This mode works only with modules using the SER flavour module
-       interface. It does not work for kamailio modules and it will
+       interface. It does not work for Kamailio modules and it will
        probably not work for future sip-router modules. It is safer and
        recommended to use instead the rpc_register_array() function.
 
    By convention the name of every exported function consists of two parts
-   delimited by a dot. The first part is the name of the module or SIP
-   server subsystem this function belongs to. The second part is the name
-   of the function.
+   delimited by a dot. The first part is the name of the module or
+   Kamailio subsystem this function belongs to. The second part is the
+   name of the function.
 
 1.2.2. Data Types
 
-   The RPC API defines several basic and 1 compound data type that can be
-   used in communication with the caller of RPC functions. The RPC API
+   The RPC API defines several basic and one compound data type that can
+   be used in communication with the caller of RPC functions. The RPC API
    uses formating strings to describe data types. Each data type is
    described by exactly one character in the formating string. For
    example, if an RPC function calls function add of the RPC API and it
@@ -263,7 +263,7 @@ add("sd", string_param, int_param);
    Integer d int
    Float f double
    String s char*
-   String S str
+   String S str*
    Optional modifier * marks all further parameters as optional
    Autoconvert modifier . requires auto-conversion for the next parameter
 
similarity index 96%
rename from doc/rpc/ser_rpc.xml
rename to doc/rpc/kamailio_rpc.xml
index 73b9f08..72ddaf1 100644 (file)
@@ -2,8 +2,12 @@
 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
        [ <!ENTITY % local.common.attrib
-        "xmlns:xi CDATA #FIXED 'http://www.w3.org/2001/XInclude'">]
->
+        "xmlns:xi CDATA #FIXED 'http://www.w3.org/2001/XInclude'">
+       <!ENTITY % docentities SYSTEM "../../docbook/entities.xml">
+       %docentities;
+
+]>
+<!-- Include general documentation entities -->
 
 <section id="rpc.main" xmlns:xi="http://www.w3.org/2001/XInclude">
     <!--
@@ -14,7 +18,7 @@
     -->
  
     <title>
-       RPC Control Interface
+       The Kamailio RPC Control Interface
     </title>
 
        <section id="rpc.overview">
@@ -23,8 +27,8 @@
                The RPC (Remote Procedure Call) interface is an interface for
                communicating with external applications. Using it an external
                application can call a function or procedure that will be executed
-               inside SIP Server (SER or Kamailio). Function parameters are
-               supported as well as returning multiple values as results.
+               inside Kamailio. Function parameters are supported as well as returning
+               multiple values as results.
        </para>
        <para>
                By itself RPC consists of two APIs, one for defining RPC functions
@@ -78,7 +82,7 @@
        <title>Module API</title>
        <para>
            Each module can export RPC functions just like it can export
-           parameters and functions to be called from the script. Whenever SIP server
+           parameters and functions to be called from the script. Whenever &kamailio;
            receives an RPC request, it will search through the list of
            exported RPC functions and the function with matching name will be
            executed. A couple of essential RPC functions are also embedded into
        </para>
        <para>
            The whole RPC API is described in header file
-           <filename>sip_router/rpc.h</filename>.  This file defines the set
+           <filename>kamailio/rpc.h</filename>.  This file defines the set
            of functions that must be implemented by RPC transport modules, as
            described in <xref linkend="rpc.new_transport"/>, prototypes of RPC
            functions and structures used for the communication between RPC
@@ -142,7 +146,7 @@ typedef void (*rpc_function_t)(rpc_t* rpc, void* ctx);
            </para>
            <para>
                Each module containing RPC functions has to export all the
-               RPC functions to SIP server core in order to make them visible to the RPC
+               RPC functions to the &kamailio; core in order to make them visible to the RPC
                transport modules.
                The export process involves a <emphasis>rpc_export_t</emphasis> 
                structure (either by itself or in an array):
@@ -163,7 +167,7 @@ typedef struct rpc_export {
                use and is currently unused.
            </para>
                <para>
-               There are several ways of exporting the RPC functions to the SIP server core:
+               There are several ways of exporting the RPC functions to the &kamailio; core:
                <itemizedlist>
                        <listitem><para>
                                register a null terminated array of rpc_export_t structures
@@ -209,10 +213,9 @@ rpc_export_t ul_rpc[] = {
                        </para></listitem>
                        <listitem><para>
                                register a null terminated array of rpc_export_t structures
-                               using the SIP server module interface SER_MOD_INTERFACE (specific
-                               for SER flavour).
+                               using the &kamailio;  module interface SER_MOD_INTERFACE
                                For this purpose, the
-                               <varname>module_exports</varname> structure of SIP server module API
+                               <varname>module_exports</varname> structure of the &kamailio; module API
                                contains a new attribute called <varname>rpc_methods</varname>:
                                <programlisting>
 struct module_exports {
@@ -252,7 +255,7 @@ struct module_exports exports = {
                                </example>
                                <note><para>
                                        This mode works only with modules using the SER flavour module
-                                       interface. It does not work for kamailio modules and it
+                                       interface. It does not work for &kamailio; modules and it
                                        will probably not work for future sip-router modules. It is
                                        safer and recommended to use instead the
                                        <function>rpc_register_array()</function> function.
@@ -263,7 +266,7 @@ struct module_exports exports = {
                <para>
                        By convention the name of every exported function consists of
                        two parts delimited by a dot. The first part is the name of the
-                       module or SIP server subsystem this function belongs to. The second
+                       module or &kamailio; subsystem this function belongs to. The second
                        part is the name of the function.
                </para>
        </section>
@@ -271,7 +274,7 @@ struct module_exports exports = {
        <section id="rpc.data_types">
            <title>Data Types</title>
            <para>
-               The RPC API defines several basic and 1 compound data type
+               The RPC API defines several basic and one compound data type
                that can be used in communication with the caller of RPC
                functions. The RPC API uses formating strings to describe data
                types. Each data type is described by exactly one character in
@@ -908,7 +911,7 @@ static void rpc_register(rpc_t* rpc, void *ctx)
 <section id="rpc.xmlrpc_examples">
        <title>Examples using xmlrpc</title>
        <para>See the <varname>xmlrpc</varname> module documentation:
-       <ulink url='http://sip-router.org/docbook/sip-router/branch/master/modules/xmlrpc/xmlrpc.html'>modules/xmlrpc/README</ulink>.
+       <ulink url='http://www.kamailio.org/docs/modules/devel/modules/xmlrpc.html'>modules/xmlrpc/README</ulink>.
        </para>
 </section>
 
index caf39c3..1767226 100644 (file)
--- a/dprint.c
+++ b/dprint.c
@@ -1,24 +1,16 @@
 /*
- * $Id$
- *
  * debug print 
  *
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -29,7 +21,7 @@
  */
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Debug print
  * \ingroup core
  * Module: \ref core
  */
@@ -396,7 +388,7 @@ void log_prefix_set(sip_msg_t *msg)
 {
        if(log_prefix_pvs == NULL)
                return;
-       if(msg==NULL) {
+       if(msg==NULL || !IS_SIP(msg)) {
                log_prefix_val = NULL;
                return;
        }
index 3c57d9c..f8ac697 100644 (file)
--- a/dprint.h
+++ b/dprint.h
@@ -1,14 +1,14 @@
 /*
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
diff --git a/dset.c b/dset.c
index 43e28db..7ccdf53 100644 (file)
--- a/dset.c
+++ b/dset.c
@@ -1,23 +1,16 @@
 /*
- * $Id$
- *
  * destination set
  *
  * Copyright (C) 2001-2004 FhG FOKUS
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -27,7 +20,7 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
 
-/** destination set / branches support.
+/** Kamailio core :: destination set / branches support.
  * @file dset.c
  * @ingroup core
  * Module: @ref core
diff --git a/dset.h b/dset.h
index d90ce61..1f02e35 100644 (file)
--- a/dset.h
+++ b/dset.h
@@ -1,16 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2004 FhG FOKUS
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
index a69d215..823aa0a 100644 (file)
@@ -1,23 +1,16 @@
 /*
- * $Id$
- *
  * resolver related functions
  *
  * Copyright (C) 2006 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/* History:
- * --------
- *  2006-07-29  created by andrei
- *  2007-05-39  added hooks for add; more locks to reduce contention (andrei)
- *  2007-06-26  added hooks for search (andrei)
- *  2007-07-30  added dst_blacklist_del() and dst_blacklist_add_to()  (andrei)
- *  2007-07-30  dst blacklist measurements added (Gergo)
- *  2008-02-11  dns_blacklist_init cfg parameter is introduced (Miklos)
- *  2009-02-26  added dst_blacklist_su* variant (andrei)
- */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: resolver related functions
  * \ingroup core
  * Module: \ref core
  */
index 491d56e..d40b8b9 100644 (file)
@@ -1,14 +1,14 @@
 /*
  * Copyright (C) 2006 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
 
 /** SIP-router core :: Destination blacklists.
  * @file
+ * @author andrei, Gergo
  * @ingroup core
  * Module: @ref core
  */
 
-/* History:
- * --------
- *  2006-07-29  created by andrei
- *  2007-07-30  dst blacklist measurements added (Gergo)
- *  2009-12-22  blacklist ignore mask support and dst_blacklist_{add,su}
- *               switched to macros (andrei)
- */
-
 #ifndef dst_black_list_h
 #define dst_black_list_h
 
index 8f621e8..1151739 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2008 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- *  endianness compile and runtime  tests
- * 
- * History:
- * --------
- *  2008-06-13  created by andrei
- */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: endianness compile and runtime  tests
  * \ingroup core
  * Module: \ref core
  */
index e69518c..53f0fba 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2008 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  */
 
 /** @file
- *  endianness compile and runtime  tests
+ *  Kamailio core :: endianness compile and runtime  tests
+ *  @author andrei
+ *  @ingroup core
  * 
- * History:
- * --------
- *  2008-06-13  created by andrei
  *
  * Defines:
  *  -  __IS_LITTLE_ENDIAN if the system is little endian and
diff --git a/error.c b/error.c
index e54c3d1..51146b1 100644 (file)
--- a/error.c
+++ b/error.c
@@ -1,22 +1,14 @@
 /*
- * $Id$
- *
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * --------
- * 2003-04-04 phrase length corrected not to include trailer 0 (jiri)
  */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Error handling
  * \ingroup core
  * Module: \ref core
  */
diff --git a/error.h b/error.h
index ebafc1b..829073e 100644 (file)
--- a/error.h
+++ b/error.h
@@ -1,16 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
index 0e1d85d..5312e7a 100644 (file)
--- a/events.c
+++ b/events.c
@@ -1,9 +1,7 @@
 /**
- * $Id$
- *
  * Copyright (C) 2009 SIP-Router.org
  *
- * This file is part of Extensible SIP Router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
@@ -20,7 +18,7 @@
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: event handling
  * \ingroup core
  * Module: \ref core
  */
index 32540a0..8218453 100644 (file)
--- a/events.h
+++ b/events.h
@@ -1,9 +1,8 @@
 /**
- * $Id$
  *
  * Copyright (C) 2009 SIP-Router.org
  *
- * This file is part of Extensible SIP Router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
index 21a0146..c2d5f55 100644 (file)
@@ -795,8 +795,25 @@ route[REGISTER] {
 
 #!ifdef WITH_RX        
        xlog("L_DBG","Subscribing to signalling bearer status\n");
-       if (Rx_AAR_Register("REG_AAR_REPLY", "location") == 0)
-               exit;
+
+       Rx_AAR_Register("REG_AAR_REPLY", "location");
+       switch ($retcode) {
+               case -1:
+                       # There was an error sending the AAR-Request:
+                       xlog("L_ERR", "Diameter: AAR failed on subscription to signalling\n");
+                       send_reply("403", "Can't register to QoS for signalling");
+                       exit;
+                       break;
+               case 0:
+                       # We are waiting for an async reply, just exit here.
+                       exit;
+                       break;
+               case 1:
+                       # We did not need to send AAR, so just continue as normal
+                       route(REGISTER_CONTINUE);
+                       break;
+       }
+       exit;
 }
 
 route[REG_AAR_REPLY] {
@@ -809,8 +826,12 @@ route[REG_AAR_REPLY] {
                        send_reply("403", "Can't register to QoS for signalling");
                        exit;
        }
-#!endif
+       # Proceed with Registering:
+       route(REGISTER_CONTINUE);
+}
 
+route[REGISTER_CONTINUE] {
+#!endif
 #!ifndef WITH_SBC
 #!ifdef WITH_WEBSOCKET
        if (($Rp == MY_WS_PORT || $Rp == MY_WSS_PORT) && (proto == WS || proto == WSS)) {
@@ -962,7 +983,7 @@ route[Orig_Initial]
 
 #!ifdef WITH_RX
        xlog("L_DBG","Diameter: Orig authorizing media via Rx\n");      
-       if(Rx_AAR("ORIG_SESSION_AAR","orig")==0){
+       if(Rx_AAR("ORIG_SESSION_AAR","orig","",-1)==0){
                exit;
        }
 }
@@ -1014,7 +1035,7 @@ onreply_route[Orig_Initial_reply]
 #!ifdef WITH_RX
        if (t_check_status("180|183|200")){
                xlog("L_DBG","Diameter: Orig authorizing media via Rx\n");      
-               if(Rx_AAR("ORIG_SESSION_AAR_REPLY","orig")==0){
+               if(Rx_AAR("ORIG_SESSION_AAR_REPLY","orig","",-1)==0){
                        exit;
                }
        }
@@ -1068,7 +1089,7 @@ route[Term_Initial]
 
 #!ifdef WITH_RX
        xlog("L_DBG","Diameter: Term authorizing media via Rx\n");      
-       if(Rx_AAR("TERM_SESSION_AAR","term")==0){
+       if(Rx_AAR("TERM_SESSION_AAR","term","",-1)==0){
                exit;
        }
 }
@@ -1117,7 +1138,7 @@ onreply_route[Term_Initial_reply]
 #!ifdef WITH_RX
        if (t_check_status("180|183|200")){
                xlog("L_DBG","Diameter: Orig authorizing media via Rx\n");      
-               if(Rx_AAR("TERM_SESSION_AAR_REPLY","term")==0){
+               if(Rx_AAR("TERM_SESSION_AAR_REPLY","term","",-1)==0){
                        exit;
                }
        }
index a09f0e9..f2e9ced 100644 (file)
@@ -1,10 +1,6 @@
 /*
  * fast architecture specific locking
  *
- * $Id$
- *
- * 
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- *
- *History:
- *--------
- *  2002-02-05  created by andrei
- *  2003-01-16  added PPC locking code contributed by Dinos Dorkofikis
- *               <kdor@intranet.gr>
- *  2004-09-12  added MIPS locking for ISA>=2 (>r3000)  (andrei)
- *  2004-12-16  for now use the same locking code for sparc32 as for sparc64
- *               (it will work only if NOSMP is defined) (andrei)
- *  2005-04-27  added alpha locking code (andrei)
- *  2005-05-25  PPC locking code enabled for PPC64; added a lwsync to
- *               the tsl part and replaced the sync with a lwsync for the
- *               unlock part (andrei)
- *  2006-03-08  mips2 NOSMP (skip sync), optimized x86 & mips clobbers and
- *               input/output constraints (andrei)
- *  2006-04-03  optimization: call lock_get memory barrier outside tsl,in the 
- *               calling function, only if the lock operation succeeded
- *               (membar_getlock()) (andrei)
- *              added try_lock(); more x86 optimizations, x86  release_lock
- *               fix (andrei)
- * 2006-04-04  sparc* optimizations, sparc32 smp support, armv6 no smp support,
- *              ppc, mips*, alpha optimizations (andrei)
- * 2006-04-05  ppc fixes (s/stw/stwx/, s/lwz/lwzx), early clobber added
- *             where needed (andrei)
- * 2006-11-22  arm early clobber added: according to the swp instruction 
- *              specification the address register must be != from the other 2
- *              (Julien Blache <jblache@debian.org>)
- *
- */
-
-/*
+/*!
+* \file
+* \brief Kamailio core :: fast architecture specific locking
+* \author andrei
+* \ingroup core
+* Module: \ref core
  * WARNING: the code was not tested on the following architectures:
  *           - arm6  (cross-compiles ok, no test)
  *           - alpha (cross-compiles ok, no test)
index b21cf46..0bd0ab2 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * here, we delete message lumps which are generated in
  * core functions using pkg_malloc and applied to shmem
  * requests; not doing so would result ugly memory problems
@@ -9,14 +7,14 @@
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/*
- * History:
- * -------
- *  2003-11-24  changed free_via_lump to free_via_clen_lump and make it
- *              handle CONTENTLENGTH lumps also (andrei)
- *  2005-07-04  lumps in SHM or dup'ed lumps are not freed and an warning
- *               message is logged (temporary fix) (andrei)
- */
+/*!
+* \file
+* \brief Kamailio core :: Lump handling
+* \ingroup core
+* Module: \ref core
+ * here, we delete message lumps which are generated in
+ * core functions using pkg_malloc and applied to shmem
+ * requests; not doing so would result ugly memory problems
+ *
+ * I admit it is not a nice hack; -jiri 
+*/
 
 
 
diff --git a/flags.c b/flags.c
index 883e312..2bfef5a 100644 (file)
--- a/flags.c
+++ b/flags.c
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/*
- * History:
- * --------
- *  2003-03-19  replaced all mallocs/frees w/ pkg_malloc/pkg_free (andrei)
- *  2006-02-02  named flags support (andrei)
- */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Flags
  * \ingroup core
  * Module: \ref core
  */
diff --git a/flags.h b/flags.h
index 5050d8d..3876082 100644 (file)
--- a/flags.h
+++ b/flags.h
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
+/*!
+* \file
+* \brief Kamailio core :: Flag handling
+* \ingroup core
+* Module: \ref core
+*/
 
 
 
index 81e39fe..c6dbdea 100644 (file)
--- a/forward.c
+++ b/forward.c
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * -------
- *  2001-??-??  created by andrei
- *  ????-??-??  lots of changes by a lot of people
- *  2003-01-23  support for determination of outbound interface added :
- *               get_out_socket (jiri)
- *  2003-01-24  reply to rport support added, contributed by
- *               Maxim Sobolev <sobomax@FreeBSD.org> and modified by andrei
- *  2003-02-11  removed calls to upd_send & tcp_send & replaced them with
- *               calls to msg_send (andrei)
- *  2003-03-19  replaced all mallocs/frees w/ pkg_malloc/pkg_free (andrei)
- *  2003-04-02  fixed get_send_socket for tcp fwd to udp (andrei)
- *  2003-04-03  added su_setport (andrei)
- *  2003-04-04  update_sock_struct_from_via now differentiates between
- *               local replies  & "normal" replies (andrei)
- *  2003-04-12  update_sock_struct_from via uses also FL_FORCE_RPORT for
- *               local replies (andrei)
- *  2003-08-21  check_self properly handles ipv6 addresses & refs   (andrei)
- *  2003-10-21  check_self updated to handle proto (andrei)
- *  2003-10-24  converted to the new socket_info lists (andrei)
- *  2004-10-10  modified check_self to use grep_sock_info (andrei)
- *  2004-11-08  added force_send_socket support in get_send_socket (andrei)
- *  2005-12-11  onsend_router support; forward_request to no longer
- *              pkg_malloc'ed (andrei)
- *  2006-04-12  forward_{request,reply} use now struct dest_info (andrei)
- *  2006-04-21  basic comp via param support (andrei)
- *  2006-07-31  forward_request can resolve destination on its own, uses the 
- *              dns cache and falls back on send error to other ips (andrei)
- *  2007-10-08  get_send_socket() will ignore force_send_socket if the forced
- *               socket is multicast (andrei)
  */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Message forwarding
  * \ingroup core
  * Module: \ref core
  */
@@ -391,7 +354,7 @@ static struct _check_self_func {
        struct _check_self_func *next;
 } *_check_self_func_list = NULL;
 
-/* check if _check_self_func_list is set
+/** check if _check_self_func_list is set
  * - return 1 if yes, 0 if no
  */
 int is_check_self_func_list_set(void)
@@ -399,7 +362,7 @@ int is_check_self_func_list_set(void)
        return (_check_self_func_list)?1:0;
 }
 
-/* register a function to be called when matching for myself
+/** register a function to be called when matching for myself
  * - return 0 on success, -1 on error
  * - f must have same prototype as check_self() and return same kind of values
  */
@@ -418,7 +381,7 @@ int register_check_self_func(check_self_f f)
        return 0;
 }
 
-/* run registered check self functions
+/** run registered check self functions
  * returns 1 if true, 0 if false
  */
 int run_check_self_func(str* host, unsigned short port, unsigned short proto)
@@ -433,7 +396,8 @@ int run_check_self_func(str* host, unsigned short port, unsigned short proto)
        return 0;
 }
 
-/* checks if the proto: host:port is one of the address we listen on;
+/** checks if the proto: host:port is one of the address we listen on;
+ *
  * if port==0, the  port number is ignored
  * if proto==0 (PROTO_NONE) the protocol is ignored
  * returns 1 if true, 0 if false, -1 on error
@@ -453,7 +417,7 @@ found:
        return 1;
 }
 
-/* checks if the proto:port is one of the ports we listen on;
+/** checks if the proto:port is one of the ports we listen on;
  * if proto==0 (PROTO_NONE) the protocol is ignored
  * returns 1 if true, 0 if false, -1 on error
  */
@@ -468,7 +432,7 @@ int check_self_port(unsigned short port, unsigned short proto)
 
 
 
-/* forwards a request to dst
+/** forwards a request to dst
  * parameters:
  *   msg       - sip msg
  *   dst       - destination name, if non-null it will be resolved and
@@ -750,7 +714,7 @@ int update_sock_struct_from_via( union sockaddr_union* to,
 
 
 
-/* removes first via & sends msg to the second
+/** removes first via & sends msg to the second
  * - mode param controls if modules sip response callbacks are executed */
 static int do_forward_reply(struct sip_msg* msg, int mode)
 {
@@ -879,13 +843,13 @@ error:
        return -1;
 }
 
-/* removes first via & sends msg to the second */
+/** removes first via & sends msg to the second */
 int forward_reply(struct sip_msg* msg)
 {
        return do_forward_reply(msg, 0);
 }
 
-/* removes first via & sends msg to the second - no module callbacks */
+/** removes first via & sends msg to the second - no module callbacks */
 int forward_reply_nocb(struct sip_msg* msg)
 {
        return do_forward_reply(msg, 1);
index 2babd74..f1418d0 100644 (file)
--- a/forward.h
+++ b/forward.h
@@ -1,21 +1,14 @@
 /*
- *  $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/*
- * History:
- * -------
- *  2001-??-?? created by andrei
- *  ????-??-?? lots of changes by a lot of people
- *  2003-02-11 added inline msg_send (andrei)
- *  2003-04-07 changed all ports to host byte order (andrei)
- *  2003-04-12  FORCE_RPORT_T added (andrei)
- *  2003-04-15  added tcp_disable support (andrei)
- *  2006-04-12  reduced msg_send() parameter list: it uses now a struct 
- *               dest_info param. (andrei)
- *  2007-10-08  msg_send() will ignore a mcast send_sock and choose another
- *               one by itself (andrei)
- */
-
-
+/*!
+* \file
+* \brief Kamailio core :: Message forwarding
+* \author andrei
+* \ingroup core
+* Module: \ref core
+*/
 
 #ifndef forward_h
 #define forward_h
@@ -205,7 +189,7 @@ static inline int msg_send(struct dest_info* dst, char* buf, int len)
                }
                if (unlikely(udp_send(dst, outb.s, outb.len)==-1)){
                        STATS_TX_DROPS;
-                       LM_ERR("udp_send failed\n");
+                       LOG(cfg_get(core, core_cfg, corelog), "udp_send failed\n");
                        goto error;
                }
        }
@@ -224,7 +208,7 @@ static inline int msg_send(struct dest_info* dst, char* buf, int len)
                        }
                        if (unlikely(tcp_send(dst, from, outb.s, outb.len)<0)){
                                STATS_TX_DROPS;
-                               LM_ERR("tcp_send failed\n");
+                               LOG(cfg_get(core, core_cfg, corelog), "tcp_send failed\n");
                                goto error;
                        }
                }
@@ -244,7 +228,7 @@ static inline int msg_send(struct dest_info* dst, char* buf, int len)
                        }
                        if (unlikely(tcp_send(dst, from, outb.s, outb.len)<0)){
                                STATS_TX_DROPS;
-                               LM_ERR("tcp_send failed\n");
+                               LOG(cfg_get(core, core_cfg, corelog), "tcp_send failed\n");
                                goto error;
                        }
                }
@@ -269,7 +253,7 @@ static inline int msg_send(struct dest_info* dst, char* buf, int len)
                        }
                        if (unlikely(sctp_core_msg_send(dst, outb.s, outb.len)<0)){
                                STATS_TX_DROPS;
-                               LM_ERR("sctp_msg_send failed\n");
+                               LOG(cfg_get(core, core_cfg, corelog), "sctp_msg_send failed\n");
                                goto error;
                        }
                }
index 0f39d83..7aa7c73 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2007 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
+/*!
+* \file
+* \brief Kamailio core :: locks
+* \author andrei
+* \ingroup core
+* Module: \ref core
+ *
  * futex based lock (mutex) implementation  (linux 2.6+ only)
  * based on Ulrich Drepper implementation in "Futexes Are Tricky"
  * (http://people.redhat.com/drepper/futex.pdf)
  *
  *  Config defines:
  */
-/* 
- * History:
- * --------
- *  2007-05-13  created by andrei
- *  2007-06-12  added ADAPTIVE_WAIT busy waiting (andrei)
- */
 
 #ifndef _futexlock_h
 #define _futexlock_h
index 1dc4194..03937a2 100644 (file)
--- a/globals.h
+++ b/globals.h
@@ -1,24 +1,17 @@
 /*
- * $Id$
- *
  * global variables
  *
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
+/*!
+* \file
+* \brief Kamailio core :: Global variables
+* \ingroup core
+* Module: \ref core
+*/
 
 
 
index 88957bc..939361a 100644 (file)
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -27,7 +20,7 @@
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: Hash functions
  * \ingroup core
  * Module: \ref core
  */
index 2d79afd..203e10b 100644 (file)
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
+/*!
+* \file
+* \brief Kamailio core :: Hash support
+* \ingroup core
+* Module: \ref core
+*/
 
 
 
index 9932905..5b8e2f2 100644 (file)
--- a/hashes.h
+++ b/hashes.h
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2006 iptelorg GmbH 
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- * History:
- * --------
- *  2006-02-02  created by andrei
- *  2006-11-24  added numeric string optimized hash function (andrei)
- *  2006-12-13  split into hashes.h (more generic) and str_hash.h (andrei)
- *  2007-02-22  added case insensitive versions (andrei)
- */
+/*!
+* \file
+* \brief Kamailio core :: hash support
+* \author Andrei
+* \ingroup core
+* Module: \ref core
+*/
 
 
 #ifndef _hashes_h
@@ -32,7 +29,7 @@
 
 
 
-/* internal use: hash update
+/** internal use: hash update
  * params: char* s   - string start,
  *         char* end - end
  *         char* p,  and unsigned v temporary vars (used)
@@ -57,7 +54,7 @@
                (h)+=(v)^((v)>>3); \
        }while(0)
 
-/* like hash_update_str, but case insensitive 
+/** like hash_update_str, but case insensitive 
  * params: char* s   - string start,
  *         char* end - end
  *         char* p,  and unsigned v temporary vars (used)
        }while(0)
 
 
-/* internal use: call it to adjust the h from hash_update_str */
+/** internal use: call it to adjust the h from hash_update_str */
 #define hash_finish(h) (((h)+((h)>>11))+(((h)>>13)+((h)>>23)))
 
 
 
-/* "raw" 2 strings hash
+/** "raw" 2 strings hash
  * returns an unsigned int (which you can use modulo table_size as hash value)
  */
 inline static unsigned int get_hash2_raw(const str* key1, const str* key2)
@@ -98,7 +95,7 @@ inline static unsigned int get_hash2_raw(const str* key1, const str* key2)
 
 
 
-/* "raw" 1 string hash
+/** "raw" 1 string hash
  * returns an unsigned int (which you can use modulo table_size as hash value)
  */
 inline static unsigned int get_hash1_raw(const char* s, int len)
@@ -115,7 +112,7 @@ inline static unsigned int get_hash1_raw(const char* s, int len)
 
 
 
-/* a little slower than hash_* , but better distribution for 
+/** a little slower than hash_* , but better distribution for 
  * numbers and about the same for strings */
 #define hash_update_str2(s, end, p, v, h) \
        do{ \
@@ -128,7 +125,7 @@ inline static unsigned int get_hash1_raw(const char* s, int len)
                (h)=16777259*(h)+((v)^((v)<<17)); \
        }while(0)
 
-/*  like hash_update_str2 but case insensitive */
+/**  like hash_update_str2 but case insensitive */
 #define hash_update_case_str2(s, end, p, v, h) \
        do{ \
                for ((p)=(s); (p)<=((end)-4); (p)+=4){ \
@@ -141,12 +138,12 @@ inline static unsigned int get_hash1_raw(const char* s, int len)
                (h)=16777259*(h)+((v)^((v)<<17)); \
        }while(0)
 
-/* internal use: call it to adjust the h from hash_update_str */
+/** internal use: call it to adjust the h from hash_update_str */
 #define hash_finish2(h) (((h)+((h)>>7))+(((h)>>13)+((h)>>23)))
 
 
 
-/* a little slower than get_hash1_raw() , but better distribution for 
+/** a little slower than get_hash1_raw() , but better distribution for 
  * numbers and about the same for strings */
 inline static unsigned int get_hash1_raw2(const char* s, int len)
 {
diff --git a/id.c b/id.c
index 7b9dbbb..1545b41 100644 (file)
--- a/id.c
+++ b/id.c
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2005 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -27,7 +20,7 @@
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: UID handling
  * \ingroup core
  * Module: \ref core
  */
@@ -42,7 +35,7 @@ static str uid_name = STR_STATIC_INIT(AVP_UID);
 static str did_name = STR_STATIC_INIT(AVP_DID);
 
 
-/*
+/**
  * Set From UID
  */
 int set_from_uid(str* uid)
@@ -63,7 +56,7 @@ int set_from_uid(str* uid)
 }
 
 
-/* Extract username attribute from authorized credentials */
+/** Extract username attribute from authorized credentials */
 static inline str* cred_user(struct sip_msg* msg)
 {
        struct hdr_field* h;
@@ -77,7 +70,7 @@ static inline str* cred_user(struct sip_msg* msg)
        return &cred->digest.username.user;
 }
 
-/*
+/**
  * Set From UID
  */
 int get_from_uid(str* uid, struct sip_msg* msg)
@@ -125,7 +118,8 @@ int get_from_uid(str* uid, struct sip_msg* msg)
        }
 }
 
-
+/** Get to UID
+ */
 int get_to_uid(str* uid, struct sip_msg* msg)
 {
        static char buf[MAX_URI_SIZE];
@@ -181,7 +175,7 @@ int get_to_uid(str* uid, struct sip_msg* msg)
 }
 
 
-/*
+/**
  * Set To UID
  */
 int set_to_uid(str* uid)
@@ -202,7 +196,7 @@ int set_to_uid(str* uid)
 }
 
 
-/*
+/**
  * Return current To domain id
  */
 int get_to_did(str* did, struct sip_msg* msg)
@@ -218,7 +212,7 @@ int get_to_did(str* did, struct sip_msg* msg)
 }
 
 
-/*
+/**
  * Return current To domain id
  */
 int get_from_did(str* did, struct sip_msg* msg)
diff --git a/id.h b/id.h
index 68e2132..42cf2aa 100644 (file)
--- a/id.h
+++ b/id.h
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2005 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
index 9a80700..b4f262c 100644 (file)
--- a/io_wait.c
+++ b/io_wait.c
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2005 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/* 
- * tcp io wait common stuff used by tcp_main.c & tcp_read.c
- * (see io_wait.h)
- */
-/* 
- * History:
- * --------
- *  2005-06-15  created by andrei
- *  2005-06-26  added kqueue (andrei)
- *  2005-07-04  added /dev/poll (andrei)
- */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: tcp io wait common stuff used by tcp_main.c & tcp_read.c
+ * (see io_wait.h)
  * \ingroup core
  * Module: \ref core
  */
index 28681e0..0485e39 100644 (file)
--- a/io_wait.h
+++ b/io_wait.h
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2005 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- * tcp io wait common stuff used by tcp_main.c & tcp_read.c
+/*!
+* \file
+* \brief Kamailio core :: tcp io wait common stuff used by tcp_main.c & tcp_read.c
+* \ingroup core
+* Module: \ref core
+* \author andrei
+*
  * All the functions are inline because of speed reasons and because they are
  * used only from 2 places.
+ *
  * You also have to define:
  *     int handle_io(struct fd_map* fm, short events, int idx) (see below)
  *     (this could be trivially replaced by a callback pointer entry attached
  *     local_free   (defaults to pkg_free)
  *
  */
-/*
- * History:
- * --------
- *  2005-06-13  created by andrei
- *  2005-06-26  added kqueue (andrei)
- *  2005-07-01  added /dev/poll (andrei)
- *  2006-05-30  sigio 64 bit workarround enabled for kernels < 2.6.5 (andrei)
- *  2007-11-22  when handle_io() is called in a loop check & stop if the fd was
- *               removed inside handle_io() (andrei)
- *  2007-11-29  support for write (POLLOUT); added io_watch_chg() (andrei)
- *  2008-02-04  POLLRDHUP & EPOLLRDHUP support (automatically enabled if POLLIN
- *               is set) (andrei)
- *  2010-06-17  re-enabled & enhanced the EV_ERROR for kqueue (andrei)
- */
-
-
 
 #ifndef _io_wait_h
 #define _io_wait_h
index 458eaa0..0ca959f 100644 (file)
--- a/ip_addr.c
+++ b/ip_addr.c
@@ -1,24 +1,16 @@
 /*
- * $Id$
- *
- *
  * ip address & address family related functions
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/*
- * History:
- * --------
- *  2003-03-19  replaced all mallocs/frees w/ pkg_malloc/pkg_free
- *  2004-10-01  mk_net fixes bad network addresses now (andrei)
- */
 
-/** inernal ip addresses representation functions.
+/** Kamailio core :: internal ip addresses representation functions.
  * @file ip_addr.c
  * @ingroup core
  * Module: @ref core
index 2a08349..9efdd0f 100644 (file)
--- a/ip_addr.h
+++ b/ip_addr.h
@@ -1,4 +1,4 @@
-/* $Id$
+/* 
  *
  * ip address family related structures
  *
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/*
- * History:
- * --------
- *  2003-02-13  added struct dest_info (andrei)
- *  2003-04-06  all ports are stored/passed in host byte order now (andrei)
- *  2006-04-20  comp support in recv_info and dest_info (andrei)
- *  2006-04-21  added init_dst_from_rcv (andrei)
- *  2007-06-26  added ip_addr_mk_any() (andrei)
- *  2008-05-21  added su2a(), ip_addr2sbuf(), ip4tosbuf(), ip62sbuf() (andrei)
- *  2009-09-14  added send flags support to dest_info (andrei)
- */
+/*!
+* \file
+* \brief Kamailio core :: ip address family related structures
+* \ingroup core
+* Module: \ref core
+*/
 
 #ifndef ip_addr_h
 #define ip_addr_h
index b8d1629..11a4d34 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2010 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
@@ -15,7 +13,8 @@
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/** kamailio statistics types.
+
+/** Kamailio Core :: kamailio statistics types.
  * This file contains type declaration for kamailio statistics.
  * They are needed when modules are loaded (sr_module.c).
  * The rest of kamailio stats are in lib/kcore (include
  * Note: kamailio statistics are obsolete. Use sr counters in new code
  * (counters.h).
  * @file kstats_types.h
- * @ingroup: core
+ * @ingroup core
+ * @author andrei
  */
-/*
- * History:
- * --------
- *  2010-08-18  initial version (andrei)
-*/
 
 #ifndef __kstats_types_h
 #define __kstats_types_h
index 3caf1a6..b490787 100644 (file)
@@ -48,7 +48,7 @@ Compilation with ser:
 --------------------
 
 Compilation and installation of these libraries is NOT DONE by running
-main ser makefile now - it MUST be done MANUALLY. To compile and install
+main Kamailio makefile now - it MUST be done MANUALLY. To compile and install
 libraries simply run
 
    make install
@@ -62,15 +62,15 @@ AFTER COMPILATION of libraries you can COMPILE MODULES using this
 libraries like PA, RLS or dialog.
 
 
-Running with ser (Linux):
+Running with Kamailio (Linux):
 ----------------
 
 The path to installed libraries must be known to linker on startup. This
-can be done by setting variable LD_LIBRARY_PATH before running ser. For
+can be done by setting variable LD_LIBRARY_PATH before running Kamailio. For
 example, if libraries were installed to default directory (/usr/local),
-you should set LD_LIBRARY_PATH=/usr/local/lib/ser. In the case of 
+you should set LD_LIBRARY_PATH=/usr/local/lib/kamailio. In the case of 
 nonstandard installation, you can use something like 
-LD_LIBRARY_PATH=/my/ser/directory/lib/ser.
+LD_LIBRARY_PATH=/my/ser/directory/lib/kamailio.
 
 Compilation without ser:
 --------------------
index 98694f6..7ff61a8 100644 (file)
@@ -3,7 +3,7 @@
 #---------------------------------------------------------------------------
 # Project related configuration options
 #---------------------------------------------------------------------------
-PROJECT_NAME           = "SER libraries"
+PROJECT_NAME           = "Kamailio libraries"
 PROJECT_NUMBER         = 1
 OUTPUT_DIRECTORY       = doc/
 CREATE_SUBDIRS         = NO
index 055e099..ca1a782 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
  * This file is part of Kamailio, a free SIP server.
@@ -23,6 +21,7 @@
 /*!
  * \file
  * \brief comparison functions
+ * \ingroup libkcore
  */
 
 #include "../../parser/parse_uri.h"
index ba2b4e2..b001608 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
  * This file is part of Kamailio, a free SIP server.
@@ -23,6 +21,7 @@
 /*!
  * \file
  * \brief comparison functions
+ * \ingroup libkcore
  */
 
 #ifndef _CMPAPI_H_
index 70d175f..1132a9b 100644 (file)
@@ -1,6 +1,4 @@
 /**
- * $Id$
- *
  * Copyright (C) 2009 Daniel-Constantin Mierla (asipto.com)
  *
  * This file is part of kamailio, a free SIP server.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
+/*!
+* \file
+* \brief Faked message handling
+* \ingroup libkcore
+* Module: \ref libkcore
+*/
 
 #include "../../dprint.h"
 #include "../../globals.h"
index 650f932..31718a8 100644 (file)
@@ -1,5 +1,4 @@
 /**
- * $Id$
  *
  * Copyright (C) 2009 Daniel-Constantin Mierla (asipto.com)
  *
index 4feeebb..0c4eef0 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2010 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
 /** k compatible statistics implemented in terms of sr counters.
  * @file kstats_wrapper.h
  * @ingroup: libkcore
+ * @author andrei
  */
-/*
- * History:
- * --------
- *  2010-08-08  initial version (andrei)
-*/
 
 #include "kstats_wrapper.h"
 
index 80cc9f8..1fe5694 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2010 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * @file kstats_wrapper.h
  * @ingroup: libkcore
  */
-/*
- * History:
- * --------
- *  2010-08-08  initial version (andrei)
- *  2010-08-18  type declaration needed by sr_module.c moved to
- *               ../../kstats_types.h (andrei)
-*/
+
+/*! @defgroup libkcore Kamailio compatibility core library
+ *
+ */
 
 #ifndef __kstats_wrapper_h
 #define __kstats_wrapper_h
index a64c0d5..46beb3f 100644 (file)
@@ -28,6 +28,7 @@
  * \file
  * \brief Privacy value parser
  * \ingroup parser
+ * Copyright (c) 2006 Juha Heinanen
  */
 
 #include <stdlib.h>
index 447593e..1bb67b9 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id: parse_privacy.h 4720 2008-08-23 10:56:15Z henningw $
- *
  * Copyright (c) 2006 Juha Heinanen
  *
  * This file is part of Kamailio, a free SIP server.
index 7a18f04..7ab497a 100644 (file)
@@ -1,5 +1,4 @@
 /*
- * $Id$
  * 
  * Copyright (c) 2006 SOMA Networks, Inc. <http://www.somanetworks.com/>
  *
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * --------
- * 2006-02-17 Initial revision (dhsueh@somanetworks.com)
  */
 
 /*!
  * \file
  * \brief SST parser
  * \ingroup parser
+ * \author dhsueh@somanetworks.com
  */
 
 #include "parse_sst.h"
index 9476ed7..91a16c9 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (c) 2006 SOMA Networks, Inc. <http://www.somanetworks.com/>
  *
  * This file is part of Kamailio, a free SIP server.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * --------
- * 2006-02-17 Initial revision (dhsueh@somanetworks.com)
  */
 
 /*!
  * \file
  * \brief SST parser
  * \ingroup parser
+ * \author dhsueh@somanetworks.com
  */
 
 #ifndef PARSE_SST_H
index eadb4ea..58896af 100644 (file)
  *
  * WARNING: Don't forget to update the dictionary if you update this file !!!
  *
- * History:
- * --------
- * 2005-06-28  multi leg call support added (bogdan)
- * 2008-09-03  added type field to attribute structure, which is set
- *             during INIT_AV.
- *
  */
 
 /*!
  * \file
  * \brief Radius support
+ * \ingroup libkcore
  */
 
 
index 96cb96b..2dc4694 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Regular expression functions
  *
  * Copyright (C) 2003 Juha Heinanen
@@ -26,6 +24,8 @@
 /*!
  * \file 
  * \brief Regular Expression functions
+ * Copyright (C) 2003 Juha Heinanen
+ * \ingroup libkcore
  */
 
 #include <sys/types.h>
index 11f42fe..77d7401 100644 (file)
@@ -1,8 +1,6 @@
 /*
  * $Id$
  *
- * Regular expression definitions
- *
  * Copyright (C) 2003 Juha Heinanen
  *
  * This file is part of Kamailio, a free SIP server.
@@ -26,6 +24,9 @@
 /*!
  * \file 
  * \brief Regular expression definitions 
+ * Copyright (C) 2003 Juha Heinanen
+ * \author Juha Heinanen
+ * \ingroup libkcore
  */
 
 
index 83ca76d..6c63a43 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2006 Voice Sistem SRL
  *
  * This file is part of Kamailio, a free SIP server.
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  *
  *
- * History:
- * ---------
- *  2006-01-16  first version (bogdan)
- *  2006-11-28  added get_stat_var_from_num_code() (Jeffrey Magder -
- *              SOMA Networks)
- *  2010-08-08  removed all the parts emulated by kstats_wrapper.[ch] (andrei)
  */
 
 /*!
  * \file
  * \brief Statistics support
+ * \author bogdan, andrei
+ * \author Jeffrey Magder - SOMA Networks
+ * \ingroup libkcore
  */
 
 
index 89a90a5..8860aa8 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2006 Voice Sistem SRL
  *
  * This file is part of Kamailio, a free SIP server.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  *
- * History:
- * ---------
- *  2006-01-16  first version (bogdan)
- *  2006-11-28  added get_stat_var_from_num_code() (Jeffrey Magder -
- *              SOMA Networks)
- *  2010-08-08  removed all the parts emulated by kstats_wrapper.[ch] (andrei)
  */
 
 /*!
  * \file
  * \brief Kamailio statistics handling
+ * \ingroup libkcore
+ * \author bogdan
+ * \author Jeffrey Magder - SOMA Networks
  */
 
 
index ce27ab3..ccc135c 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2007 voice-system.ro
  *
  * This file is part of Kamailio, a free SIP server.
@@ -24,6 +22,7 @@
 /*!
  * \file
  * \brief Generic string handling functions
+ * \ingroup libkcore
  */
 
 #include "../../ut.h"
index c3d0c70..a1edc3a 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * Copyright (C) 2007 voice-system.ro
  *
  * This file is part of Kamailio, a free SIP server.
@@ -23,6 +21,7 @@
 /*!
  * \file
  * \brief Common string handling functions
+ * \ingroup libkcore
  */
 
 #ifndef _STRCOMMON_H_
index 98d3cde..72fe2d8 100644 (file)
@@ -78,19 +78,19 @@ int db_check_api(db_func_t* dbf, char *mname)
 
        /* All modules must export db_use_table */
        if (dbf->use_table == 0) {
-               LM_ERR("module %s does not export db_use_table function\n", mname);
+               LM_ERR("module %s does not export db_use_table function. Please check if module is loaded.\n", mname);
                goto error;
        }
 
        /* All modules must export db_init */
        if (dbf->init == 0) {
-               LM_ERR("module %s does not export db_init function\n", mname);
+               LM_ERR("module %s does not export db_init function. Please check if module is loaded.\n", mname);
                goto error;
        }
 
        /* All modules must export db_close */
        if (dbf->close == 0) {
-               LM_ERR("module %s does not export db_close function\n", mname);
+               LM_ERR("module %s does not export db_close function. Please check if module is loaded.\n", mname);
                goto error;
        }
 
index 8a8df24..5a0e9a2 100644 (file)
@@ -1,7 +1,7 @@
 Library collecting various utility components needed by several modules
 #######################################################################
 
-The licesing matches the rules for core - owned by FhG or more liberal
+The licensing matches the rules for core - owned by FhG or more liberal
 like BSD or MIT style.
 
 1. TMREC
@@ -15,17 +15,17 @@ COS - RFC 2445)
 =========
 
 Adapted verision of cJSON - a C JSON parsing library - that integrates better
-with Kamailio/SER environment.
+with Kamailio environment.
 
 The changes so far:
   - rename cJSON to srjson to avoid name space conflicts
   - ability to specify malloc/free functions per JSON document. In
-  Kamailio/SER, based on needs, it can be PKG or SHM type of used memory.
+  Kamailio based on needs, it can be PKG or SHM type of used memory.
   - ability to add a string value by pointer and length - the very common
   str structure
 
 Next targets:
-  - option to clone or not the full JSON document buffer and parse using
+- option to clone or not the full JSON document buffer and parse using
   the clone (tied to and becomes usefule with the next item in this list)
   - don't clone the string values when parsing a JSON document, but set
   references to names and string values
index 25f9e38..21cb6cc 100644 (file)
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
+/*! @defgroup srutils Various utilities
+ *
+ * Kamailio core library.
+ */
+/*!
+* \file
+* \brief srutils :: SHA and other hashing utilities
+* \ingroup srutils
+* Module: \ref srutils
+*/
 
 #include "../../md5.h"
 #include "../../ut.h"
index 1d7b0e4..1ca8d07 100644 (file)
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
+/*!
+* \file
+* \brief srutils :: SHA and other hashing utilities
+* \ingroup srutils
+* Module: \ref srutils
+*/
 
 #ifndef _SHAUTILS_H_
 #define _SHAUTILS_H_
index 4a7e261..b8c1945 100644 (file)
    THE SOFTWARE.
    */
 
-/**
- * srjson - JSON parser in C - MIT License
+/*!
+ * \file
+ * \brief srutils :: SRjson - JSON parser in C - MIT License
+ * \ingroup srutils
+ * Module: \ref srutils
  * - addapted from cJSON to fit better within Kamailio/SER environment
  */
 
index 4d8306f..02d65d7 100644 (file)
   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
   THE SOFTWARE.
 */
+/*!
+* \file
+* \brief srutils :: SRjson
+* \ingroup srutils
+* Module: \ref srutils
+*/
 
 #ifndef _srjson__h_
 #define _srjson__h_
index ca67bfc..385252e 100644 (file)
@@ -1,5 +1,4 @@
 /*
- * $Id$
  *
  * sruid - unique id generator
  *
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
+/*!
+* \file
+* \brief srutils :: Unique ID generator
+* \ingroup srutils
+* Module: \ref srutils
+*/
 
 #include <stdio.h>
 #include <unistd.h>
index a459188..6f1ea1d 100644 (file)
@@ -1,6 +1,4 @@
 /*
- * $Id$
- *
  * sruid - unique id generator
  *
  * Copyright (C) 2012 Daniel-Constantin Mierla (asipto.com)
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
+/*!
+* \file
+* \brief srutils :: Unique ID generator
+* \ingroup srutils
+* Module: \ref srutils
+*/
 
 #ifndef _SRUID_H_
 #define _SRUID_H_
index 4b88349..07c7820 100644 (file)
@@ -1,5 +1,4 @@
 /*
- * $Id$
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
@@ -25,7 +24,9 @@
  * Time Recurence Library according to iCalendar (RFC 2445)
  * - implemented at FhG Fokus, 2003 - external link:
  *   https://github.com/miconda/tmrec
- * - this is a clone adapted for kamailio/ser
+ * \brief srutils :: <description of this file>
+ * \ingroup srutils
+ * Module: \ref srutils
  */
 
 #include <stdio.h>
diff --git a/list.h b/list.h
index d712253..bdbecca 100644 (file)
--- a/list.h
+++ b/list.h
@@ -1,4 +1,4 @@
-/*-
+/*
  * Copyright (c) 1991, 1993
  *     The Regents of the University of California.  All rights reserved.
  *
index 1673e0e..3e7c67d 100644 (file)
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2007 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/* local, per process timer routines
- * WARNING: this should be used only within the same process, the timers
- *  are not multi-process safe or multi-thread safe
- *  (there are no locks)
- *
- * History:
- * --------
- *  2006-02-03  created by andrei
- */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core :: local, per process timer routines
+ * WARNING: this should be used only within the same process, the timers
+ *  are not multi-process safe or multi-thread safe
+ *  (there are no locks)
  * \ingroup core
  * Module: \ref core
  */
@@ -53,7 +40,7 @@
 
 
 
-/* init a local_timer handle
+/** init a local_timer handle
  * returns 0 on success, -1 on error */
 int init_local_timer(struct local_timer *t, ticks_t crt_ticks)
 {
@@ -83,7 +70,7 @@ void destroy_local_timer(struct local_timer* lt)
 
 
 
-/* generic add timer entry to the timer lists function (see _timer_add)
+/** generic add timer entry to the timer lists function (see _timer_add)
  * tl->expire must be set previously, delta is the difference in ticks
  * from current time to the timer desired expire (should be tl->expire-*tick)
  * If you don't know delta, you probably want to call _timer_add instead.
@@ -124,7 +111,7 @@ static inline void local_timer_redist(struct local_timer* l,
 
 
 
-/* local timer add function (no lock, not multithread or multiprocess safe,
+/** local timer add function (no lock, not multithread or multiprocess safe,
  * designed for local process use only)
  * t = current ticks
  * tl must be filled (the intial_timeout and flags must be set)
@@ -141,7 +128,7 @@ static inline int _local_timer_add(struct local_timer *h, ticks_t t,
 
 
 
-/* "public", safe timer add functions (local process use only)
+/** "public", safe timer add functions (local process use only)
  * adds a timer at delta ticks from the current time
  * returns -1 on error, 0 on success
  * WARNING: to re-add a deleted or expired timer you must call
@@ -173,7 +160,7 @@ error:
 
 
 
-/* safe timer delete
+/** safe timer delete
  * deletes tl and inits the list pointer to 0
  * WARNING: to be able to reuse a deleted timer you must call
  *          timer_reinit(tl) on it
@@ -199,7 +186,7 @@ void local_timer_del(struct local_timer* h, struct timer_ln* tl)
 
 
 
-/* called from timer_handle*/
+/** called from timer_handle*/
 inline static void local_timer_list_expire(struct local_timer* l, 
                                                                                        ticks_t t, struct timer_head* h)
 {
@@ -226,7 +213,7 @@ inline static void local_timer_list_expire(struct local_timer* l,
 
 
 
-/* run all the handler that expire at t ticks */
+/** run all the handler that expire at t ticks */
 static inline void local_timer_expire(struct local_timer* h, ticks_t t)
 {
        /* trust the compiler for optimizing */
@@ -245,7 +232,7 @@ static inline void local_timer_expire(struct local_timer* h, ticks_t t)
 
 
 
-/* "main" local timer routine, should be called with a proper ticks value
+/** "main" local timer routine, should be called with a proper ticks value
  * WARNING: it should never be called twice for the same ticks value
  * (it could cause too fast expires for long timers), ticks must be also
  *  always increasing */
index 75503ce..e981809 100644 (file)
@@ -1,21 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2007 iptelorg GmbH
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/* local timer routines
+/*!
+* \file
+* \brief Kamailio core :: local timer routines
+* \ingroup core
+* \author andrei
+* Module: \ref core
+*
  * WARNING: this should be used only from within the same process.
  * The local timers are not multi-process or multi-thread safe 
  *  (there are no locks)
  *
- * History:
- * --------
- *  2007-11-22  created by andrei
  */
 
 #ifndef _local_timer_h
index 84e9dac..145aa81 100644 (file)
@@ -1,21 +1,20 @@
-/* $Id$ */
 /*
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
+ * For a license to use the Kamailio software under conditions
  * other than those described here, or to purchase support for this
  * software, please contact iptel.org by e-mail at the following addresses:
  *    info@iptel.org
  *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
 
-/*
- *   ser locking library
+/*!
+* \file
+* \brief Kamailio core :: Kamailio locking library
+* \author andrei
+* \ingroup core
+* Module: \ref core
+*
  *   WARNING: don't include this directly include instead locking.h!
- * History:
- * --------
- *  2003-03-06  created by andrei (contains parts of the original locking.h)
- *  2003-03-17  fixed cast warning in shm_free (forced to void*) (andrei)
- *  2004-07-28  s/lock_set_t/gen_lock_set_t/ because of a type conflict
- *              on darwin (andrei)
  *
 Implements: (see also locking.h)
 
index 3392c58..c932a84 100644 (file)
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2007 iptelorg GmbH
  *
  * Permission to use, copy, modify, and distribute this software for any
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- *  lock operations init
- */
-/* 
- * History:
- * --------
- *  2007-05-14  created by andrei
- */
 
 /*!
  * \file
- * \brief SIP-router core :: 
+ * \brief Kamailio core ::  lock operations init
  * \ingroup core
  *
  * Module: \ref core
index 097d5bb..0baa4e6 100644 (file)
@@ -1,4 +1,3 @@
-/* $Id$ */
 /*
  *
  * Copyright (C) 2001-2003 FhG Fokus
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
 
-/*
- *   ser locking library
+/*!
+* \file
+* \brief Kamailio core :: Kamailio locking library
+* \ingroup core
+* \author andrei
+* Module: \ref core
+*
  *   WARNING: do not include this file directly, use instead locking.h
  *   (unless you don't need to alloc/dealloc locks)
  *
- *  2002-12-16  created by andrei
- *  2003-02-20  s/gen_lock_t/gen_lock_t/ to avoid a type conflict 
- *               on solaris  (andrei)
- *  2003-03-05  lock set support added for FAST_LOCK & SYSV (andrei)
- *  2003-03-06  removed *_alloc,*_dealloc & moved them to lock_alloc.h
- *              renamed locking.h to lock_ops.h (all this to solve
- *              the locking.h<->shm_mem.h interdependency) (andrei)
- *  2003-03-10  lock set support added also for PTHREAD_MUTEX & POSIX_SEM
- *               (andrei)
- *  2003-03-17  possible signal interruptions treated for sysv (andrei)
- *  2004-07-28  s/lock_set_t/gen_lock_set_t/ because of a type conflict
- *              on darwin (andrei)
- *  2006-04-04  added lock_try(lock) and lock_set_try(s,i) (andrei)
- *  2007-05-13  added futex support (andrei)
  *
 Implements:
 
index edad6bb..6eff737 100644 (file)
@@ -1,5 +1,4 @@
 /* 
- * $Id$
  * 
  * Copyright (C) 2007 iptelorg GmbH
  *
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-/*
- * lock_ops init functions
- */
-/* 
- * History:
- * --------
- *  2007-05-14  created by andrei
+/*!
+* \file
+* \brief Kamailio core :: lock_ops init functions
+* \ingroup core
+* \author andrei
+* Module: \ref core
  */
 
 #ifndef __lock_ops_init_h
index 6dfc11f..2d7e934 100644 (file)
--- a/locking.h
+++ b/locking.h
@@ -1,21 +1,15 @@
-/* $Id$ */
 /*
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
 
-/*
- *   ser locking library
+/*!
+* \file
+* \brief Kamailio core :: Kamailio locking library
+* \ingroup core
+* \author andrei
+* Module: \ref core
  *
- *  2002-12-16  created by andrei
- *  2003-02-20  s/gen_lock_t/gen_lock_t/ to avoid a type conflict 
- *               on solaris  (andrei)
- *  2003-03-05  lock set support added for FAST_LOCK & SYSV (andrei)
- *  2003-03-06  split in two: lock_ops.h & lock_alloc.h, to avoid
- *               shm_mem.h<->locking.h interdependency (andrei)
- *  2004-07-28  s/lock_set_t/gen_lock_set_t/ because of a type conflict
- *              on darwin (andrei)
  *
 Implements (in lock_ops.h & lock_alloc.h):
 
index a9e53b2..ba07fa4 100644 (file)
@@ -1,23 +1,17 @@
 /*
- * $Id$
  *
  * adding/removing headers or any other data chunk from a message
  *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software 
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  */
-/* History:
- * --------
- *  2003-01-29  s/int/enum ... more convenient for gdb (jiri)
- *  2003-03-31  added subst lumps -- they expand in ip addr, port a.s.o (andrei)
- *  2003-04-01  added opt (condition) lumps (andrei)
- *  2003-04-02  added more subst lumps: SUBST_{SND,RCV}_ALL  
- *              => ip:port;transport=proto (andrei)
- *  2003-10-20  split from data_lump.h (andrei)
- *  2005-03-24  the type of type attribute changed to enum _hdr_types_t (janakj)
- *
- */
-
+/*!
+* \file
+* \brief Kamailio core :: Adding/removing headers or any other data chunk from a message
+* \ingroup core
+* \author jiri, andrei, janakj
+* Module: \ref core
+*/
 
 #ifndef lump_struct_h
 #define lump_struct_h
index 156e506..89e1f4e 100644 (file)
--- a/lvalue.c
+++ b/lvalue.c
 
 /**
  * @file 
- * @brief SIP-router core :: lvalues (assignment)
+ * @brief Kamailio core :: lvalues (assignment)
  * \ingroup core
  * Module: \ref core
  */
 
-/* 
- * History:
- * --------
- *  2008-11-30  initial version (andrei)
- *  2009-04-24  delete avps after finding their new value and not before
- *               (fixed $avp=$avp)
- *              when assigning something undefined (e.g. non-existing avp),
- *              delete the lvalue (similar to perl)  (andrei)
- */
-
-
 #include "lvalue.h"
 #include "dprint.h"
 #include "route.h"
index b5eccd4..0f48adb 100644 (file)
--- a/lvalue.h
+++ b/lvalue.h
@@ -1,5 +1,4 @@
 /* 
- * $Id$
  * 
  * Copyright (C) 2008 iptelorg GmbH
  *
 /**
  * @file 
  * @brief lvalues (assignment)
- */
-/* 
- * History:
- * --------
- *  2008-11-30  initial version (andrei)
+ * @author andrei
  */
 
 #ifndef __lvalue_h_
diff --git a/main.c b/main.c
index 0667276..ec88a1f 100644 (file)
--- a/main.c
+++ b/main.c
@@ -1,16 +1,14 @@
 /*
- * $Id$
- *
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of SIP-router, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * SIP-router is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * SIP-router is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  *
- * History:
- * -------
- *  2002-01-29  argc/argv globalized via my_{argc|argv} (jiri)
- *  2003-01-23  mhomed added (jiri)
- *  2003-03-19  replaced all malloc/frees w/ pkg_malloc/pkg_free (andrei)
- *  2003-03-29  pkg cleaners for fifo and script callbacks introduced (jiri)
- *  2003-03-31  removed snmp part (obsolete & no place in core) (andrei)
- *  2003-04-06  child_init called in all processes (janakj)
- *  2003-04-08  init_mallocs split into init_{pkg,shm}_mallocs and
- *               init_shm_mallocs called after cmd. line parsing (andrei)
- *  2003-04-15  added tcp_disable support (andrei)
- *  2003-05-09  closelog() before openlog to force opening a new fd
- *               (needed on solaris) (andrei)
- *  2003-06-11  moved all signal handlers init. in install_sigs and moved it
- *               after daemonize (so that we won't catch anymore our own
- *               SIGCHLD generated when becoming session leader) (andrei)
- *              changed is_main default value to 1 (andrei)
- *  2003-06-28  kill_all_children is now used instead of kill(0, sig)
- *                see comment above it for explanations. (andrei)
- *  2003-06-29  replaced port_no_str snprintf w/ int2str (andrei)
- *  2003-10-10  added switch for config check (-c) (andrei)
- *  2003-10-24  converted to the new socket_info lists (andrei)
- *  2004-03-30  core dump is enabled by default
- *              added support for increasing the open files limit    (andrei)
- *  2004-04-28  sock_{user,group,uid,gid,mode} added
- *              user2uid() & user2gid() added  (andrei)
- *  2004-09-11  added timeout on children shutdown and final cleanup
- *               (if it takes more than 60s => something is definitely wrong
- *                => kill all or abort)  (andrei)
- *              force a shm_unlock before cleaning-up, in case we have a
- *               crashed childvwhich still holds the lock  (andrei)
- *  2004-12-02  removed -p, extended -l to support [proto:]address[:port],
- *               added parse_phostport, parse_proto (andrei)
- *  2005-06-16  always record the pid in pt[process_no].pid twice: once in the
- *               parent & once in the child to avoid a short window when one
- *               of them might use it "unset" (andrei)
- *  2005-07-25  use sigaction for setting the signal handlers (andrei)
- *  2006-07-13  added dns cache/failover init. (andrei)
- *  2006-10-13  added global variables stun_refresh_interval, stun_allow_stun
- *               and stun_allow_fp (vlada)
- *  2006-10-25  don't log messages from signal handlers if NO_SIG_DEBUG is
- *               defined; improved exit kill timeout (andrei)
- *              init_childs(PROC_MAIN) before starting tcp_main, to allow
- *               tcp usage for module started processes (andrei)
- * 2007-01-18  children shutdown procedure moved into shutdown_children;
- *               safer shutdown on start-up error (andrei)
- * 2007-02-09  TLS support split into tls-in-core (CORE_TLS) and generic TLS
- *             (USE_TLS)  (andrei)
- * 2007-06-07  added support for locking pages in mem. and using real time
- *              scheduling policies (andrei)
- * 2007-07-30  dst blacklist and DNS cache measurements added (Gergo)
- * 2008-08-08  sctp support (andrei)
- * 2008-08-19  -l support for mmultihomed addresses/addresses lists
- *                (e.g. -l (eth0, 1.2.3.4, foo.bar) ) (andrei)
- * 2010-04-19  added daemon_status_fd pipe to communicate the parent process
- *              with the main process in daemonize mode, so the parent process
- *              can return the proper exit status code (ibc)
- * 2010-08-19  moved the daemon status stuff to daemonize.c (andrei)
  */
 
-/** main file (init, daemonize, startup) 
+/** Kamailio core :: main file (init, daemonize, startup) 
  * @file main.c
  * @ingroup core
  * Module: core
  */
 
-/*! @defgroup core SIP-router core
+/*! @defgroup core Kamailio core
  *
  * sip router core part.
  */
index b610cf9..e415eab 100644 (file)
@@ -23,7 +23,7 @@
 
 /*!
  * \file
- * \brief SIP-router core :: md5 hash support
+ * \brief Kamailio core :: md5 hash support
  * \ingroup core
  * Module: \ref core
  */
index a16c8f3..a8df9cb 100644 (file)
@@ -1,19 +1,14 @@
 /* 
  * Copyright (C) 2001-2003 FhG Fokus
  *
- * This file is part of ser, a free SIP server.
+ * This file is part of Kamailio, a free SIP server.
  *
- * ser is free software; you can redistribute it and/or modify
+ * Kamailio is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
- * For a license to use the ser software under conditions
- * other than those described here, or to purchase support for this
- * software, please contact iptel.org by e-mail at the following addresses:
- *    info@iptel.org
- *
- * ser is distributed in the hope that it will be useful,
+ * Kamailio is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -25,7 +20,7 @@
 
 /*!
  * \file
- * \brief SIP-router core :: md5 hash support
+ * \brief Kamailio core :: MD5 digest support
  * \ingroup core
  * Module: \ref core
  */
index dc04d2f..46505f4 100644 (file)
--- a/mod_fix.c
+++ b/mod_fix.c
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
 
-/* 
- * History:
- * --------
- *  2008-11-25  initial version (andrei)
- */
-
 /*!
  * \file
- * \brief SIP-router core :: kamailio compatible fixups
+ * \brief Kamailio core :: kamailio compatible fixups
  * \ingroup core
  * Module: \ref core
  */
index c7740d0..36c2ec0 100644 (file)
--- a/mod_fix.h
+++ b/mod_fix.h
@@ -1,6 +1,4 @@
 /* 
- * $Id$
- * 
  * Copyright (C) 2008 iptelorg GmbH
  *