pthread_mutexattr_create

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

Syntax

pthread_mutexattr_create( attr );

Argument Data Type Access

attr opaque pthread_ write mutexattr_t

C Binding

int
pthread_mutexattr_create (
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:

Return Error Description

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