rw_wrlock(3scl)rw_wrlock(3scl)NAMErw_wrlock - Locks a readers/writer lock for write access.
SCL Threads Library (libthread.so)
rwlock_t *rwlockp );
Address of the readers/writer lock to be write-locked.
This routine locks a readers/writer lock for write access. If the read‐
ers/writer lock is already locked (either for read or write access),
this routine blocks until it can acquire the lock for write access.
SCL IMPLEMENTATION NOTESrw_wrlock(3scl) is implemented by calling tis_write_lock(3).
rw_wrlock(3scl) first checks if the readers/writer lock is valid: if it
is not, then the readers/writer lock is initialized for intra-process
thread synchronization (type USYNC_THREAD).
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. Error from tis_rwlock_init(3) or
tis_write_lock(3). A message is written to the SCL errorlog which out‐
lines 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), rwlock_destroy(3scl), rwlock_init(3scl),
scl_intro(3scl), scl_thread_intro(3scl), tis_rwlock_init(3),
Manuals: Solaris Compatibility Libraries User's Guide