NAME    [Toc]    [Back]

       pthread_mutex_destroy - Destroys a mutex

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_mutex_destroy(
               pthread_mutex_t *mutex );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       IEEE Std 1003.1c-1995, POSIX  System  Application  Program
       Interface

PARAMETERS    [Toc]    [Back]

       The mutex to be destroyed.

DESCRIPTION    [Toc]    [Back]

       This  routine destroys the specified mutex by uninitializing
 it, and should be called when a  mutex  object  is  no
       longer  referenced.  After  this  routine  is called, DECthreads
 may reclaim internal storage used by the specified
       mutex.

       It  is  safe  to  destroy  an  initialized  mutex  that is
       unlocked. However, it  is  illegal  to  destroy  a  locked
       mutex.

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

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition  occurs,  this routine returns an
       integer value  indicating  the  type  of  error.  Possible
       return  values  are as follows: Successful completion.  An
       attempt was made to destroy the object referenced by mutex
       while it is locked or referenced.  The value specified for
       mutex is invalid.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:  pthread_mutex_init(3),  pthread_mutex_lock(3),
       pthread_mutex_trylock(3), pthread_mutex_unlock(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                         pthread_mutex_destroy(3)