pthread_rwlock_destroy(3)

Index for
Section 3
Alphabetical
listing for P
Bottom of
page
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
  rwlock    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
  referenced 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 V*rwlock argument and
  releases any resources that the object used.

  A destroyed read-write lock object can be reinitialized using the

  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:

  0	    Successful completion.

  [EBUSY]   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
Index for
Section 3
Alphabetical
listing for P
Top of
page