Mutex

Macros
#define	trmutexCreate()   TRMutex_create()
#define	trmutexWakeup(self)   (self)->_->wakeup(TRMutex(self))

Detailed Description

TRMutex provides mutex-based serialization of task execution. Tasks requiring this resource will run one at a time, with approximate FIFO ordering.

Characteristics:

• Simple hashtable-based wait list
• Approximate FIFO ordering (not strictly guaranteed)
• Good for moderate numbers of waiting tasks
• Can be locked by non-task code (call wakeup() after releasing)

When to use:

• Moderate contention levels (dozens of tasks)
• Ordering is helpful but not critical
• Simple exclusive access pattern

Alternatives:

• Use TRFifo for strict FIFO ordering or large numbers of waiters
• Use TRLifo for stack ordering (most recent first)

Simple mutex-based resource with approximate FIFO ordering.

Macro Definition Documentation

trmutexCreate

#define trmutexCreate

(

)

TRMutex_create()

TRMutex* trmutexCreate();

Create a new mutex-based resource.

Returns

New TRMutex instance

Definition at line 97 of file trmutex.h.

trmutexWakeup

#define trmutexWakeup

(

self

)

(self)->_->wakeup(TRMutex(self))

void trmutexWakeup(TRMutex* self);

Manually release a task from wait list. Call this after releasing mtx if locked from non-task code.

Definition at line 111 of file trmutex.h.