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

NAME
     pthreadmutextrylock -- attempt to lock a mutex without blocking

SYNOPSIS
     ##include <>

     int
     pthreadmutextrylock(pthreadmutext *mutex);

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

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

ERORS
     pthreadmutextrylock() 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
     pthreadmutextrylock() conforms to ISO/IEC 9945-1:1996 (``POSIX.1'').

BSD                              July 30, 1998                             BSD