PTHREADMUTEXTRYLOCK(3) BSD Library Functions Manual PTHREADMUTEXTRYLOCK(3)

NAME
     pptthhrreeaaddmmuutteexxttrryylloocckk - attempt to lock a mutex without blocking

SYNOPSIS
     ##iinncclluuddee <>

     int
     pptthhrreeaaddmmuutteexxttrryylloocckk(pthreadmutext *mutex);

DESCRIPTION
     The pptthhrreeaaddmmuutteexxttrryylloocckk() function locks mutex.  If the mutex is
     already locked, pptthhrreeaaddmmuutteexxttrryylloocckk() will not block waiting for the
     mutex, but will return an error condition.

RETURN VALUES
     If successful, pptthhrreeaaddmmuutteexxttrryylloocckk() will return zero, otherwise an
     error number will be returned to indicate the error.

EERRRROORRSS
     pptthhrreeaaddmmuutteexxttrryylloocckk() will fail if:

     [EINVAL]           The value specified by mutex is invalid.

     [EBUSY]            Mutex is already locked.

SEE ALSO
     pthreadmutexdestroy(3), pthreadmutexinit(3), pthreadmutexlock(3),
     pthreadmutexunlock(3)

STANDARDS
     pptthhrreeaaddmmuutteexxttrryylloocckk() conforms to ISO/IEC 9945-1:1996 (``POSIX.1'').

BSD                              July 30, 1998                             BSD