mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-10-05 21:29:20 +02:00
b8f0117b95
These are similar to g_pointer_bit_lock_and_get() and g_pointer_bit_unlock_and_set(). The bitlock API is pretty amazing, as it allows to use a single bit of an integer for locking while using the remaining 31 bits for other purposes. But those other bits always need to be accessed atomically too. There is a use in being able to lock_and_get(), to combine the setting of the lock bit and fetching the new value at once. For one, that can safe additional atomic operations to fetch the value afterwards. But more importantly, it allows to do this change in one atomic operation. Likewise, unlock_and_set() allows to atomically clear the lock bit and set a new value (while also preserving unrelated bits, by using the @preserve_mask parameter).
121 lines
4.6 KiB
C
121 lines
4.6 KiB
C
/*
|
|
* Copyright © 2008 Ryan Lortie
|
|
* Copyright © 2010 Codethink Limited
|
|
*
|
|
* SPDX-License-Identifier: LGPL-2.1-or-later
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Author: Ryan Lortie <desrt@desrt.ca>
|
|
*/
|
|
|
|
#ifndef __G_BITLOCK_H__
|
|
#define __G_BITLOCK_H__
|
|
|
|
#include <glib/gtypes.h>
|
|
|
|
#if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
|
|
#error "Only <glib.h> can be included directly."
|
|
#endif
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_bit_lock (volatile gint *address,
|
|
gint lock_bit);
|
|
GLIB_AVAILABLE_IN_2_86
|
|
void g_bit_lock_and_get (gint *address,
|
|
guint lock_bit,
|
|
gint *out_val);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_bit_trylock (volatile gint *address,
|
|
gint lock_bit);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_bit_unlock (volatile gint *address,
|
|
gint lock_bit);
|
|
|
|
GLIB_AVAILABLE_IN_2_86
|
|
void g_bit_unlock_and_set (gint *address,
|
|
guint lock_bit,
|
|
gint new_val,
|
|
gint preserve_mask);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_pointer_bit_lock (volatile void *address,
|
|
gint lock_bit);
|
|
|
|
GLIB_AVAILABLE_IN_2_80
|
|
void g_pointer_bit_lock_and_get (gpointer address,
|
|
guint lock_bit,
|
|
guintptr *out_ptr);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_pointer_bit_trylock (volatile void *address,
|
|
gint lock_bit);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_pointer_bit_unlock (volatile void *address,
|
|
gint lock_bit);
|
|
|
|
GLIB_AVAILABLE_IN_2_80
|
|
gpointer g_pointer_bit_lock_mask_ptr (gpointer ptr,
|
|
guint lock_bit,
|
|
gboolean set,
|
|
guintptr preserve_mask,
|
|
gpointer preserve_ptr);
|
|
|
|
GLIB_AVAILABLE_IN_2_80
|
|
void g_pointer_bit_unlock_and_set (void *address,
|
|
guint lock_bit,
|
|
gpointer ptr,
|
|
guintptr preserve_mask);
|
|
|
|
#ifdef __GNUC__
|
|
|
|
#define g_pointer_bit_lock(address, lock_bit) \
|
|
(G_GNUC_EXTENSION ({ \
|
|
G_STATIC_ASSERT (sizeof *(address) == sizeof (gpointer)); \
|
|
g_pointer_bit_lock ((address), (lock_bit)); \
|
|
}))
|
|
|
|
#define g_pointer_bit_lock_and_get(address, lock_bit, out_ptr) \
|
|
(G_GNUC_EXTENSION ({ \
|
|
G_STATIC_ASSERT (sizeof *(address) == sizeof (gpointer)); \
|
|
g_pointer_bit_lock_and_get ((address), (lock_bit), (out_ptr)); \
|
|
}))
|
|
|
|
#define g_pointer_bit_trylock(address, lock_bit) \
|
|
(G_GNUC_EXTENSION ({ \
|
|
G_STATIC_ASSERT (sizeof *(address) == sizeof (gpointer)); \
|
|
g_pointer_bit_trylock ((address), (lock_bit)); \
|
|
}))
|
|
|
|
#define g_pointer_bit_unlock(address, lock_bit) \
|
|
(G_GNUC_EXTENSION ({ \
|
|
G_STATIC_ASSERT (sizeof *(address) == sizeof (gpointer)); \
|
|
g_pointer_bit_unlock ((address), (lock_bit)); \
|
|
}))
|
|
|
|
#define g_pointer_bit_unlock_and_set(address, lock_bit, ptr, preserve_mask) \
|
|
(G_GNUC_EXTENSION ({ \
|
|
G_STATIC_ASSERT (sizeof *(address) == sizeof (gpointer)); \
|
|
g_pointer_bit_unlock_and_set ((address), (lock_bit), (ptr), (preserve_mask)); \
|
|
}))
|
|
|
|
#endif
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_BITLOCK_H_ */
|