next up previous contents
Next: 9.5 fluke_mutex_create_hash: create a Up: 9 Mutexes Previous: 9.3 References

9.4 fluke_mutex_create: create a new mutex

SYNOPSIS

fluke_error_t fluke_mutex_create( fluke_mutex_t *new_mutex);

DESCRIPTION

Creates a new mutex object. The mutex is initially unlocked and has no special attributes and thus is usable without an explicit fluke_set_state call.

The mutex's hash value will be set to an implementation-specific value. To set a specific hash value use fluke_mutex_create_hash.

PARAMETERS

new_mutex
A pointer to the address in the current task's address space at which to create the new mutex object.

ERRORS

If any of the following errors is detected, the appropriate error code is returned: All of these have an implicit FLUKE_ prefix.
NO_MEMORY
Insufficient resources were available.

If any of the following errors is detected by the Fluke implementation, it causes the current thread to take a synchronous exception with one of the following codes. All of these have an implicit FLUKE_INSANITY_ prefix.
OBJECT_EXISTS
An object already exists at the location pointed to by new_mutex.
NOT_ALIGNED
new_mutex is not properly aligned for a mutex object.

RELATED INFORMATION

fluke_mutex_set_state, fluke_mutex_create_hash



Utah Flux Research Group