NAME    [Toc]    [Back]

       tis_mutex_trylock - Attempts to lock the specified mutex

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_mutex_trylock(
               pthread_mutex_t *mutex );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc.so, libc.a)

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Address of the mutex (passed by reference) to be locked.

DESCRIPTION    [Toc]    [Back]

       This  routine  attempts to lock the specified mutex mutex.
       When this routine is called, an attempt  is  made  immediately
  to  lock  the  mutex.  If the mutex is successfully
       locked, zero (0) is returned.

       If the specified mutex is already locked when this routine
       is  called,  the  caller  does  not  wait for the mutex to
       become available. [EBUSY] is returned, and the thread does
       not wait to acquire the lock.

RETURN VALUES    [Toc]    [Back]

       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 invalid.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:     tis_mutex_destroy(3),    tis_mutex_init(3),
       tis_mutex_lock(3), tis_mutex_unlock(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                             tis_mutex_trylock(3)