diff options
Diffstat (limited to 'tinySIP/src/api/tsip_api_register.c')
-rw-r--r-- | tinySIP/src/api/tsip_api_register.c | 166 |
1 files changed, 166 insertions, 0 deletions
diff --git a/tinySIP/src/api/tsip_api_register.c b/tinySIP/src/api/tsip_api_register.c new file mode 100644 index 0000000..2e2cb29 --- /dev/null +++ b/tinySIP/src/api/tsip_api_register.c @@ -0,0 +1,166 @@ +/* +* Copyright (C) 2009-2010 Mamadou Diop. +* +* Contact: Mamadou Diop <diopmamadou(at)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_api_register.c + * @brief Public registration (REGISTER) functions. + * + * @author Mamadou Diop <diopmamadou(at)doubango.org> + * + * @date Created: Sat Nov 8 16:54:58 2009 mdiop + */ +#include "tinysip/api/tsip_api_register.h" + +#include "tinysip/dialogs/tsip_dialog_layer.h" +#include "tinysip/dialogs/tsip_dialog_register.h" + +#include "tsip.h" +#include "tinysip/tsip_action.h" + +#include "tsk_runnable.h" +#include "tsk_debug.h" + +#define TSIP_REGISTER_EVENT_CREATE( type) tsk_object_new(tsip_register_event_def_t, type) + +/* Internal functions */ +extern tsip_action_t* _tsip_action_create(tsip_action_type_t type, va_list* app); +extern int _tsip_action_ANY(const tsip_ssession_handle_t *ss, tsip_action_type_t type, va_list* app); + +/* internal function used to signal evant from REGISTER dialog to user app */ +int tsip_register_event_signal(tsip_register_event_type_t type, tsip_ssession_t* ss, short status_code, const char *phrase, const tsip_message_t* sipmessage) +{ + tsip_register_event_t* sipevent = TSIP_REGISTER_EVENT_CREATE(type); + tsip_event_init(TSIP_EVENT(sipevent), ss, status_code, phrase, sipmessage, tsip_event_register); + + TSK_RUNNABLE_ENQUEUE_OBJECT(TSK_RUNNABLE(ss->stack), sipevent); + + return 0; +} + +/**@ingroup tsip_action_group +* Sends SIP REGISTER request. If the session is already established, the same dialog will +* be used (refresh). +* @param ss The SIP Session managing the REGISTER dialog. +* @param ... Any TSIP_ACTION_SET_*() macros. e.g. @ref TSIP_ACTION_SET_HEADER(). +* MUST always ends with @ref TSIP_ACTION_SET_NULL(). +* @retval Zero if succeed and non-zero error code otherwise. +* @sa @ref tsip_action_UNREGISTER +*/ +int tsip_action_REGISTER(const tsip_ssession_handle_t *ss, ...) +{ + const tsip_ssession_t* _ss; + va_list ap; + tsip_action_t* action; + tsip_dialog_t* dialog; + int ret = -1; + + if(!(_ss = ss) || !_ss->stack){ + TSK_DEBUG_ERROR("Invalid parameter."); + return ret; + } + + /* Checks if the stack has been started */ + if(!TSK_RUNNABLE(_ss->stack)->started){ + TSK_DEBUG_ERROR("Stack not started."); + return -2; + } + + /* performs action */ + va_start(ap, ss); + if((action = _tsip_action_create(tsip_atype_register, &ap))){ + if(!(dialog = tsip_dialog_layer_find_by_ss(_ss->stack->layer_dialog, _ss))){ + dialog = tsip_dialog_layer_new(_ss->stack->layer_dialog, tsip_dialog_REGISTER, _ss); + } + ret = tsip_dialog_fsm_act(dialog, action->type, tsk_null, action); + + TSK_OBJECT_SAFE_FREE(dialog); + TSK_OBJECT_SAFE_FREE(action); + } + va_end(ap); + + return ret; +} + +/**@ingroup tsip_action_group +* Sends SIP unREGISTER request (expires=0). The session should be already established. +* @param ss The SIP Session managing the REGISTER dialog. +* @param ... Any TSIP_ACTION_SET_*() macros. e.g. @ref TSIP_ACTION_SET_HEADER(). +* MUST always ends with @ref TSIP_ACTION_SET_NULL(). +* @retval Zero if succeed and non-zero error code otherwise. +* @sa @ref tsip_action_REGISTER +*/ +int tsip_action_UNREGISTER(const tsip_ssession_handle_t *ss, ...) +{ + int ret = -1; + va_list ap; + + va_start(ap, ss); + if((ret = _tsip_action_ANY(ss, tsip_atype_unregister, &ap))){ + TSK_DEBUG_ERROR("unREGISTER() failed."); + } + va_end(ap); + + return ret; +} + + + + + + + + + + +//======================================================== +// SIP REGISTER event object definition +// +static tsk_object_t* tsip_register_event_ctor(tsk_object_t * self, va_list * app) +{ + tsip_register_event_t *sipevent = self; + if(sipevent){ + sipevent->type = va_arg(*app, tsip_register_event_type_t); + } + return self; +} + +static tsk_object_t* tsip_register_event_dtor(tsk_object_t * self) +{ + tsip_register_event_t *sipevent = self; + if(sipevent){ + tsip_event_deinit(TSIP_EVENT(sipevent)); + } + return self; +} + +static int tsip_register_event_cmp(const tsk_object_t *obj1, const tsk_object_t *obj2) +{ + return -1; +} + +static const tsk_object_def_t tsip_register_event_def_s = +{ + sizeof(tsip_register_event_t), + tsip_register_event_ctor, + tsip_register_event_dtor, + tsip_register_event_cmp, +}; +const tsk_object_def_t *tsip_register_event_def_t = &tsip_register_event_def_s; |