NAME    [Toc]    [Back]

       tis_rwlock_init - Initializes a read-write lock object

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_rwlock_init(
               tis_rwlock_t *lock );

LIBRARY    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Address of a read-write lock object.

DESCRIPTION    [Toc]    [Back]

       This  routine  initializes  a  read-write lock object. The
       routine initializes the tis_rwlock_t structure that  holds
       the object's lock states.

       To   destroy   a   read-write   lock   object,   call  the
       tis_rwlock_destroy(3) routine.

       NOTE: The tis read-write lock has no relationship  to  the
       Single  UNIX  Specification,  Version 2 (SUSV2, or UNIX98)
       read-write lock  routines  (pthread_rwlock_init(3),  etc).
       The  tis_rwlock_t type, in particular, cannot be used with
       the  pthread  read-write  lock  functions;   nor   can   a
       pthread_rwlock_t type be used with the tis read-write lock
       functions.

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 not a valid read-write lock.
       Insufficient memory exists to initialize lock.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:     tis_read_lock(3),      tis_read_trylock(3),
       tis_read_unlock(3),                 tis_rwlock_destroy(3),
       tis_write_lock(3),                   tis_write_trylock(3),
       tis_write_unlock(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                               tis_rwlock_init(3)