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