Blame shared/nm-glib-aux/nm-hash-utils.c

Packit Service b23acc
// SPDX-License-Identifier: LGPL-2.1+
Packit Service b23acc
/*
Packit Service b23acc
 * Copyright (C) 2017 Red Hat, Inc.
Packit Service b23acc
 */
Packit Service b23acc
Packit Service b23acc
#include "nm-default.h"
Packit Service b23acc
Packit Service b23acc
#include "nm-hash-utils.h"
Packit Service b23acc
Packit Service b23acc
#include <stdint.h>
Packit Service b23acc
Packit Service b23acc
#include "nm-shared-utils.h"
Packit Service b23acc
#include "nm-random-utils.h"
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
#define HASH_KEY_SIZE 16u
Packit Service b23acc
#define HASH_KEY_SIZE_GUINT ((HASH_KEY_SIZE + sizeof (guint) - 1) / sizeof (guint))
Packit Service b23acc
Packit Service b23acc
G_STATIC_ASSERT (sizeof (guint) * HASH_KEY_SIZE_GUINT >= HASH_KEY_SIZE);
Packit Service b23acc
Packit Service b23acc
static const guint8 *volatile global_seed = NULL;
Packit Service b23acc
Packit Service b23acc
static const guint8 *
Packit Service b23acc
_get_hash_key_init (void)
Packit Service b23acc
{
Packit Service b23acc
	/* the returned hash is aligned to guin64, hence, it is safe
Packit Service b23acc
	 * to use it as guint* or guint64* pointer. */
Packit Service b23acc
	static union {
Packit Service b23acc
		guint8 v8[HASH_KEY_SIZE];
Packit Service b23acc
		guint _align_as_uint;
Packit Service b23acc
		guint32 _align_as_uint32;
Packit Service b23acc
		guint64 _align_as_uint64;
Packit Service b23acc
	} g_arr;
Packit Service b23acc
	const guint8 *g;
Packit Service b23acc
Packit Service b23acc
again:
Packit Service b23acc
	g = g_atomic_pointer_get (&global_seed);
Packit Service b23acc
	if (!G_UNLIKELY (g)) {
Packit Service b23acc
		static gsize g_lock;
Packit Service b23acc
		uint64_t h;
Packit Service b23acc
		union {
Packit Service b23acc
			guint vuint;
Packit Service b23acc
			guint8 v8[HASH_KEY_SIZE];
Packit Service b23acc
			guint8 _extra_entropy[3 * HASH_KEY_SIZE];
Packit Service b23acc
		} t_arr;
Packit Service b23acc
Packit Service b23acc
		nm_utils_random_bytes (&t_arr, sizeof (t_arr));
Packit Service b23acc
Packit Service b23acc
		/* We only initialize one random hash key. So we can spend some effort
Packit Service b23acc
		 * of getting this right. For one, we collect more random bytes than
Packit Service b23acc
		 * necessary.
Packit Service b23acc
		 *
Packit Service b23acc
		 * Then, the first guint of the seed should have all the entropy that we could
Packit Service b23acc
		 * obtain in sizeof(t_arr). For that, siphash(t_arr) and xor the first guint
Packit Service b23acc
		 * with hash.
Packit Service b23acc
		 * The first guint is especially interesting for nm_hash_static() below that
Packit Service b23acc
		 * doesn't use siphash itself. */
Packit Service b23acc
		h = c_siphash_hash (t_arr.v8,
Packit Service b23acc
		                    (const guint8 *) &t_arr,
Packit Service b23acc
		                    sizeof (t_arr));
Packit Service b23acc
		if (sizeof (h) > sizeof (guint))
Packit Service b23acc
			t_arr.vuint = t_arr.vuint ^ ((guint) (h & G_MAXUINT)) ^ ((guint) (h >> 32));
Packit Service b23acc
		else
Packit Service b23acc
			t_arr.vuint = t_arr.vuint ^ ((guint) (h & G_MAXUINT));
Packit Service b23acc
Packit Service b23acc
		if (!g_once_init_enter (&g_lock)) {
Packit Service b23acc
			/* lost a race. The random key is already initialized. */
Packit Service b23acc
			goto again;
Packit Service b23acc
		}
Packit Service b23acc
Packit Service b23acc
		memcpy (g_arr.v8, t_arr.v8, HASH_KEY_SIZE);
Packit Service b23acc
		g = g_arr.v8;
Packit Service b23acc
		g_atomic_pointer_set (&global_seed, g);
Packit Service b23acc
		g_once_init_leave (&g_lock, 1);
Packit Service b23acc
	}
Packit Service b23acc
Packit Service b23acc
	nm_assert (g == g_arr.v8);
Packit Service b23acc
	return g;
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
#define _get_hash_key() \
Packit Service b23acc
	({ \
Packit Service b23acc
		const guint8 *_g; \
Packit Service b23acc
		\
Packit Service b23acc
		_g = g_atomic_pointer_get (&global_seed); \
Packit Service b23acc
		if (G_UNLIKELY (!_g)) \
Packit Service b23acc
			_g = _get_hash_key_init (); \
Packit Service b23acc
		_g; \
Packit Service b23acc
	})
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_hash_static (guint static_seed)
Packit Service b23acc
{
Packit Service b23acc
	/* Note that we only xor the static_seed with the first guint of the key.
Packit Service b23acc
	 *
Packit Service b23acc
	 * We don't use siphash, which would mix the bits better with _get_hash_key().
Packit Service b23acc
	 * Note that nm_hash_static() isn't used to hash the static_seed. Instead, it
Packit Service b23acc
	 * is used to get a unique hash value in a static context. That means, every
Packit Service b23acc
	 * caller is responsible to choose a static_seed that is sufficiently
Packit Service b23acc
	 * distinct from all other callers. In other words, static_seed should be a
Packit Service b23acc
	 * unique constant with good entropy.
Packit Service b23acc
	 *
Packit Service b23acc
	 * Note that _get_hash_key_init() already xored the first guint of the
Packit Service b23acc
	 * key with the siphash of the entire static key. That means, even if
Packit Service b23acc
	 * we got bad randomness for the first guint, the first guint is also
Packit Service b23acc
	 * mixed with the randomness of the entire random key.
Packit Service b23acc
	 *
Packit Service b23acc
	 * Also, ensure that we don't return zero (like for nm_hash_complete()).
Packit Service b23acc
	 */
Packit Service b23acc
	return    ((*((const guint *) _get_hash_key ())) ^ static_seed)
Packit Service b23acc
	       ?: 3679500967u;
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
void
Packit Service b23acc
nm_hash_siphash42_init (CSipHash *h, guint static_seed)
Packit Service b23acc
{
Packit Service b23acc
	const guint8 *g;
Packit Service b23acc
	union {
Packit Service b23acc
		guint64 _align_as_uint64;
Packit Service b23acc
		guint arr[HASH_KEY_SIZE_GUINT];
Packit Service b23acc
	} seed;
Packit Service b23acc
Packit Service b23acc
	nm_assert (h);
Packit Service b23acc
Packit Service b23acc
	g = _get_hash_key ();
Packit Service b23acc
	memcpy (&seed, g, HASH_KEY_SIZE);
Packit Service b23acc
	seed.arr[0] ^= static_seed;
Packit Service b23acc
	c_siphash_init (h, (const guint8 *) &seed);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_hash_str (const char *str)
Packit Service b23acc
{
Packit Service b23acc
	NMHashState h;
Packit Service b23acc
Packit Service b23acc
	if (!str)
Packit Service b23acc
		return nm_hash_static (1867854211u);
Packit Service b23acc
	nm_hash_init (&h, 1867854211u);
Packit Service b23acc
	nm_hash_update_str (&h, str);
Packit Service b23acc
	return nm_hash_complete (&h);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_str_hash (gconstpointer str)
Packit Service b23acc
{
Packit Service b23acc
	return nm_hash_str (str);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_hash_ptr (gconstpointer ptr)
Packit Service b23acc
{
Packit Service b23acc
	NMHashState h;
Packit Service b23acc
Packit Service b23acc
	if (!ptr)
Packit Service b23acc
		return nm_hash_static (2907677551u);
Packit Service b23acc
	nm_hash_init (&h, 2907677551u);
Packit Service b23acc
	nm_hash_update (&h, &ptr, sizeof (ptr));
Packit Service b23acc
	return nm_hash_complete (&h);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_direct_hash (gconstpointer ptr)
Packit Service b23acc
{
Packit Service b23acc
	return nm_hash_ptr (ptr);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_pstr_hash (gconstpointer p)
Packit Service b23acc
{
Packit Service b23acc
	const char *const*s = p;
Packit Service b23acc
Packit Service b23acc
	if (!s)
Packit Service b23acc
		return nm_hash_static (101061439u);
Packit Service b23acc
	return nm_hash_str (*s);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
gboolean
Packit Service b23acc
nm_pstr_equal (gconstpointer a, gconstpointer b)
Packit Service b23acc
{
Packit Service b23acc
	const char *const*s1 = a;
Packit Service b23acc
	const char *const*s2 = b;
Packit Service b23acc
Packit Service b23acc
	return    (s1 == s2)
Packit Service b23acc
	       || (   s1
Packit Service b23acc
	           && s2
Packit Service b23acc
	           && nm_streq0 (*s1, *s2));
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_pint_hash (gconstpointer p)
Packit Service b23acc
{
Packit Service b23acc
	const int *s = p;
Packit Service b23acc
Packit Service b23acc
	if (!s)
Packit Service b23acc
		return nm_hash_static (298377461u);
Packit Service b23acc
	return nm_hash_val (1208815757u, *s);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
gboolean
Packit Service b23acc
nm_pint_equals (gconstpointer a, gconstpointer b)
Packit Service b23acc
{
Packit Service b23acc
	const int *s1 = a;
Packit Service b23acc
	const int *s2 = a;
Packit Service b23acc
Packit Service b23acc
	return    s1 == s2
Packit Service b23acc
	       || (s1 && s2 && *s1 == *s2);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_pdirect_hash (gconstpointer p)
Packit Service b23acc
{
Packit Service b23acc
	const void *const*s = p;
Packit Service b23acc
Packit Service b23acc
	if (!s)
Packit Service b23acc
		return nm_hash_static (1852748873u);
Packit Service b23acc
	return nm_direct_hash (*s);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
gboolean
Packit Service b23acc
nm_pdirect_equal (gconstpointer a, gconstpointer b)
Packit Service b23acc
{
Packit Service b23acc
	const void *const*s1 = a;
Packit Service b23acc
	const void *const*s2 = b;
Packit Service b23acc
Packit Service b23acc
	return    (s1 == s2)
Packit Service b23acc
	       || (   s1
Packit Service b23acc
	           && s2
Packit Service b23acc
	           && *s1 == *s2);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_ppdirect_hash (gconstpointer p)
Packit Service b23acc
{
Packit Service b23acc
	const void *const*const*s = p;
Packit Service b23acc
Packit Service b23acc
	if (!s)
Packit Service b23acc
		return nm_hash_static (396534869u);
Packit Service b23acc
	if (!*s)
Packit Service b23acc
		return nm_hash_static (1476102263u);
Packit Service b23acc
	return nm_direct_hash (**s);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
gboolean
Packit Service b23acc
nm_ppdirect_equal (gconstpointer a, gconstpointer b)
Packit Service b23acc
{
Packit Service b23acc
	const void *const*const*s1 = a;
Packit Service b23acc
	const void *const*const*s2 = b;
Packit Service b23acc
Packit Service b23acc
	if (s1 == s2)
Packit Service b23acc
		return TRUE;
Packit Service b23acc
	if (!s1 || !s2)
Packit Service b23acc
		return FALSE;
Packit Service b23acc
Packit Service b23acc
	if (*s1 == *s2)
Packit Service b23acc
		return TRUE;
Packit Service b23acc
	if (!*s1 || !*s2)
Packit Service b23acc
		return FALSE;
Packit Service b23acc
Packit Service b23acc
	return **s1 == **s2;
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_gbytes_hash (gconstpointer p)
Packit Service b23acc
{
Packit Service b23acc
	GBytes *ptr = (GBytes *) p;
Packit Service b23acc
	gconstpointer arr;
Packit Service b23acc
	gsize len;
Packit Service b23acc
Packit Service b23acc
	arr = g_bytes_get_data (ptr, &len;;
Packit Service b23acc
	return nm_hash_mem (792701303u, arr, len);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
guint
Packit Service b23acc
nm_pgbytes_hash (gconstpointer p)
Packit Service b23acc
{
Packit Service b23acc
	GBytes *const*ptr = p;
Packit Service b23acc
	gconstpointer arr;
Packit Service b23acc
	gsize len;
Packit Service b23acc
Packit Service b23acc
	arr = g_bytes_get_data (*ptr, &len;;
Packit Service b23acc
	return nm_hash_mem (1470631313u, arr, len);
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
gboolean
Packit Service b23acc
nm_pgbytes_equal (gconstpointer a, gconstpointer b)
Packit Service b23acc
{
Packit Service b23acc
	GBytes *const*ptr_a = a;
Packit Service b23acc
	GBytes *const*ptr_b = b;
Packit Service b23acc
Packit Service b23acc
	return g_bytes_equal (*ptr_a, *ptr_b);
Packit Service b23acc
}