sr-dev July 2012

sr-dev@lists.kamailio.org

24 participants
172 discussions

Using t_suspend()/t_continue() multiple times on the same transaction
by Peter Dunkley 02 Jul '14

02 Jul '14

Hi, I am trying to use t_suspend()/t_continue() multiple times on the same transaction. Calling t_suspend() more than once works, but the second time I call t_continue() the transaction is killed and a 500 response is sent. It is the "if (branch == t->nr_of_outgoings)" check from the code fragment below (from t_suspend.c:t_continue()) that results in the transaction being killed - you can see the debug/error line I added to determine this in the fragment. Is using t_suspend()/t_continue() multiple times something that should work? Thanks, Peter if (t->uas.status < 200) { /* No final reply has been sent yet. * Check whether or not there is any pending branch. */ for ( branch = 0; branch < t->nr_of_outgoings; branch++ ) { if ((t->uac[branch].request.buffer != NULL) && (t->uac[branch].last_received < 200) ) break; } if (branch == t->nr_of_outgoings) { /* There is not any open branch so there is * no chance that a final response will be received. */ ret = 0; LM_ERR("branch == t->nr_of_outgoings\n"); goto kill_trans; } } -- Peter Dunkley Technical Director Crocodile RCS Ltd

5 12

git:master: modules_k/uac: uac_replace_from/to AUTO mode with dialog module
by Anca Vamanu 27 Jun '13

27 Jun '13

Module: sip-router Branch: master Commit: 0f702f6e236eb0cbb238bf83a0c4ae94d7b3cad8 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=0f702f6… Author: Anca Vamanu <anca.vamanu(a)1and1.ro> Committer: Anca Vamanu <anca.vamanu(a)1and1.ro> Date: Thu Jul 19 17:49:13 2012 +0300 modules_k/uac: uac_replace_from/to AUTO mode with dialog module Added a implementation for uac_replace_from/to() that uses the dialog module for AUTO mode. In this mode the URIs are stored as dialog variables. The change in tm module fixes a bug: if uac_replace_to() was called, the URI was not changed accordingly in Cancel. --- modules/tm/t_cancel.c | 5 +- modules_k/dialog/dialog.c | 2 + modules_k/dialog/dlg_load.h | 6 + modules_k/uac/README | 111 +++++++++++----- modules_k/uac/doc/uac_admin.xml | 68 +++++++++- modules_k/uac/replace.c | 292 ++++++++++++++++++++++++++++++--------- modules_k/uac/uac.c | 17 ++- 7 files changed, 393 insertions(+), 108 deletions(-) Diff: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commitdiff;h=0f7…

2 1

kamailio core at qm_status
by Jijo 01 Oct '12

01 Oct '12

Hi All, I'm observing a core intermittently at "qm_status (qm=0x786cd000) at mem/q_malloc.c:763" for kamailio version 3.1.0 looking at the backtrace this is occurring while doing a tcp buffer overrun. Please have a look and let me know if anyone observed this issue or how can we debug it. Please find the backtrace and kamailio version osbprod-V2R0:~ # /usr/sbin/kamailio -V version: kamailio 3.1.0 (i386/linux) 21a375 flags: STATS: Off, USE_IPV6, USE_TCP, USE_TLS, TLS_HOOKS, USE_RAW_SOCKS, DISABLE_NAGLE, USE_MCAST, DNS_IP_HACK, SHM_MEM, SHM_MMAP, PKG_MALLOC, DBG_QM_MALLOC, USE_FUTEX, FAST_LOCK-ADAPTIVE_WAIT, USE_DNS_CACHE, USE_DNS_FAILOVER, USE_NAPTR, USE_DST_BLACKLIST, HAVE_RESOLV_RES ADAPTIVE_WAIT_LOOPS=1024, MAX_RECV_BUFFER_SIZE 262144, MAX_LISTEN 16, MAX_URI_SIZE 1024, BUF_SIZE 65535, PKG_SIZE 15MB poll method support: poll, epoll_lt, epoll_et, sigio_rt, select. id: 21a375 compiled on 12:38:44 Apr 26 2012 with gcc 4.5.0 #0 qm_status (qm=0x786cd000) at mem/q_malloc.c:763 #1 0x0819c0f3 in qm_debug_frag (qm=0x786cd000, f=<value optimized out>) at mem/q_malloc.c:167 #2 0x0819c352 in qm_free (qm=0x786cd000, p=0x7a6cb6ac, file=0x821cce2 "<core>: tcp_main.c", func=0x822285f "wbufq_run", line=880) at mem/q_malloc.c:457 #3 0x0815f686 in wbufq_run (tcpconn=0x7a1a7548, ev=4, fd_i=-1) at tcp_main.c:880 #4 handle_tcpconn_ev (tcpconn=0x7a1a7548, ev=4, fd_i=-1) at tcp_main.c:4141 #5 0x08169bf2 in io_wait_loop_epoll () at io_wait.h:1092 #6 tcp_main_loop () at tcp_main.c:4606 #7 0x080b0404 in main_loop () at main.c:1655 #8 0x080b1f84 in main (argc=9, argv=0xbfb4c9f4) at main.c:2446 (gdb) l 758 LOG_(DEFAULT_FACILITY, memlog, "qm_status: ", 759 "dumping free list stats :\n"); 760 for(h=0,i=0;h<QM_HASH_SIZE;h++){ 761 unused=0; 762 for (f=qm->free_hash[h].head.u.nxt_free,j=0; 763 f!=&(qm->free_hash[h].head); f=f->u.nxt_free, i++, j++){ 764 if (!FRAG_WAS_USED(f)){ 765 unused++; 766 #ifdef DBG_QM_MALLOC 767 LOG_(DEFAULT_FACILITY, memlog, "qm_status: ",

4 7

Re: [sr-dev] [SR-Users] Outbound and Registrar. No binding update
by Iñaki Baz Castillo 02 Aug '12

02 Aug '12

Hi, full agree with this bug report. Adding the devel maillist. More comments at the end of the mail: 2012/7/26 José Luis Millán <jmillan(a)aliax.net>: > Hi, > > I'm using Kamilio 3.3.0 as registrar server. I`m using an outbound proxy so > 'use_path' parameter or 'registrar' module is enabled. > > According to RFC 5626, a re-registration from a specific combination of AoR, > instance_id and reg_id must update the binding. > > "" > If the registrar receives a re-registration for a specific > combination of AOR, and instance-id and reg-id values, the registrar > MUST update any information that uniquely identifies the network flow > over which the request arrived if that information has changed, and > SHOULD update the time the binding was last updated. > "" > > In my installation this is not fullfilled as shown: > > "" > AOR:: jmillan > Contact:: sip:jmillan@MY_IP;transport=ws;ov-ob=a570655c14 Q= > Expires:: 181 > Callid:: 1hgq3khalq2rzfr > Cseq:: 108 > User-agent:: JsSIP 0.1.0 > Path:: > <sip:OUTBOUND_IP:9090;transport=tcp;lr;ovid=de0c0b9f>,<sip:a570655c14@OUTBOUND_IP:10080;transport=ws;lr;ovid=de0c0b9f;ob> > State:: CS_SYNC > Flags:: 0 > Cflag:: 0 > Socket:: tcp:KAM_IP:5060 > Methods:: 783 > Ruid:: uloc-50119d99-328e-1 > Instance:: > <urn:uuid:38dce009-ae1f-4fd1-91dc-99ed9affddc1> > Reg-Id:: 1 > Contact:: sip:jmillan@MY_IP;transport=ws;ov-ob=1dd97b4d51 Q= > Expires:: 193 > Callid:: 1hgq3khalq2rzfr > Cseq:: 110 > User-agent:: JsSIP 0.1.0 > Path:: > <sip:OUTBOUND_IP:9090;transport=tcp;lr;ovid=de0c0b9f>,<sip:1dd97b4d51@OUTBOUND_IP:10080;transport=ws;lr;ovid=de0c0b9f;ob> > State:: CS_SYNC > Flags:: 0 > Cflag:: 0 > Socket:: tcp:KAM_IP:5060 > Methods:: 783 > Ruid:: uloc-50119d99-3290-2 > Instance:: > <urn:uuid:38dce009-ae1f-4fd1-91dc-99ed9affddc1> > Reg-Id:: 1 > "" > > The scenario is such that when the client looses the connection with the > Outbound Server, it reconnects and re-registers to Kamailio in order to > replace registration and be able to receive in-dialog messages. Receiving in-dialog requests should work since GRUU is also being used. The problem is that the new REGISTER (after UA disconnection) does not update the previous one (as this thread reports) so Kamailio still chooses the previous binding which does not work anymore. Regards. -- Iñaki Baz Castillo <ibc(a)aliax.net>

4 18

planning release of v3.3.1
by Daniel-Constantin Mierla 02 Aug '12

02 Aug '12

Hello, I am planning to package v3.3.1 out of the latest branch 3.3 this Thursday, August 2. If you are aware of issues that are not listed on the tracker (http://sip-router.org/tracker/), add them there to see what can be sorted out before. Cheers, Daniel -- Daniel-Constantin Mierla - http://www.asipto.com http://twitter.com/#!/miconda - http://www.linkedin.com/in/miconda Kamailio Advanced Training, Seattle, USA, Sep 23-26, 2012 - http://asipto.com/u/katu Kamailio Practical Workshop, Netherlands, Sep 10-12, 2012 - http://asipto.com/u/kpw

1 1

New Wiki Site has problems?
by Andrew Pogrebennyk 31 Jul '12

31 Jul '12

At least some links at http://www.kamailio.org/wiki/ don't work at the moment: Install Kamailio v3.3.x From GIT Upgrade Kamailio v3.1.x to v3.2.0 Upgrade Kamailio v3.2.x to v3.3.0 you are redirected to some instruction from DokuWiki Installer when trying to visit them. Could somebody please check it? Thanks. Andrew

2 1

[tracker] Task opened: Kamailio version 3.1.2 crash when memory realloc
by sip-router 30 Jul '12

30 Jul '12

THIS IS AN AUTOMATED MESSAGE, DO NOT REPLY. A new Flyspray task has been opened. Details are below. User who did this - Bruno Bresciani de Sousa (bruno.bresciani) Attached to Project - sip-router Summary - Kamailio version 3.1.2 crash when memory realloc Task Type - Bug Report Category - Core Status - Unconfirmed Assigned To - Operating System - Linux Severity - Critical Priority - Normal Reported Version - 3.1 Due in Version - Undecided Due Date - Undecided Details - Kamailio version 3.1.2 crash when memory realloc... I observed two crashes at 0x08173bf0 in fm_realloc (qm=0xb5f7d000, p=0xb61f0bc0, size=0) at mem/f_malloc.c:536. I don't know exactly what may be caused this core because the debug of kamailio is disabled, but looking at backtrace (gdb) and source code I could notice a relationship with TLS connection establishment (handshake). Other important fact is that core was generated by the kamalio itself with signal 6 (abort) because it can't find the pointer to memory realloc. Bellow is backtrace full with gdb: Core was generated by `/home2/local/kamailio/sbin/kamailio -P /var/run/kamailio.pid'. Program terminated with signal 6, Aborted. #0 0x00f30402 in __kernel_vsyscall () (gdb) (gdb) (gdb) (gdb) (gdb) bt full #0 0x00f30402 in __kernel_vsyscall () No symbol table info available. #1 0x009fec10 in raise () from /lib/libc.so.6 No symbol table info available. #2 0x00a00521 in abort () from /lib/libc.so.6 No symbol table info available. #3 0x08173bf0 in fm_realloc (qm=0xb5f7d000, p=0xb61f0bc0, size=0) at mem/f_malloc.c:536 f = (struct fm_frag *) 0xb61f0bb8 pf = <value optimized out> orig_size = 18 L=ÃbÂ¬Ã2n = (struct fm_frag *) 0xb61f0bd2 ptr = <value optimized out> hash = 23548 #4 0x0051a87f in ser_realloc (ptr=0xb61f0bc0, size=32) at ../../mem/shm_mem.h:266 No locals. #5 0x00460295 in OPENSSL_cleanse () from /lib/libcrypto.so.6 No symbol table info available. #6 0x004609f7 in CRYPTO_realloc () from /lib/libcrypto.so.6 No symbol table info available. #7 0x003efb22 in sk_insert () from /lib/libcrypto.so.6 No symbol table info available. #8 0x003efbaa in sk_push () from /lib/libcrypto.so.6 No symbol table info available. #9 0x007c2ac3 in ssl_bytes_to_cipher_list () from /lib/libssl.so.6 No symbol table info available. #10 0x007aa9f3 in ssl3_get_client_hello () from /lib/libssl.so.6 No symbol table info available. #11 0x007ab815 in ssl3_accept () from /lib/libssl.so.6 No symbol table info available. #12 0x007c1c3a in SSL_accept () from /lib/libssl.so.6 No symbol table info available. #13 0x005278e3 in tls_accept (c=0xb621af88, error=0xbf91dfc8) at tls_server.c:346 ret = <value optimized out> ssl = (SSL *) 0xb61c1878 cert = <value optimized out> tls_c = (struct tls_extra_data *) 0xb6208e58 tls_log = <value optimized out> #14 0x0052da8e in tls_read_f (c=0xb621af88, flags=0xbf91e200) at tls_server.c:1028 r = (struct tcp_req *) 0xb621affc bytes_free = 4095 bytes_read = 70 read_size = 4095 ssl_error = 0 ssl_read = 0 ssl = (SSL *) 0xb61c1878 rd_buf = "\026\003\001\000A\001\000\000=\003\001OÃ¿\vÂ¡ywP\fkÃDÃ 0/\000\a\000\005\001\000ÃÃÃÃ¯000\000\026\0009\0008\0005\000\026\000\023\000\n\0003\0002\00 202i<Ã¤<Ã¥Ã¾\031Ã¬234Â \237Ãª030Y){lÑ¶"...06Ã'Ãr9Ã¬Ã«Â¸{[Â©\t\205\037\036Ã¿HPH5Âµ\t(Ã©32Ã027Ã¦Ã²036Â¾\"\rÔ¤YÃ215uÂº\027)Ã¶000Ã±215\vÃÃ Ã©Ea\023xÃ©J\206T\204CÃ wr_buf = "\027\003\001\003Â wÂ²'\016Ñ¼Ã033ÃLÃ021Ã)Ã\220hnLÂ¦\020XÃª\236\200\tIhÃÂ¸Sf\234Ã\rÃ ?Â¯Â¼\024FÃ\200Âª/\2264RÃaÃÂ¤IpXÂ»Â¨Ã035Ã¤Qh\211Ã026Ã½4ÃU+\asrÂ£/`Â¤OÃ»1AÊ¹qUÜ¿Â·vÂ±Ã¼\205"... rd = {buf = 0xbf90dfa4 "\026\003\001", pos = 70, used = 70, size = 65536} wr = { buf = 0xbf8fdfa4 "\027\003\001\003Â wÂ²'\016Ñ¼Ã033ÃLÃ021Ã)Ã\220hnLÂ¦\020XÃª\236\200\tIhÃÂ¸Sf\234Ã\rÃ ?Â¯Â¼\024FÃ\200Âª/\2264RÃaÃÂ¤IpXÂ»Â¨Ã035Ã¤Qh\211Ã026Ã½4ÃU+\asrÂ£/`Â¤OÃ»1AÊ¹qUÜ¿Â·vÂ±Ã¼\205"..., pos = 0, used = 0, size = 65536} tls_c = (struct tls_extra_data *) 0xb6208e58 enc_rd_buf = (struct tls_rd_buf *) 0x0 n = 0 flush_flags = <value optimized out> err_src = 0x541a83 "TLS read:" x = <value optimized out> #15 0x08158ade in tcp_read_headers (c=0xb621af88, read_flags=0xbf91e200) at tcp_read.c:406 bytes = -1 remaining = <value optimized out> p = <value optimized out> r = (struct tcp_req *) 0xb621affc #16 0x08158fd4 in tcp_read_req (con=0xb621af88, bytes_read=0xbf91e204, read_flags=0xbf91e200) at tcp_read.c:871 bytes = <value optimized out> total_bytes = 0 resp = <value optimized out> size = <value optimized out> req = (struct tcp_req *) 0xb621affc dst = {send_sock = 0x1, to = {s = {sa_family = 57540, sa_data = "\221Â¿\020\000\000\000\000\000\000\000\020\000\000"}, sin = {sin_family = 57540, sin_port = 49041, sin_addr = {s_addr = 16}, sin_zero = "\000\000\000\000\020\000\000"}, sin6 = {sin6_family = 57540, sin6_port = 49041, sin6_flowinfo = 16, sin6_addr = {in6_u = {u6_addr8 = "\000\000\000\000\020\000\000\000\001\000\000\000\001\000\000", u6_addr16 = {0, 0, 16, 0, 1, 0, 1, 0}, u6_addr32 = {0, 16, 1, 1}}}, sin6_scope_id = 12}}, id = -1080958468, proto = 4 '\004', send_flags = {f = 0 '\0', blst_imask = 0 '\0'}} c = 10 '\n' #17 0x08159a0f in handle_io (fm=0x83296b0, events=1, idx=-1) at tcp_read.c:1150 ret = 4 n = 4 read_flags = 1 con = (struct tcp_connection *) 0xb621af88 s = 12 resp = <value optimized out> t = <value optimized out> #18 0x0815d653 in tcp_receive_loop (unix_sock=35) at io_wait.h:1091 No locals. ---Type <return> to continue, or q <return> to quit--- #19 0x0812885b in tcp_init_children () at tcp_main.c:4819 r = 3 reader_fd_1 = 35 pid = <value optimized out> si = <value optimized out> #20 0x080ad412 in main_loop () at main.c:1632 i = 4 pid = <value optimized out> si = (struct socket_info *) 0x0 si_desc = "udp receiver child=3 sock=192.168.166.31:5060\000\221Â¿\002\000\000\000/\200\220\000\001\000\000\000\000\000H\000Â¨Ã¤21Â¿\001\000\000\000Â°Â¶Ã¨026Â¶\000\000\000\000\000ÃÂµ\030s2\b\002\000\000\000Ã¢f\b\000ÃÂµ\001\000\000\000\000\000\000\000\001\000\000\000\000\000\000\000Ã¿Ã¿Ã¿Ã¿Â¸Ã¤21Â¿" #21 0x080afbe7 in main (argc=3, argv=dwarf2_read_address: Corrupted DWARF expression. ) at main.c:2398 cfg_stream = (FILE *) 0x8a2d008 c = <value optimized out> r = 0 tmp = 0xbf91e674 "\212Ã¾\221Â¿\233Ã¾\221Â¿Â°Ã¾\221Â¿Â»Ã¾\221Â¿Ã\221Â¿Ã¹1Â¿\020Ã¿\221Â¿DÃ¿\221Â¿LÃ¿\221Â¿WÃ¿\221Â¿]Ã¿\221Â¿oÃ¿\221Â¿{Ã¿\221Â¿\202Ã¿\221 tmp_len = 10492229 port = 136192361 proto = -1080957480 ret = <value optimized out> seed = 21782655 rfd = 4 debug_save = <value optimized out> debug_flag = 0 dont_fork_cnt = 0 n_lst = <value optimized out> p = <value optimized out> More information can be found at the following URL: http://sip-router.org/tracker/index.php?do=details&task_id=247 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.

1 0

git:master: register(k): pack contact info based on header for searching existing ul records
by Daniel-Constantin Mierla 30 Jul '12

30 Jul '12

Module: sip-router Branch: master Commit: efa3099252ca5d200bef6ce71df33f33b55f9941 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=efa3099… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Mon Jul 30 12:57:09 2012 +0200 register(k): pack contact info based on header for searching existing ul records - not using the contact header resulted in omitting instance and reg-id parameters, not following gruu/ob extensions, ending in duplicate records for same +sip.instance - reported by José Luis Millán --- modules_k/registrar/save.c | 22 ++++++++++------------ 1 files changed, 10 insertions(+), 12 deletions(-) diff --git a/modules_k/registrar/save.c b/modules_k/registrar/save.c index 4b3eda2..517f12e 100644 --- a/modules_k/registrar/save.c +++ b/modules_k/registrar/save.c @@ -302,6 +302,10 @@ static inline ucontact_info_t* pack_ci( struct sip_msg* _m, contact_t* _c, } if(_c!=0) { + /* hook uri address - should be more than 'sip:' chars */ + if(_c->uri.s!=NULL && _c->uri.len>4) + ci.c = &_c->uri; + /* Calculate q value of the contact */ if (calc_contact_q(_c->q, &ci.q) < 0) { rerrno = R_INV_Q; @@ -651,6 +655,12 @@ static inline int update_contacts(struct sip_msg* _m, urecord_t* _r, /* calculate expires */ calc_contact_expires(_m, _c->expires, &expires); + /* pack the contact info */ + if ( (ci=pack_ci( 0, _c, expires, 0))==0 ) { + LM_ERR("failed to pack contact specific info\n"); + goto error; + } + /* search for the contact*/ ret = ul.get_ucontact_by_instance( _r, &_c->uri, ci, &c); if (ret==-1) { @@ -668,12 +678,6 @@ static inline int update_contacts(struct sip_msg* _m, urecord_t* _r, if (expires==0) continue; - /* pack the contact_info */ - if ( (ci=pack_ci( 0, _c, expires, 0))==0 ) { - LM_ERR("failed to extract contact info\n"); - goto error; - } - if (ul.insert_ucontact( _r, &_c->uri, ci, &c) < 0) { rerrno = R_UL_INS_C; LM_ERR("failed to insert contact\n"); @@ -710,12 +714,6 @@ static inline int update_contacts(struct sip_msg* _m, urecord_t* _r, rc = 3; } else { /* do update */ - /* pack the contact specific info */ - if ( (ci=pack_ci( 0, _c, expires, 0))==0 ) { - LM_ERR("failed to pack contact specific info\n"); - goto error; - } - if(_mode) { ptr=_r->contacts;

1 0

git:master: usrloc(k): on ul update, re-clone uri and callid if instance is set
by Daniel-Constantin Mierla 30 Jul '12

30 Jul '12

Module: sip-router Branch: master Commit: a7cad776a514b0ec73a5c40b7971af8e0f0da92b URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=a7cad77… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Mon Jul 30 12:55:36 2012 +0200 usrloc(k): on ul update, re-clone uri and callid if instance is set - changes can happen when gruu/ob is enabled as the UA can get different address for same instance --- modules_k/usrloc/ucontact.c | 11 ++++++++--- modules_k/usrloc/usrloc.h | 1 + 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/modules_k/usrloc/ucontact.c b/modules_k/usrloc/ucontact.c index 2d07a26..ac76e9b 100644 --- a/modules_k/usrloc/ucontact.c +++ b/modules_k/usrloc/ucontact.c @@ -218,9 +218,14 @@ int mem_update_ucontact(ucontact_t* _c, ucontact_info_t* _ci) char* ptr; - /* No need to update Callid as it is constant - * per ucontact (set at insert time) -bogdan */ - + if(_ci->instance.s!=NULL && _ci->instance.len>0) + { + /* when we have instance set, update contact address and call-id */ + if(_ci->c!=NULL && _ci->c->s!=NULL && _ci->c->len>0) + update_str( &_c->c, _ci->c); + if(_ci->callid!=NULL && _ci->callid->s!=NULL && _ci->callid->len>0) + update_str( &_c->callid, _ci->callid); + } update_str( &_c->user_agent, _ci->user_agent); if (_ci->received.s && _ci->received.len) { diff --git a/modules_k/usrloc/usrloc.h b/modules_k/usrloc/usrloc.h index d08632b..bfd225a 100644 --- a/modules_k/usrloc/usrloc.h +++ b/modules_k/usrloc/usrloc.h @@ -94,6 +94,7 @@ typedef struct ucontact { /*! \brief Informations related to a contact */ typedef struct ucontact_info { str ruid; /*!< Pointer to record internal unique id */ + str *c; /*!< Contact address */ str received; /*!< Received interface */ str* path; /*!< Path informations */ time_t expires; /*!< Contact expires */

1 0

git:master: db_sqlite: added notes about usage in readme
by Daniel-Constantin Mierla 30 Jul '12

30 Jul '12

Module: sip-router Branch: master Commit: 72942d8441e04c6f92c8072a373e1f0a9dcc0e61 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=72942d8… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Mon Jul 30 11:18:28 2012 +0200 db_sqlite: added notes about usage in readme - based on content by Meftah Tayeb --- modules_k/db_sqlite/README | 40 +++++++++++++++++++++++++-- modules_k/db_sqlite/doc/db_sqlite_admin.xml | 40 +++++++++++++++++++++++++++ 2 files changed, 77 insertions(+), 3 deletions(-) diff --git a/modules_k/db_sqlite/README b/modules_k/db_sqlite/README index a1ef4fa..34d1302 100644 --- a/modules_k/db_sqlite/README +++ b/modules_k/db_sqlite/README @@ -1,12 +1,12 @@ SQlite Module -Timo Teräs +Timo Ter�s Edited by -Timo Teräs +Timo Ter�s - Copyright © 2011 Timo Teräs + Copyright � 2011 Timo Ter�s __________________________________________________________________ Table of Contents @@ -21,6 +21,13 @@ Timo Teräs 3. Parameters 4. Functions + 5. Usage + + List of Examples + + 1.1. loading the module usage + 1.2. db_url module parameter usage + 1.3. DBURL define usage Chapter 1. Admin Guide @@ -34,6 +41,7 @@ Chapter 1. Admin Guide 3. Parameters 4. Functions + 5. Usage 1. Overview @@ -65,3 +73,29 @@ Chapter 1. Admin Guide 4. Functions NONE + +5. Usage + + To use the module, first you have to load it in the Kamailio + configuration file. + + Example 1.1. loading the module usage +... +loadmodule "db_sqlite.so" +... + + Then set the db_url (or similar) parameter of modules that have to use + the SQLite database to driver part 'sqlite://', followed by the path to + database file. For example: + + Example 1.2. db_url module parameter usage +... +modparam("auth_db", "db_url", "sqlite:///etc/kamailio/kamailio.db") +... + + In the default config file, defined token DBURL can be updated like: + + Example 1.3. DBURL define usage +... +#!define DBURL "sqlite:///etc/kamailio/kamailio.db" +... diff --git a/modules_k/db_sqlite/doc/db_sqlite_admin.xml b/modules_k/db_sqlite/doc/db_sqlite_admin.xml index 43c2d5d..8c11032 100644 --- a/modules_k/db_sqlite/doc/db_sqlite_admin.xml +++ b/modules_k/db_sqlite/doc/db_sqlite_admin.xml @@ -74,5 +74,45 @@ NONE </para> </section> + + <section> + <title>Usage</title> + <para> + To use the module, first you have to load it in the &kamailio; + configuration file. + </para> + <example> + <title><function>loading the module</function> usage</title> + <programlisting format="linespecific"> +... +loadmodule "db_sqlite.so" +... +</programlisting> + </example> + <para> + Then set the db_url (or similar) parameter of modules that have to + use the SQLite database to driver part 'sqlite://', followed by the + path to database file. For example: + </para> + <example> + <title><function>db_url module parameter</function> usage</title> + <programlisting format="linespecific"> +... +modparam("auth_db", "db_url", "sqlite:///etc/kamailio/kamailio.db") +... +</programlisting> + </example> + <para> + In the default config file, defined token DBURL can be updated like: + </para> + <example> + <title><function>DBURL define</function> usage</title> + <programlisting format="linespecific"> +... +#!define DBURL "sqlite:///etc/kamailio/kamailio.db" +... +</programlisting> + </example> + </section> </chapter>

1 0

Jump to page:

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

sr-dev July 2012