Module: kamailio
Branch: master
Commit: c2c7e5b7f4cccdcd3154760bd9b8dfcf9ee8075a
URL: https://github.com/kamailio/kamailio/commit/c2c7e5b7f4cccdcd3154760bd9b8dfc…
Author: Olle E. Johansson <oej(a)edvina.net>
Committer: Olle E. Johansson <oej(a)edvina.net>
Date: 2017-01-02T17:26:14+01:00
acc README: Starting to remove radius (separate module now) and updating text about Diameter (no longer beta, more deprecated)
---
Modified: src/modules/acc/doc/acc_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/c2c7e5b7f4cccdcd3154760bd9b8dfc…
Patch: https://github.com/kamailio/kamailio/commit/c2c7e5b7f4cccdcd3154760bd9b8dfc…
---
diff --git a/src/modules/acc/doc/acc_admin.xml b/src/modules/acc/doc/acc_admin.xml
index 0a67b2e..107f1a5 100644
--- a/src/modules/acc/doc/acc_admin.xml
+++ b/src/modules/acc/doc/acc_admin.xml
@@ -18,9 +18,11 @@
<title>Overview</title>
<para>
ACC module is used to account transactions information to different
- backends like syslog, <abbrev>SQL</abbrev>,
- <acronym>RADIUS</acronym> and <acronym>DIAMETER</acronym>
- (beta version).
+ backends like syslog and <abbrev>SQL</abbrev>. With the separate module,
+ <acronym>radius</acronym> support is enabled. There is some very early support of
+ the <acronym>Diameter</acronym> protocol in the code which is no longer included
+ by default. This support is not up to date with the current Diameter protocols and
+ is disabled.
</para>
<para>
To account a transaction and to choose which set of backends to be
@@ -98,36 +100,17 @@
</itemizedlist>
</para>
<para>
- The SQL backend support is compiled in the module. For RADIUS and
+ The SQL backend support is compiled in the module. For
DIAMETER you need to enable it by recompiling the module with properly
- set defines: uncomment the RAD_ACC or DDIAM_ACC lines in
- modules/acc/Makefile. To compile RADIUS support,
- you need to have radiusclient-ng (only versions higher or equal
- to 0.5.0) installed on your system which is available from
- <ulink url='http://developer.berlios.de/projects/radiusclient-ng/'>
- http://developer.berlios.de/projects/radiusclient-ng/</ulink>.
- The radius client needs to be configured properly. To do so, use the
- template at etc/radiusclient.conf and make sure
- that module's radius_config parameter points to its location.
- In particular, accounting secret must match that one configured in
- server and proper dictionary is used (one is available at
- etc/sip_dictionary). Also note that Debian radiusclient-ng uses
- /var/run/radius.seq as seqfile but &kamailio; Debian init script expects
- /var/run/kamailio/kamailio_radius.seq, so is needed to change it in
- radiusclient-ng configuration or in &kamailio; Debian init script (if not,
- &kamailio; can't create the seq file when not running as root). Uses along
- with FreeRadius (<ulink url='http://www.freeradius.org/'>
- http://www.freeradius.org/</ulink>) and Radiator
- (<ulink url='http://www.open.com.au/radiator/'>
- http://www.open.com.au/radiator/</ulink>) servers have been
- reported to us.
+ set defines: uncomment the DDIAM_ACC lines in
+ modules/acc/Makefile.
</para>
<para>
- NOTE: diameter support was developed for DISC (DIameter Server Client
- project at http://developer.berlios.de/projects/disc/). This project
- seems to be no longer maintained and DIAMETER specifications were updated
- in the meantime. Thus, the DIAMETER part in the module is obsolete and
- needs rework to be usable with opendiameter or other DIAMETER servers.
+ NOTE: diameter support was developed for DISC (DIameter Server Client
+ project at http://developer.berlios.de/projects/disc/). This project
+ seems to be no longer maintained and DIAMETER specifications were updated
+ in the meantime. Thus, the DIAMETER part in the module is obsolete and
+ needs rework to be usable with opendiameter or other DIAMETER servers.
</para>
<section>
<title>General Example</title>
@@ -485,11 +468,7 @@ $dlg_var(callee) = $avp(callee); #callee='C'
</para>
<itemizedlist>
<listitem>
- <para><emphasis>radiusclient-ng</emphasis> 0.5.0 or higher --
- if compiled with RADIUS support. See <ulink
- url='http://developer.berlios.de/projects/radiusclient-ng/'>
- http://developer.berlios.de/projects/radiusclient-ng/</ulink>.
- </para>
+ <para>None</para>
</listitem>
</itemizedlist>
</section>
From the README:
"The SQL backend support is compiled in the module. For RADIUS and DIAMETER you need to enable it by recompiling the module with properly set defines: uncomment the RAD_ACC or DDIAM_ACC lines in modules/acc/Makefile. To compile RADIUS support, you need to have radiusclient-ng (only versions higher or equal to 0.5.0) installed on your system which is available from http://developer.berlios.de/projects/radiusclient-ng/.”
This compile-time option is one of the few remaining that makes binary distributions hard - I don’t know how the debian packages handled this one.
Anyone that wants to attempt a way to handle this as modules instead? I don’t fancy adding diameter and radius support as a requirement
for compiling ACC but there has to be a way to follow the lead of the AUTH modules, with one generic module and then additional AUTH_RADIUS etc.
(Looking at you Carsten :-) )
/O
Module: kamailio
Branch: master
Commit: 2fb7bd770977e748efd2be90147a44ac96731285
URL: https://github.com/kamailio/kamailio/commit/2fb7bd770977e748efd2be90147a44a…
Author: Olle E. Johansson <oej(a)edvina.net>
Committer: Olle E. Johansson <oej(a)edvina.net>
Date: 2017-01-02T17:17:38+01:00
http_client Update devel documentation
---
Modified: src/modules/http_client/doc/http_client_devel.xml
---
Diff: https://github.com/kamailio/kamailio/commit/2fb7bd770977e748efd2be90147a44a…
Patch: https://github.com/kamailio/kamailio/commit/2fb7bd770977e748efd2be90147a44a…
---
diff --git a/src/modules/http_client/doc/http_client_devel.xml b/src/modules/http_client/doc/http_client_devel.xml
index 049d107..80bb99b 100644
--- a/src/modules/http_client/doc/http_client_devel.xml
+++ b/src/modules/http_client/doc/http_client_devel.xml
@@ -13,10 +13,14 @@
<title>&develguide;</title>
<section>
+ This module provides a set of API functions that other modules can use in order to
+ integrate with HTTP services.
+ </section>
+ <section>
<title>Available Functions</title>
<section>
<title>
- <function moreinfo="none">http_connect(msg, connection, url, result, content_type, post)</function>
+ <function moreinfo="none">int http_connect(msg, connection, url, result, content_type, post)</function>
</title>
<para>
Sends HTTP GET or POST request to a given connection. If content_type and post
@@ -86,10 +90,10 @@
</section>
<section>
<title>
- <function moreinfo="none">http_query(msg, url, dest, post)</function>
+ <function moreinfo="none">int http_query(msg, url, dest, post)</function>
</title>
<para>
- Sends HTTP GET or POST request to a given connection. If post data
+ Sends a HTTP GET or POST request to a given connection. If post data
is defined, POST will be used, otherwise GET. The default settings
defined as module params of the http_client module will be used for
the connection.
@@ -99,7 +103,7 @@
<listitem>
<para><emphasis>struct sip_msg *msg</emphasis></para>
<para>
- The current sip message structure.
+ The current SIP message structure.
</para>
</listitem>
<listitem>
Module: kamailio
Branch: master
Commit: 00789326622272191605153dcbce84fb06d6b9f2
URL: https://github.com/kamailio/kamailio/commit/00789326622272191605153dcbce84f…
Author: Olle E. Johansson <oej(a)edvina.net>
Committer: Olle E. Johansson <oej(a)edvina.net>
Date: 2017-01-02T17:17:11+01:00
http_client Update README
---
Modified: src/modules/http_client/doc/http_client_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/00789326622272191605153dcbce84f…
Patch: https://github.com/kamailio/kamailio/commit/00789326622272191605153dcbce84f…
---
diff --git a/src/modules/http_client/doc/http_client_admin.xml b/src/modules/http_client/doc/http_client_admin.xml
index bb7b5a1..799f477 100644
--- a/src/modules/http_client/doc/http_client_admin.xml
+++ b/src/modules/http_client/doc/http_client_admin.xml
@@ -19,7 +19,8 @@
This module implements protocol functions that use the libcurl library
to fetch data from external HTTP servers or post data to HTTP servers.
The module is using a concept of "connections" to define properties
- of HTTP sessions in a simple way.
+ of HTTP sessions in a simple way. A connection has one or multiple
+ servers and a set of settings that apply to the specific connection.
</para>
<para>
The http_client module has multiple settings, some of them applies to
@@ -38,10 +39,11 @@
Cookbook (as used in the http_client_query example below).
</para>
<para>
- Function http_client_query allows &kamailio; to issue an HTTP GET
+ The function http_client_query allows &kamailio; to issue an HTTP GET
request and get access to parts of the reply. This function has
been ported from the utils module and now use the same libcurl
- functions.
+ functions. We recommend using the new functionality provided by
+ this module.
</para>
<para>
The http_client module use the CURL library setting up connections.