/*
* Copyright (C) 2020, University of the Basque Country (UPV/EHU)
* 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_header.h
* @brief Defines a SIP header (field-name: field-value).
*
* @author Mamadou Diop <diopmamadou(at)doubango[dot]org>
*
*/
#ifndef TINYSIP_HEADER_H
#define TINYSIP_HEADER_H
#include "tinysip_config.h"
#include "tsk_ragel_state.h"
#include "tsk_params.h"
#include "tsk_object.h"
#include "tsk_safeobj.h"
#include "tsk_memory.h"
#include "tsk_string.h"
#include "tsk_list.h"
#include "tsk_buffer.h"
TSIP_BEGIN_DECLS
struct tsip_header_s;
#define TSIP_HEADER(self) ((tsip_header_t*)(self))
#define TSIP_HEADER_PARAMS(self) (TSIP_HEADER(self)->params)
#define TSIP_HEADER_VALUE_SERIALIZE_F(self) ((tsip_header_value_serialize_f)(self))
#define TSIP_HEADER_GET_PARAM_VALUE_F(self) ((tsip_header_get_param_value_f)(self))
typedef int (*tsip_header_value_serialize_f)(const struct tsip_header_s* header, tsk_buffer_t* output);
typedef char* (*tsip_header_get_special_param_value_f)(const struct tsip_header_s* header, const char* pname);
/**
* @enum tsip_header_type_e
*
* @brief List of all supported headers.
**/
typedef enum tsip_header_type_e
{
tsip_htype_Accept,
tsip_htype_Accept_Contact,
tsip_htype_Accept_Encoding,
tsip_htype_Accept_Language,
tsip_htype_Accept_Resource_Priority,
tsip_htype_Alert_Info,
tsip_htype_Allow,
tsip_htype_Allow_Events,
tsip_htype_Authentication_Info,
tsip_htype_Authorization,
tsip_htype_Call_ID,
tsip_htype_Call_Info,
tsip_htype_Contact,
tsip_htype_Content_Disposition,
tsip_htype_Content_Encoding,
tsip_htype_Content_Language,
tsip_htype_Content_Length,
tsip_htype_Content_Type,
tsip_htype_Content_ID,
tsip_htype_CSeq,
tsip_htype_Date,
tsip_htype_Dummy,
tsip_htype_Error_Info,
tsip_htype_Event,
tsip_htype_Expires,
tsip_htype_From,
tsip_htype_History_Info,
tsip_htype_Identity,
tsip_htype_Identity_Info,
tsip_htype_In_Reply_To,
tsip_htype_Join,
tsip_htype_Max_Forwards,
tsip_htype_MIME_Version,
tsip_htype_Min_Expires,
tsip_htype_Min_SE,
tsip_htype_Organization,
tsip_htype_Path,
tsip_htype_Priv_Answer_Mode,
tsip_htype_Answer_Mode,
tsip_htype_Priority,
tsip_htype_Privacy,
tsip_htype_Proxy_Authenticate,
tsip_htype_Proxy_Authorization,
tsip_htype_Proxy_Require,
tsip_htype_RAck,
tsip_htype_Reason,
tsip_htype_Record_Route,
tsip_htype_Refer_Sub,
tsip_htype_Refer_To,
tsip_htype_Referred_By,
tsip_htype_Reject_Contact,
tsip_htype_Replaces,
tsip_htype_Reply_To,
tsip_htype_Request_Disposition,
tsip_htype_Require,
tsip_htype_Resource_Priority,
tsip_htype_Retry_After,
tsip_htype_Route,
tsip_htype_RSeq,
tsip_htype_Security_Client,
tsip_htype_Security_Server,
tsip_htype_Security_Verify,
tsip_htype_Server,
tsip_htype_Service_Route,
tsip_htype_Session_Expires,
tsip_htype_SIP_ETag,
tsip_htype_SIP_If_Match,
tsip_htype_Subject,
tsip_htype_Subscription_State,
tsip_htype_Supported,
tsip_htype_Target_Dialog,
tsip_htype_Timestamp,
tsip_htype_To,
tsip_htype_Unsupported,
tsip_htype_User_Agent,
tsip_htype_Via,
tsip_htype_Warning,
tsip_htype_WWW_Authenticate,
tsip_htype_P_Access_Network_Info,
tsip_htype_P_Answer_State,
tsip_htype_P_Asserted_Identity,
tsip_htype_P_Associated_URI,
tsip_htype_P_Called_Party_ID,
tsip_htype_P_Charging_Function_Addresses,
tsip_htype_P_Charging_Vector,
tsip_htype_P_DCS_Billing_Info,
tsip_htype_P_DCS_LAES,
tsip_htype_P_DCS_OSPS,
tsip_htype_P_DCS_Redirect,
tsip_htype_P_DCS_Trace_Party_ID,
tsip_htype_P_Early_Media,
tsip_htype_P_Media_Authorization,
tsip_htype_P_Preferred_Identity,
tsip_htype_P_Profile_Key,
tsip_htype_P_User_Database,
tsip_htype_P_Visited_Network_ID
}
tsip_header_type_t;
/*================================
*/
typedef struct tsip_header_s
{
TSK_DECLARE_OBJECT;
tsip_header_type_t type;
tsip_header_value_serialize_f serialize;
tsip_header_get_special_param_value_f get_special_param_value;
tsk_params_L_t *params;
}
tsip_header_t;
#define TSIP_DECLARE_HEADER tsip_header_t __header__
typedef tsk_list_t tsip_headers_L_t; /**< List of @ref tsip_header_t elements. */
/*
================================*/
TINYSIP_API const char *tsip_header_get_name(tsip_header_type_t type);
TINYSIP_API const char *tsip_header_get_name_2(const tsip_header_t *self);
TINYSIP_API char tsip_header_get_param_separator(const tsip_header_t *self);
TINYSIP_API int tsip_header_serialize(const tsip_header_t *self, tsk_buffer_t *output);
TINYSIP_API char* tsip_header_tostring(const tsip_header_t *self);
TINYSIP_API int tsip_header_value_serialize(const tsip_header_t *self, tsk_buffer_t *output);
TINYSIP_API char* tsip_header_value_tostring(const tsip_header_t *self);
TINYSIP_API char* tsip_header_get_param_value(const tsip_header_t *self, const char* pname);
#define TSIP_HEADER_HAVE_PARAM(self, name) ((self) && TSIP_HEADER((self))->params) ? tsk_params_have_param(TSIP_HEADER(self)->params, name) : tsk_false
#define TSIP_HEADER_ADD_PARAM(self, name, value) tsk_params_add_param((self) ? &TSIP_HEADER((self))->params : tsk_null, name, value)
#define TSIP_HEADER_REMOVE_PARAM(self, name) tsk_params_remove_param((self) ? TSIP_HEADER((self))->params : tsk_null, name)
#define TSIP_HEADER_GET_PARAM_BY_NAME(self, name) tsk_params_get_param_by_name((self) ? TSIP_HEADER((self))->params : tsk_null, name)
#define TSIP_HEADER_GET_PARAM_VALUE(self, name) tsk_params_get_param_value((self) ? TSIP_HEADER((self))->params : tsk_null, name)
#define TSIP_HEADER_GET_PARAM_VALUE_AS_INT(self, name) tsk_params_get_param_value_as_int((self) ? TSIP_HEADER((self))->params : tsk_null, name)
TSIP_END_DECLS
#endif /* TINYSIP_HEADERS_H */