ucommon
|
A generic and portable implimentation of Read/Write locking. More...
#include <thread.h>
Data Structures | |
class | guard_reader |
Guard class to apply scope based access locking to objects. More... | |
class | guard_writer |
Guard class to apply scope based exclusive locking to objects. More... | |
Public Member Functions | |
bool | access (timeout_t timeout=Timer::inf) |
Request shared (read) access through the lock. | |
bool | modify (timeout_t timeout=Timer::inf) |
Request modify (write) access through the lock. | |
void | release (void) |
Release the lock. | |
ThreadLock () | |
Create an instance of a rwlock. | |
![]() | |
void | exclusive_lock (void) |
Access interface to exclusive lock the object. | |
void | release_exclusive (void) |
Access interface to release a lock. | |
![]() | |
virtual void | exclusive (void) |
Convert object to an exclusive lock. | |
void | release_share (void) |
virtual void | share (void) |
Share the lock with other referencers. | |
void | shared_lock (void) |
Static Public Member Functions | |
static void | indexing (unsigned size) |
Specify hash table size for guard protection. | |
static bool | reader (const void *object, timeout_t timeout=Timer::inf) |
Shared access to an arbitrary object. | |
static void | release (const void *object) |
Release an arbitrary object that has been protected by a rwlock. | |
static bool | writer (const void *object, timeout_t timeout=Timer::inf) |
Write protect access to an arbitrary object. | |
Protected Member Functions | |
virtual void | _lock (void) |
virtual void | _share (void) |
Access interface to share lock the object. | |
virtual void | _unlock (void) |
Protected Attributes | |
pthread_t | writeid |
unsigned | writers |
Additional Inherited Members | |
![]() | |
void | access (void) |
Access mode shared thread scheduling. | |
void | commit (void) |
Complete exclusive mode write scheduling. | |
ConditionalAccess () | |
Initialize and construct conditional. | |
void | limit_sharing (unsigned max) |
Specify a maximum sharing (access) limit. | |
void | modify (void) |
Exclusive mode write thread scheduling. | |
void | release (void) |
Release access mode read scheduling. | |
~ConditionalAccess () | |
Destroy conditional, release any blocked threads. | |
void | broadcast (void) |
Signal the conditional to release all broadcast threads. | |
void | lock (void) |
Lock the conditional's supporting mutex. | |
void | signal (void) |
Signal the conditional to release one signalled thread. | |
void | unlock (void) |
Unlock the conditional's supporting mutex. | |
bool | waitBroadcast (timeout_t timeout) |
Conditional wait for broadcast on millisecond timeout. | |
bool | waitBroadcast (struct timespec *timeout) |
Conditional wait for broadcast on timespec timeout. | |
void | waitBroadcast (void) |
Wait (block) until broadcast. | |
bool | waitSignal (timeout_t timeout) |
Conditional wait for signal on millisecond timeout. | |
bool | waitSignal (struct timespec *timeout) |
Conditional wait for signal on timespec timeout. | |
void | waitSignal (void) |
Wait (block) until signalled. | |
A generic and portable implimentation of Read/Write locking.
This class impliments classical read/write locking, including "timed" locks. Support for scheduling threads to avoid writer starvation is also provided for. By building read/write locks from a conditional, we make them available on pthread implimetations and other platforms which do not normally include optional pthread rwlock's. We also do not restrict the number of threads that may use the lock. Finally, both the exclusive and shared protocols are implimented to support exclusive_lock and shared_lock referencing.
bool ucommon::ThreadLock::access | ( | timeout_t | timeout = Timer::inf | ) |
Request shared (read) access through the lock.
timeout | in milliseconds to wait for lock. |
|
static |
Specify hash table size for guard protection.
The default is 1. This should be called at initialization time from the main thread of the application before any other threads are created.
size | of hash table used for guarding. |
bool ucommon::ThreadLock::modify | ( | timeout_t | timeout = Timer::inf | ) |
Request modify (write) access through the lock.
timeout | in milliseconds to wait for lock. |
|
static |
Shared access to an arbitrary object.
This is based on the protect function of mutex.
object | to share. |
timeout | in milliseconds to wait for lock. |
|
static |
Release an arbitrary object that has been protected by a rwlock.
object | to release. |
|
static |
Write protect access to an arbitrary object.
This is like the protect function of mutex.
object | to protect. |
timeout | in milliseconds to wait for lock. |