PthreadReadWriteLock Class Reference

#include <PthreadReadWriteLock.h>

Inheritance diagram for PthreadReadWriteLock:

Collaboration diagram for PthreadReadWriteLock:

Public Member Functions
	PthreadReadWriteLock (int _priorityWrites=1)
void	ReadLock (void)
void	WriteLock (void)
void	ReadUnlock (void)
void	WriteUnlock (void)
int	Error (void)
void	Clear (void)

Protected Member Functions
void	TrapError (int result)

Protected Attributes
int	error

Private Attributes
PthreadMutex	mutex
PthreadCondition	lockFree
int	numReaders
int	writing
int	noNewReaders
int	priorityWrites

Detailed Description

Definition at line 37 of file PthreadReadWriteLock.h.

Constructor & Destructor Documentation

PthreadReadWriteLock::PthreadReadWriteLock

(

int

_priorityWrites = 1

)

Definition at line 29 of file PthreadReadWriteLock.cc.

:   numReaders(0),
    writing(0),
    noNewReaders(0),
    priorityWrites(_priorityWrites)
//  mutex(), lockFree()
{
}

Member Function Documentation

void PthreadErrorHandler::Clear ( void  )

inlineinherited

Definition at line 40 of file PthreadErrorHandler.h.

References PthreadErrorHandler::error.

{ error = 0; }

int PthreadErrorHandler::Error ( void  )

inlineinherited

Definition at line 39 of file PthreadErrorHandler.h.

References PthreadErrorHandler::error.

{ return error; }

void PthreadReadWriteLock::ReadLock

(

void

)

Definition at line 41 of file PthreadReadWriteLock.cc.

References lockFree, mutex, noNewReaders, numReaders, and PthreadCondition::Wait().

Referenced by PthreadReadLockProtected::PthreadReadLockProtected().

{
    PthreadMutexProtected protect(mutex);
    while (noNewReaders)
        lockFree.Wait(mutex);
    numReaders++;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void PthreadReadWriteLock::ReadUnlock

(

void

)

Definition at line 66 of file PthreadReadWriteLock.cc.

References lockFree, mutex, numReaders, PthreadCondition::Signal(), and PthreadErrorHandler::TrapError().

Referenced by PthreadReadLockProtected::~PthreadReadLockProtected().

{
    PthreadMutexProtected protect(mutex);

    if (numReaders<=0) {
        TrapError(-1);
        return;
    }

    numReaders--;
    if (!numReaders)
        lockFree.Signal();
}

Here is the call graph for this function:

Here is the caller graph for this function:

void PthreadErrorHandler::TrapError ( int  result )

inlineprotectedinherited

Definition at line 48 of file PthreadErrorHandler.h.

References PthreadErrorHandler::error.

Referenced by PthreadCondition::Broadcast(), PthreadAttr::DetachState(), PthreadBase::Join(), Pthread::Join(), PthreadMutex::Lock(), PthreadMutex::Poll(), Pthread::Pthread(), PthreadAttr::PthreadAttr(), PthreadBase::PthreadBase(), PthreadCondition::PthreadCondition(), PthreadConditionAttr::PthreadConditionAttr(), PthreadKey< T >::PthreadKey(), PthreadMutex::PthreadMutex(), PthreadMutexAttr::PthreadMutexAttr(), ReadUnlock(), PthreadAttr::ScheduleScope(), PthreadKey< T >::Set(), PthreadCondition::Signal(), PthreadCondition::TimedWait(), PthreadMutex::Unlock(), PthreadCondition::Wait(), WriteUnlock(), PthreadAttr::~PthreadAttr(), PthreadCondition::~PthreadCondition(), PthreadConditionAttr::~PthreadConditionAttr(), PthreadKey< T >::~PthreadKey(), PthreadMutex::~PthreadMutex(), and PthreadMutexAttr::~PthreadMutexAttr().

{
    if (err) {
        error = err;
        throw ErrnoException(err);
    }
}

Here is the caller graph for this function:

void PthreadReadWriteLock::WriteLock

(

void

)

Definition at line 52 of file PthreadReadWriteLock.cc.

References lockFree, mutex, noNewReaders, numReaders, priorityWrites, PthreadCondition::Wait(), and writing.

Referenced by PthreadWriteLockProtected::PthreadWriteLockProtected().

{
    PthreadMutexProtected protect(mutex);
    if (priorityWrites)
        noNewReaders = 1;
    while (writing || numReaders)
        lockFree.Wait(mutex);
    writing++;
    noNewReaders = 1;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void PthreadReadWriteLock::WriteUnlock

(

void

)

Definition at line 83 of file PthreadReadWriteLock.cc.

References PthreadCondition::Broadcast(), lockFree, mutex, noNewReaders, PthreadErrorHandler::TrapError(), and writing.

Referenced by PthreadWriteLockProtected::~PthreadWriteLockProtected().

{
    PthreadMutexProtected protect(mutex);

    if (!writing) {
        TrapError(-1);
        return;
    }
    
    writing = 0;
    noNewReaders = 0;
    lockFree.Broadcast();
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

int PthreadErrorHandler::error

protectedinherited

Definition at line 43 of file PthreadErrorHandler.h.

Referenced by PthreadErrorHandler::Clear(), PthreadErrorHandler::Error(), PthreadErrorHandler::PthreadErrorHandler(), and PthreadErrorHandler::TrapError().

PthreadCondition PthreadReadWriteLock::lockFree

private

Definition at line 51 of file PthreadReadWriteLock.h.

Referenced by ReadLock(), ReadUnlock(), WriteLock(), and WriteUnlock().

PthreadMutex PthreadReadWriteLock::mutex

private

Definition at line 50 of file PthreadReadWriteLock.h.

Referenced by ReadLock(), ReadUnlock(), WriteLock(), and WriteUnlock().

int PthreadReadWriteLock::noNewReaders

private

Definition at line 54 of file PthreadReadWriteLock.h.

Referenced by ReadLock(), WriteLock(), and WriteUnlock().

int PthreadReadWriteLock::numReaders

private

Definition at line 52 of file PthreadReadWriteLock.h.

Referenced by ReadLock(), ReadUnlock(), and WriteLock().

int PthreadReadWriteLock::priorityWrites

private

Definition at line 55 of file PthreadReadWriteLock.h.

Referenced by WriteLock().

int PthreadReadWriteLock::writing

private

Definition at line 53 of file PthreadReadWriteLock.h.

Referenced by WriteLock(), and WriteUnlock().

---

The documentation for this class was generated from the following files:

• include/cpn/threading/PthreadReadWriteLock.h
• lib/threading/PthreadReadWriteLock.cc