NAME    [Toc]    [Back]

       pthread_mutexattr_init  -  Initializes  a mutex attributes
       object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_mutexattr_init(
               pthread_mutexattr_t *attr );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program
       Interface

PARAMETERS    [Toc]    [Back]

       Address of the mutex attributes object to be  initialized.

DESCRIPTION    [Toc]    [Back]

       This routine initializes the mutex attributes object specified
 by the attr argument with a set of default values. A
       mutex  attributes object is used to specify the attributes
       of  one  or  more  mutexes  when  they  are  created.  The
       attributes  object created by this routine is used only in
       calls to the pthread_mutex_init(3) routine.

       When a mutex attributes object is used to create a  mutex,
       the  values  of  the  individual  attributes determine the
       characteristics  of  the  new  mutex.   Thus,   attributes
       objects  act  as  additional  arguments to mutex creation.
       Changing individual attributes  in  an  attributes  object
       does  not  affect any mutexes that were previously created
       using that attributes object.

       You can use the same mutex attributes object in successive
       calls to pthread_mutex_init(3), from any thread. If multiple
 threads  can  change  attributes  in  a  shared  mutex
       attributes  object,  your program must use a mutex to protect
 the integrity of the attributes object's contents.

       Results are undefined if this routine is  called  and  the
       attr  argument specifies a mutex attributes object that is
       already initialized.

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.
       Insufficient memory to create the mutex attributes object.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:  pthread_mutexattr_destroy(3),   pthread_mutexattr_gettype(3),             pthread_mutexattr_settype(3),
       pthread_mutex_init(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                        pthread_mutexattr_init(3)