Recursive Mutex

Recursive Mutex for thread synchronization. More...

Detailed Description

Recursive Mutex for thread synchronization.

Files
file	rmutex.h
	Recursive Mutex for thread synchronization.

Data Structures
struct	rmutex_t
	Mutex structure. More...

Macros
#define	RMUTEX_INIT   { MUTEX_INIT, 0, ATOMIC_VAR_INIT(KERNEL_PID_UNDEF) }
	Static initializer for rmutex_t. More...

Typedefs
typedef struct rmutex_t	rmutex_t
	Mutex structure. More...

Functions
static void	rmutex_init (rmutex_t *rmutex)
	Initializes a recursive mutex object. More...
int	rmutex_trylock (rmutex_t *rmutex)
	Tries to get a recursive mutex, non-blocking. More...
void	rmutex_lock (rmutex_t *rmutex)
	Locks a recursive mutex, blocking. More...
void	rmutex_unlock (rmutex_t *rmutex)
	Unlocks the recursive mutex. More...

Macro Definition Documentation

RMUTEX_INIT

#define RMUTEX_INIT   { MUTEX_INIT, 0, ATOMIC_VAR_INIT(KERNEL_PID_UNDEF) }

Static initializer for rmutex_t.

This initializer is preferable to rmutex_init().

Definition at line 72 of file rmutex.h.

Typedef Documentation

rmutex_t

typedef struct rmutex_t rmutex_t

Mutex structure.

Must never be modified by the user.

Function Documentation

rmutex_init()

static void rmutex_init ( rmutex_t *  rmutex )

inlinestatic

Initializes a recursive mutex object.

For initialization of variables use RMUTEX_INIT instead. Only use the function call for dynamically allocated mutexes.

Parameters

[out]

rmutex

pre-allocated mutex structure, must not be NULL.

Definition at line 80 of file rmutex.h.

rmutex_lock()

void rmutex_lock

(

rmutex_t *

rmutex

)

Locks a recursive mutex, blocking.

Parameters

[in]

rmutex

Recursive mutex object to lock. Has to be initialized first. Must not be NULL.

rmutex_trylock()

int rmutex_trylock

(

rmutex_t *

rmutex

)

Tries to get a recursive mutex, non-blocking.

Parameters

[in]

rmutex

Recursive mutex object to lock. Has to be initialized first. Must not be NULL.

Returns

1 if mutex was unlocked, now it is locked.

0 if the mutex was locked.

rmutex_unlock()

void rmutex_unlock

(

rmutex_t *

rmutex

)

Unlocks the recursive mutex.

Parameters

[in]

rmutex

Recursive mutex object to unlock, must not be NULL.