next up previous contents
Next: 10.9 fluke_cond_move: move a Up: 10 Condition Variables Previous: 10.7 fluke_cond_destroy: destroy a

10.8 fluke_cond_get_state: retrieve the current state of a condition variable

SYNOPSIS

void fluke_cond_get_state(fluke_cond_t *cond, fluke_cond_state *state, fluke_ref_t *inheritor_ref);

DESCRIPTION

This operation retrieves the application-visible state of a condition variable. The condition variable itself is unaffected by the operation.

PARAMETERS

cond
The condition variable whose state is to be retrieved.
state
If non-null, the structure to fill in with the condition variable state.
inheritor_ref
If non-null, the address of a reference object to associate with the mutex's inheritor thread object.

ERRORS

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.
NO_OBJECT
cond does not point to an active object.
NOT_COND
The object pointed to by cond is not a condition variable object.
INVALID_OBJECT
The state of the condition variable or reference object has become invalid.
NOT_REF
inheritor_ref does not point to a valid reference object.

RELATED INFORMATION

fluke_cond_set_state



Utah Flux Research Group