NAME

rwmtx_tryrdlock — attempt to acquire a read lock

SYNOPSIS

library “threads”
#include <threadse.h>

int
rwmtx_tryrdlock(rwmtx_t *rw);

DESCRIPTION

The function rwmtx_tryrdlock() will attempt to acquire a read lock on the given read/write lock rw. If a read lock cannot be acquired the function will return a respective return code.

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_tryrdlock() will return thrd_success if a read lock has been acquired. If no read lock can be acquired at this time thrd_busy will be returned. In case of error thrd_error will be returned.

SEE ALSO

rwmtx_init(3) rwmtx_destroy(3) rwmtx_rdlock(3) rwmtx_wrlock(3) rwmtx_trywrlock(3) rwmtx_timedrdlock(3) rwmtx_timedwrlock(3) rwmtx_unlock(3)

HISTORY

The rwmtx_tryrdlock() function first appeared in the Adelsbach Enhanced Threading Library.

AUTHORS

Jan Adelsbach <jan@jadelsbach.de>