pthread_rwlock_destroy(3)				     Library Functions Manual					 pthread_rwlock_destroy(3)

NAME

       pthread_rwlock_destroy - Destroys a read-write lock object.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int   pthread_rwlock_destroy(
			     pthread_rwlock_t	*rwlock);

PARAMETERS

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

DESCRIPTION

       This  routine  destroys the specified read-write lock object by uninitializing it, and should be called when the object is no longer refer-
       enced in your program.  After this routine is called, DECthreads may reclaim internal storage used by the specified read-write lock object.
       The effect of subsequent use of the lock is undefined until the lock is reinitialized by another call to pthread_rwlock_init.

       It is illegal to destroy a locked read-write lock.

       The results of this routine are unpredictable if the specified read-write lock object does not currently exist or is not initialized.  This
       routine destroys the read-write lock object specified by the rwlock argument and releases any resources that the object used.

       A destroyed read-write lock object can be reinitialized using the pthread_rwlock_init(3) routine. The results of  otherwise  referencing  a
       destroyed read-write lock object are undefined.

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.  An attempt was made to destroy the object referenced by rwlock while it is locked or referenced.

ERRORS

       None

RELATED INFORMATION

       Functions: pthread_rwlock_init(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															 pthread_rwlock_destroy(3)