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
       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

RELATED INFORMATION

       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 delim off

																  tis_read_lock(3)