*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> pthread_mutex_destroy (3)              



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

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

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

       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]


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

[ Back ]
 Similar pages
Name OS Title
tis_mutex_destroy Tru64 Destroys the specified mutex object
pthread_mutexattr_destroy Tru64 Destroys the specified mutex attributes object
pthread_mutexattr_gettype Tru64 Obtains the mutex type attribute in the specified mutex attributes object
pthread_mutexattr_settype Tru64 Specifies the mutex type attribute that is used when a mutex is created
pset_destroy Tru64 Destroys a processor set
destroy_pset Tru64 Destroys a processor set
pthread_cond_destroy Tru64 Destroys a condition variable
EvmEventCreate Tru64 Creates and destroys events
EvmEventDestroy Tru64 Creates and destroys events
EvmEventCreateVa Tru64 Creates and destroys events
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service