Miosix  2.0alpha1
miosix::Mutex Class Reference

#include <sync.h>

Public Types

enum  Options { DEFAULT, RECURSIVE }
 

Public Member Functions

 Mutex (Options opt=DEFAULT)
 
void lock ()
 
bool tryLock ()
 
void unlock ()
 

Detailed Description

A mutex class with support for priority inheritance. If a thread tries to enter a critical section which is not free, it will be put to sleep and added to a queue of sleeping threads, ordered by priority. The thread that is into the critical section inherits the highest priority among the threads that are waiting if it is higher than its original priority.
This mutex is meant to be a static or global class. Dynamically creating a mutex with new or on the stack must be done with care, to avoid deleting a locked mutex, and to avoid situations where a thread tries to lock a deleted mutex.

Constructor & Destructor Documentation

miosix::Mutex::Mutex ( Options  opt = DEFAULT)

Constructor, initializes the mutex.

Member Function Documentation

void miosix::Mutex::lock ( )
inline

Locks the critical section. If the critical section is already locked, the thread will be queued in a wait list.

bool miosix::Mutex::tryLock ( )
inline

Acquires the lock only if the critical section is not already locked by other threads. Attempting to lock again a recursive mutex will fail, and the mutex' lock count will not be incremented.

Returns
true if the lock was acquired
void miosix::Mutex::unlock ( )
inline

Unlocks the critical section.


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