Contents
Notes
…
- Readers-writer locks preferring readers.
- That is, writers must wait until there are no more readers.
…
Include
ao_async.h |
ao_list.h |
ao_time.h |
ao_uint.h |
stdbool.h |
Types
ao_rw_t
typedef struct ao_rw_t ao_rw_t;
Represents a readers-writer lock.
ao_rw_lock_t
typedef struct ao_rw_lock_t ao_rw_lock_t;
Represents the locking of a readers-writer lock.
Structs
ao_rw_t
struct ao_rw_t
{
ao_uint_t active_r;
bool active_w;
ao_list_t lock_r;
ao_list_t lock_w;
};
active_r |
The number of active readers. |
active_w |
Indicates whether a writer is active. |
lock_r |
The list of waiting readers. |
lock_w |
The list of waiting writers. |
ao_rw_lock_t
struct ao_rw_lock_t
{
ao_async_t async;
bool volatile result;
ao_rw_t * rw;
ao_list_node_t rw_lock_node;
};
async |
The asynchronous event. |
result |
The result. |
rw |
The readers-writer lock. |
rw_lock_node |
The node for the readers-writer lock’s waiting lists. |
Functions
ao_rw_lock_read
ao_rw_lock_read_from
bool ao_rw_lock_read (ao_rw_t * r, ao_time_t timeout);
bool ao_rw_lock_read_from(ao_rw_t * r, ao_time_t timeout, ao_time_t beginning);
Locks a readers-writer lock for reading in a blocking fashion with a timeout and an optional beginning.
ao_rw_lock_read_forever
bool ao_rw_lock_read_forever(ao_rw_t * r);
Locks a readers-writer lock for reading indefinitely in a blocking fashion.
ao_rw_lock_read_try
bool ao_rw_lock_read_try(ao_rw_t * r);
Locks a readers-writer lock for reading in a non-blocking fashion.
ao_rw_lock_read_begin
ao_rw_lock_read_end
void ao_rw_lock_read_begin(ao_rw_lock_t * l);
void ao_rw_lock_read_end (ao_rw_lock_t * l);
Begins or ends, respectively, a locking of a readers-writer lock for reading.
ao_rw_lock_write
ao_rw_lock_write_from
bool ao_rw_lock_write (ao_rw_t * r, ao_time_t timeout);
bool ao_rw_lock_write_from(ao_rw_t * r, ao_time_t timeout, ao_time_t beginning);
Locks a readers-writer lock for writing in a blocking fashion with a timeout and an optional beginning.
ao_rw_lock_write_forever
bool ao_rw_lock_write_forever(ao_rw_t * r);
Locks a readers-writer lock for writing indefinitely in a blocking fashion.
ao_rw_lock_write_try
bool ao_rw_lock_write_try(ao_rw_t * r);
Locks a readers-writer lock for writing in a non-blocking fashion.
ao_rw_lock_write_begin
ao_rw_lock_write_end
void ao_rw_lock_write_begin(ao_rw_lock_t * l);
void ao_rw_lock_write_end (ao_rw_lock_t * l);
Begins or ends, respectively, a locking of a readers-writer lock for writing.
ao_rw_unlock_read
void ao_rw_unlock_read(ao_rw_t * r);
Unlocks a readers-writer lock for reading.
ao_rw_unlock_write
void ao_rw_unlock_write(ao_rw_t * r);
Unlocks a readers-writer lock for writing.