1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
/*
* $Id$
*
* Copyright (C) 2006 Voice Sistem SRLs
*
* This file is part of Kamailio, a free SIP server.
*
* 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
*
* 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.
*
* You should have received a copy of the GNU General Public License
* 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-04-11 initial version (bogdan)
* 2008-04-04 added direction reporting in dlg callbacks (bogdan)
* 2008-04-14 added new type of callback to be triggered when dialogs are
* loaded from DB (bogdan)
* 2008-04-17 added new type of callback to be triggered right before the
* dialog is destroyed (deleted from memory) (bogdan)
*/
#ifndef _DIALOG_DLG_CB_H_
#define _DIALOG_DLG_CB_H_
#include "../../parser/msg_parser.h"
struct dlg_cell;
struct dlg_cb_params {
struct sip_msg* req; /* sip request msg related to the callback event */
struct sip_msg* rpl; /* sip reply msg related to the callback event */
unsigned int direction; /* direction of the sip msg */
void *dlg_data; /* generic paramter, specific to callback */
void **param; /* parameter passed at callback registration*/
};
/* callback function prototype */
typedef void (dialog_cb) (struct dlg_cell* dlg, int type,
struct dlg_cb_params * params);
/* function to free the callback param */
typedef void (param_free_cb) (void *param);
/* register callback function prototype */
typedef int (*register_dlgcb_f)(struct dlg_cell* dlg, int cb_types,
dialog_cb f, void *param, param_free_cb ff);
/* method to set a variable within a dialog */
typedef int (*set_dlg_variable_f)( struct dlg_cell* dlg,
str* key,
str* val);
/* method to get a variable from a dialog */
typedef str* (*get_dlg_variable_f)( struct dlg_cell* dlg,
str* key);
#define DLGCB_LOADED (1<<0)
#define DLGCB_CREATED (1<<1)
#define DLGCB_FAILED (1<<2)
#define DLGCB_CONFIRMED_NA (1<<3)
#define DLGCB_CONFIRMED (1<<4)
#define DLGCB_REQ_WITHIN (1<<5)
#define DLGCB_TERMINATED (1<<6)
#define DLGCB_EXPIRED (1<<7)
#define DLGCB_EARLY (1<<8)
#define DLGCB_RESPONSE_FWDED (1<<9)
#define DLGCB_RESPONSE_WITHIN (1<<10)
#define DLGCB_MI_CONTEXT (1<<11)
#define DLGCB_RPC_CONTEXT (1<<12)
#define DLGCB_DESTROY (1<<13)
#define DLGCB_SPIRALED (1<<14)
#define DLGCB_TERMINATED_CONFIRMED (1<<15)
struct dlg_callback {
int types;
dialog_cb* callback;
void *param;
param_free_cb* callback_param_free;
struct dlg_callback* next;
};
struct dlg_head_cbl {
struct dlg_callback *first;
int types;
};
void destroy_dlg_callbacks(unsigned int type);
void destroy_dlg_callbacks_list(struct dlg_callback *cb);
int register_dlgcb( struct dlg_cell* dlg, int types, dialog_cb f, void *param, param_free_cb ff);
void run_create_callbacks(struct dlg_cell *dlg, struct sip_msg *msg);
void run_dlg_callbacks( int type ,
struct dlg_cell *dlg,
struct sip_msg *req,
struct sip_msg *rpl,
unsigned int dir,
void *dlg_data);
void run_load_callbacks( void );
/*!
* \brief Function that returns valid SIP message from given dialog callback parameter struct
* \param cb_params dialog callback parameter struct
* \return pointer to valid SIP message if existent, NULL otherwise
*/
static inline struct sip_msg *dlg_get_valid_msg(struct dlg_cb_params *cb_params)
{
struct sip_msg *msg;
if (cb_params == NULL) {
LM_ERR("no dialog parameters given\n");
return NULL;
}
msg = cb_params->req;
if (msg == NULL) {
msg = cb_params->rpl;
if (msg == NULL || msg == FAKED_REPLY) {
return NULL;
}
}
return msg;
};
#endif
|
