tis_read_lock(3)tis_read_lock(3)NAMEtis_read_lock - Acquires a read-write lock for read access
SYNOPSIS
#include <tis.h>
int tis_read_lock(
tis_rwlock_t *lock );
LIBRARY
Standard C Library (libc.so, libc.a)
STANDARDS
None
PARAMETERS
Address of the read-write lock.
DESCRIPTION
This routine acquires a read-write lock for read access. This routine
waits for any existing lock holder for write access to relinquish its
lock before granting the lock for read access. This routine returns
when the lock is acquired. If the lock is already held for read access,
the lock is granted.
For each call to tis_read_lock(3) that successfully acquires the lock
for read access, a corresponding call to tis_read_unlock(3) must be
issued.
Note that the type tis_rwlock_p is a pointer to type tis_rwlock_t.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error. Possible return values are as follows:
Successful completion. The value specified by lock is invalid.
ERRORS
None
SEE ALSO
Functions: tis_read_trylock(3), tis_read_unlock(3),
tis_rwlock_destroy(3), tis_rwlock_init(3), tis_write_lock(3),
tis_write_trylock(3), tis_write_unlock(3)
Manuals: Guide to DECthreads and Programmer's Guide
tis_read_lock(3)