Hello,
I thought some people may have spare cycles and are willing to help with
the documentation. Here is some updates I would like to get for modules:
1) adding ids for parameters, functions, and other sections of the
docbook xml files. Now we generate the alphabetic indexes pointing to
the online html readmes, would be better to point directly to the exact
section. Practically, for example, sections such as next from async module:
<section>
<title><varname>workers</varname> (int)</title>
should become:
<section id="async.p.workers">
<title><varname>workers</varname> (int)</title>
To get unique ids over all files, I suggest using following pattern:
[module name] [dot] [type] [dot] [title]
The [type] should be:
- p - parameters
- f - functions
- m - mi commands
- r - rpc commands
- s - statistics
2) Add RPC commands to readmes -- some of modules already do, but many
don't. There is a perl script that should get the list of RPC commands
from source code, but it requires some patch to a perl lib, not working
on all systems. Moreover, the output is quite minimalistic, not easy to
improve the content or add examples. Last generated index is:
- http://www.kamailio.org/docs/docbooks/3.4.x/rpc_list/rpc_list.html
3) Document selects -- although their name are quite suggestive, a bit
of text around won't harm.
- http://www.kamailio.org/wiki/cookbooks/devel/selects
Because 1) and 2) requires git access, the easiest way to contribute is
to provide patches to the xml files. If anyone commits to do an
extensive work on these tasks in short term, we may eventually arrange
for git access. The 3) is in the wiki, everyone can register an account
and then update the pages.
I would recommend these guidelines to be followed from now on by
developers when adding new elements to the module documentation.
Cheers,
Daniel
--
Daniel-Constantin Mierla - http://www.asipto.comhttp://twitter.com/#!/miconda - http://www.linkedin.com/in/miconda
Kamailio World Conference, April 16-17, 2013, Berlin
- http://conference.kamailio.com -
i built latest master and got error when trying to load websocket
module:
0(10759) ERROR: <core> [sr_module.c:588]: ERROR: load_module: could not open module </usr/lib/sip-proxy/modules/websocket.so>: /usr/lib/sip-proxy/modules/websocket.so: undefined symbol: ws_keepalive_mechanism
is there a bug in websocket module or am i missing something? i read
websocket readme and didn't find anything missing.
i have not defined keepalive_mechanism variable in config.
-- juha
Module: sip-router
Branch: master
Commit: 2168999d8f198268526404946b0def97b87fd8f5
URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=2168999…
Author: Hugh Waite <hugh.waite(a)crocodile-rcs.com>
Committer: Hugh Waite <hugh.waite(a)crocodile-rcs.com>
Date: Fri Apr 5 09:33:38 2013 +0100
Merge remote branch 'origin/hpw/branch_failure_route'
* origin/hpw/branch_failure_route:
modules/tm: Fix t_next_contact_flow return value
modules/tmx: Add $T_reply_ruid pv to return ruid for a branch reply
modules/tm: Make ruid available in uac structure
modules/registrar: Allow unregister for ruids in branch_failure_route
modules/usrloc: Fix get_urecord_by_ruid to return static aor
modules/tm: Fix setting instance in uac branches
modules/tm: Enable retrieving of branch instance id from uac structure
modules/xprint: Updated to use the new get_branch()/next_branch() functions
modules/pv: Updated to use the new get_branch()/next_branch() functions
modules/permissions: Updated to use the new get_branch()/next_branch() functions
modules/domain: Updated to use the new get_branch()/next_branch() functions
core: Update get_branch() to return instance from appended branches
modules/tm: Update t_next_contact_flows for use in branch_failure event_route
core: Add defines required for a new branch_failure_route type
modules/tm: Create branch-failure event route
Revert "core: Initial revision of branch_failure_route"
core: Initial revision of branch_failure_route
modules/tm: Initial revision of branch_failure_route
---
Hi All,
The following in Makefile.defs is incorrect IMO:
# setting LDFLAGS
ifeq ($(CC_NAME), gcc)
ifeq ($(LDTYPE), solaris)
# solaris ld
LDFLAGS+=-O2 $(PROFILE)
MOD_LDFLAGS:=-G $(LDFLAGS)
LIB_LDFLAGS:=-G $(LDFLAGS)
LIB_SONAME=-Wl,-h,
LD_RPATH=-Wl,-R,
else
#gcc and maybe others, => gnu ld
LDFLAGS+=-Wl,-O2 -Wl,-E $(PROFILE)
MOD_LDFLAGS:=-shared $(LDFLAGS)
LIB_LDFLAGS:=-shared $(LDFLAGS)
LIB_SONAME=-Wl,-soname,
LD_RPATH=-Wl,-rpath,
endif
endif
Solaris GCC supports the standard -shared flag parameter. TBH, I'm not sure
where the -G came from and why? If nobody has any objections I would like
to remove -G switch for Solaris GCC???
ps. the -G switch works fine when building 32 bit but breaks when building
64 bit with errors like:
fatal: relocation error: R_AMD64_PC32: .... value 0x2800c20d934 does not fit
Cheers
Jason
THIS IS AN AUTOMATED MESSAGE, DO NOT REPLY.
The following task has a new comment added:
FS#278 - usrloc module stops updating some records in db_mode 2
User who did this - Daniel-Constantin Mierla (miconda)
----------
Have you been able to compare the db queries in 3.1 vs. 3.3? Just wondering, maybe I overlooked something and I should investigate in other direction. I don't have any 3.1 going on anymore.
----------
More information can be found at the following URL:
http://sip-router.org/tracker/index.php?do=details&task_id=278#comment819
You are receiving this message because you have requested it from the Flyspray bugtracking system. If you did not expect this message or don't want to receive mails in future, you can change your notification settings at the URL shown above.
Module: sip-router
Branch: master
Commit: 0964bc96b1e3cd3bb7478388f6df3cb69fffce64
URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=0964bc9…
Author: Olle E. Johansson <oej(a)edvina.net>
Committer: Olle E. Johansson <oej(a)edvina.net>
Date: Thu Apr 4 22:27:02 2013 +0200
snmpstats Add support for the new transports as well as new roles
The edgeproxyServer is a SIP Outbound edge proxy that manages flows to NATted clients.
The sipcaptureServer collects SIP messages for Homer SIP capture
---
modules/snmpstats/README | 7 +++++--
modules/snmpstats/doc/snmpstats_admin.xml | 6 ++++--
modules/snmpstats/mibs/KAMAILIO-SIP-COMMON-MIB | 2 +-
modules/snmpstats/mibs/KAMAILIO-TC | 24 ++++++++++++++++++------
modules/snmpstats/snmpSIPCommonObjects.c | 6 ++++++
modules/snmpstats/snmpstats_globals.h | 2 ++
6 files changed, 36 insertions(+), 11 deletions(-)
diff --git a/modules/snmpstats/README b/modules/snmpstats/README
index 49d20dd..12d2c31 100644
--- a/modules/snmpstats/README
+++ b/modules/snmpstats/README
@@ -302,7 +302,8 @@ Chapter 1. Admin Guide
and will be used in determining what is returned for the
kamailioSIPEntityType scalar. Valid parameters are:
- registrarServer, redirectServer, proxyServer, userAgent, other
+ registrarServer, redirectServer, proxyServer, userAgent,
+ edgeproxyServer, sipcaptureServer,other
Example 1.1. Setting the sipEntityType parameter
...
@@ -312,7 +313,9 @@ modparam("snmpstats", "sipEntityType", "proxyServer")
Note that as the above example shows, you can define this parameter
more than once. This is of course because a given Kamailio instance can
- take on more than one role.
+ take on more than one role. The edgeproxyServer is an edge server using
+ the outbound module and path extensions. The sipcaptureServer is a
+ Homer Sip Capture server that collect SIP messages.
4.2. MsgQueueMinorThreshold (Integer)
diff --git a/modules/snmpstats/doc/snmpstats_admin.xml b/modules/snmpstats/doc/snmpstats_admin.xml
index 568e1c2..71a7b61 100644
--- a/modules/snmpstats/doc/snmpstats_admin.xml
+++ b/modules/snmpstats/doc/snmpstats_admin.xml
@@ -259,7 +259,7 @@
<para>
<emphasis>
- registrarServer, redirectServer, proxyServer, userAgent, other
+ registrarServer, redirectServer, proxyServer, userAgent, edgeproxyServer, sipcaptureServer,other
</emphasis>
</para>
@@ -276,7 +276,9 @@ modparam("snmpstats", "sipEntityType", "proxyServer")
<para>
Note that as the above example shows, you can define this parameter more
than once. This is of course because a given Kamailio instance can take on
- more than one role.
+ more than one role. The edgeproxyServer is an edge server using the outbound
+ module and path extensions. The sipcaptureServer is a Homer Sip Capture
+ server that collect SIP messages.
</para>
</section>
diff --git a/modules/snmpstats/mibs/KAMAILIO-SIP-COMMON-MIB b/modules/snmpstats/mibs/KAMAILIO-SIP-COMMON-MIB
index 939a1a7..3ceec33 100644
--- a/modules/snmpstats/mibs/KAMAILIO-SIP-COMMON-MIB
+++ b/modules/snmpstats/mibs/KAMAILIO-SIP-COMMON-MIB
@@ -338,7 +338,7 @@ KAMAILIO-SIP-COMMON-MIB DEFINITIONS ::= BEGIN
bit 4: Transport Layer Security Protocol over TCP
bit 5: Transport Layer Security Protocol over SCTP
bit 6: WebSocket transport
- bit 7: WebSocket transport over HTTP/TLS (WSS)
+ bit 7: WebSocket transport over HTTP/TLS (WSS)"
::= { kamailioSIPPortEntry 4 }
--
diff --git a/modules/snmpstats/mibs/KAMAILIO-TC b/modules/snmpstats/mibs/KAMAILIO-TC
index 828ce2b..81d1459 100644
--- a/modules/snmpstats/mibs/KAMAILIO-TC
+++ b/modules/snmpstats/mibs/KAMAILIO-TC
@@ -23,7 +23,7 @@ IMPORTS
kamailioTcModule MODULE-IDENTITY
- LAST-UPDATED "201301081200Z"
+ LAST-UPDATED "201304041200Z"
ORGANIZATION "Kamailio"
CONTACT-INFO
"http://www.kamailio.org"
@@ -51,16 +51,22 @@ KamailioSIPTransportProtocol ::= TEXTUAL-CONVENTION
bit 1 : User Datagram Protocol.
bit 2 : Transmission Control Protocol.
bit 3 : Stream Control Transmission Protocol.
- bit 4 : Transport Layer Security Protocol."
+ bit 4 : Transport Layer Security Protocol.
+ bit 5 : SCTP/Transport Layer Security Protocol.
+ bit 6 : WebSocket transport (http)
+ bit 7 : WebSocket over HTTP/TLS (wss)"
SYNTAX BITS {
other(0), -- none of the following
udp(1),
tcp(2),
sctp(3),
- tls(4)
+ tls(4),
+ sctp_tls(5),
+ ws(6),
+ wss(7)
}
--- REFERENCE "RFC 3261, Section 18"
+-- REFERENCE "RFC 4780, SipTCTransportProtocol"
KamailioSIPEntityRole ::= TEXTUAL-CONVENTION
STATUS current
@@ -68,13 +74,20 @@ KamailioSIPEntityRole ::= TEXTUAL-CONVENTION
"This convention defines the role of a SIP entity.
Examples of SIP entities are proxies, user agents,
redirect servers, registrars or combinations of
- the above."
+ the above.
+ Kamailio adds the role 'edgeproxyServer' for
+ operation of a SIP outbound edge proxy node.
+ Kamailio adds the role 'sipcaptureServer' for
+ operation of a Homer SIPcapture node."
+ "
SYNTAX BITS {
other(0),
userAgent(1),
proxyServer(2),
redirectServer(3),
registrarServer(4)
+ edgeproxyServer(5)
+ sipcaptureServer(6)
}
@@ -87,7 +100,6 @@ KamailioSIPMethodIdentifier ::= TEXTUAL-CONVENTION
of all defined SIP methods.
Experimental support of extension methods is
-
acceptable and expected. Extention methods are
those defined in Internet-Draft documents but
not yet allocated an official number by IANA.
diff --git a/modules/snmpstats/snmpSIPCommonObjects.c b/modules/snmpstats/snmpSIPCommonObjects.c
index f4244d5..44ffa9d 100644
--- a/modules/snmpstats/snmpSIPCommonObjects.c
+++ b/modules/snmpstats/snmpSIPCommonObjects.c
@@ -502,6 +502,12 @@ int handleSipEntityType( modparam_t type, void* val)
else if (strcasecmp(strEntityType, "registrarServer") == 0) {
kamailioEntityType |= TC_SIP_ENTITY_ROLE_REGISTRAR_SERVER;
}
+ else if (strcasecmp(strEntityType, "edgeproxyServer") == 0) {
+ kamailioEntityType |= TC_SIP_ENTITY_ROLE_EDGEPROXY_SERVER;
+ }
+ else if (strcasecmp(strEntityType, "sipcaptureServer") == 0) {
+ kamailioEntityType |= TC_SIP_ENTITY_ROLE_SIPCAPTURE_SERVER;
+ }
else {
LM_ERR("The configuration file specified sipEntityType=%s,"
" an unknown type\n", strEntityType);
diff --git a/modules/snmpstats/snmpstats_globals.h b/modules/snmpstats/snmpstats_globals.h
index 431e907..1eb37ed 100644
--- a/modules/snmpstats/snmpstats_globals.h
+++ b/modules/snmpstats/snmpstats_globals.h
@@ -73,6 +73,8 @@
#define TC_SIP_ENTITY_ROLE_PROXY_SERVER (128 >> 2)
#define TC_SIP_ENTITY_ROLE_REDIRECT_SERVER (128 >> 3)
#define TC_SIP_ENTITY_ROLE_REGISTRAR_SERVER (128 >> 4)
+#define TC_SIP_ENTITY_ROLE_EDGEPROXY_SERVER (128 >> 5)
+#define TC_SIP_ENTITY_ROLE_SIPCAPTURE_SERVER (128 >> 6)
#define TC_SIP_OPTION_TAG_REQUIRE (128 >> 0)
#define TC_SIP_OPTION_TAG_PROXY_REQUIRE (128 >> 1)