diff options
Diffstat (limited to 'tinySIP/src/api/tsip_api_common.c')
-rw-r--r-- | tinySIP/src/api/tsip_api_common.c | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/tinySIP/src/api/tsip_api_common.c b/tinySIP/src/api/tsip_api_common.c new file mode 100644 index 0000000..4261fd5 --- /dev/null +++ b/tinySIP/src/api/tsip_api_common.c @@ -0,0 +1,134 @@ +/* +* Copyright (C) 2010-2011 Mamadou Diop. +* +* Contact: Mamadou Diop <diopmamadou(at)doubango[dot]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_common.c + * @brief Public common functions. + * + * @author Mamadou Diop <diopmamadou(at)doubango[dot]org> + * + + */ +#include "tinysip/api/tsip_api_common.h" + +#include "tinysip/tsip_action.h" + +#include "tsk_runnable.h" +#include "tsk_debug.h" + +/* Internal functions */ +extern tsip_action_t* _tsip_action_create(tsip_action_type_t type, va_list* app); +/* Local functions */ +int _tsip_api_common_any(const tsip_ssession_handle_t *ss, tsip_action_type_t type, va_list* app); + +/* internal function used to execute any user action +* can only handle session with dialogs */ +int _tsip_api_common_any(const tsip_ssession_handle_t *ss, tsip_action_type_t type, va_list* app) +{ + int ret = -1; + tsip_action_t* action; + const tsip_ssession_t* _ss; + + /* Checks for validity */ + 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; + } + + /* execute action */ + if((action = _tsip_action_create(type, app))){ + ret = tsip_ssession_handle(_ss, action); + TSK_OBJECT_SAFE_FREE(action); + } + return ret; +} + +/**@ingroup tsip_action_group +* Rejects an incoming request. +* @param ss The SIP Session managing the dialog on which the request has been received. +* @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. +*/ +int tsip_api_common_reject(const tsip_ssession_handle_t *ss, ...) +{ + int ret = -1; + va_list ap; + + va_start(ap, ss); + if((ret = _tsip_api_common_any(ss, tsip_atype_reject, &ap))){ + TSK_DEBUG_ERROR("Reject() failed."); + } + va_end(ap); + + return ret; +} + +/**@ingroup tsip_action_group +* Hangs up a session. +* @param ss The SIP Session to hang-up. Will send an unREGISTER or unSUBSCRIBE or unPUBLISH or +* BYE etc depending on the type of the SIP dialog managed by the session. +* @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. +*/ +int tsip_api_common_hangup(const tsip_ssession_handle_t *ss, ...) +{ + int ret = -1; + va_list ap; + + va_start(ap, ss); + if((ret = _tsip_api_common_any(ss, tsip_atype_hangup, &ap))){ + TSK_DEBUG_ERROR("Hang-up() failed."); + } + va_end(ap); + + return ret; +} + +/**@ingroup tsip_action_group +* Accepts an incoming request. +* @param ss The SIP Session managing the dialog on which the request has been received. +* @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. +*/ +int tsip_api_common_accept(const tsip_ssession_handle_t *ss, ...) +{ + int ret = -1; + va_list ap; + + va_start(ap, ss); + if((ret = _tsip_api_common_any(ss, tsip_atype_accept, &ap))){ + TSK_DEBUG_ERROR("Accept() failed."); + } + va_end(ap); + + return ret; +} + + |