next up previous contents
Next: 3.8 fluke_task_move: move a Up: 3 Task Previous: 3.6 fluke_task_destroy: destroy a

3.7 fluke_task_get_state: retrieve the current state of a task object

SYNOPSIS

void fluke_task_get_state(fluke_task_t *task, fluke_task_state *state, fluke_ref_t *keeper_ref);

DESCRIPTION

This operation retrieves the application-visible state of a task object.

PARAMETERS

task
The task whose state is to be retrieved.
state
If non-null, the structure to fill in with the simple (non-reference) task state.
keeper_ref
If non-null, the address of a reference object to associate with the task's keeper port.

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
task does not point to an active object.
NOT_TASK
The object pointed to by task is not a task object.
INVALID_OBJECT
The state of the task or reference object has become invalid.
NOT_REF
keeper_ref is not a pointer to a reference object.

RELATED INFORMATION

fluke_task_set_state



Utah Flux Research Group