Content-type: text/html Man page of pthread_rwlock_destroy

pthread_rwlock_destroy

Section: C Library Functions (3)
Index Return to Main Contents
 

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 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.  

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. The value specified by attr is invalid.  

ERRORS

None  

RELATED INFORMATION

Functions: pthread_rwlock_init(3)

Manuals: Guide to DECthreads and Programmer's Guide

delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:08 GMT, October 02, 2010