NAME    [Toc]    [Back]

       tis_mutex_init - Initializes a mutex object

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_mutex_init(
               pthread_mutex_t *mutex );

LIBRARY    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Pointer to a mutex object (passed by reference) to be initialized.

DESCRIPTION    [Toc]    [Back]

       This routine initializes a  mutex  object  with  the  DECthreads
  default  mutex  attributes. A mutex is a synchronization
 object that allows multiple threads to  serialize
       their  access to shared data. The mutex is initialized and
       set to an unlocked state.

       Your program can use the  PTHREAD_MUTEX_INITIALIZER  macro
       to  statically  initialize  a mutex object without calling
       this routine. Static initialization can be used only for a
       condition variable with class extern or static - automatic
       (stack local)  objects  must  be  initialized  by  calling
       tis_mutex_init(3).  Use this macro as follows:

       pthread_mutex_t mutex= PTHREAD_MUTEX_INITIALIZER

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition  occurs,  this routine returns an
       integer value indicating the type of error, the  mutex  is
       not  initialized, and the contents of mutex are undefined.
       Possible return values are as follows: Successful  completion.
   The  system  lacks the necessary resources to initialize
 a  mutex.   The  implementation  has  detected  an
       attempt  to  reinitialize mutex (a previously initialized,
       but not yet destroyed  mutex).   The  value  specified  by
       mutex is not a valid mutex.  Insufficient memory exists to
       initialize the mutex.  The caller does not have privileges
       to perform this operation.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

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

       Manuals: Guide to DECthreads and Programmer's Guide



                                                tis_mutex_init(3)