Query: pthread_condattr_init
OS: osf1
Section: 3
Links: osf1 man pages all man pages
Forums: forum home forum categories
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
pthread_condattr_init(3) Library Functions Manual pthread_condattr_init(3)NAMEpthread_condattr_init - Initializes a condition variable attributes object.LIBRARYDECthreads POSIX 1003.1c Library (libpthread.so)SYNOPSIS#include <pthread.h> int pthread_condattr_init( pthread_condattr_t *attr);STANDARDSInterfaces documented on this reference page conform to industry standards as follows: IEEE Std 1003.1c-1995, POSIX System Application Program InterfacePARAMETERSAddress of the condition variable attributes object to be initialized.DESCRIPTIONThis 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 ini- tialized. The pthread_condattr_init(3) and pthread_condattr_destroy(3) routines are provided for future expandability of the DECthreads pthread interface and to conform with the POSIX.1c standard. These routines serve no useful function, because there are no pthread_con- dattr_set*(3) type routines available at this time.RETURN VALUESIf an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. The value specified by attr is not a valid condition variable attributes object. Insufficient memory exists to initialize the condition variable attributes object.ERRORSNoneRELATED INFORMATIONFunctions: pthread_condattr_destroy(3), pthread_cond_init(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_condattr_init(3)