PTHREADMUTEXINIT(3) BSD Library Functions Manual PTHREADMUTEXINIT(3)

NAME
     pptthhrreeaaddmmuutteexxiinniitt - create a mutex

SYNOPSIS
     ##iinncclluuddee <>

     int
     pptthhrreeaaddmmuutteexxiinniitt(pthreadmutext *mutex,
         const pthreadmutexattrt *attr);

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

RETURN VALUES
     If successful, pptthhrreeaaddmmuutteexxiinniitt() will return zero and put the new
     mutex id into mutex, otherwise an error number will be returned to indi-
     cate the error.

EERRRROORRSS
     pptthhrreeaaddmmuutteexxiinniitt() will fail if:

     [EINVAL]           The value specified by attr is invalid.

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

     [EAGAIN]           The temporarily lacks the resources to create another
                        mutex.

SEE ALSO
     pthreadmutexdestroy(3), pthreadmutexlock(3),
     pthreadmutextrylock(3), pthreadmutexunlock(3)

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

BSD                              July 29, 1998                             BSD