*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> tis_mutex_init (3)              



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]


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]


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

[ Back ]
 Similar pages
Name OS Title
pthread_mutexattr_init Tru64 Initializes a mutex attributes object
pthread_mutex_init Tru64 Initializes a mutex
pthread_mutexattr_gettype Tru64 Obtains the mutex type attribute in the specified mutex attributes object
pthread_attr_init Tru64 Initializes a thread attributes object
pthread_rwlock_init Tru64 Initializes a read-write lock object
pthread_condattr_init Tru64 Initializes a condition variable attributes object
tis_rwlock_init Tru64 Initializes a read-write lock object
pthread_mutex_getname_np Tru64 Obtain the object name from a mutex object
tis_mutex_destroy Tru64 Destroys the specified mutex object
pthread_mutexattr_destroy Tru64 Destroys the specified mutex attributes object
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service