pthread_mutex_trylock(3-thr) — Reliant UNIX 5.44c4

pthread_mutex_trylock(3-thr)                   pthread_mutex_trylock(3-thr)

NAME
     pthreadmutextrylock - Einen Mutex sperren

SYNTAX
     #include <pthread.h>

     int pthreadmutextrylock(pthreadmutext *mutex);

PARAMETER
     mutex     Der Mutex, der gesperrt wird.

BESCHREIBUNG
     Die Routine pthreadmutextrylock() sperrt einen Mutex. Ist der ange-
     gebene Mutex bereits gesperrt, wenn ein Thread diese Routine aufruft,
     wartet der aufrufende Thread nicht darauf, daß der Mutex freigegeben
     wird.

     Wenn ein Thread diese Routine aufruft, wird versucht, den Mutex sofort
     zu sperren. Bei erfolgreicher Sperrung wird der Wert 1 zurückgegeben,
     und der aktuelle Thread wird zum aktuellen Eigner des Mutex.

     Ist der Mutex beim Aufruf dieser Routine durch einen anderen Thread
     gesperrt, wird der Wert 0 (Null) zurückgegeben, und der Thread wartet
     nicht darauf, bis er die Sperre erhält. Hält der aktuelle Thread einen
     schnellen (fast) Mutex, wird der Wert 0 zurückgegeben. Hält der aktu-
     elle Thread einen rekursiven Mutex, wird der Wert 1 zurückgegeben, und
     der Mutex wird erneut gesperrt. (Zum Entsperren eines rekursiven Mutex
     muß die Anzahl der Aufrufe von pthreadmutextrylock() mit der der
     Aufrufe von pthreadmutexunlock() übereinstimmen.)

RÜCKGABEWERTE
     Wenn die Funktion fehlschlägt, kann errno auf folgenden Wert gesetzt
     werden:

     EINVAL    Der durch mutex angegebene Wert ist ungültig.

SIEHE AUCH
     pthreadmutexdestroy(3-thr), pthreadmutexinit(3-thr),
     pthreadmutexlock(3-thr), pthreadmutexunlock(3-thr),
     pthreadmutexattrsetkindnp(3-thr).















Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98
Museum
