Each item in an execution sequence, which corresponds to a dereferenced control. More...

#include <exec_item.h>

Collaboration diagram for refda_exec_item_t:

Data Fields
refda_exec_seq_t *	seq
	Weak reference to a parent execution sequence.

cace_ari_t	ref
	A copy of the single-CTRL reference which created this item.

cace_amm_lookup_t	deref
	Dereference result for CTRL of this item.

cace_ari_t	result
	Storage for an optional result value.

atomic_int	execution_stage
	The state of execution for this item, used to synchronize the result member and the parent sequence execution.

cace_amm_user_data_t	user_data
	Store of optional CTRL-specific user data which will be cleaned up at the end of execution of this item.

Detailed Description

Each item in an execution sequence, which corresponds to a dereferenced control.

Field Documentation

◆ deref

cace_amm_lookup_t refda_exec_item_t::deref

Dereference result for CTRL of this item.

This includes actual parameters for the execution. This state is read-only after the item is constructed.

Referenced by check_execute(), refda_ctrl_exec_ctx_get_aparam_index(), refda_ctrl_exec_ctx_get_aparam_name(), refda_ctrl_exec_ctx_has_aparam_undefined(), refda_exec_item_deinit(), refda_exec_item_finish_result(), refda_exec_item_init(), refda_exec_proc_ctrl_finish(), refda_exec_proc_ctrl_start(), and refda_exec_proc_exp_ref().

◆ execution_stage

atomic_int refda_exec_item_t::execution_stage

The state of execution for this item, used to synchronize the result member and the parent sequence execution.

Values are one of the refda_exec_item_status_t enumerations.

Referenced by check_execute(), refda_adm_ietf_dtnma_agent_ctrl_exec_deadline_timeout(), refda_adm_ietf_dtnma_agent_edd_exec_running(), refda_ctrl_exec_ctx_set_waiting(), refda_exec_item_finish_result(), refda_exec_item_init(), refda_exec_item_resume(), refda_exec_proc_ctrl_start(), refda_exec_proc_front_status(), refda_exec_proc_terminate(), refda_exec_seq_front_status(), and refda_exec_worker_iteration().

◆ ref

cace_ari_t refda_exec_item_t::ref

A copy of the single-CTRL reference which created this item.

This includes given parameters for the execution. This state is read-only after the item is constructed.

Referenced by check_execute(), refda_adm_ietf_dtnma_agent_edd_exec_running(), refda_exec_item_deinit(), refda_exec_item_init(), refda_exec_proc_ctrl_finish(), refda_exec_proc_ctrl_start(), refda_exec_proc_exp_ref(), and test_exec_ctrl_exec_one_int().

◆ result

cace_ari_t refda_exec_item_t::result

Storage for an optional result value.

This is initialized as undefined and may be set to any other value to indicate that a result is produced. The result is meant to be set before execution_stage is REFDA_EXEC_COMPLETE and then is read-only after that point.

Referenced by check_execute(), refda_ctrl_exec_ctx_set_result_copy(), refda_ctrl_exec_ctx_set_result_move(), refda_ctrl_exec_ctx_set_result_null(), refda_exec_item_deinit(), refda_exec_item_finish_result(), refda_exec_item_init(), and refda_exec_proc_ctrl_finish().