pthread_mutex_trylock man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

pthread_mutex_trylock(3)			      pthread_mutex_trylock(3)

       pthread_mutex_trylock  -	 Attempts to lock the specified mutex, without
       waiting if already locked

       #include <pthread.h>

       int pthread_mutex_trylock(
	       pthread_mutex_t *mutex );

       DECthreads POSIX 1003.1c Library (

       Interfaces documented on this reference page conform to industry	 stan‐
       dards as follows:

       IEEE Std 1003.1c-1995, POSIX System Application Program Interface

       Mutex to be locked.

       This  routine  attempts	to lock the mutex specified in the mutex argu‐
       ment. When a thread calls this routine, an attempt is made  to  immedi‐
       ately lock the mutex. If the mutex is successfully locked, this routine
       returns zero (0) and the calling thread	becomes	 the  mutex's  current
       owner.  If  the specified mutex is locked when a thread calls this rou‐
       tine, the calling thread does not wait for the mutex to	become	avail‐

       The  behavior  of this routine is as follows: For a normal, default, or
       errorcheck mutex: if the mutex is locked by any thread  (including  the
       calling	thread)	 when  this  routine  is  called, this routine returns
       [EBUSY] and the calling thread does not wait to acquire the lock.   For
       a  normal  or errorcheck mutex: if the mutex is not owned, this routine
       returns zero (0) and the mutex becomes locked by	 the  calling  thread.
       For  a  recursive  mutex:  if the mutex is owned by the calling thread,
       this routine returns zero (0) and the mutex lock count is  incremented.
       (To  unlock  a  recursive  mutex, each call to pthread_mutex_trylock(3)
       must be matched by a call to pthread_mutex_unlock(3).)

       Use the pthread_mutexattr_settype(3) routine  to	 set  the  mutex  type
       attribute (normal, default, recursive, or errorcheck).

       If  an  error  condition	 occurs, this routine returns an integer value
       indicating the type of error. Possible return values  are  as  follows:
       Successful  completion.	The mutex is already locked; therefore, it was
       not acquired.  The value specified by mutex is not a valid mutex.


       Functions:   pthread_mutexattr_settype(3),    pthread_mutex_destroy(3),
       pthread_mutex_init(3), pthread_mutex_lock(3), pthread_mutex_unlock(3)

       Manuals: Guide to DECthreads and Programmer'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