mutex.h File Reference

Thread subsystem III. More...

#include <gctypes.h>

Macros
#define	LWP_MUTEX_NULL   0xffffffff

Typedefs
typedef u32	mutex_t
	typedef for the mutex handle

Functions
s32	LWP_MutexDestroy (mutex_t mutex)
	Close mutex lock, release all threads and handles locked on this mutex. More...
s32	LWP_MutexInit (mutex_t *mutex, bool use_recursive)
	Initializes a mutex lock. More...
s32	LWP_MutexLock (mutex_t mutex)
	Enter the mutex lock. More...
s32	LWP_MutexTryLock (mutex_t mutex)
	Try to enter the mutex lock. More...
s32	LWP_MutexUnlock (mutex_t mutex)
	Release the mutex lock and let other threads process further on this mutex. More...

Detailed Description

Thread subsystem III.

Function Documentation

LWP_MutexDestroy()

s32 LWP_MutexDestroy

(

mutex_t

mutex

)

Close mutex lock, release all threads and handles locked on this mutex.

Parameters

[in]

mutex

handle to the mutex_t structure.

Returns

0 on success, <0 on error

LWP_MutexInit()

s32 LWP_MutexInit	(	mutex_t *	mutex,
		bool	use_recursive
	)

Initializes a mutex lock.

Parameters

[out]	mutex	pointer to a mutex_t handle.
[in]	use_recursive	whether to allow the thread, whithin the same context, to enter multiple times the lock or not.

Returns

0 on success, <0 on error

LWP_MutexLock()

s32 LWP_MutexLock

(

mutex_t

mutex

)

Enter the mutex lock.

Parameters

[in]

mutex

handle to the mutext_t structure.

Returns

0 on success, <0 on error

LWP_MutexTryLock()

s32 LWP_MutexTryLock

(

mutex_t

mutex

)

Try to enter the mutex lock.

Parameters

[in]

mutex

handle to the mutex_t structure.

Returns

0: on first aquire, 1: would lock

LWP_MutexUnlock()

s32 LWP_MutexUnlock

(

mutex_t

mutex

)

Release the mutex lock and let other threads process further on this mutex.

Parameters

[in]

mutex

handle to the mutex_t structure.

Returns

0 on success, <0 on error