pthread_cond_init Subroutine



Purpose

Initializes a condition variable and sets its attributes.

Library

Threads Library (libpthreads.a)

Syntax

#include <pthread.h>

int pthread_cond_init (condition, attr)
pthread_cond_t *condition;
pthread_condattr_t *attr;

Description

The pthread_cond_init subroutine initializes a new condition variable
condition, and sets its attributes according the condition attributes
object attr.

After initialization of the condition variable, the condition attributes
object can be reused for another condition variable initialization,
or deleted.

Note:	The pthread.h header file must be the first included file of
each source file using the threads library.

Parameters

condition	Specifies the condition to be created.

attr	Specifies the condition attributes object to use for initializing
the condition variable. If the value is NULL, the default attributes
values are used.

Return Values

Upon successful completion, the new condition variable is returned
via the condition parameter, and 0 is returned. Otherwise, an error
code is returned.

Error Codes

The pthread_cond_init subroutine is unsuccessful if the following
is true:

EBUSY	The condition condition is already in use: it was previously
created with by calling the pthread_cond_init subroutine, and not
destroyed by calling the pthread_cond_destroy subroutine.

EINVAL	The condition or attr parameters are not valid.

Implementation Specifics

This subroutine is part of the Base Operating System (BOS) Runtime.

Related Information

The pthread_condattr_init subroutine, pthread_condattr_destroy subroutine,
pthread_cond_wait or pthread_cond_timedwait subroutine, pthread_cond_destroy
subroutine, PTHREAD_COND_INITIALIZER macro.

Using Condition Variables and Threads Library Quick Reference.