/usr/include/osipparser2/headers/osip_via.h is in libosip2-dev 3.3.0-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 | /*
The oSIP library implements the Session Initiation Protocol (SIP -rfc3261-)
Copyright (C) 2001,2002,2003,2004,2005,2006,2007 Aymeric MOIZARD jack@atosc.org
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library 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
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#ifndef _OSIP_VIA_H_
#define _OSIP_VIA_H_
#include <osipparser2/osip_list.h>
/**
* @file osip_via.h
* @brief oSIP osip_via header definition.
*/
/**
* @defgroup oSIP_VIA oSIP via header definition.
* @ingroup oSIP_HEADERS
* @{
*/
/**
* Structure for Via headers.
* @var osip_via_t
*/
typedef struct osip_via osip_via_t;
/**
* Definition of the Via header.
* @struct osip_via
*/
struct osip_via
{
char *version; /**< SIP Version */
char *protocol; /**< Protocol used by SIP Agent */
char *host; /**< Host where to send answers */
char *port; /**< Port where to send answers */
char *comment; /**< Comments about SIP Agent */
osip_list_t via_params; /**< Via parameters */
};
#ifdef __cplusplus
extern "C"
{
#endif
/**
* Allocate a Via element.
* @param header The element to work on.
*/
int osip_via_init (osip_via_t ** header);
/**
* Free a Via element.
* @param header The element to work on.
*/
void osip_via_free (osip_via_t * header);
/**
* Parse a Via element.
* @param header The element to work on.
* @param hvalue The string to parse.
*/
int osip_via_parse (osip_via_t * header, const char *hvalue);
/**
* Get a string representation of a Via element.
* @param header The element to work on.
* @param dest A pointer on the new allocated string.
*/
int osip_via_to_str (const osip_via_t * header, char **dest);
/**
* Clone a Via element.
* @param header The element to work on.
* @param dest A pointer on the copy of the element.
*/
int osip_via_clone (const osip_via_t * header, osip_via_t ** dest);
/**
* Set the SIP version in the Via element.
* @param header The element to work on.
* @param value The value of the element.
*/
#define osip_via_set_version via_set_version
void via_set_version (osip_via_t * header, char *value);
/**
* Get the SIP version from a Via header.
* @param header The element to work on.
*/
#define osip_via_get_version via_get_version
char *via_get_version (osip_via_t * header);
/**
* Set the protocol in the Via element.
* @param header The element to work on.
* @param value The value of the element.
*/
#define osip_via_set_protocol via_set_protocol
void via_set_protocol (osip_via_t * header, char *value);
/**
* Get the protocol from a Via header.
* @param header The element to work on.
*/
#define osip_via_get_protocol via_get_protocol
char *via_get_protocol (osip_via_t * header);
/**
* Set the host in the Via element.
* @param header The element to work on.
* @param value The value of the element.
*/
#define osip_via_set_host via_set_host
void via_set_host (osip_via_t * header, char *value);
/**
* Get the host from a Via header.
* @param header The element to work on.
*/
#define osip_via_get_host via_get_host
char *via_get_host (osip_via_t * header);
/**
* Set the port in the Via element.
* @param header The element to work on.
* @param value The value of the element.
*/
#define osip_via_set_port via_set_port
void via_set_port (osip_via_t * header, char *value);
/**
* Get the port from a Via header.
* @param header The element to work on.
*/
#define osip_via_get_port via_get_port
char *via_get_port (osip_via_t * header);
/**
* Set the comment in the Via element.
* @param header The element to work on.
* @param value The value of the element.
*/
#define osip_via_set_comment via_set_comment
void via_set_comment (osip_via_t * header, char *value);
/**
* Get the comment from a Via header.
* @param header The element to work on.
*/
#define osip_via_get_comment via_get_comment
char *via_get_comment (osip_via_t * header);
/**
* Allocate and add a hidden parameter element in a list.
* @param header The element to work on.
*/
#define osip_via_set_hidden(header) osip_generic_param_add((&(header)->via_params),osip_strdup("hidden"),NULL)
/**
* Allocate and add a ttl parameter element in a list.
* @param header The element to work on.
* @param value The token value.
*/
#define osip_via_set_ttl(header,value) osip_generic_param_add((&(header)->via_params),osip_strdup("ttl"),value)
/**
* Allocate and add a maddr parameter element in a list.
* @param header The element to work on.
* @param value The token value.
*/
#define osip_via_set_maddr(header,value) osip_generic_param_add((&(header)->via_params),osip_strdup("maddr"),value)
/**
* Allocate and add a received parameter element in a list.
* @param header The element to work on.
* @param value The token value.
*/
#define osip_via_set_received(header,value) osip_generic_param_add((&(header)->via_params),osip_strdup("received"),value)
/**
* Allocate and add a branch parameter element in a list.
* @param header The element to work on.
* @param value The token value.
*/
#define osip_via_set_branch(header,value) osip_generic_param_add((&(header)->via_params),osip_strdup("branch"),value)
/**
* Allocate and add a generic parameter element in a list.
* @param header The element to work on.
* @param name The token name.
* @param value The token value.
*/
#define osip_via_param_add(header,name,value) osip_generic_param_add((&(header)->via_params),name,value)
/**
* Find a header parameter in a Via element.
* @param header The element to work on.
* @param name The token name to search.
* @param dest A pointer on the element found.
*/
#define osip_via_param_get_byname(header,name,dest) osip_generic_param_get_byname((&(header)->via_params),name,dest)
/**
* Check if the Via headers match.
* NOTE: THIS IS AN INTERNAL METHOD ONLY
* @param via1 The first Via header.
* @param via2 The second Via header.
*/
int osip_via_match (osip_via_t * via1, osip_via_t * via2);
#ifdef __cplusplus
}
#endif
/** @} */
#endif
|