doubango/tinySIP/include/tinysip/transactions/tsip_transac.h
c732d49e
 /*
74ca6d11
 * Copyright (C) 2020, University of the Basque Country (UPV/EHU)
c732d49e
 * Contact for licensing options: <licensing-mcpttclient(at)mcopenplatform(dot)com>
 *
 * The original file was part of Open Source Doubango Framework
 * Copyright (C) 2010-2011 Mamadou Diop.
 * Copyright (C) 2012 Doubango Telecom <http://doubango.org>
 *
 * This file is part of Open Source Doubango Framework.
 *
 * DOUBANGO 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 3 of the License, or
 * (at your option) any later version.
 *
 * DOUBANGO 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 DOUBANGO.
 *
 */
 
 /**@file tsip_transac.h
  * @brief SIP transaction base class as per RFC 3261 subclause 17.
  *
  * @author Mamadou Diop <diopmamadou(at)doubango[dot]org>
  *
 
  */
 #ifndef TINYSIP_TRANSAC_H
 #define TINYSIP_TRANSAC_H
 
 #include "tinysip_config.h"
 
 #include "tsip.h"
 #include "tinysip/tsip_timers.h"
 #include "tinysip/tsip_message.h"
 
 #include "tinysip/dialogs/tsip_dialog.h"
 
 #include "tsk_safeobj.h"
 #include "tsk_list.h"
 #include "tsk_fsm.h"
 
 TSIP_BEGIN_DECLS
 
 #define TSIP_TRANSAC(self)						((tsip_transac_t*)(self))
 #define TSIP_TRANSAC_GET_TYPE(self)				TSIP_TRANSAC((self))->type
 #define TSIP_TRANSAC_GET_FSM(self)				TSIP_TRANSAC((self))->fsm
 #define TSIP_TRANSAC_GET_SESSION(self)			((struct tsip_ssession_s*)(TSIP_TRANSAC_GET_DIALOG((self)) ? TSIP_TRANSAC_GET_DIALOG((self))->ss : tsk_null))
 #define TSIP_TRANSAC_GET_DIALOG(self)			((struct tsip_dialog_s*)(TSIP_TRANSAC_GET_DST((self))->type == tsip_transac_dst_type_dialog ? TSIP_TRANSAC_GET_DST((self))->dialog.dlg : tsk_null))
 #define TSIP_TRANSAC_GET_DST(self)				TSIP_TRANSAC((self))->dst
 #define TSIP_TRANSAC_GET_STACK(self)			TSIP_TRANSAC_GET_DST((self))->stack
 #define TSIP_TRANSAC_GET_TIMER_MGR(self)		TSIP_TRANSAC_GET_STACK((self))->timer_mgr
 
 #define TSIP_TRANSAC_IS_CLIENT(self)			((self) && ((self)->type == tsip_transac_type_ict || (self)->type == tsip_transac_type_nict))
 #define TSIP_TRANSAC_IS_SERVER(self)			!TSIP_TRANSAC_IS_CLIENT((self))
 
 #define TSIP_TRANSAC_MAGIC_COOKIE				"z9hG4bK"
 
 #define TSIP_TRANSAC_SYNC_BEGIN(self)			tsk_safeobj_lock(TSIP_TRANSAC(self))
 #define TSIP_TRANSAC_SYNC_END(self)				tsk_safeobj_unlock(TSIP_TRANSAC(self))
 
 #define TRANSAC_TIMER_SCHEDULE(name, TX) \
 	self->timer##TX.id = tsk_timer_mgr_global_schedule(self->timer##TX.timeout, TSK_TIMER_CALLBACK_F(tsip_transac_##name##_timer_callback), self)
 
 #define TRANSAC_TIMER_CANCEL(TX) \
 	tsk_timer_mgr_global_cancel(self->timer##TX.id)
 
 typedef enum tsip_transac_event_type_e
 {
 	tsip_transac_incoming_msg,
 	tsip_transac_outgoing_msg,
 	tsip_transac_canceled,
 	tsip_transac_terminated,
 	tsip_transac_timedout,
 	tsip_transac_error,
 	tsip_transac_transport_error
 }
 tsip_transac_event_type_t;
 
 /*typedef struct tsip_transac_event_s
 {
 	tsip_transac_event_type_t type;
 	const tsip_message_t *msg;
 }
 tsip_transac_event_t;
 
 #define TSIP_TRANSAC_EVENT_INIT(transac_event, type, msg)	\
 	transac_event.type = type;								\
 	transac_event.msg = msg;*/
 
 typedef int (*tsip_transac_event_callback_f)(const void *arg, tsip_transac_event_type_t type, const tsip_message_t *msg);
 #define TSIP_TRANSAC_EVENT_CALLBACK_F(callback)	 ((tsip_transac_event_callback_f)(callback))
 
 typedef enum tsip_transac_type_e
 {
 	tsip_transac_type_ict, /**< Invite Client Transaction. */
 	tsip_transac_type_ist, /**< Invite Server Transaction. */
 	tsip_transac_type_nict, /**< Non-Invite Client Transaction. */
 	tsip_transac_type_nist, /**< Non-Invite Server Transaction. */
 }
 tsip_transac_type_t;
 
 
 
 typedef enum tsip_transac_dst_type_e
 {
 	tsip_transac_dst_type_dialog,
 	tsip_transac_dst_type_net
 }
 tsip_transac_dst_type_t;
 
 typedef struct tsip_transac_dst_s
 {
 	TSK_DECLARE_OBJECT;
 
 	tsip_transac_dst_type_t type;
 	struct tsip_stack_s* stack;
 
 	union{
 		struct{
 			tsip_dialog_t *dlg;
 		}dialog;
 
 		//struct{
 		//}net;
 	};
 }
 tsip_transac_dst_t;
 #define TSIP_TRANSAC_DST(self)	((tsip_transac_dst_t*)(self))
 #define TSIP_DECLARE_TRANSAC_DST tsip_transac_dst_t __transac__
 
 
 typedef struct tsip_transac_s
 {
 	TSK_DECLARE_OBJECT;
 	
 	tsip_transac_type_t type;
 
 	struct tsip_transac_dst_s* dst;
 	tsk_fsm_t *fsm;
 	
 	tsk_bool_t reliable;
 	tsk_bool_t running;
 	tsk_bool_t initialized;
 	
 	char *branch;
 	
 	int32_t cseq_value;
 	char* cseq_method;
 	
 	char* callid;
 	
 	tsip_transac_event_callback_f callback;
 }
 tsip_transac_t;
 
 #define TSIP_DECLARE_TRANSAC tsip_transac_t __transac__
 
 typedef tsk_list_t tsip_transacs_L_t; /**< List of @ref tsip_transac_t elements. */
 /*
 ================================*/
 
 int tsip_transac_init(tsip_transac_t *self, tsip_transac_type_t type, int32_t cseq_value, const char* cseq_method, const char* callid, struct tsip_transac_dst_s* dst, tsk_fsm_state_id curr, tsk_fsm_state_id term);
 int tsip_transac_deinit(tsip_transac_t *self);
 int tsip_transac_start(tsip_transac_t *self, const tsip_request_t* request);
 int tsip_transac_deliver(tsip_transac_t* self, tsip_dialog_event_type_t event_type, const tsip_message_t *msg);
 int tsip_transac_send(tsip_transac_t *self, const char *branch, tsip_message_t *msg);
 int tsip_transac_cmp(const tsip_transac_t *t1, const tsip_transac_t *t2);
 int tsip_transac_remove(const tsip_transac_t* self);
 int tsip_transac_fsm_act(tsip_transac_t* self, tsk_fsm_action_id , const tsip_message_t*);
 
 
 struct tsip_transac_dst_s* tsip_transac_dst_dialog_create(tsip_dialog_t *dlg);
 struct tsip_transac_dst_s* tsip_transac_dst_net_create(struct tsip_stack_s* stack);
 
 TSIP_END_DECLS
 
 #endif /* TINYSIP_TRANSAC_H */