pthread_mutex_destroy(3) Library Functions Manual pthread_mutex_destroy(3)NAME
pthread_mutex_destroy - Destroys a mutex.
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
SYNOPSIS
#include <pthread.h>
int pthread_mutex_destroy(
pthread_mutex_t *mutex);
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
PARAMETERS
The mutex to be destroyed.
DESCRIPTION
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 ini-
tialized.
RETURN VALUES
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 speci-
fied for mutex is invalid.
ERRORS
None
RELATED INFORMATION
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
delim off
pthread_mutex_destroy(3)
Check Out this Related Man Page
pthread_mutex_unlock(3) Library Functions Manual pthread_mutex_unlock(3)NAME
pthread_mutex_unlock - Unlocks the specified mutex.
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
SYNOPSIS
#include <pthread.h>
int pthread_mutex_unlock(
pthread_mutex_t *mutex);
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
PARAMETERS
Mutex to be unlocked.
DESCRIPTION
This routine unlocks the mutex specified by the mutex argument.
This routine behaves as follows, based on the type of the specified mutex: For a normal, default, or errorcheck mutex: if the mutex is
owned by the calling thread, it is unlocked with no current owner. Further, for a normal or default mutex: if the mutex is not locked or
is locked by another thread, this routine can also return [EPERM], but this is not guaranteed. For an errorcheck mutex: if the mutex is not
locked or is locked by another thread, this routine returns [EPERM]. For a recursive mutex: if the mutex is owned by the calling thread,
the lock count is decremented. The mutex remains locked and owned until the lock count reaches zero (0). When the lock count reaches zero,
the mutex becomes unlocked with no current owner.
If one or more threads are waiting to lock the specified mutex, and the mutex becomes unlocked, this routine causes one thread to unblock
and to try to acquire the mutex. The scheduling policy is used to determine which thread to unblock. For the SCHED_FIFO and SCHED_RR
policies, a blocked thread is chosen in priority order, using first-in/first-out within priorities. Note that the mutex might not be
acquired by the awakened thread if any other running thread attempts to lock the mutex first.
On Tru64 UNIX, if a signal is delivered to a thread waiting for a mutex, upon return from the signal handler, the thread resumes waiting
for the mutex as if it was not interrupted.
RETURN VALUES
If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows:
Successful completion. The value specified for mutex is invalid. The calling thread does not own the mutex.
ERRORS
None
RELATED INFORMATION
Functions: pthread_mutexattr_settype(3), pthread_mutex_destroy(3), pthread_mutex_init(3), pthread_mutex_lock(3), pthread_mutex_trylock(3)
Manuals: Guide to DECthreads and Programmer's Guide
delim off
pthread_mutex_unlock(3)