Name

pthread_mutexattr_create − Creates a mutex attributes object that is used to specify the attributes of mutexes when they are created. 

Syntax

#include <pthread.h>

int pthread_mutexattr_create (attr)
pthread_mutexattr_t *attr;

Arguments

attr Mutex attributes object created. 

Description

This 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 arguments 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 argument. 

If an error condition occurs, this routine returns -1 and sets errno to the corresponding error value.  Possible return values are as follows.