[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1

pthread_mutexattr_destroy or pthread_mutexattr_init Subroutine

Purpose

Initializes and destroys mutex attributes.

Library

Threads Library (libpthreads.a)

Syntax

#include <pthread.h>

int pthread_mutexattr_init (attr)
pthread_mutexattr_t *attr;

int pthread_mutexattr_destroy (attr)
pthread_mutexattr_t *attr;

Description

The function pthread_mutexattr_init initializes a mutex attributes object attr with the default value for all of the attributes defined by the implementation.

The effect of initializing an already initialized mutex attributes object is undefined.

After a mutex attributes object has been used to initialize one or more mutexes, any function affecting the attributes object (including destruction) does not affect any previously initialized mutexes.

The pthread_mutexattr_destroy function destroys a mutex attributes object; the object becomes, in effect, uninitialized. An implementation may cause pthread_mutexattr_destroy to set the object referenced by attr to an invalid value. A destroyed mutex attributes object can be re-initialized using pthread_mutexattr_init; the results of otherwise referencing the object after it has been destroyed are undefined.

Parameters

attr Specifies the mutex attributes object to initialize or delete.

Return Values

Upon successful completion, pthread_mutexattr_init and pthread_mutexattr_destroy return zero. Otherwise, an error number is returned to indicate the error.

Error Codes

The pthread_mutexattr_init function will fail if:

ENOMEM Insufficient memory exists to initialize the mutex attributes object.

The pthread_mutexattr_destroy function will fail if:

EINVAL The value specified by attr is invalid.

These functions will not return EINTR.

Related Information

The pthread_create (pthread_create Subroutine) subroutine, pthread_mutex_init or pthread_mutex_destroy (pthread_mutex_init or pthread_mutex_destroy Subroutine) subroutine, pthread_cond_destroy or pthread_cond_init (pthread_cond_destroy or pthread_cond_init Subroutine) subroutine, pthread.h file.

Using Mutexes in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

Threads Library Options and Threads Library Quick Reference in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]