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>