Logo Search packages:      
Sourcecode: sofia-sip version File versions  Download package


Go to the documentation of this file.
 * 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
 * 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>

#ifndef STRING0_H
#include <sofia-sip/string0.h>


/* @deprecated
 * These are just wrappers around msg_params_*() functions. 
 * Use msg_header_*_param() functions instead.
SOFIAPUBFUN char const *sip_params_find(sip_param_t const pp[],
                              char const *token);
SOFIAPUBFUN int sip_params_add(su_home_t *sh, 
                         sip_param_t **pparams,
                         char const *param);
SOFIAPUBFUN int sip_params_cmp(sip_param_t const a[], sip_param_t const b[]);
SOFIAPUBFUN int sip_params_replace(su_home_t *,
                           sip_param_t **pparams, char const *param);

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);

sip_contact_t *sip_contact_create_from_via(su_home_t *, sip_via_t const *,
                                 char const *user);

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
00094 #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 */
00129 enum sp_type { 
  sp_error = -1, 

/** Possible values for SIP media tags */
00139 union sip_pref
  /** Type of the media tag */
00142   enum sp_type sp_type;

  /** Literal (tag="foo"). */
00145   struct sp_literal {
    enum sp_type spl_type; 
    char const *spl_value;
    usize_t spl_length;
  } sp_literal;

  /** String (tag="&lt;foo&gt;"). */
00152   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").
00160   struct sp_range {
    enum sp_type spr_type;
    double spr_lower;
    double spr_upper;
  } 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);

 * Check if contact is immune to calleprefs.
 * @deprecated Use sip_contact_is_immune() instead.
00181 #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);

sip_security_client_t const *
sip_security_client_select(sip_security_client_t const *client,
                     sip_security_server_t const *server);


#endif /** !defined(SIP_UTIL_H) */

Generated by  Doxygen 1.6.0   Back to index