mutex_destroy man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]



mutex_destroy(3scl)					   mutex_destroy(3scl)

NAME
       mutex_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 NOTES
       mutex_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)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net