rwlock.h File Reference

Read/write lock synchronization primitive. More...

#include "../kernel/mutex.h"
#include "../kernel/condvar.h"

Go to the source code of this file.

Data Structures
struct	RwLock
	Read/write lock structure. More...

Functions
void	rwlockInit (RwLock *r)
	Initializes the read/write lock.
void	rwlockReadLock (RwLock *r)
	Locks the read/write lock for reading.
bool	rwlockTryReadLock (RwLock *r)
	Attempts to lock the read/write lock for reading without waiting.
void	rwlockReadUnlock (RwLock *r)
	Unlocks the read/write lock for reading.
void	rwlockWriteLock (RwLock *r)
	Locks the read/write lock for writing.
bool	rwlockTryWriteLock (RwLock *r)
	Attempts to lock the read/write lock for writing without waiting.
void	rwlockWriteUnlock (RwLock *r)
	Unlocks the read/write lock for writing.
bool	rwlockIsWriteLockHeldByCurrentThread (RwLock *r)
	Checks if the write lock is held by the current thread.
bool	rwlockIsOwnedByCurrentThread (RwLock *r)
	Checks if the read/write lock is owned by the current thread.

Detailed Description

Read/write lock synchronization primitive.

Author

plutoo, SciresM

Copyright

libnx Authors

Function Documentation

rwlockInit()

void rwlockInit

(

RwLock *

r

)

Initializes the read/write lock.

Parameters

r	Read/write lock object.

rwlockIsOwnedByCurrentThread()

bool rwlockIsOwnedByCurrentThread

(

RwLock *

r

)

Checks if the read/write lock is owned by the current thread.

Parameters

r	Read/write lock object.

Returns

1 if the current hold holds the write lock or if it holds read locks acquired while it held the write lock, and 0 if it does not.

rwlockIsWriteLockHeldByCurrentThread()

bool rwlockIsWriteLockHeldByCurrentThread

(

RwLock *

r

)

Checks if the write lock is held by the current thread.

Parameters

r	Read/write lock object.

Returns

1 if the current hold holds the write lock, and 0 if it does not.

rwlockReadLock()

void rwlockReadLock

(

RwLock *

r

)

Locks the read/write lock for reading.

Parameters

r	Read/write lock object.

rwlockReadUnlock()

void rwlockReadUnlock

(

RwLock *

r

)

Unlocks the read/write lock for reading.

Parameters

r	Read/write lock object.

rwlockTryReadLock()

bool rwlockTryReadLock

(

RwLock *

r

)

Attempts to lock the read/write lock for reading without waiting.

Parameters

r	Read/write lock object.

Returns

1 if the mutex has been acquired successfully, and 0 on contention.

rwlockTryWriteLock()

bool rwlockTryWriteLock

(

RwLock *

r

)

Attempts to lock the read/write lock for writing without waiting.

Parameters

r	Read/write lock object.

Returns

1 if the mutex has been acquired successfully, and 0 on contention.

rwlockWriteLock()

void rwlockWriteLock

(

RwLock *

r

)

Locks the read/write lock for writing.

Parameters

r	Read/write lock object.

rwlockWriteUnlock()

void rwlockWriteUnlock

(

RwLock *

r

)

Unlocks the read/write lock for writing.

Parameters

r	Read/write lock object.