pthread_mutexattr_destroy

Detroys a mutex attributes object.

Syntax

pthread_mutexattr_destroy( attr );

Argument Data Type Access

attr opaque pthread_ write mutexattr_t

C Binding

#include 


int
pthread_mutexattr_destroy (
         pthread_mutexattr_t   *attr);

Arguments

attr: Attributes object to be detroyed.

Description

This routine destroys a mutex attributes object (that is, the object becomes uninitialized). Call this routine when a mutex attributes object is no longer needed.

This routine gives permission to reclaim storage for the mutex attributes object. Mutexes that were created using this attributes object are not affected by the destruction of the mutex attributes object.

The results of calling this routine are unpredictable if the attributes object specified in the attr argument does not exist.

Return Values

If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows:

Return Description

0 Successful completion. [EINVAL] The object value specified by attr is invalid.

Associated Routines

   pthread_mutexattr_init