mutex_destroy(3scl)mutex_destroy(3scl)NAMEmutex_destroy - Destroys a mutex.
LIBRARY
SCL Threads Library (libthread.so)
SYNOPSIS
#include <synch.h>
int mutex_destroy(
mutex_t *mutexp );
PARAMETERS
Address of 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.
SCL IMPLEMENTATION NOTESmutex_destroy(3scl) is implemented by calling pthread_mutex_destroy(3).
mutex_destroy(3scl) checks if the specified mutex is valid or not: if
it is valid, then pthread_mutex_destroy(3) is called; otherwise this
routine just returns 0. If pthread_mutex_destroy(3) is called and
returns EBUSY, indicating that the mutex is still in use, then this
routine returns EFAULT and logs an error-mapping message to the SCL
errorlog.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error.
Additional error return information may be written to the SCL error
log. Refer to scl_error_log(4scl) for details.
Possible return values are as follows:
Successful completion. (Returned even if the specified mutex had not
been initialized).
Error EBUSY from pthread_mutex_destroy(3), meaning that the mutex is
still in use. A message is written to the SCL errorlog which outlines
the error-code mapping. Or:
An internal implementation error occurred. Refer to the SCL errorlog
for additional information.
Note: EFAULT is not returned if mutexp is an illegal address. An ille‐
gal address generates a SIGSEGV signal, which by default will abort the
process and generate a core dump.
ERRORS
None.
RELATED INFORMATION
Functions: mutex_init(3scl), mutex_lock(3scl), mutex_trylock(3scl),
mutex_unlock(3scl), pthread_mutex_destroy(3), scl_intro(3scl),
scl_thread_intro(3scl)
Files: scl_error_log(4scl)
Manuals: Solaris Compatibility Libraries User's Guide
mutex_destroy(3scl)