#include <Synch.h>
Inheritance diagram for ACE_RW_Mutex

Public Methods | |
| ACE_RW_Mutex (int type = USYNC_THREAD, const ACE_TCHAR *name = 0, void *arg = 0) | |
| Initialize a readers/writer lock. | |
| ~ACE_RW_Mutex (void) | |
| Implicitly destroy a readers/writer lock. | |
| int | remove (void) |
| int | acquire_read (void) |
| Acquire a read lock, but block if a writer hold the lock. | |
| int | acquire_write (void) |
| Acquire a write lock, but block if any readers or a writer hold the lock. | |
| int | tryacquire_read (void) |
| int | tryacquire_write (void) |
| Conditionally acquire a write lock (i.e., won't block). | |
| int | tryacquire_write_upgrade (void) |
| int | acquire (void) |
| int | tryacquire (void) |
| int | release (void) |
| Unlock a readers/writer lock. | |
| const ACE_rwlock_t& | lock (void) const |
| Return the underlying lock. | |
| void | dump (void) const |
| Dump the state of an object. | |
Public Attributes | |
| ACE_ALLOC_HOOK_DECLARE | |
| Declare the dynamic allocation hooks. | |
Protected Attributes | |
| ACE_rwlock_t | lock_ |
| Readers/writer lock. | |
| int | removed_ |
| 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... | |
Private Methods | |
| void | operator= (const ACE_RW_Mutex &) |
| ACE_RW_Mutex (const ACE_RW_Mutex &) | |
These are most useful for applications that have many more parallel readers than writers...
|
|
Initialize a readers/writer lock.
|
|
|
Implicitly destroy a readers/writer lock.
|
|
|
|
|
|
Note, for interface uniformity with other synchronization wrappers we include the method. This is implemented as a write-lock to safe... |
|
|
Acquire a read lock, but block if a writer hold the lock.
|
|
|
Acquire a write lock, but block if any readers or a writer hold the lock.
|
|
|
Dump the state of an object.
Reimplemented in ACE_RW_Thread_Mutex. |
|
|
Return the underlying lock.
|
|
|
|
|
|
Unlock a readers/writer lock.
|
|
|
Explicitly destroy a readers/writer lock. Note that only one thread should call this method since it doesn't protect against race conditions. |
|
|
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>. |
|
|
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>. |
|
|
Conditionally acquire a write lock (i.e., won't block).
|
|
|
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). Reimplemented in ACE_RW_Thread_Mutex. |
|
|
Declare the dynamic allocation hooks.
Reimplemented in ACE_RW_Thread_Mutex. |
|
|
Readers/writer lock.
|
|
|
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...
|
1.2.3 written by Dimitri van Heesch,
© 1997-2000