pthread_mutexattr_destroy Subroutine



Purpose

Deletes a mutex attributes object.

Library

Threads Library (libpthreads.a)

Syntax

#include <pthread.h>

int pthread_mutexattr_destroy (attr)
pthread_mutexattr_t *attr;

Description

The pthread_mutexattr_destroy subroutine deletes the mutex attributes
object attr, reclaiming its storage space. It has no effect on the
mutexes previously created with that attributes object.

Note:	The pthread.h header file must be the first included file of
each source file using the threads library.

Parameters

attr	Specifies the mutex attributes object to delete.

Return Values

Upon successful completion, 0 is returned. Otherwise, an error code
is returned.

Error Codes

The pthread_mutexattr_destroy subroutine is unsuccessful if the following
is true:

EINVAL	The attr parameter is not valid.

Implementation Specifics

This subroutine is part of the Base Operating System (BOS) Runtime.

Related Information

The pthread_mutexattr_init subroutine, pthread_mutex_init subroutine.

Using Mutexes.

Threads Library Quick Reference.