tis_rwlock_destroy(3)					     Library Functions Manual					     tis_rwlock_destroy(3)

NAME

       tis_rwlock_destroy - Destroys the specified read-write lock object.

LIBRARY

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

SYNOPSIS

       #include <tis.h>

       int   tis_rwlock_destroy(
			      tis_rwlock_t   *lock);

STANDARDS

       None

PARAMETERS

       Address of the read-write lock object to be destroyed.

DESCRIPTION

       This  routine  destroys the specified read-write lock object.  Prior to calling this routine, ensure that there are no locks granted to the
       specified read-write lock and that there are no threads waiting for pending lock acquisitions on the specified read-write lock.

       This routine should be called only after all reader threads (and perhaps one writer thread) have finished using	the  specified	read-write
       lock.

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 lock is in use.

ERRORS

       None

RELATED INFORMATION

       Functions:  tis_read_lock(3),  tis_read_trylock(3),  tis_read_unlock(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_rwlock_destroy(3)