address/address.h

   1 /*
   2  * This file is part of the Nice GLib ICE library.
   3  *
   4  * (C) 2006, 2007 Collabora Ltd.
   5  *  Contact: Dafydd Harries
   6  * (C) 2006, 2007 Nokia Corporation. All rights reserved.
   7  *  Contact: Kai Vehmanen
   8  *
   9  * The contents of this file are subject to the Mozilla Public License Version
  10  * 1.1 (the "License"); you may not use this file except in compliance with
  11  * the License. You may obtain a copy of the License at
  12  * http://www.mozilla.org/MPL/
  13  *
  14  * Software distributed under the License is distributed on an "AS IS" basis,
  15  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  16  * for the specific language governing rights and limitations under the
  17  * License.
  18  *
  19  * The Original Code is the Nice GLib ICE library.
  20  *
  21  * The Initial Developers of the Original Code are Collabora Ltd and Nokia
  22  * Corporation. All Rights Reserved.
  23  *
  24  * Contributors:
  25  *   Dafydd Harries, Collabora Ltd.
  26  *
  27  * Alternatively, the contents of this file may be used under the terms of the
  28  * the GNU Lesser General Public License Version 2.1 (the "LGPL"), in which
  29  * case the provisions of LGPL are applicable instead of those above. If you
  30  * wish to allow use of your version of this file only under the terms of the
  31  * LGPL and not to allow others to use your version of this file under the
  32  * MPL, indicate your decision by deleting the provisions above and replace
  33  * them with the notice and other provisions required by the LGPL. If you do
  34  * not delete the provisions above, a recipient may use your version of this
  35  * file under either the MPL or the LGPL.
  36  */
  37
  38 #ifndef _ADDRESS_H
  39 #define _ADDRESS_H
  40
  41 #include <sys/types.h>
  42 #include <sys/socket.h>
  43 #include <netinet/in.h>
  44
  45 #include <glib.h>
  46
  47 G_BEGIN_DECLS
  48
  49 #define NICE_ADDRESS_STRING_LEN INET6_ADDRSTRLEN
  50
  51 typedef struct _NiceAddress NiceAddress;
  52
  53 /* note: clients need to know the storage size, so needs to be public */
  54 struct _NiceAddress
  55 {
  56   union
  57   {
  58     struct sockaddr     addr;
  59     struct sockaddr_in  ip4;
  60     struct sockaddr_in6 ip6;
  61   } s;
  62 };
  63
  64 static inline void
  65 nice_address_init (NiceAddress *addr)
  66 {
  67   addr->s.addr.sa_family = AF_UNSPEC;
  68 }
  69
  70 NiceAddress *
  71 nice_address_new (void);
  72
  73 void
  74 nice_address_free (NiceAddress *addr);
  75
  76 NiceAddress *
  77 nice_address_dup (const NiceAddress *a);
  78
  79 void
  80 nice_address_set_ipv4 (NiceAddress *addr, guint32 addr_ipv4);
  81
  82 void
  83 nice_address_set_ipv6 (NiceAddress *addr, const guchar *addr_ipv6);
  84
  85 void
  86 nice_address_set_port (NiceAddress *addr, guint port);
  87
  88 guint
  89 nice_address_get_port (const NiceAddress *addr);
  90
  91 G_GNUC_WARN_UNUSED_RESULT
  92 gboolean
  93 nice_address_set_from_string (NiceAddress *addr, const gchar *str);
  94
  95 void
  96 nice_address_set_from_sockaddr (NiceAddress *addr, const struct sockaddr *sin);
  97
  98 void
  99 nice_address_copy_to_sockaddr (const NiceAddress *addr, struct sockaddr *sin);
 100
 101 gboolean
 102 nice_address_equal (const NiceAddress *a, const NiceAddress *b);
 103
 104 void
 105 nice_address_to_string (const NiceAddress *addr, gchar *dst);
 106
 107 gboolean
 108 nice_address_is_private (const NiceAddress *a);
 109
 110 G_GNUC_WARN_UNUSED_RESULT
 111 gboolean
 112 nice_address_is_valid (const NiceAddress *a);
 113
 114 G_END_DECLS
 115
 116 #endif /* _ADDRESS_H */
 117