Manual Reference Pages - PTHREAD_RWLOCK_TIMEDRDLOCK (3)
- acquire a read-write lock for reading or give up after a specified period
pthread_rwlock_timedrdlock pthread_rwlock_t *rwlock const struct timespec *abs_timeout
This function acquires a read lock on the read-write lock
However, if the lock cannot be
acquired without waiting for another thread to
unlock the lock,
this wait shall be terminated when
A thread may hold multiple concurrent read locks.
function must be called once for each lock acquired.
If the thread should be interrupted by a signal,
function will be automatically restarted after the thread returns from
the signal handler.
The calling thread may deadlock if
at the time the call is made it holds a write lock on
The results are undefined if this function is called with
an uninitialized read-write lock.
To prevent writer starvation, writers are favored over readers.
If successful, the
function will return zero.
Otherwise, an error number will be returned to indicate the error.
This function shall not return an error code of
function will fail if:
The lock could not be acquired before the specified timeout expired.
function may fail if:
The read lock could not be
acquired because the maximum number of read locks for
would be exceeded.
The calling thread already holds a write lock on
The value specified by
does not refer to an initialized read-write lock object,
nanosecond value is less than zero or
greater than or equal to 1 billion.
function is expected to conform to
function first appeared in
.Fx 5.2 .
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.