rw_unlock(3scl)rw_unlock(3scl)NAMErw_unlock - Unlocks a readers/writer lock.
LIBRARY
SCL Threads Library (libthread.so)
SYNOPSIS
#include <synch.h>
int rw_unlock(
rwlock_t *rwlockp );
PARAMETERS
Address of the readers/writer lock to be unlocked.
DESCRIPTION
This routine unlocks the readers/writer lock specified by the rwlockp
argument. The readers/writer lock must be locked by the caller either
for read or write access. Unlocking the readers/writer lock may enable
any other threads waiting for the readers/writer lock to proceed.
SCL IMPLEMENTATION NOTESrw_unlock(3scl) is implemented by calling either tis_read_unlock(3) or
tis_write_unlock(3): the readers/writer lock is examined to determine
if it is read-locked or write-locked, so that the appropriate unlock
function is called.
If the specified readers/writer lock is not valid (i.e. has not been
initialized), then this routine returns 0, to be consistent with the
observed Solaris behaviour.
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. Or:
The readers/writer lock is invalid (un-initialized). An internal
implementation error occurred. Refer to the SCL errorlog for additional
information. A possible cause is that the readers/writer lock is not
locked by this thread.
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.
ERRORS
None.
RELATED INFORMATION
Functions: rw_rdlock(3scl), rw_tryrdlock(3scl), rw_trywrlock(3scl),
rw_wrlock(3scl), rwlock_destroy(3scl), rwlock_init(3scl),
scl_intro(3scl), scl_thread_intro(3scl), tis_read_unlock(3),
tis_write_trylock(3)
Files: scl_error_log(4scl)
Manuals: Solaris Compatibility Libraries User's Guide
rw_unlock(3scl)