NAME    [Toc]    [Back]

     pthread_mutex_init - create a mutex

SYNOPSIS    [Toc]    [Back]

     #include <pthread.h>

     int
     pthread_mutex_init(pthread_mutex_t *mutex,
             const pthread_mutexattr_t *attr);

DESCRIPTION    [Toc]    [Back]

     The pthread_mutex_init() function creates a new mutex,  with
attributes
     specified with attr.  If attr is NULL the default attributes
are used.

RETURN VALUES    [Toc]    [Back]

     If successful, pthread_mutex_init() will return zero and put
the new mutex
  ID  into  mutex,  otherwise an error number will be returned to indicate
     the error.

ERRORS    [Toc]    [Back]

     pthread_mutex_init() will fail if:

     [EINVAL]      The value specified by attr is invalid.

     [ENOMEM]      The process cannot allocate enough  memory  to
create another
                   mutex.

SEE ALSO    [Toc]    [Back]

     pthread_mutex_destroy(3), pthread_mutex_lock(3),
     pthread_mutex_trylock(3), pthread_mutex_unlock(3)

STANDARDS    [Toc]    [Back]

     pthread_mutex_init()   conforms   to   ISO/IEC   9945-1:1996
(``POSIX'').

OpenBSD     3.6                           July      29,      1998