condCreateWithAttr#

Synopsis#

#include <sys/threads.h>

int condCreateWithAttr(handle_t *h, struct condAttr *attr);

Status#

Implemented

Conformance#

Phoenix-RTOS specific

Description#

The condCreateWithAttr() function shall initialize the condition variable referenced by h using attributes specified in the attr structure (non-NULL). Upon successful initialization, the state of the condition variable shall become initialized.

Attempting to initialize an already initialized condition variable results in undefined behavior.

Attributes structure condAttr is defined as follows:

struct condAttr {
	int clock;
};

The clock field specifies the clock to be used for the condition variable. The following values are supported:

PH_CLOCK_RELATIVE - timeout passed to condWait() is relative to the current time.
PH_CLOCK_REALTIME - timeout passed to condWait() is absolute time based on the real-time clock.
PH_CLOCK_MONOTONIC - timeout passed to condWait() is absolute time based on the monotonic clock.

Return value#

If successful, the condCreateWithAttr() function shall return zero; otherwise, an error number shall be returned to indicate the error.

Errors#

The condCreateWithAttr() function shall fail if:

-ENOMEM - Insufficient memory exists to initialize the condition variable.
-EINVAL - The attributes specified in attr are invalid.
-EFAULT - The address specified by h or attr is invalid.

These functions shall not return an error code of EINTR.

Tests#

Tested in test-sys

Known bugs#

None