pthread_mutexattr_create(3) — Subroutines
Digital
NAME
pthread_mutexattr_create − Creates a mutex attributes object that is used to specify the attributes of mutexes when they are created.
SYNOPSIS
#include <pthread.h>
int pthread_mutexattr_create(
pthread_mutexattr_t ∗attr );
PARAMETERS
attrMutex 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 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 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. |
RELATED INFORMATION
pthread_create(3), pthread_mutexattr_delete(3), pthread_mutexattr_getkind_np(3), pthread_mutexattr_setkind_np(3), pthread_mutex_init(3)