Index Click this button to go to the index for this section.


pthread_condattr_init(3)

NAME

pthread_condattr_init - Initializes a condition variable attributes object.

LIBRARY

DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

#include <pthread.h> int pthread_condattr_init( pthread_condattr_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

attr Address of the condition variable attributes object to be initialized.

DESCRIPTION

This routine initializes the condition variable attributes object specified by the (attr) argument with a set of default attribute values. When an attributes object is used to create a condition variable, the values of the individual attributes determine the characteristics of the new condition variable. Attributes objects act as additional arguments to condition variable creation. Changing individual attributes in an attributes object does not affect any condition variables that were previously created using that attributes object. You can use the same condition variable attributes object in successive calls to pthread_condattr_init(3), from any thread. If multiple threads can change attributes in a shared attributes object, your program must use a mutex to protect the integrity of that attributes object. Results are undefined if this routine is called and the attr argument specifies a condition variable 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: 0 Successful completion. [ENOMEM] Insufficient memory exists to initialize the condition variable attributes object.

ERRORS

None

RELATED INFORMATION

Functions: pthread_condattr_destroy(3), pthread_cond_init(3) Manuals: Guide to DECthreads and Programmer's Guide