tis_mutex_destroy - Destroys the specified mutex object
pthread_mutex_t *mutex );
Standard C Library (libc.so, libc.a)
Address of the mutex object (passed by reference) to be
This routine destroys a mutex object by uninitializing it,
and should be called when a mutex object is no longer referenced.
After this routine is called, DECthreads can
reclaim internal storage used by the mutex object.
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.
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 by
mutex is invalid. The caller does not have privileges to
perform the operation.
Functions: tis_mutex_init(3), tis_mutex_lock(3),
Manuals: Guide to DECthreads and Programmer's Guide
[ Back ]