mutex.h File Reference

#include <uacpi/internal/types.h>
#include <uacpi/kernel_api.h>

Include dependency graph for mutex.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	uacpi_recursive_lock
struct	uacpi_rw_lock

Functions
uacpi_bool	uacpi_this_thread_owns_aml_mutex (uacpi_mutex *)
uacpi_status	uacpi_acquire_aml_mutex (uacpi_mutex *, uacpi_u16 timeout)
uacpi_status	uacpi_release_aml_mutex (uacpi_mutex *)
static uacpi_handle	uacpi_create_native_mutex (void)
static void	uacpi_free_native_mutex (uacpi_handle mtx)
static uacpi_status	uacpi_acquire_native_mutex (uacpi_handle mtx)
uacpi_status	uacpi_acquire_native_mutex_with_timeout (uacpi_handle mtx, uacpi_u16 timeout)
static uacpi_status	uacpi_release_native_mutex (uacpi_handle mtx)
static uacpi_status	uacpi_acquire_native_mutex_may_be_null (uacpi_handle mtx)
static uacpi_status	uacpi_release_native_mutex_may_be_null (uacpi_handle mtx)
static uacpi_handle	uacpi_create_native_event (void)
static void	uacpi_free_native_event (uacpi_handle evt)
static uacpi_bool	uacpi_wait_for_native_event (uacpi_handle evt, uacpi_u16 timeout)
static void	uacpi_signal_native_event (uacpi_handle evt)
static void	uacpi_reset_native_event (uacpi_handle evt)
uacpi_status	uacpi_recursive_lock_init (struct uacpi_recursive_lock *lock)
uacpi_status	uacpi_recursive_lock_deinit (struct uacpi_recursive_lock *lock)
uacpi_status	uacpi_recursive_lock_acquire (struct uacpi_recursive_lock *lock)
uacpi_status	uacpi_recursive_lock_release (struct uacpi_recursive_lock *lock)
uacpi_status	uacpi_rw_lock_init (struct uacpi_rw_lock *lock)
uacpi_status	uacpi_rw_lock_deinit (struct uacpi_rw_lock *lock)
uacpi_status	uacpi_rw_lock_read (struct uacpi_rw_lock *lock)
uacpi_status	uacpi_rw_unlock_read (struct uacpi_rw_lock *lock)
uacpi_status	uacpi_rw_lock_write (struct uacpi_rw_lock *lock)
uacpi_status	uacpi_rw_unlock_write (struct uacpi_rw_lock *lock)

Function Documentation

uacpi_acquire_aml_mutex()

uacpi_status uacpi_acquire_aml_mutex	(	uacpi_mutex *	mutex,
		uacpi_u16	timeout
	)

Definition at line 199 of file mutex.c.

{
    uacpi_thread_id this_id;
    uacpi_status ret = UACPI_STATUS_OK;
 
    this_id = uacpi_kernel_get_thread_id();
    if (UACPI_ATOMIC_LOAD_THREAD_ID(&mutex->owner) == this_id) {
        if (uacpi_unlikely(mutex->depth == 0xFFFF)) {
            uacpi_warn(
                "failing an attempt to acquire mutex @%p, too many recursive "
                "acquires", mutex
            );
            return UACPI_STATUS_DENIED;
        }
 
        mutex->depth++;
        return ret;
    }
 
    uacpi_namespace_write_unlock();
    ret = uacpi_acquire_native_mutex_with_timeout(mutex->handle, timeout);
    if (ret != UACPI_STATUS_OK)
        goto out;
 
    if (mutex->handle == g_uacpi_rt_ctx.global_lock_mutex->handle) {
        ret = uacpi_acquire_global_lock_from_firmware();
        if (uacpi_unlikely_error(ret)) {
            uacpi_release_native_mutex(mutex->handle);
            goto out;
        }
    }
 
    UACPI_ATOMIC_STORE_THREAD_ID(&mutex->owner, this_id);
    mutex->depth = 1;
 
out:
    uacpi_namespace_write_lock();
    return ret;
}

Referenced by enter_method(), handle_mutex_ctl(), and lock_field_unit_transaction().

uacpi_acquire_native_mutex()

static uacpi_status uacpi_acquire_native_mutex ( uacpi_handle  mtx )

inlinestatic

Definition at line 32 of file mutex.h.

{
    if (uacpi_unlikely(mtx == UACPI_NULL))
        return UACPI_STATUS_INVALID_ARGUMENT;
 
    return uacpi_kernel_wait_for_semaphore(mtx, 0xFFFF);
}

Referenced by configure_host_interface(), uacpi_bulk_configure_interfaces(), uacpi_handle_osi(), uacpi_install_interface(), uacpi_install_notify_handler(), uacpi_notify_all(), uacpi_recursive_lock_acquire(), uacpi_rw_lock_read(), uacpi_rw_lock_write(), uacpi_rw_unlock_read(), uacpi_set_interface_query_handler(), uacpi_uninstall_interface(), and uacpi_uninstall_notify_handler().

uacpi_acquire_native_mutex_may_be_null()

static uacpi_status uacpi_acquire_native_mutex_may_be_null ( uacpi_handle  mtx )

inlinestatic

Definition at line 53 of file mutex.h.

{
    if (mtx == UACPI_NULL)
        return UACPI_STATUS_OK;
 
    return uacpi_kernel_wait_for_semaphore(mtx, 0xFFFF);
}

Referenced by table_ctl(), uacpi_for_each_installed_table(), uacpi_for_each_table(), uacpi_set_table_installation_handler(), uacpi_table_info_get_by_index(), uacpi_table_install_physical_with_origin(), and uacpi_table_install_with_origin().

uacpi_acquire_native_mutex_with_timeout()

uacpi_status uacpi_acquire_native_mutex_with_timeout	(	uacpi_handle	mtx,
		uacpi_u16	timeout
	)

Referenced by uacpi_acquire_aml_mutex(), and uacpi_acquire_global_lock().

uacpi_create_native_event()

static uacpi_handle uacpi_create_native_event ( void  )

inlinestatic

Definition at line 78 of file mutex.h.

{
    return uacpi_kernel_create_semaphore(0);
}

Referenced by event_alloc(), and uacpi_initialize_events().

uacpi_create_native_mutex()

static uacpi_handle uacpi_create_native_mutex ( void  )

inlinestatic

Definition at line 22 of file mutex.h.

{
    return uacpi_kernel_create_semaphore(1);
}

Referenced by uacpi_create_mutex(), uacpi_initialize_interfaces(), uacpi_initialize_notify(), uacpi_initialize_tables(), uacpi_recursive_lock_init(), and uacpi_rw_lock_init().

uacpi_free_native_event()

static void uacpi_free_native_event ( uacpi_handle  evt )

inlinestatic

Definition at line 83 of file mutex.h.

{
    uacpi_kernel_free_semaphore(evt);
}

Referenced by free_event(), and uacpi_state_reset().

uacpi_free_native_mutex()

static void uacpi_free_native_mutex ( uacpi_handle  mtx )

inlinestatic

Definition at line 27 of file mutex.h.

{
    uacpi_kernel_free_semaphore(mtx);
}

Referenced by free_mutex(), uacpi_deinitialize_interfaces(), uacpi_deinitialize_notify(), uacpi_deinitialize_tables(), uacpi_recursive_lock_deinit(), uacpi_rw_lock_deinit(), and uacpi_rw_lock_init().

uacpi_recursive_lock_acquire()

uacpi_status uacpi_recursive_lock_acquire

(

struct uacpi_recursive_lock *

lock

)

Definition at line 285 of file mutex.c.

{
    uacpi_thread_id this_id;
    uacpi_status ret = UACPI_STATUS_OK;
 
    this_id = uacpi_kernel_get_thread_id();
    if (UACPI_ATOMIC_LOAD_THREAD_ID(&lock->owner) == this_id) {
        lock->depth++;
        return ret;
    }
 
    ret = uacpi_acquire_native_mutex(lock->mutex);
    if (uacpi_unlikely_error(ret))
        return ret;
 
    UACPI_ATOMIC_STORE_THREAD_ID(&lock->owner, this_id);
    lock->depth = 1;
    return ret;
}

Referenced by event_config_lock(), for_all_gpes_locked(), uacpi_clear_all_events(), uacpi_enable_gpe(), uacpi_events_match_post_dynamic_table_load(), uacpi_finalize_gpe_initialization(), uacpi_install_address_space_handler_with_flags(), uacpi_reg_all_opregions(), uacpi_uninstall_address_space_handler(), uacpi_upgrade_to_opregion_lock(), unlink_gpe_interrupt_ctx(), and wait_for_work_completion_unlocked().

uacpi_recursive_lock_deinit()

uacpi_status uacpi_recursive_lock_deinit

(

struct uacpi_recursive_lock *

lock

)

Definition at line 265 of file mutex.c.

{
    if (uacpi_unlikely(lock->depth)) {
        uacpi_warn(
            "de-initializing active recursive lock %p with depth=%zu",
            lock, lock->depth
        );
        lock->depth = 0;
    }
 
    lock->owner = UACPI_THREAD_ID_NONE;
 
    if (lock->mutex != UACPI_NULL) {
        uacpi_free_native_mutex(lock->mutex);
        lock->mutex = UACPI_NULL;
    }
 
    return UACPI_STATUS_OK;
}

Referenced by uacpi_deinitialize_events(), and uacpi_deinitialize_opregion().

uacpi_recursive_lock_init()

uacpi_status uacpi_recursive_lock_init

(

struct uacpi_recursive_lock *

lock

)

Definition at line 253 of file mutex.c.

{
    lock->mutex = uacpi_create_native_mutex();
    if (uacpi_unlikely(lock->mutex == UACPI_NULL))
        return UACPI_STATUS_OUT_OF_MEMORY;
 
    lock->owner = UACPI_THREAD_ID_NONE;
    lock->depth = 0;
 
    return UACPI_STATUS_OK;
}

Referenced by uacpi_initialize_events_early(), and uacpi_initialize_opregion().

uacpi_recursive_lock_release()

uacpi_status uacpi_recursive_lock_release

(

struct uacpi_recursive_lock *

lock

)

Definition at line 305 of file mutex.c.

{
    if (lock->depth-- > 1)
        return UACPI_STATUS_OK;
 
    UACPI_ATOMIC_STORE_THREAD_ID(&lock->owner, UACPI_THREAD_ID_NONE);
    return uacpi_release_native_mutex(lock->mutex);
}

Referenced by event_config_lock(), event_config_unlock(), for_all_gpes_locked(), uacpi_clear_all_events(), uacpi_enable_gpe(), uacpi_events_match_post_dynamic_table_load(), uacpi_finalize_gpe_initialization(), uacpi_initialize_opregion_node(), uacpi_install_address_space_handler_with_flags(), uacpi_opregion_uninstall_handler(), uacpi_reg_all_opregions(), uacpi_release_opregion_lock(), uacpi_uninstall_address_space_handler(), unlink_gpe_interrupt_ctx(), and wait_for_work_completion_unlocked().

uacpi_release_aml_mutex()

uacpi_status uacpi_release_aml_mutex

(

uacpi_mutex *

mutex

)

Definition at line 239 of file mutex.c.

{
    if (mutex->depth-- > 1)
        return UACPI_STATUS_OK;
 
    if (mutex->handle == g_uacpi_rt_ctx.global_lock_mutex->handle)
        uacpi_release_global_lock_to_firmware();
 
    UACPI_ATOMIC_STORE_THREAD_ID(&mutex->owner, UACPI_THREAD_ID_NONE);
    uacpi_release_native_mutex(mutex->handle);
 
    return UACPI_STATUS_OK;
}

Referenced by enter_method(), handle_mutex_ctl(), held_mutexes_array_remove_and_release(), lock_field_unit_transaction(), and unlock_field_unit_transaction().

uacpi_release_native_mutex()

static uacpi_status uacpi_release_native_mutex ( uacpi_handle  mtx )

inlinestatic

Definition at line 44 of file mutex.h.

{
    if (uacpi_unlikely(mtx == UACPI_NULL))
        return UACPI_STATUS_INVALID_ARGUMENT;
 
    uacpi_kernel_signal_semaphore(mtx);
    return UACPI_STATUS_OK;
}

Referenced by configure_host_interface(), uacpi_acquire_aml_mutex(), uacpi_acquire_global_lock(), uacpi_bulk_configure_interfaces(), uacpi_handle_osi(), uacpi_install_interface(), uacpi_install_notify_handler(), uacpi_notify_all(), uacpi_recursive_lock_release(), uacpi_release_aml_mutex(), uacpi_release_global_lock(), uacpi_rw_lock_read(), uacpi_rw_unlock_read(), uacpi_rw_unlock_write(), uacpi_set_interface_query_handler(), uacpi_uninstall_interface(), and uacpi_uninstall_notify_handler().

uacpi_release_native_mutex_may_be_null()

static uacpi_status uacpi_release_native_mutex_may_be_null ( uacpi_handle  mtx )

inlinestatic

Definition at line 63 of file mutex.h.

{
    if (mtx == UACPI_NULL)
        return UACPI_STATUS_OK;
 
    uacpi_kernel_signal_semaphore(mtx);
    return UACPI_STATUS_OK;
}

Referenced by table_ctl(), uacpi_for_each_installed_table(), uacpi_for_each_table(), uacpi_set_table_installation_handler(), uacpi_table_info_get_by_index(), uacpi_table_install_physical_with_origin(), and uacpi_table_install_with_origin().

uacpi_reset_native_event()

static void uacpi_reset_native_event ( uacpi_handle  evt )

inlinestatic

Definition at line 106 of file mutex.h.

{
    while (uacpi_kernel_wait_for_semaphore(evt, 0) == UACPI_STATUS_OK);
}

Referenced by handle_event_ctl().

uacpi_rw_lock_deinit()

uacpi_status uacpi_rw_lock_deinit

(

struct uacpi_rw_lock *

lock

)

Definition at line 331 of file mutex.c.

{
    if (uacpi_unlikely(lock->num_readers)) {
        uacpi_warn("de-initializing rw_lock %p with %zu active readers",
                   lock, lock->num_readers);
        lock->num_readers = 0;
    }
 
    if (lock->read_mutex != UACPI_NULL) {
        uacpi_free_native_mutex(lock->read_mutex);
        lock->read_mutex = UACPI_NULL;
    }
    if (lock->write_mutex != UACPI_NULL) {
        uacpi_free_native_mutex(lock->write_mutex);
        lock->write_mutex = UACPI_NULL;
    }
 
    return UACPI_STATUS_OK;
}

Referenced by uacpi_deinitialize_namespace().

uacpi_rw_lock_init()

uacpi_status uacpi_rw_lock_init

(

struct uacpi_rw_lock *

lock

)

Definition at line 314 of file mutex.c.

{
    lock->read_mutex = uacpi_create_native_mutex();
    if (uacpi_unlikely(lock->read_mutex == UACPI_NULL))
        return UACPI_STATUS_OUT_OF_MEMORY;
 
    lock->write_mutex = uacpi_create_native_mutex();
    if (uacpi_unlikely(lock->write_mutex == UACPI_NULL)) {
        uacpi_free_native_mutex(lock->read_mutex);
        lock->read_mutex = UACPI_NULL;
        return UACPI_STATUS_OUT_OF_MEMORY;
    }
 
    lock->num_readers = 0;
    return UACPI_STATUS_OK;
}

Referenced by uacpi_initialize_namespace().

uacpi_rw_lock_read()

uacpi_status uacpi_rw_lock_read

(

struct uacpi_rw_lock *

lock

)

Definition at line 351 of file mutex.c.

{
    uacpi_status ret;
 
    ret = uacpi_acquire_native_mutex(lock->read_mutex);
    if (uacpi_unlikely_error(ret))
        return ret;
 
    if (lock->num_readers++ == 0) {
        ret = uacpi_acquire_native_mutex(lock->write_mutex);
        if (uacpi_unlikely_error(ret))
            lock->num_readers = 0;
    }
 
    uacpi_release_native_mutex(lock->read_mutex);
    return ret;
}

Referenced by uacpi_namespace_read_lock().

uacpi_rw_lock_write()

uacpi_status uacpi_rw_lock_write

(

struct uacpi_rw_lock *

lock

)

Definition at line 384 of file mutex.c.

{
    return uacpi_acquire_native_mutex(lock->write_mutex);
}

Referenced by uacpi_namespace_write_lock().

uacpi_rw_unlock_read()

uacpi_status uacpi_rw_unlock_read

(

struct uacpi_rw_lock *

lock

)

Definition at line 369 of file mutex.c.

{
    uacpi_status ret;
 
    ret = uacpi_acquire_native_mutex(lock->read_mutex);
    if (uacpi_unlikely_error(ret))
        return ret;
 
    if (lock->num_readers-- == 1)
        uacpi_release_native_mutex(lock->write_mutex);
 
    uacpi_release_native_mutex(lock->read_mutex);
    return ret;
}

Referenced by uacpi_namespace_read_unlock().

uacpi_rw_unlock_write()

uacpi_status uacpi_rw_unlock_write

(

struct uacpi_rw_lock *

lock

)

Definition at line 389 of file mutex.c.

{
    return uacpi_release_native_mutex(lock->write_mutex);
}

Referenced by uacpi_namespace_write_unlock().

uacpi_signal_native_event()

static void uacpi_signal_native_event ( uacpi_handle  evt )

inlinestatic

Definition at line 95 of file mutex.h.

{
    uacpi_kernel_signal_semaphore(evt);
}

Referenced by handle_event_ctl(), and handle_global_lock().

uacpi_this_thread_owns_aml_mutex()

uacpi_bool uacpi_this_thread_owns_aml_mutex

(

uacpi_mutex *

mutex

)

Definition at line 191 of file mutex.c.

{
    uacpi_thread_id id;
 
    id = UACPI_ATOMIC_LOAD_THREAD_ID(&mutex->owner);
    return id == uacpi_kernel_get_thread_id();
}

Referenced by enter_method(), and handle_mutex_ctl().

uacpi_wait_for_native_event()

static uacpi_bool uacpi_wait_for_native_event ( uacpi_handle  evt, uacpi_u16  timeout  )

inlinestatic

Definition at line 88 of file mutex.h.

{
    return uacpi_kernel_wait_for_semaphore(evt, timeout) == UACPI_STATUS_OK;
}

Referenced by handle_event_ctl(), and uacpi_acquire_global_lock_from_firmware().