pthread_mutex_destroy(3thr)

Name

pthread_mutex_destroy − Deletes a mutex

#include <pthread.h>

int pthread_mutex_destroy (mutex)
pthread_mutex_t *mutex;

mutex Mutex deleted.

This routine deletes a mutex and should be called when a mutex object is longer referenced. This routine reclaims storage for the mutex object.

It is illegal to delete a locked mutex.

The results of this routine are unpredictable if the mutex object specified in the mutex argument does not currently exist.

If an error condition occurs, this routine returns -1 and sets errno to the corresponding error value. Possible return values are as follows.

Return	Error	Description
0		Successful completion.
-1	[EBUSY]	An attempt is made to destroy a locked mutex.
-1	[EINVAL]	The value specified by mutex is invalid.