src/utils/state_machine.h

2  * wpa_supplicant/hostapd - State machine definitions
15  * implement a state machine. In addition to including this header file, each
16  * file implementing a state machine must define STATE_MACHINE_DATA to be the
30  * SM_STATE - Declaration of a state machine function
31  * @machine: State machine name
32  * @state: State machine state
34  * This macro is used to declare a state machine function. It is used in place
38 #define SM_STATE(machine, state) \
39 static void sm_ ## machine ## _ ## state ## _Enter(STATE_MACHINE_DATA *sm, \
43  * SM_ENTRY - State machine function entry point
44  * @machine: State machine name
45  * @state: State machine state
47  * This macro is used inside each state machine function declared with
50  * information about state transition and update the state machine state.
52 #define SM_ENTRY(machine, state) \
53 if (!global || sm->machine ## _state != machine ## _ ## state) { \
55 	wpa_printf(MSG_DEBUG, STATE_MACHINE_DEBUG_PREFIX ": " #machine \
58 sm->machine ## _state = machine ## _ ## state;
61  * SM_ENTRY_M - State machine function entry point for state machine group
62  * @machine: State machine name
63  * @_state: State machine state
66  * This macro is like SM_ENTRY, but for state machine groups that use a shared
67  * data structure for more than one state machine. Both machine and prefix
68  * parameters are set to "sub-state machine" name. prefix is used to allow more
71 #define SM_ENTRY_M(machine, _state, data) \
72 if (!global || sm->data ## _ ## state != machine ## _ ## _state) { \
75 		   #machine " entering state " #_state); \
77 sm->data ## _ ## state = machine ## _ ## _state;
80  * SM_ENTRY_MA - State machine function entry point for state machine group
81  * @machine: State machine name
82  * @_state: State machine state
89 #define SM_ENTRY_MA(machine, _state, data) \
90 if (!global || sm->data ## _ ## state != machine ## _ ## _state) { \
93 		   #machine " entering state " #_state, \
96 sm->data ## _ ## state = machine ## _ ## _state;
99  * SM_ENTER - Enter a new state machine state
100  * @machine: State machine name
101  * @state: State machine state
103  * This macro expands to a function call to a state machine function defined
104  * with SM_STATE macro. SM_ENTER is used in a state machine step function to
105  * move the state machine to a new state.
107 #define SM_ENTER(machine, state) \
108 sm_ ## machine ## _ ## state ## _Enter(sm, 0)
111  * SM_ENTER_GLOBAL - Enter a new state machine state based on global rule
112  * @machine: State machine name
113  * @state: State machine state
118  * rule is forcing a state machine to remain in on state.
120 #define SM_ENTER_GLOBAL(machine, state) \
121 sm_ ## machine ## _ ## state ## _Enter(sm, 1)
124  * SM_STEP - Declaration of a state machine step function
125  * @machine: State machine name
127  * This macro is used to declare a state machine step function. It is used in
129  * state machine to a new state based on state variables. This function uses
132 #define SM_STEP(machine) \
133 static void sm_ ## machine ## _Step(STATE_MACHINE_DATA *sm)
136  * SM_STEP_RUN - Call the state machine step function
137  * @machine: State machine name
139  * This macro expands to a function call to a state machine step function
142 #define SM_STEP_RUN(machine) sm_ ## machine ## _Step(sm)