Content-type: text/html Man page of pthread_mutexattr_init

pthread_mutexattr_init

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

pthread_mutexattr_init - Initializes a mutex attributes object.  

LIBRARY

DECthreads POSIX 1003.1c Library (libpthread.so)  

SYNOPSIS

#include <pthread.h>

int pthread_mutexattr_init(
                       pthread_mutexattr_t   *attr);  

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

IEEE Std 1003.1c-1995, POSIX System Application Program Interface  

PARAMETERS

Address of the mutex attributes object to be initialized.  

DESCRIPTION

This routine initializes the mutex attributes object specified by the attr argument with a set of default values. A mutex attributes object is used to specify the attributes of one or more mutexes when they are created. The attributes object created by this routine is used only in calls to the pthread_mutex_init(3) routine.

When a mutex attributes object is used to create a mutex, the values of the individual attributes determine the characteristics of the new mutex. Thus, attributes objects act as additional arguments to mutex creation. Changing individual attributes in an attributes object does not affect any mutexes that were previously created using that attributes object.

You can use the same mutex attributes object in successive calls to pthread_mutex_init(3), from any thread. If multiple threads can change attributes in a shared mutex attributes object, your program must use a mutex to protect the integrity of the attributes object's contents.

Results are undefined if this routine is called and the attr argument specifies a mutex attributes object that is already initialized.

 

RETURN VALUES

If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. Insufficient memory to create the mutex attributes object.  

ERRORS

None  

RELATED INFORMATION

Functions: pthread_mutexattr_destroy(3), pthread_mutexattr_gettype(3), pthread_mutexattr_settype(3), pthread_mutex_init(3)

Manuals: Guide to DECthreads and Programmer's Guide

delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:30 GMT, October 02, 2010