ACE
6.1.9
|
Wrapper for readers/writer locks. More...
#include <RW_Mutex.h>
Public Member Functions | |
ACE_RW_Mutex (int type=USYNC_THREAD, const ACE_TCHAR *name=0, void *arg=0) | |
Initialize a readers/writer lock. More... | |
~ACE_RW_Mutex (void) | |
Implicitly destroy a readers/writer lock. More... | |
int | remove (void) |
int | acquire_read (void) |
Acquire a read lock, but block if a writer hold the lock. More... | |
int | acquire_write (void) |
int | tryacquire_read (void) |
int | tryacquire_write (void) |
Conditionally acquire a write lock (i.e., won't block). More... | |
int | tryacquire_write_upgrade (void) |
int | acquire (void) |
int | tryacquire (void) |
int | release (void) |
Unlock a readers/writer lock. More... | |
const ACE_rwlock_t & | lock (void) const |
Return the underlying lock. More... | |
void | dump (void) const |
Dump the state of an object. More... | |
Public Attributes | |
ACE_ALLOC_HOOK_DECLARE | |
Declare the dynamic allocation hooks. More... | |
Protected Attributes | |
ACE_rwlock_t | lock_ |
Readers/writer lock. More... | |
bool | removed_ |
Private Member Functions | |
void | operator= (const ACE_RW_Mutex &) |
ACE_RW_Mutex (const ACE_RW_Mutex &) | |
Wrapper for readers/writer locks.
These are most useful for applications that have many more parallel readers than writers...
ACE_RW_Mutex::ACE_RW_Mutex | ( | int | type = USYNC_THREAD , |
const ACE_TCHAR * | name = 0 , |
||
void * | arg = 0 |
||
) |
Initialize a readers/writer lock.
ACE_RW_Mutex::~ACE_RW_Mutex | ( | void | ) |
Implicitly destroy a readers/writer lock.
|
private |
|
inline |
Note, for interface uniformity with other synchronization wrappers we include the <acquire> method. This is implemented as a write-lock to safe...
|
inline |
Acquire a read lock, but block if a writer hold the lock.
|
inline |
Acquire a write lock, but block if any readers or a writer hold the lock.
void ACE_RW_Mutex::dump | ( | void | ) | const |
Dump the state of an object.
|
inline |
Return the underlying lock.
|
private |
|
inline |
Unlock a readers/writer lock.
|
inline |
Explicitly destroy a readers/writer lock. Note that only one thread should call this method since it doesn't protect against race conditions.
|
inline |
Note, for interface uniformity with other synchronization wrappers we include the tryacquire() method. This is implemented as a write-lock to be safe... Returns -1 on failure. If we "failed" because someone else already had the lock, errno
is set to EBUSY
.
|
inline |
Conditionally acquire a read lock (i.e., won't block). Returns -1 on failure. If we "failed" because someone else already had the lock, errno
is set to EBUSY
.
|
inline |
Conditionally acquire a write lock (i.e., won't block).
|
inline |
Conditionally upgrade a read lock to a write lock. This only works if there are no other readers present, in which case the method returns 0. Otherwise, the method returns -1 and sets errno
to EBUSY
. Note that the caller of this method must already possess this lock as a read lock (but this condition is not checked by the current implementation).
ACE_RW_Mutex::ACE_ALLOC_HOOK_DECLARE |
Declare the dynamic allocation hooks.
|
protected |
Readers/writer lock.
|
protected |
Keeps track of whether remove() has been called yet to avoid multiple remove() calls, e.g., explicitly and implicitly in the destructor. This flag isn't protected by a lock, so make sure that you don't have multiple threads simultaneously calling remove() on the same object, which is a bad idea anyway...