NAME    [Toc]    [Back]

       tis_read_lock - Acquires a read-write lock for read access

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_read_lock(
               tis_rwlock_t *lock );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc.so, libc.a)

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Address of the read-write lock.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       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)