*** UNIX MANUAL PAGE BROWSER ***

tis_read_lock(3) Library Functions Manual tis_read_lock(3) NAME tis_read_lock - Acquires a read-write lock for read access. LIBRARY Standard C Library (libc.so, libc.a) SYNOPSIS #include <tis.h> int tis_read_lock( tis_rwlock_t *lock); 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 ac- cess, 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 is- sued. 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 in- dicating the type of error. Possible return values are as follows: Successful completion. The value specified by lock is invalid. ERRORS None RELATED INFORMATION Functions: tis_read_trylock(3), tis_read_unlock(3), tis_rwlock_de- stroy(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 delim off tis_read_lock(3)