Blame gio/ginetaddress.c

Packit ae235b
/* GIO - GLib Input, Output and Streaming Library
Packit ae235b
 *
Packit ae235b
 * Copyright (C) 2008 Christian Kellner, Samuel Cormier-Iijima
Packit ae235b
 *
Packit ae235b
 * This library is free software; you can redistribute it and/or
Packit ae235b
 * modify it under the terms of the GNU Lesser General Public
Packit ae235b
 * License as published by the Free Software Foundation; either
Packit ae235b
 * version 2.1 of the License, or (at your option) any later version.
Packit ae235b
 *
Packit ae235b
 * This library is distributed in the hope that it will be useful,
Packit ae235b
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit ae235b
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit ae235b
 * Lesser General Public License for more details.
Packit ae235b
 *
Packit ae235b
 * You should have received a copy of the GNU Lesser General
Packit ae235b
 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
Packit ae235b
 *
Packit ae235b
 * Authors: Christian Kellner <gicmo@gnome.org>
Packit ae235b
 *          Samuel Cormier-Iijima <sciyoshi@gmail.com>
Packit ae235b
 */
Packit ae235b
Packit ae235b
#include <config.h>
Packit ae235b
Packit ae235b
#include <string.h>
Packit ae235b
Packit ae235b
#include <glib.h>
Packit ae235b
Packit ae235b
#include "ginetaddress.h"
Packit ae235b
#include "gioenums.h"
Packit ae235b
#include "gioenumtypes.h"
Packit ae235b
#include "glibintl.h"
Packit ae235b
#include "gnetworkingprivate.h"
Packit ae235b
Packit ae235b
#ifdef G_OS_WIN32
Packit ae235b
/* Ensure Windows XP runtime compatibility, while using
Packit ae235b
 * inet_pton() and inet_ntop() if available
Packit ae235b
 */
Packit ae235b
#include "gwin32networking.h"
Packit ae235b
#endif
Packit ae235b
Packit ae235b
struct _GInetAddressPrivate
Packit ae235b
{
Packit ae235b
  GSocketFamily family;
Packit ae235b
  union {
Packit ae235b
    struct in_addr ipv4;
Packit ae235b
    struct in6_addr ipv6;
Packit ae235b
  } addr;
Packit ae235b
};
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * SECTION:ginetaddress
Packit ae235b
 * @short_description: An IPv4/IPv6 address
Packit ae235b
 * @include: gio/gio.h
Packit ae235b
 *
Packit ae235b
 * #GInetAddress represents an IPv4 or IPv6 internet address. Use
Packit ae235b
 * g_resolver_lookup_by_name() or g_resolver_lookup_by_name_async() to
Packit ae235b
 * look up the #GInetAddress for a hostname. Use
Packit ae235b
 * g_resolver_lookup_by_address() or
Packit ae235b
 * g_resolver_lookup_by_address_async() to look up the hostname for a
Packit ae235b
 * #GInetAddress.
Packit ae235b
 *
Packit ae235b
 * To actually connect to a remote host, you will need a
Packit ae235b
 * #GInetSocketAddress (which includes a #GInetAddress as well as a
Packit ae235b
 * port number).
Packit ae235b
 */
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * GInetAddress:
Packit ae235b
 *
Packit ae235b
 * An IPv4 or IPv6 internet address.
Packit ae235b
 */
Packit ae235b
Packit ae235b
G_DEFINE_TYPE_WITH_CODE (GInetAddress, g_inet_address, G_TYPE_OBJECT,
Packit ae235b
                         G_ADD_PRIVATE (GInetAddress)
Packit ae235b
			 g_networking_init ();)
Packit ae235b
Packit ae235b
enum
Packit ae235b
{
Packit ae235b
  PROP_0,
Packit ae235b
  PROP_FAMILY,
Packit ae235b
  PROP_BYTES,
Packit ae235b
  PROP_IS_ANY,
Packit ae235b
  PROP_IS_LOOPBACK,
Packit ae235b
  PROP_IS_LINK_LOCAL,
Packit ae235b
  PROP_IS_SITE_LOCAL,
Packit ae235b
  PROP_IS_MULTICAST,
Packit ae235b
  PROP_IS_MC_GLOBAL,
Packit ae235b
  PROP_IS_MC_LINK_LOCAL,
Packit ae235b
  PROP_IS_MC_NODE_LOCAL,
Packit ae235b
  PROP_IS_MC_ORG_LOCAL,
Packit ae235b
  PROP_IS_MC_SITE_LOCAL,
Packit ae235b
};
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_inet_address_set_property (GObject      *object,
Packit ae235b
			     guint         prop_id,
Packit ae235b
			     const GValue *value,
Packit ae235b
			     GParamSpec   *pspec)
Packit ae235b
{
Packit ae235b
  GInetAddress *address = G_INET_ADDRESS (object);
Packit ae235b
Packit ae235b
  switch (prop_id)
Packit ae235b
    {
Packit ae235b
    case PROP_FAMILY:
Packit ae235b
      address->priv->family = g_value_get_enum (value);
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_BYTES:
Packit ae235b
      memcpy (&address->priv->addr, g_value_get_pointer (value),
Packit ae235b
	      address->priv->family == AF_INET ?
Packit ae235b
	      sizeof (address->priv->addr.ipv4) :
Packit ae235b
	      sizeof (address->priv->addr.ipv6));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    default:
Packit ae235b
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
Packit ae235b
      break;
Packit ae235b
    }
Packit ae235b
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_inet_address_get_property (GObject    *object,
Packit ae235b
                             guint       prop_id,
Packit ae235b
                             GValue     *value,
Packit ae235b
                             GParamSpec *pspec)
Packit ae235b
{
Packit ae235b
  GInetAddress *address = G_INET_ADDRESS (object);
Packit ae235b
Packit ae235b
  switch (prop_id)
Packit ae235b
    {
Packit ae235b
    case PROP_FAMILY:
Packit ae235b
      g_value_set_enum (value, address->priv->family);
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_BYTES:
Packit ae235b
      g_value_set_pointer (value, &address->priv->addr);
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_ANY:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_any (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_LOOPBACK:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_loopback (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_LINK_LOCAL:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_link_local (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_SITE_LOCAL:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_site_local (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_MULTICAST:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_multicast (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_MC_GLOBAL:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_mc_global (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_MC_LINK_LOCAL:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_mc_link_local (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_MC_NODE_LOCAL:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_mc_node_local (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_MC_ORG_LOCAL:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_mc_org_local (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_IS_MC_SITE_LOCAL:
Packit ae235b
      g_value_set_boolean (value, g_inet_address_get_is_mc_site_local (address));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    default:
Packit ae235b
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
Packit ae235b
    }
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_inet_address_class_init (GInetAddressClass *klass)
Packit ae235b
{
Packit ae235b
  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
Packit ae235b
Packit ae235b
  gobject_class->set_property = g_inet_address_set_property;
Packit ae235b
  gobject_class->get_property = g_inet_address_get_property;
Packit ae235b
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_FAMILY,
Packit ae235b
                                   g_param_spec_enum ("family",
Packit ae235b
						      P_("Address family"),
Packit ae235b
						      P_("The address family (IPv4 or IPv6)"),
Packit ae235b
						      G_TYPE_SOCKET_FAMILY,
Packit ae235b
						      G_SOCKET_FAMILY_INVALID,
Packit ae235b
						      G_PARAM_READWRITE |
Packit ae235b
                                                      G_PARAM_CONSTRUCT_ONLY |
Packit ae235b
                                                      G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_BYTES,
Packit ae235b
                                   g_param_spec_pointer ("bytes",
Packit ae235b
							 P_("Bytes"),
Packit ae235b
							 P_("The raw address data"),
Packit ae235b
							 G_PARAM_READWRITE |
Packit ae235b
                                                         G_PARAM_CONSTRUCT_ONLY |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-any:
Packit ae235b
   *
Packit ae235b
   * Whether this is the "any" address for its family.
Packit ae235b
   * See g_inet_address_get_is_any().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_ANY,
Packit ae235b
                                   g_param_spec_boolean ("is-any",
Packit ae235b
                                                         P_("Is any"),
Packit ae235b
                                                         P_("Whether this is the \"any\" address for its family"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-link-local:
Packit ae235b
   *
Packit ae235b
   * Whether this is a link-local address.
Packit ae235b
   * See g_inet_address_get_is_link_local().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_LINK_LOCAL,
Packit ae235b
                                   g_param_spec_boolean ("is-link-local",
Packit ae235b
                                                         P_("Is link-local"),
Packit ae235b
                                                         P_("Whether this is a link-local address"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-loopback:
Packit ae235b
   *
Packit ae235b
   * Whether this is the loopback address for its family.
Packit ae235b
   * See g_inet_address_get_is_loopback().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_LOOPBACK,
Packit ae235b
                                   g_param_spec_boolean ("is-loopback",
Packit ae235b
                                                         P_("Is loopback"),
Packit ae235b
                                                         P_("Whether this is the loopback address for its family"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-site-local:
Packit ae235b
   *
Packit ae235b
   * Whether this is a site-local address.
Packit ae235b
   * See g_inet_address_get_is_loopback().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_SITE_LOCAL,
Packit ae235b
                                   g_param_spec_boolean ("is-site-local",
Packit ae235b
                                                         P_("Is site-local"),
Packit ae235b
                                                         P_("Whether this is a site-local address"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-multicast:
Packit ae235b
   *
Packit ae235b
   * Whether this is a multicast address.
Packit ae235b
   * See g_inet_address_get_is_multicast().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_MULTICAST,
Packit ae235b
                                   g_param_spec_boolean ("is-multicast",
Packit ae235b
                                                         P_("Is multicast"),
Packit ae235b
                                                         P_("Whether this is a multicast address"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-mc-global:
Packit ae235b
   *
Packit ae235b
   * Whether this is a global multicast address.
Packit ae235b
   * See g_inet_address_get_is_mc_global().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_MC_GLOBAL,
Packit ae235b
                                   g_param_spec_boolean ("is-mc-global",
Packit ae235b
                                                         P_("Is multicast global"),
Packit ae235b
                                                         P_("Whether this is a global multicast address"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-mc-link-local:
Packit ae235b
   *
Packit ae235b
   * Whether this is a link-local multicast address.
Packit ae235b
   * See g_inet_address_get_is_mc_link_local().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_MC_LINK_LOCAL,
Packit ae235b
                                   g_param_spec_boolean ("is-mc-link-local",
Packit ae235b
                                                         P_("Is multicast link-local"),
Packit ae235b
                                                         P_("Whether this is a link-local multicast address"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-mc-node-local:
Packit ae235b
   *
Packit ae235b
   * Whether this is a node-local multicast address.
Packit ae235b
   * See g_inet_address_get_is_mc_node_local().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_MC_NODE_LOCAL,
Packit ae235b
                                   g_param_spec_boolean ("is-mc-node-local",
Packit ae235b
                                                         P_("Is multicast node-local"),
Packit ae235b
                                                         P_("Whether this is a node-local multicast address"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-mc-org-local:
Packit ae235b
   *
Packit ae235b
   * Whether this is an organization-local multicast address.
Packit ae235b
   * See g_inet_address_get_is_mc_org_local().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_MC_ORG_LOCAL,
Packit ae235b
                                   g_param_spec_boolean ("is-mc-org-local",
Packit ae235b
                                                         P_("Is multicast org-local"),
Packit ae235b
                                                         P_("Whether this is an organization-local multicast address"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
Packit ae235b
  /**
Packit ae235b
   * GInetAddress:is-mc-site-local:
Packit ae235b
   *
Packit ae235b
   * Whether this is a site-local multicast address.
Packit ae235b
   * See g_inet_address_get_is_mc_site_local().
Packit ae235b
   *
Packit ae235b
   * Since: 2.22
Packit ae235b
   */
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_IS_MC_SITE_LOCAL,
Packit ae235b
                                   g_param_spec_boolean ("is-mc-site-local",
Packit ae235b
                                                         P_("Is multicast site-local"),
Packit ae235b
                                                         P_("Whether this is a site-local multicast address"),
Packit ae235b
                                                         FALSE,
Packit ae235b
                                                         G_PARAM_READABLE |
Packit ae235b
                                                         G_PARAM_STATIC_STRINGS));
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_inet_address_init (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  address->priv = g_inet_address_get_instance_private (address);
Packit ae235b
}
Packit ae235b
Packit ae235b
/* These are provided so that we can use inet_pton() and inet_ntop() on Windows
Packit ae235b
 * if they are available (i.e. Vista and later), and use the existing code path
Packit ae235b
 * on Windows XP/Server 2003.  We can drop this portion when we drop support for
Packit ae235b
 * XP/Server 2003.
Packit ae235b
 */
Packit ae235b
#if defined(G_OS_WIN32) && _WIN32_WINNT < 0x0600
Packit ae235b
static gint
Packit ae235b
inet_pton (gint family,
Packit ae235b
           const gchar *addr_string,
Packit ae235b
           gpointer addr)
Packit ae235b
{
Packit ae235b
  /* For Vista/Server 2008 and later, there is native inet_pton() in Winsock2 */
Packit ae235b
  if (ws2funcs.pInetPton != NULL)
Packit ae235b
    return ws2funcs.pInetPton (family, addr_string, addr);
Packit ae235b
  else
Packit ae235b
    {
Packit ae235b
      /* Fallback codepath for XP/Server 2003 */
Packit ae235b
      struct sockaddr_storage sa;
Packit ae235b
      struct sockaddr_in *sin = (struct sockaddr_in *)&sa;
Packit ae235b
      struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)&sa;
Packit ae235b
      gint len = sizeof (sa);
Packit ae235b
Packit ae235b
      if (family != AF_INET && family != AF_INET6)
Packit ae235b
        {
Packit ae235b
          WSASetLastError (WSAEAFNOSUPPORT);
Packit ae235b
          return -1;
Packit ae235b
        }
Packit ae235b
Packit ae235b
      /* WSAStringToAddress() will accept various not-an-IP-address
Packit ae235b
       * strings like "127.0.0.1:80", "[1234::5678]:80", "127.1", etc.
Packit ae235b
       */
Packit ae235b
      if (!g_hostname_is_ip_address (addr_string))
Packit ae235b
        return 0;
Packit ae235b
Packit ae235b
      if (WSAStringToAddress ((LPTSTR) addr_string, family, NULL, (LPSOCKADDR) &sa, &len) != 0)
Packit ae235b
        return 0;
Packit ae235b
Packit ae235b
      if (family == AF_INET)
Packit ae235b
        *(IN_ADDR *)addr = sin->sin_addr;
Packit ae235b
      else
Packit ae235b
        *(IN6_ADDR *)addr = sin6->sin6_addr;
Packit ae235b
Packit ae235b
      return 1;
Packit ae235b
    }
Packit ae235b
}
Packit ae235b
Packit ae235b
static const gchar *
Packit ae235b
inet_ntop (gint family,
Packit ae235b
           const gpointer addr,
Packit ae235b
           gchar *addr_str,
Packit ae235b
           socklen_t size)
Packit ae235b
{
Packit ae235b
  /* On Vista/Server 2008 and later, there is native inet_ntop() in Winsock2 */
Packit ae235b
  if (ws2funcs.pInetNtop != NULL)
Packit ae235b
    return ws2funcs.pInetNtop (family, addr, addr_str, size);
Packit ae235b
  else
Packit ae235b
    {
Packit ae235b
      /* Fallback codepath for XP/Server 2003 */
Packit ae235b
      DWORD buflen = size, addrlen;
Packit ae235b
      struct sockaddr_storage sa;
Packit ae235b
      struct sockaddr_in *sin = (struct sockaddr_in *)&sa;
Packit ae235b
      struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)&sa;
Packit ae235b
Packit ae235b
      memset (&sa, 0, sizeof (sa));
Packit ae235b
      sa.ss_family = family;
Packit ae235b
      if (sa.ss_family == AF_INET)
Packit ae235b
        {
Packit ae235b
          struct in_addr *addrv4 = (struct in_addr *) addr;
Packit ae235b
Packit ae235b
          addrlen = sizeof (*sin);
Packit ae235b
          memcpy (&sin->sin_addr, addrv4, sizeof (sin->sin_addr));
Packit ae235b
        }
Packit ae235b
      else if (sa.ss_family == AF_INET6)
Packit ae235b
        {
Packit ae235b
          struct in6_addr *addrv6 = (struct in6_addr *) addr;
Packit ae235b
Packit ae235b
          addrlen = sizeof (*sin6);
Packit ae235b
          memcpy (&sin6->sin6_addr, addrv6, sizeof (sin6->sin6_addr));
Packit ae235b
        }
Packit ae235b
      else
Packit ae235b
        {
Packit ae235b
          WSASetLastError (WSAEAFNOSUPPORT);
Packit ae235b
          return NULL;
Packit ae235b
        }
Packit ae235b
      if (WSAAddressToString ((LPSOCKADDR) &sa, addrlen, NULL, addr_str, &buflen) == 0)
Packit ae235b
        return addr_str;
Packit ae235b
      else
Packit ae235b
        return NULL;
Packit ae235b
    }
Packit ae235b
}
Packit ae235b
#endif
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_new_from_string:
Packit ae235b
 * @string: a string representation of an IP address
Packit ae235b
 *
Packit ae235b
 * Parses @string as an IP address and creates a new #GInetAddress.
Packit ae235b
 *
Packit ae235b
 * Returns: a new #GInetAddress corresponding to @string, or %NULL if
Packit ae235b
 * @string could not be parsed.
Packit ae235b
 *     Free the returned object with g_object_unref().
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
GInetAddress *
Packit ae235b
g_inet_address_new_from_string (const gchar *string)
Packit ae235b
{
Packit ae235b
  struct in_addr in_addr;
Packit ae235b
  struct in6_addr in6_addr;
Packit ae235b
Packit ae235b
  g_return_val_if_fail (string != NULL, NULL);
Packit ae235b
Packit ae235b
  /* If this GInetAddress is the first networking-related object to be
Packit ae235b
   * created, then we won't have called g_networking_init() yet at
Packit ae235b
   * this point.
Packit ae235b
   */
Packit ae235b
  g_networking_init ();
Packit ae235b
Packit ae235b
  if (inet_pton (AF_INET, string, &in_addr) > 0)
Packit ae235b
    return g_inet_address_new_from_bytes ((guint8 *)&in_addr, AF_INET);
Packit ae235b
  else if (inet_pton (AF_INET6, string, &in6_addr) > 0)
Packit ae235b
    return g_inet_address_new_from_bytes ((guint8 *)&in6_addr, AF_INET6);
Packit ae235b
Packit ae235b
  return NULL;
Packit ae235b
}
Packit ae235b
Packit ae235b
#define G_INET_ADDRESS_FAMILY_IS_VALID(family) ((family) == AF_INET || (family) == AF_INET6)
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_new_from_bytes:
Packit ae235b
 * @bytes: (array) (element-type guint8): raw address data
Packit ae235b
 * @family: the address family of @bytes
Packit ae235b
 *
Packit ae235b
 * Creates a new #GInetAddress from the given @family and @bytes.
Packit ae235b
 * @bytes should be 4 bytes for %G_SOCKET_FAMILY_IPV4 and 16 bytes for
Packit ae235b
 * %G_SOCKET_FAMILY_IPV6.
Packit ae235b
 *
Packit ae235b
 * Returns: a new #GInetAddress corresponding to @family and @bytes.
Packit ae235b
 *     Free the returned object with g_object_unref().
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
GInetAddress *
Packit ae235b
g_inet_address_new_from_bytes (const guint8         *bytes,
Packit ae235b
			       GSocketFamily  family)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_INET_ADDRESS_FAMILY_IS_VALID (family), NULL);
Packit ae235b
Packit ae235b
  return g_object_new (G_TYPE_INET_ADDRESS,
Packit ae235b
		       "family", family,
Packit ae235b
		       "bytes", bytes,
Packit ae235b
		       NULL);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_new_loopback:
Packit ae235b
 * @family: the address family
Packit ae235b
 *
Packit ae235b
 * Creates a #GInetAddress for the loopback address for @family.
Packit ae235b
 *
Packit ae235b
 * Returns: a new #GInetAddress corresponding to the loopback address
Packit ae235b
 * for @family.
Packit ae235b
 *     Free the returned object with g_object_unref().
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
GInetAddress *
Packit ae235b
g_inet_address_new_loopback (GSocketFamily family)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_INET_ADDRESS_FAMILY_IS_VALID (family), NULL);
Packit ae235b
Packit ae235b
  if (family == AF_INET)
Packit ae235b
    {    
Packit ae235b
      guint8 addr[4] = {127, 0, 0, 1};
Packit ae235b
Packit ae235b
      return g_inet_address_new_from_bytes (addr, family);
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    return g_inet_address_new_from_bytes (in6addr_loopback.s6_addr, family);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_new_any:
Packit ae235b
 * @family: the address family
Packit ae235b
 *
Packit ae235b
 * Creates a #GInetAddress for the "any" address (unassigned/"don't
Packit ae235b
 * care") for @family.
Packit ae235b
 *
Packit ae235b
 * Returns: a new #GInetAddress corresponding to the "any" address
Packit ae235b
 * for @family.
Packit ae235b
 *     Free the returned object with g_object_unref().
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
GInetAddress *
Packit ae235b
g_inet_address_new_any (GSocketFamily family)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_INET_ADDRESS_FAMILY_IS_VALID (family), NULL);
Packit ae235b
Packit ae235b
  if (family == AF_INET)
Packit ae235b
    {    
Packit ae235b
      guint8 addr[4] = {0, 0, 0, 0};
Packit ae235b
Packit ae235b
      return g_inet_address_new_from_bytes (addr, family);
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    return g_inet_address_new_from_bytes (in6addr_any.s6_addr, family);
Packit ae235b
}
Packit ae235b
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_to_string:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Converts @address to string form.
Packit ae235b
 *
Packit ae235b
 * Returns: a representation of @address as a string, which should be
Packit ae235b
 * freed after use.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gchar *
Packit ae235b
g_inet_address_to_string (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  gchar buffer[INET6_ADDRSTRLEN];
Packit ae235b
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), NULL);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    inet_ntop (AF_INET, &address->priv->addr.ipv4, buffer, sizeof (buffer));
Packit ae235b
  else
Packit ae235b
    inet_ntop (AF_INET6, &address->priv->addr.ipv6, buffer, sizeof (buffer));
Packit ae235b
Packit ae235b
  return g_strdup (buffer);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_to_bytes: (skip)
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Gets the raw binary address data from @address.
Packit ae235b
 *
Packit ae235b
 * Returns: a pointer to an internal array of the bytes in @address,
Packit ae235b
 * which should not be modified, stored, or freed. The size of this
Packit ae235b
 * array can be gotten with g_inet_address_get_native_size().
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
const guint8 *
Packit ae235b
g_inet_address_to_bytes (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), NULL);
Packit ae235b
Packit ae235b
  return (guint8 *)&address->priv->addr;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_native_size:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Gets the size of the native raw binary address for @address. This
Packit ae235b
 * is the size of the data that you get from g_inet_address_to_bytes().
Packit ae235b
 *
Packit ae235b
 * Returns: the number of bytes used for the native version of @address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gsize
Packit ae235b
g_inet_address_get_native_size (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    return sizeof (address->priv->addr.ipv4);
Packit ae235b
  return sizeof (address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_family:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Gets @address's family
Packit ae235b
 *
Packit ae235b
 * Returns: @address's family
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
GSocketFamily
Packit ae235b
g_inet_address_get_family (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  return address->priv->family;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_any:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is the "any" address for its family.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is the "any" address for its family.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_any (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    {
Packit ae235b
      guint32 addr4 = g_ntohl (address->priv->addr.ipv4.s_addr);
Packit ae235b
Packit ae235b
      return addr4 == INADDR_ANY;
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_UNSPECIFIED (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_loopback:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is the loopback address for its family.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is the loopback address for its family.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_loopback (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    {
Packit ae235b
      guint32 addr4 = g_ntohl (address->priv->addr.ipv4.s_addr);
Packit ae235b
Packit ae235b
      /* 127.0.0.0/8 */
Packit ae235b
      return ((addr4 & 0xff000000) == 0x7f000000);
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_LOOPBACK (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_link_local:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is a link-local address (that is, if it
Packit ae235b
 * identifies a host on a local network that is not connected to the
Packit ae235b
 * Internet).
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is a link-local address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_link_local (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    {
Packit ae235b
      guint32 addr4 = g_ntohl (address->priv->addr.ipv4.s_addr);
Packit ae235b
Packit ae235b
      /* 169.254.0.0/16 */
Packit ae235b
      return ((addr4 & 0xffff0000) == 0xa9fe0000);
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_LINKLOCAL (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_site_local:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is a site-local address such as 10.0.0.1
Packit ae235b
 * (that is, the address identifies a host on a local network that can
Packit ae235b
 * not be reached directly from the Internet, but which may have
Packit ae235b
 * outgoing Internet connectivity via a NAT or firewall).
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is a site-local address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_site_local (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    {
Packit ae235b
      guint32 addr4 = g_ntohl (address->priv->addr.ipv4.s_addr);
Packit ae235b
Packit ae235b
      /* 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 */
Packit ae235b
      return ((addr4 & 0xff000000) == 0x0a000000 ||
Packit ae235b
	      (addr4 & 0xfff00000) == 0xac100000 ||
Packit ae235b
	      (addr4 & 0xffff0000) == 0xc0a80000);
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_SITELOCAL (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_multicast:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is a multicast address.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is a multicast address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_multicast (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    {
Packit ae235b
      guint32 addr4 = g_ntohl (address->priv->addr.ipv4.s_addr);
Packit ae235b
Packit ae235b
      return IN_MULTICAST (addr4);
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_MULTICAST (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_mc_global:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is a global multicast address.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is a global multicast address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_mc_global (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    return FALSE;
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_MC_GLOBAL (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_mc_link_local:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is a link-local multicast address.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is a link-local multicast address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_mc_link_local (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    return FALSE;
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_MC_LINKLOCAL (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_mc_node_local:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is a node-local multicast address.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is a node-local multicast address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_mc_node_local (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    return FALSE;
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_MC_NODELOCAL (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_mc_org_local:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is an organization-local multicast address.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is an organization-local multicast address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_mc_org_local  (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    return FALSE;
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_MC_ORGLOCAL (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_get_is_mc_site_local:
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests whether @address is a site-local multicast address.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address is a site-local multicast address.
Packit ae235b
 *
Packit ae235b
 * Since: 2.22
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_get_is_mc_site_local (GInetAddress *address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (address->priv->family == AF_INET)
Packit ae235b
    return FALSE;
Packit ae235b
  else
Packit ae235b
    return IN6_IS_ADDR_MC_SITELOCAL (&address->priv->addr.ipv6);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_equal:
Packit ae235b
 * @address: A #GInetAddress.
Packit ae235b
 * @other_address: Another #GInetAddress.
Packit ae235b
 *
Packit ae235b
 * Checks if two #GInetAddress instances are equal, e.g. the same address.
Packit ae235b
 *
Packit ae235b
 * Returns: %TRUE if @address and @other_address are equal, %FALSE otherwise.
Packit ae235b
 *
Packit ae235b
 * Since: 2.30
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_equal (GInetAddress *address,
Packit ae235b
                      GInetAddress *other_address)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (other_address), FALSE);
Packit ae235b
Packit ae235b
  if (g_inet_address_get_family (address) != g_inet_address_get_family (other_address))
Packit ae235b
    return FALSE;
Packit ae235b
Packit ae235b
  if (memcmp (g_inet_address_to_bytes (address),
Packit ae235b
              g_inet_address_to_bytes (other_address),
Packit ae235b
              g_inet_address_get_native_size (address)) != 0)
Packit ae235b
    return FALSE;
Packit ae235b
Packit ae235b
  return TRUE;
Packit ae235b
}