pthread_mutex_destroy(3-thr) pthread_mutex_destroy(3-thr)
NAME
pthreadmutexdestroy - deletes a mutex
SYNOPSIS
#include <pthread.h>
int pthreadmutexdestroy(pthreadmutext *mutex);
PARAMETERS
mutex Mutex to be deleted.
DESCRIPTION
The pthreadmutexdestroy() routine deletes a mutex and must be called
when a mutex object is no longer referenced. The effect of calling
this routine is to reclaim storage for the mutex object.
It is illegal to delete a mutex that has a current owner (in other
words, is locked).
The results of this routine are unpredictable if the mutex object
specified in the mutex parameter does not currently exist.
RETURN VALUES
If the function fails, errno may be set to one of the following
values:
EBUSY An attempt was made to destroy a mutex that is locked.
EINVAL The value specified by mutex is invalid.
SEE ALSO
pthreadmutexinit(3-thr), pthreadmutexlock(3-thr),
pthreadmutextrylock(3-thr), pthreadmutexunlock(3-thr).
Page 1 Reliant UNIX 5.44 Printed 11/98