Manual Pages  — PTHREAD_RWLOCK_TIMEDRDLOCK

pthread_rwlock_timedrdlock – acquire a read-write lock for reading or give up after a specified period

LIBRARY SYNOPSIS DESCRIPTION IMPLEMENTATION NOTES RETURN VALUES ERRORS SEE ALSO STANDARDS HISTORY

POSIX Threads Library (libpthread, -lpthread)

#include <pthread.h>

int
pthread_rwlock_timedrdlock(pthread_rwlock_t *restrict rwlock, const struct timespec *restrict abs_timeout);

To prevent writer starvation, writers are favored over readers.

If successful, the pthread_rwlock_timedrdlock() function will return zero. Otherwise, an error number will be returned to indicate the error.

This function shall not return an error code of EINTR.

The pthread_rwlock_timedrdlock() function will fail if:

[ETIMEDOUT]
	The lock could not be acquired before the specified timeout expired.

The pthread_rwlock_timedrdlock() function may fail if:

[EAGAIN]
	The read lock could not be acquired because the maximum number of read locks for rwlock would be exceeded.
[EDEADLK]
	The calling thread already holds a write lock on rwlock.
[EINVAL]
	The value specified by rwlock does not refer to an initialized read-write lock object, or the abs_timeout nanosecond value is less than zero or greater than or equal to 1 billion.

The pthread_rwlock_timedrdlock() function is expected to conform to IEEE Std 1003.1-96 ("POSIX.1").

The pthread_rwlock_timedrdlock() function first appeared in FreeBSD 5.2 .