1 /* SPDX-License-Identifier: GPL-2.0 */ 1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* 2 /*
3 * Copyright (C) 2019-2022 Red Hat, Inc. Danie 3 * Copyright (C) 2019-2022 Red Hat, Inc. Daniel Bristot de Oliveira <bristot@kernel.org>
4 * 4 *
5 * Deterministic automata helper functions, to 5 * Deterministic automata helper functions, to be used with the automata
6 * models in C generated by the dot2k tool. 6 * models in C generated by the dot2k tool.
7 */ 7 */
8 8
9 /* 9 /*
10 * DECLARE_AUTOMATA_HELPERS - define a set of 10 * DECLARE_AUTOMATA_HELPERS - define a set of helper functions for automata
11 * 11 *
12 * Define a set of helper functions for automa 12 * Define a set of helper functions for automata. The 'name' argument is used
13 * as suffix for the functions and data. These 13 * as suffix for the functions and data. These functions will handle automaton
14 * with data type 'type'. 14 * with data type 'type'.
15 */ 15 */
16 #define DECLARE_AUTOMATA_HELPERS(name, type) 16 #define DECLARE_AUTOMATA_HELPERS(name, type) \
17 17 \
18 /* 18 /* \
19 * model_get_state_name_##name - return the (s 19 * model_get_state_name_##name - return the (string) name of the given state \
20 */ 20 */ \
21 static char *model_get_state_name_##name(enum 21 static char *model_get_state_name_##name(enum states_##name state) \
22 { 22 { \
23 if ((state < 0) || (state >= state_max 23 if ((state < 0) || (state >= state_max_##name)) \
24 return "INVALID"; 24 return "INVALID"; \
25 25 \
26 return automaton_##name.state_names[st 26 return automaton_##name.state_names[state]; \
27 } 27 } \
28 28 \
29 /* 29 /* \
30 * model_get_event_name_##name - return the (s 30 * model_get_event_name_##name - return the (string) name of the given event \
31 */ 31 */ \
32 static char *model_get_event_name_##name(enum 32 static char *model_get_event_name_##name(enum events_##name event) \
33 { 33 { \
34 if ((event < 0) || (event >= event_max 34 if ((event < 0) || (event >= event_max_##name)) \
35 return "INVALID"; 35 return "INVALID"; \
36 36 \
37 return automaton_##name.event_names[ev 37 return automaton_##name.event_names[event]; \
38 } 38 } \
39 39 \
40 /* 40 /* \
41 * model_get_initial_state_##name - return the 41 * model_get_initial_state_##name - return the automaton's initial state \
42 */ 42 */ \
43 static inline type model_get_initial_state_##n 43 static inline type model_get_initial_state_##name(void) \
44 { 44 { \
45 return automaton_##name.initial_state; 45 return automaton_##name.initial_state; \
46 } 46 } \
47 47 \
48 /* 48 /* \
49 * model_get_next_state_##name - process an au 49 * model_get_next_state_##name - process an automaton event occurrence \
50 * 50 * \
51 * Given the current state (curr_state) and th 51 * Given the current state (curr_state) and the event (event), returns \
52 * the next state, or INVALID_STATE in case of 52 * the next state, or INVALID_STATE in case of error. \
53 */ 53 */ \
54 static inline type model_get_next_state_##name 54 static inline type model_get_next_state_##name(enum states_##name curr_state, \
55 55 enum events_##name event) \
56 { 56 { \
57 if ((curr_state < 0) || (curr_state >= 57 if ((curr_state < 0) || (curr_state >= state_max_##name)) \
58 return INVALID_STATE; 58 return INVALID_STATE; \
59 59 \
60 if ((event < 0) || (event >= event_max 60 if ((event < 0) || (event >= event_max_##name)) \
61 return INVALID_STATE; 61 return INVALID_STATE; \
62 62 \
63 return automaton_##name.function[curr_ 63 return automaton_##name.function[curr_state][event]; \
64 } 64 } \
65 65 \
66 /* 66 /* \
67 * model_is_final_state_##name - check if the 67 * model_is_final_state_##name - check if the given state is a final state \
68 */ 68 */ \
69 static inline bool model_is_final_state_##name 69 static inline bool model_is_final_state_##name(enum states_##name state) \
70 { 70 { \
71 if ((state < 0) || (state >= state_max 71 if ((state < 0) || (state >= state_max_##name)) \
72 return 0; 72 return 0; \
73 73 \
74 return automaton_##name.final_states[s 74 return automaton_##name.final_states[state]; \
75 } 75 }
76 76
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.