Query: pthread_rwlock_timedwrlock
OS: freebsd
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
PTHREAD_RWLOCK_TIMEDWRLOCK(3) BSD Library Functions Manual PTHREAD_RWLOCK_TIMEDWRLOCK(3)NAMEpthread_rwlock_timedwrlock -- acquire a read-write lock for writing or give up after a specified periodLIBRARYPOSIX Threads Library (libpthread, -lpthread)SYNOPSIS#include <pthread.h> int pthread_rwlock_timedwrlock(pthread_rwlock_t *rwlock, const struct timespec *abs_timeout);DESCRIPTIONThis function acquires a write lock on the read-write lock rwlock. However, if the lock cannot be acquired without waiting for another thread to unlock the lock, this wait shall be terminated when abs_timeout expires. If the thread should be interrupted by a signal, the pthread_rwlock_timedwrlock() function will be automatically restarted after the thread returns from the signal handler. The calling thread may deadlock if at the time the call is made it holds rwlock. The results are undefined if this function is called with an uninitialized read-write lock.IMPLEMENTATION NOTESTo prevent writer starvation, writers are favored over readers.RETURN VALUESIf successful, the pthread_rwlock_timedwrlock() function will return zero. Otherwise, an error number will be returned to indicate the error. This function shall not return an error code of EINTR.ERRORSThe pthread_rwlock_timedwrlock() function shall fail if: [ETIMEDOUT] The lock could not be acquired before the specified timeout expired. The pthread_rwlock_timedwrlock() function may fail if: [EDEADLK] The calling thread already holds rwlock. [EINVAL] The value specified by rwlock does not refer to an initialized read-write lock object, or the abs_timeout nanosecond value is less than zero or greater than or equal to 1 billion.SEE ALSOpthread_rwlock_init(3), pthread_rwlock_timedrdlock(3), pthread_rwlock_unlock(3)STANDARDSThe pthread_rwlock_timedwrlock() function is expected to conform to ISO/IEC 9945-1:1996 (``POSIX.1'').HISTORYThe pthread_rwlock_timedwrlock() function first appeared in FreeBSD 5.2.BSDJanuary 16, 2004 BSD
Similar Topics in the Unix Linux Community |
---|
Mac OS X: Based on UNIX - Solid As a Rock |
FreeBSD Kernel Internals, Dr. Marshall Kirk McKusick |
A simple UNIXtime component in Vue.js |
Valid separator in time and date format |