NAME    [Toc]    [Back]

       tis_mutex_lock - Locks an unlocked mutex

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_mutex_lock(
               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  locks the specified mutex mutex. A deadlock
       can result if the current owner of a mutex calls this routine
  in  an attempt to lock the same mutex a second time.
       (DECthreads does not detect or report the deadlock.)

       In a threaded environment, the thread that  has  locked  a
       mutex  becomes  its  current  owner  and remains the owner
       until the  same  thread  has  unlocked  it.  This  routine
       returns  with  the  mutex in the locked state and with the
       current thread as the mutex's current owner.

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
       value specified by mutex is invalid.  A deadlock condition
       is detected.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

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

       Manuals: Guide to DECthreads and Programmer's Guide



                                                tis_mutex_lock(3)