rwmtx_rdlock(3) | Library Functions Manual | rwmtx_rdlock(3) |
NAME
rwmtx_rdlock
—
acquire a read lock
SYNOPSIS
library “threads”
#include <threadse.h>
int
rwmtx_rdlock
(rwmtx_t
*rw);
DESCRIPTION
The function
rwmtx_rdlock
()
will acquire a read lock on the given read/write lock
rw. If a write lock is acquired on the lock, the
thread will be stalled until the read lock can be acquired.
A thread can hold multiple read locks at the same time, rwmtx_unlock(3) must be called for each acquired lock.
RETURN VALUES
Upon success rwmtx_rdlock
() will return
thrd_success. In case of error
thrd_error will be returned.
SEE ALSO
rwmtx_init(3) rwmtx_destroy(3) rwmtx_wrlock(3) rwmtx_tryrdlock(3) rwmtx_trywrlock(3) rwmtx_timedrdlock(3) rwmtx_timedwrlock(3) rwmtx_unlock(3)
HISTORY
The rwmtx_rdlock
() function first appeared
in the Adelsbach Enhanced Threading Library.
AUTHORS
Jan Adelsbach <jan@jadelsbach.de>
May 9, 2020 | Debian |