mutexCreate

Synopsis

#include <sys/threads.h>

int mutexCreate(handle_t *h);

Status

Implemented

Conformance

Phoenix-RTOS specific

Description

The mutexCreate() function shall initialize the mutex referenced by h using default attributes. Upon successful initialization, the state of the mutex shall become initialized.

Attempting to initialize an already initialized mutex results in undefined behavior.

Return value

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

Errors

The mutexCreate() function shall fail if:

• -ENOMEM - Insufficient memory exists to initialize the mutex.

• -EFAULT - The address specified by h is invalid.

These functions shall not return an error code of EINTR.

Tests

Tested in test-sys

Known bugs

None