FreeBSD Manual Pages
PTHREAD_MUTEX_TRYLOCK(3) BSD Library Functions Manual PTHREAD_MUTEX_TRYLOCK(3) NAME pthread_mutex_trylock -- attempt to lock a mutex without blocking LIBRARY POSIX Threads Library (libpthread, -lpthread) SYNOPSIS #include <pthread.h> int pthread_mutex_trylock(pthread_mutex_t *mutex); DESCRIPTION The pthread_mutex_trylock() function locks mutex. If the mutex is al- ready locked, pthread_mutex_trylock() will not block waiting for the mu- tex, but will return an error condition. RETURN VALUES If successful, pthread_mutex_trylock() will return zero, otherwise an er- ror number will be returned to indicate the error. ERRORS The pthread_mutex_trylock() function will fail if: [EINVAL] The value specified by mutex is invalid. [EBUSY] Mutex is already locked. [EOWNERDEAD] The argument mutex points to a robust mutex and the process containing the previous owning thread termi- nated while holding the mutex lock. The lock was granted to the caller and it is up to the new owner to make the state consistent. [ENOTRECOVERABLE] The state protected by the mutex is not recoverable. SEE ALSO pthread_mutex_consistent(3), pthread_mutex_destroy(3), pthread_mutex_init(3), pthread_mutex_lock(3), pthread_mutex_unlock(3) STANDARDS The pthread_mutex_trylock() function conforms to ISO/IEC 9945-1:1996 ("POSIX.1"). BSD August 7, 2019 BSD
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | STANDARDS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pthread_mutex_trylock&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>