NAME

    pthread_mutexattr_create - Creates a mutex attributes object

 SYNOPSIS

     #include <pthread.h>

     int pthread_mutexattr_create( pthread_mutexattr_t *attr );

 PARAMETERS

     attr                Mutex attributes object created.

 DESCRIPTION

 The pthread_mutexattr_create() routine creates a mutex attributes object
 used to specify the attributes of mutexes when they are created. The
 mutex attributes object is initialized with the default value for all of
 the attributes defined by a given implementation.

 When a mutex attributes object is used to create a mutex, the values of
 the individual attributes determine the characteristics of the new
 object.  Attributes objects act like additional parameters to object
 creation.  Changing individual attributes does not affect any objects
 that were previously created using the attributes object.

 RETURN VALUES

 The created mutex attributes object is returned to the attr parameter.

 If the function fails, errno may be set to one of the following values:

    Return   Error      Description
    ___________________________________________________
     0                  Successful completion.

    -1      [EINVAL]    The value specified by attr is invalid.

    -1      [ENOMEM]    Insufficient memory exists to create
                        the mutex attributes object.

 RELATED INFORMATION

     FUNCTIONS:  pthread_create
                 pthread_mutexattr_delete
                 pthread_mutexattr_getkind_np
                 pthread_mutexattr_setkind_np
                 pthread_mutex_init