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, KERNEL_PID_UNDEF }
	Static initializer for rmutex_t.

Typedefs
typedef struct rmutex_t	rmutex_t
	Mutex structure.

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

Macro Definition Documentation

RMUTEX_INIT

#define RMUTEX_INIT   { MUTEX_INIT, 0, KERNEL_PID_UNDEF }

Static initializer for rmutex_t.

This initializer is preferable to rmutex_init().

Definition at line 67 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 75 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.