/usr/include/sofia-sip-1.12/sofia-sip/sip_util.h is in libsofia-sip-ua-dev 1.12.11+20110422-1build1.
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 | /*
* This file is part of the Sofia-SIP package
*
* Copyright (C) 2005 Nokia Corporation.
*
* Contact: Pekka Pessi <pekka.pessi@nokia.com>
*
* 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., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA
*
*/
#ifndef SIP_UTIL_H
/** Defined when <sofia-sip/sip_util.h> has been included. */
#define SIP_UTIL_H
/**@file sofia-sip/sip_util.h
* @brief SIP utility functions
*
* @author Pekka Pessi <Pekka.Pessi@nokia.com>.
*
* @date Created: Thu Jun 8 19:28:55 2000 ppessi
*/
#ifndef SIP_H
#include <sofia-sip/sip.h>
#endif
#ifndef STRING0_H
#include <sofia-sip/string0.h>
#endif
#ifndef MSG_HEADER_H
#include <sofia-sip/msg_header.h>
#endif
SOFIA_BEGIN_DECLS
SOFIAPUBFUN
sip_contact_t *
sip_contact_create_from_via_with_transport(su_home_t *home,
sip_via_t const *v,
char const *user,
char const *transport);
SOFIAPUBFUN
sip_contact_t *sip_contact_create_from_via(su_home_t *, sip_via_t const *,
char const *user);
SOFIAPUBFUN
char *
sip_contact_string_from_via(su_home_t *home,
sip_via_t const *v,
char const *user,
char const *transport);
SOFIAPUBFUN int sip_transport_has_tls(char const *transport_name);
SOFIAPUBFUN int sip_response_terminates_dialog(int response_code,
sip_method_t method,
int *return_graceful_terminate);
SOFIAPUBFUN int sip_sanity_check(sip_t const *sip);
SOFIAPUBFUN unsigned sip_q_value(char const * q);
SOFIAPUBFUN url_t *sip_url_dup(su_home_t *sh, url_t const *o);
/**Add optional prefix and string to argument list if @a s is non-NULL.
* @HIDE
*/
#define SIP_STRLOG(prefix, s) ((s) ? (prefix) : ""), ((s) ? (s) : "")
SOFIAPUBFUN int sip_addr_match(sip_addr_t const *a, sip_addr_t const *b);
/* ----------------------------------------------------------------------
* Header-specific functions below
*/
SOFIAPUBFUN int sip_route_is_loose(sip_route_t const *r);
SOFIAPUBFUN sip_route_t *sip_route_remove(msg_t *msg, sip_t *sip);
SOFIAPUBFUN sip_route_t *sip_route_pop(msg_t *msg, sip_t *sip);
SOFIAPUBFUN sip_route_t *sip_route_follow(msg_t *msg, sip_t *sip);
SOFIAPUBFUN sip_route_t *sip_route_reverse(su_home_t *, sip_route_t const *);
SOFIAPUBFUN sip_route_t *sip_route_fixdup(su_home_t *, sip_route_t const *);
SOFIAPUBFUN sip_route_t *sip_route_fix(sip_route_t *route);
SOFIAPUBFUN sip_route_t *sip_route_fixdup_as(su_home_t *,
msg_hclass_t *,
sip_route_t const *);
SOFIAPUBFUN sip_route_t *sip_route_reverse_as(su_home_t *,
msg_hclass_t *,
sip_route_t const *);
SOFIAPUBFUN sip_via_t *sip_via_remove(msg_t *msg, sip_t *sip);
/* ---------------------------------------------------------------------- */
/* Caller preferences */
/** Check callerprefs. */
SOFIAPUBFUN int sip_prefs_matching(char const *pvalue,
char const *nvalue,
int *return_parse_error);
SOFIAPUBFUN int sip_is_callerpref(char const *param);
/** Type of the SIP media tag */
enum sp_type {
sp_error = -1,
sp_init,
sp_literal,
sp_string,
sp_range,
};
/** Possible values for SIP media tags */
union sip_pref
{
/** Type of the media tag */
enum sp_type sp_type;
/** Literal (tag="foo"). */
struct sp_literal {
enum sp_type spl_type;
char const *spl_value;
usize_t spl_length;
} sp_literal;
/** String (tag="<foo>"). */ /* (tag="<foo>") */
struct sp_string {
enum sp_type sps_type;
char const *sps_value;
usize_t sps_length;
} sp_string;
/** Numeric value or range (tag="#=1"; tag="#<=3"; tag="#>=-2"; tag="#1:6").
*/
struct sp_range {
enum sp_type spr_type;
double spr_lower; /**< Lower limit. Lowest value is -DBL_MAX. */
double spr_upper; /**< Upper limit. Highest value is DBL_MAX. */
} sp_range;
};
/** Parse a single preference */
SOFIAPUBFUN int sip_prefs_parse(union sip_pref *sp,
char const **in_out_s,
int *return_negation);
/** Match preferences */
SOFIAPUBFUN int sip_prefs_match(union sip_pref const *, union sip_pref const *);
SOFIAPUBFUN int sip_contact_is_immune(sip_contact_t const *m);
/**@internal
* Check if contact is immune to calleprefs.
* @deprecated Use sip_contact_is_immune() instead.
*/
#define sip_contact_immune(m) sip_contact_is_immune(m)
SOFIAPUBFUN sip_contact_t *sip_contact_immunize(su_home_t *home,
sip_contact_t const *m);
SOFIAPUBFUN int sip_contact_reject(sip_contact_t const *m,
sip_reject_contact_t const *rc);
SOFIAPUBFUN int sip_contact_accept(sip_contact_t const *m,
sip_accept_contact_t const *cp,
unsigned *return_S,
unsigned *return_N,
int *return_error);
SOFIAPUBFUN int sip_contact_score(sip_contact_t const *m,
sip_accept_contact_t const *ac,
sip_reject_contact_t const *rc);
SOFIAPUBFUN int sip_aor_strip(url_t *url);
/* sec-agree utility functions. */
SOFIAPUBFUN int sip_security_verify_compare(sip_security_server_t const *s,
sip_security_verify_t const *v,
char const **return_d_ver);
SOFIAPUBFUN
sip_security_client_t const *
sip_security_client_select(sip_security_client_t const *client,
sip_security_server_t const *server);
/* Compatibility stuff */
#define sip_params_add msg_params_add
#define sip_params_cmp msg_params_cmp
#define sip_params_replace msg_params_replace
#define sip_params_find msg_params_find
SOFIA_END_DECLS
#endif /** !defined(SIP_UTIL_H) */
|