VMS Help DCE_THREADS, Application Routines, pthread_mutexattr_create  *Conan The Librarian (sorry for the slow response - running on an old VAX)

  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