Blame gio/ginetaddressmask.c

Packit ae235b
/* GIO - GLib Input, Output and Streaming Library
Packit ae235b
 *
Packit ae235b
 * Copyright 2011 Red Hat, Inc.
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
Packit ae235b
#include <config.h>
Packit ae235b
Packit ae235b
#include <stdlib.h>
Packit ae235b
#include <string.h>
Packit ae235b
Packit ae235b
#include "ginetaddressmask.h"
Packit ae235b
#include "ginetaddress.h"
Packit ae235b
#include "ginitable.h"
Packit ae235b
#include "gioerror.h"
Packit ae235b
#include "gioenumtypes.h"
Packit ae235b
#include "glibintl.h"
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * SECTION:ginetaddressmask
Packit ae235b
 * @short_description: An IPv4/IPv6 address mask
Packit ae235b
 * @include: gio/gio.h
Packit ae235b
 *
Packit ae235b
 * #GInetAddressMask represents a range of IPv4 or IPv6 addresses
Packit ae235b
 * described by a base address and a length indicating how many bits
Packit ae235b
 * of the base address are relevant for matching purposes. These are
Packit ae235b
 * often given in string form. Eg, "10.0.0.0/8", or "fe80::/10".
Packit ae235b
 */
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * GInetAddressMask:
Packit ae235b
 *
Packit ae235b
 * A combination of an IPv4 or IPv6 base address and a length,
Packit ae235b
 * representing a range of IP addresses.
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
Packit ae235b
struct _GInetAddressMaskPrivate
Packit ae235b
{
Packit ae235b
  GInetAddress *addr;
Packit ae235b
  guint         length;
Packit ae235b
};
Packit ae235b
Packit ae235b
static void     g_inet_address_mask_initable_iface_init (GInitableIface  *iface);
Packit ae235b
Packit ae235b
G_DEFINE_TYPE_WITH_CODE (GInetAddressMask, g_inet_address_mask, G_TYPE_OBJECT,
Packit ae235b
                         G_ADD_PRIVATE (GInetAddressMask)
Packit ae235b
			 G_IMPLEMENT_INTERFACE (G_TYPE_INITABLE,
Packit ae235b
						g_inet_address_mask_initable_iface_init))
Packit ae235b
Packit ae235b
enum
Packit ae235b
{
Packit ae235b
  PROP_0,
Packit ae235b
  PROP_FAMILY,
Packit ae235b
  PROP_ADDRESS,
Packit ae235b
  PROP_LENGTH
Packit ae235b
};
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_inet_address_mask_set_property (GObject      *object,
Packit ae235b
				  guint         prop_id,
Packit ae235b
				  const GValue *value,
Packit ae235b
				  GParamSpec   *pspec)
Packit ae235b
{
Packit ae235b
  GInetAddressMask *mask = G_INET_ADDRESS_MASK (object);
Packit ae235b
Packit ae235b
  switch (prop_id)
Packit ae235b
    {
Packit ae235b
    case PROP_ADDRESS:
Packit ae235b
      if (mask->priv->addr)
Packit ae235b
	g_object_unref (mask->priv->addr);
Packit ae235b
      mask->priv->addr = g_value_dup_object (value);
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_LENGTH:
Packit ae235b
      mask->priv->length = g_value_get_uint (value);
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_mask_get_property (GObject    *object,
Packit ae235b
				  guint       prop_id,
Packit ae235b
				  GValue     *value,
Packit ae235b
				  GParamSpec *pspec)
Packit ae235b
{
Packit ae235b
  GInetAddressMask *mask = G_INET_ADDRESS_MASK (object);
Packit ae235b
Packit ae235b
  switch (prop_id)
Packit ae235b
    {
Packit ae235b
    case PROP_FAMILY:
Packit ae235b
      g_value_set_enum (value, g_inet_address_get_family (mask->priv->addr));
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_ADDRESS:
Packit ae235b
      g_value_set_object (value, mask->priv->addr);
Packit ae235b
      break;
Packit ae235b
Packit ae235b
    case PROP_LENGTH:
Packit ae235b
      g_value_set_uint (value, mask->priv->length);
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_mask_dispose (GObject *object)
Packit ae235b
{
Packit ae235b
  GInetAddressMask *mask = G_INET_ADDRESS_MASK (object);
Packit ae235b
Packit ae235b
  g_clear_object (&mask->priv->addr);
Packit ae235b
Packit ae235b
  G_OBJECT_CLASS (g_inet_address_mask_parent_class)->dispose (object);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_inet_address_mask_class_init (GInetAddressMaskClass *klass)
Packit ae235b
{
Packit ae235b
  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
Packit ae235b
Packit ae235b
  gobject_class->set_property = g_inet_address_mask_set_property;
Packit ae235b
  gobject_class->get_property = g_inet_address_mask_get_property;
Packit ae235b
  gobject_class->dispose = g_inet_address_mask_dispose;
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_READABLE |
Packit ae235b
                                                      G_PARAM_STATIC_STRINGS));
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_ADDRESS,
Packit ae235b
                                   g_param_spec_object ("address",
Packit ae235b
							P_("Address"),
Packit ae235b
							P_("The base address"),
Packit ae235b
							G_TYPE_INET_ADDRESS,
Packit ae235b
							G_PARAM_READWRITE |
Packit ae235b
							G_PARAM_STATIC_STRINGS));
Packit ae235b
  g_object_class_install_property (gobject_class, PROP_LENGTH,
Packit ae235b
                                   g_param_spec_uint ("length",
Packit ae235b
						      P_("Length"),
Packit ae235b
						      P_("The prefix length"),
Packit ae235b
						      0, 128, 0,
Packit ae235b
						      G_PARAM_READWRITE |
Packit ae235b
						      G_PARAM_STATIC_STRINGS));
Packit ae235b
}
Packit ae235b
Packit ae235b
static gboolean
Packit ae235b
g_inet_address_mask_initable_init (GInitable     *initable,
Packit ae235b
				   GCancellable  *cancellable,
Packit ae235b
				   GError       **error)
Packit ae235b
{
Packit ae235b
  GInetAddressMask *mask = G_INET_ADDRESS_MASK (initable);
Packit ae235b
  guint addrlen, nbytes, nbits;
Packit ae235b
  const guint8 *bytes;
Packit ae235b
  gboolean ok;
Packit ae235b
Packit ae235b
  if (!mask->priv->addr)
Packit ae235b
    {
Packit ae235b
      g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
Packit ae235b
			   _("No address specified"));
Packit ae235b
      return FALSE;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  addrlen = g_inet_address_get_native_size (mask->priv->addr);
Packit ae235b
  if (mask->priv->length > addrlen * 8)
Packit ae235b
    {
Packit ae235b
      g_set_error (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
Packit ae235b
		   _("Length %u is too long for address"),
Packit ae235b
		   mask->priv->length);
Packit ae235b
      return FALSE;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  /* Make sure all the bits after @length are 0 */
Packit ae235b
  bytes = g_inet_address_to_bytes (mask->priv->addr);
Packit ae235b
  ok = TRUE;
Packit ae235b
Packit ae235b
  nbytes = mask->priv->length / 8;
Packit ae235b
  bytes += nbytes;
Packit ae235b
  addrlen -= nbytes;
Packit ae235b
Packit ae235b
  nbits = mask->priv->length % 8;
Packit ae235b
  if (nbits)
Packit ae235b
    {
Packit ae235b
      if (bytes[0] & (0xFF >> nbits))
Packit ae235b
	ok = FALSE;
Packit ae235b
      bytes++;
Packit ae235b
      addrlen--;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  while (addrlen)
Packit ae235b
    {
Packit ae235b
      if (bytes[0])
Packit ae235b
	ok = FALSE;
Packit ae235b
      bytes++;
Packit ae235b
      addrlen--;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  if (!ok)
Packit ae235b
    {
Packit ae235b
      g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
Packit ae235b
			   _("Address has bits set beyond prefix length"));
Packit ae235b
      return FALSE;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  return TRUE;
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_inet_address_mask_initable_iface_init (GInitableIface  *iface)
Packit ae235b
{
Packit ae235b
  iface->init = g_inet_address_mask_initable_init;
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_inet_address_mask_init (GInetAddressMask *mask)
Packit ae235b
{
Packit ae235b
  mask->priv = g_inet_address_mask_get_instance_private (mask);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_mask_new:
Packit ae235b
 * @addr: a #GInetAddress
Packit ae235b
 * @length: number of bits of @addr to use
Packit ae235b
 * @error: return location for #GError, or %NULL
Packit ae235b
 *
Packit ae235b
 * Creates a new #GInetAddressMask representing all addresses whose
Packit ae235b
 * first @length bits match @addr.
Packit ae235b
 *
Packit ae235b
 * Returns: a new #GInetAddressMask, or %NULL on error
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
GInetAddressMask *
Packit ae235b
g_inet_address_mask_new (GInetAddress  *addr,
Packit ae235b
			 guint          length,
Packit ae235b
			 GError       **error)
Packit ae235b
{
Packit ae235b
  return g_initable_new (G_TYPE_INET_ADDRESS_MASK, NULL, error,
Packit ae235b
			 "address", addr,
Packit ae235b
			 "length", length,
Packit ae235b
			 NULL);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_mask_new_from_string:
Packit ae235b
 * @mask_string: an IP address or address/length string
Packit ae235b
 * @error: return location for #GError, or %NULL
Packit ae235b
 *
Packit ae235b
 * Parses @mask_string as an IP address and (optional) length, and
Packit ae235b
 * creates a new #GInetAddressMask. The length, if present, is
Packit ae235b
 * delimited by a "/". If it is not present, then the length is
Packit ae235b
 * assumed to be the full length of the address.
Packit ae235b
 *
Packit ae235b
 * Returns: a new #GInetAddressMask corresponding to @string, or %NULL
Packit ae235b
 * on error.
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
GInetAddressMask *
Packit ae235b
g_inet_address_mask_new_from_string (const gchar  *mask_string,
Packit ae235b
				     GError      **error)
Packit ae235b
{
Packit ae235b
  GInetAddressMask *mask;
Packit ae235b
  GInetAddress *addr;
Packit ae235b
  gchar *slash;
Packit ae235b
  guint length;
Packit ae235b
Packit ae235b
  slash = strchr (mask_string, '/');
Packit ae235b
  if (slash)
Packit ae235b
    {
Packit ae235b
      gchar *address, *end;
Packit ae235b
Packit ae235b
      length = strtoul (slash + 1, &end, 10);
Packit ae235b
      if (*end || !*(slash + 1))
Packit ae235b
	{
Packit ae235b
	parse_error:
Packit ae235b
	  g_set_error (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
Packit ae235b
		       _("Could not parse ā€œ%sā€ as IP address mask"),
Packit ae235b
		       mask_string);
Packit ae235b
	  return NULL;
Packit ae235b
	}
Packit ae235b
Packit ae235b
      address = g_strndup (mask_string, slash - mask_string);
Packit ae235b
      addr = g_inet_address_new_from_string (address);
Packit ae235b
      g_free (address);
Packit ae235b
Packit ae235b
      if (!addr)
Packit ae235b
	goto parse_error;
Packit ae235b
    }
Packit ae235b
  else
Packit ae235b
    {
Packit ae235b
      addr = g_inet_address_new_from_string (mask_string);
Packit ae235b
      if (!addr)
Packit ae235b
	goto parse_error;
Packit ae235b
Packit ae235b
      length = g_inet_address_get_native_size (addr) * 8;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  mask = g_inet_address_mask_new (addr, length, error);
Packit ae235b
  g_object_unref (addr);
Packit ae235b
Packit ae235b
  return mask;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_mask_to_string:
Packit ae235b
 * @mask: a #GInetAddressMask
Packit ae235b
 *
Packit ae235b
 * Converts @mask back to its corresponding string form.
Packit ae235b
 *
Packit ae235b
 * Returns: a string corresponding to @mask.
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
gchar *
Packit ae235b
g_inet_address_mask_to_string (GInetAddressMask *mask)
Packit ae235b
{
Packit ae235b
  gchar *addr_string, *mask_string;
Packit ae235b
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS_MASK (mask), NULL);
Packit ae235b
Packit ae235b
  addr_string = g_inet_address_to_string (mask->priv->addr);
Packit ae235b
Packit ae235b
  if (mask->priv->length == (g_inet_address_get_native_size (mask->priv->addr) * 8))
Packit ae235b
    return addr_string;
Packit ae235b
Packit ae235b
  mask_string = g_strdup_printf ("%s/%u", addr_string, mask->priv->length);
Packit ae235b
  g_free (addr_string);
Packit ae235b
Packit ae235b
  return mask_string;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_mask_get_family:
Packit ae235b
 * @mask: a #GInetAddressMask
Packit ae235b
 *
Packit ae235b
 * Gets the #GSocketFamily of @mask's address
Packit ae235b
 *
Packit ae235b
 * Returns: the #GSocketFamily of @mask's address
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
GSocketFamily
Packit ae235b
g_inet_address_mask_get_family (GInetAddressMask *mask)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS_MASK (mask), G_SOCKET_FAMILY_INVALID);
Packit ae235b
Packit ae235b
  return g_inet_address_get_family (mask->priv->addr);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_mask_get_address:
Packit ae235b
 * @mask: a #GInetAddressMask
Packit ae235b
 *
Packit ae235b
 * Gets @mask's base address
Packit ae235b
 *
Packit ae235b
 * Returns: (transfer none): @mask's base address
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
GInetAddress *
Packit ae235b
g_inet_address_mask_get_address (GInetAddressMask *mask)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS_MASK (mask), NULL);
Packit ae235b
Packit ae235b
  return mask->priv->addr;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_mask_get_length:
Packit ae235b
 * @mask: a #GInetAddressMask
Packit ae235b
 *
Packit ae235b
 * Gets @mask's length
Packit ae235b
 *
Packit ae235b
 * Returns: @mask's length
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
guint
Packit ae235b
g_inet_address_mask_get_length (GInetAddressMask *mask)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS_MASK (mask), 0);
Packit ae235b
Packit ae235b
  return mask->priv->length;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_mask_matches:
Packit ae235b
 * @mask: a #GInetAddressMask
Packit ae235b
 * @address: a #GInetAddress
Packit ae235b
 *
Packit ae235b
 * Tests if @address falls within the range described by @mask.
Packit ae235b
 *
Packit ae235b
 * Returns: whether @address falls within the range described by
Packit ae235b
 * @mask.
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_mask_matches (GInetAddressMask *mask,
Packit ae235b
			     GInetAddress     *address)
Packit ae235b
{
Packit ae235b
  const guint8 *maskbytes, *addrbytes;
Packit ae235b
  int nbytes, nbits;
Packit ae235b
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS_MASK (mask), FALSE);
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS (address), FALSE);
Packit ae235b
Packit ae235b
  if (g_inet_address_get_family (mask->priv->addr) !=
Packit ae235b
      g_inet_address_get_family (address))
Packit ae235b
    return FALSE;
Packit ae235b
Packit ae235b
  if (mask->priv->length == 0)
Packit ae235b
    return TRUE;
Packit ae235b
Packit ae235b
  maskbytes = g_inet_address_to_bytes (mask->priv->addr);
Packit ae235b
  addrbytes = g_inet_address_to_bytes (address);
Packit ae235b
Packit ae235b
  nbytes = mask->priv->length / 8;
Packit ae235b
  if (nbytes != 0 && memcmp (maskbytes, addrbytes, nbytes) != 0)
Packit ae235b
    return FALSE;
Packit ae235b
Packit ae235b
  nbits = mask->priv->length % 8;
Packit ae235b
  if (nbits == 0)
Packit ae235b
    return TRUE;
Packit ae235b
Packit ae235b
  return maskbytes[nbytes] == (addrbytes[nbytes] & (0xFF << (8 - nbits)));
Packit ae235b
}
Packit ae235b
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_inet_address_mask_equal:
Packit ae235b
 * @mask: a #GInetAddressMask
Packit ae235b
 * @mask2: another #GInetAddressMask
Packit ae235b
 *
Packit ae235b
 * Tests if @mask and @mask2 are the same mask.
Packit ae235b
 *
Packit ae235b
 * Returns: whether @mask and @mask2 are the same mask
Packit ae235b
 *
Packit ae235b
 * Since: 2.32
Packit ae235b
 */
Packit ae235b
gboolean
Packit ae235b
g_inet_address_mask_equal (GInetAddressMask  *mask,
Packit ae235b
			   GInetAddressMask  *mask2)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS_MASK (mask), FALSE);
Packit ae235b
  g_return_val_if_fail (G_IS_INET_ADDRESS_MASK (mask2), FALSE);
Packit ae235b
Packit ae235b
  return ((mask->priv->length == mask2->priv->length) &&
Packit ae235b
	  g_inet_address_equal (mask->priv->addr, mask2->priv->addr));
Packit ae235b
}