src/core/sdpmsg.h

   1 /**
   2  * @file sdpmsg.h
   3  *
   4  * pidgin-sipe
   5  *
   6  * Copyright (C) 2014 SIPE Project <http://sipe.sourceforge.net/>
   7  * Copyright (C) 2010 Jakub Adam <jakub.adam@ktknet.cz>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  22  */
  23
  24 struct sdpmsg {
  25         gchar           *ip;    /* currently this has to be an IPv4 address */
  26         GSList          *media;
  27         SipeIceVersion   ice_version;
  28 };
  29
  30 struct sdpmedia {
  31         gchar           *name;
  32         gchar           *ip;    /* currently this has to be an IPv4 address */
  33         guint            port;
  34
  35         GSList          *attributes;
  36         GSList          *candidates;
  37         GSList          *codecs;
  38         GSList          *remote_candidates;
  39 };
  40
  41 struct sdpcandidate {
  42         gchar                   *foundation;
  43         SipeComponentType        component;
  44         SipeCandidateType        type;
  45         SipeNetworkProtocol      protocol;
  46         guint32                  priority;
  47         gchar                   *ip; /* currently this has to be an IPv4 address */
  48         guint                    port;
  49         gchar                   *base_ip;
  50         guint                    base_port;
  51         gchar                   *username;
  52         gchar                   *password;
  53 };
  54
  55 struct sdpcodec {
  56         gint             id;
  57         gchar           *name;
  58         gint             clock_rate;
  59         SipeMediaType    type;
  60         GSList          *parameters;
  61 };
  62
  63 /**
  64  * Parses SDP message into @c sdpmsg structure.
  65  *
  66  * @param msg SDP message as character string
  67  *
  68  * @return New @c sdpmsg or NULL if message can not be parsed.
  69  */
  70 struct sdpmsg *sdpmsg_parse_msg(gchar *msg);
  71
  72 /**
  73  * Creates a SDP message from the @c sdpmsg structure.
  74  *
  75  * @param msg a @c sdpmsg
  76  *
  77  * @return SDP message as a character string that must be g_free'd after use.
  78  */
  79 gchar *sdpmsg_to_string(const struct sdpmsg *msg);
  80
  81 /**
  82  * Deallocates @c sdpmsg.
  83  */
  84 void sdpmsg_free(struct sdpmsg *msg);
  85
  86 /**
  87  * Deallocates @c sdpcodec.
  88  */
  89 void sdpcodec_free(struct sdpcodec *codec);
  90
  91 /**
  92  * Deallocates @c sdpmedia.
  93  */
  94 void sdpmedia_free(struct sdpmedia *media);