rwlock_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]

rwlock_destroy(3scl)					  rwlock_destroy(3scl)

       rwlock_destroy - Destroys a readers/writer lock.

       SCL Threads Library (

       #include <synch.h>

       int rwlock_destroy(
			   rwlock_t *rwlockp );

       Address of the readers/writer lock object to be destroyed.

       This routine destroys the specified readers/writer lock by uninitializ‐
       ing it, and should be called when a readers/writer lock	object	is  no
       longer referenced by any thread.

       rwlock_destroy(3scl) is implemented by calling tis_rwlock_destroy(3).

       rwlock_destroy(3scl)  first checks if the specified readers/writer lock
       is valid: if it is valid, then tis_rwlock_destroy(3) is called;	other‐
       wise this routine just returns 0.

       If  tis_rwlock_destroy(3)  returns  EBUSY,  indicating  that  the read‐
       ers/writer lock is still	 in  use,  then	 rwlock_destroy(3scl)  returns
       EFAULT  and logs an error-mapping message to the SCL errorlog. This be‐
       haviour	 is   different	  to   that   observed	 on   Solaris,	 where
       rwlock_destroy()	 returns 0 even if the readers/writer lock is still in

       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. Or:

       Successful completion, even though the specified rwlock	had  not  been
       initialized.   Error EBUSY from tis_rwlock_destroy(3), meaning that the
       readers/writer lock 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 rwlockp is an illegal address. An ille‐
       gal address generates a SIGSEGV signal, which by default will abort the
       process and generate a core dump.


       Functions:  rw_rdlock(3scl),  rw_tryrdlock(3scl),   rw_trywrlock(3scl),
       rw_unlock(3scl),	 rw_wrlock(3scl)  rwlock_init(3scl),  scl_intro(3scl),
       scl_thread_intro(3scl), tis_rwlock_destroy(3)

       Files: scl_error_log(4scl)

       Manuals: Solaris Compatibility Libraries User's Guide


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]
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