cbf66550e3ab75d64a1acd5bcbb1a764027b25aa
[sip-router] / modules_k / rr / rr_cb.c
1 /*
2  * $Id$
3  *
4  * Copyright (C) 2005 Voice Sistem SRL
5  *
6  * This file is part of Kamailio, a free SIP server.
7  *
8  * Kamailio is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * as published by the Free Software Foundation; either version 2
11  * of the License, or (at your option) any later version.
12  *
13  * Kamailio is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
21  */
22
23 /*!
24  * \file
25  * \brief Route & Record-Route module, callback API
26  * \ingroup rr
27  */
28
29 #include "../../mem/mem.h"
30 #include "rr_cb.h"
31
32
33 /*! global callback list */
34 struct rr_callback* rrcb_hl = 0;  /* head list */
35
36
37 /*!
38  * \brief destroy global callback list, frees memory
39  */
40 void destroy_rrcb_lists(void)
41 {
42         struct rr_callback *cbp, *cbp_tmp;
43
44         for( cbp=rrcb_hl; cbp ; ) {
45                 cbp_tmp = cbp;
46                 cbp = cbp->next;
47                 pkg_free( cbp_tmp );
48         }
49 }
50
51
52 /*!
53  * \brief register a RR callback, allocates new private memory for it
54  * \param f callback register function
55  * \param param callback parameter
56  * \return 0 on success, -1 on failure (out of memory)
57  */
58 int register_rrcb( rr_cb_t f, void *param )
59 {
60         struct rr_callback *cbp;
61
62         /* build a new callback structure */
63         if (!(cbp=pkg_malloc( sizeof( struct rr_callback)))) {
64                 LM_ERR("no more pkg mem\n");
65                 return -1;
66         }
67
68         /* fill it up */
69         cbp->callback = f;
70         cbp->param = param;
71         /* link it at the beginning of the list */
72         cbp->next = rrcb_hl;
73         rrcb_hl = cbp;
74         /* set next id */
75         if (cbp->next)
76                 cbp->id = cbp->next->id+1;
77         else
78                 cbp->id = 0;
79
80         return 0;
81 }
82
83
84 /*!
85  * \brief run RR transaction callbacks
86  * \param req SIP request
87  * \param rr_param callback list
88  */
89 void run_rr_callbacks( struct sip_msg *req, str *rr_params )
90 {
91         str l_param;
92         struct rr_callback *cbp;
93
94         for ( cbp=rrcb_hl ; cbp ; cbp=cbp->next ) {
95                 l_param = *rr_params;
96                 LM_DBG("callback id %d entered with <%.*s>\n",
97                         cbp->id , l_param.len,l_param.s);
98                 cbp->callback( req, &l_param, cbp->param );
99         }
100 }