Destroys the specified mutex.
#include <pthread.h> int pthread_mutex_destroy ( pthread_mutex_t *mutex);
(IN) Points to the mutex to destroy.
If successful, returns 0. Otherwise returns a nonzero error code.
The mutex being destroyed must have been allocated by calling pthread_mutex_init. The pthread_mutex_destroy function does not release the memory for the mutex, but it does release the memory allocated with the pthread_mutex_init function.
You must free the memory for the mutex with the function that is paired with the function you used to allocate the memory. For example, if you used malloc to allocate the mutex, use free to release the memory.