xref: /openbmc/u-boot/include/env_callback.h (revision 5e90470a)
1 /*
2  * (C) Copyright 2012
3  * Joe Hershberger, National Instruments, joe.hershberger@ni.com
4  *
5  * SPDX-License-Identifier:	GPL-2.0+
6  */
7 
8 #ifndef __ENV_CALLBACK_H__
9 #define __ENV_CALLBACK_H__
10 
11 #include <env_flags.h>
12 #include <linker_lists.h>
13 #include <search.h>
14 
15 #define ENV_CALLBACK_VAR ".callbacks"
16 
17 /* Board configs can define additional static callback bindings */
18 #ifndef CONFIG_ENV_CALLBACK_LIST_STATIC
19 #define CONFIG_ENV_CALLBACK_LIST_STATIC
20 #endif
21 
22 #ifdef CONFIG_SILENT_CONSOLE
23 #define SILENT_CALLBACK "silent:silent,"
24 #else
25 #define SILENT_CALLBACK
26 #endif
27 
28 #ifdef CONFIG_SPLASHIMAGE_GUARD
29 #define SPLASHIMAGE_CALLBACK "splashimage:splashimage,"
30 #else
31 #define SPLASHIMAGE_CALLBACK
32 #endif
33 
34 #ifdef CONFIG_REGEX
35 #define ENV_DOT_ESCAPE "\\"
36 #else
37 #define ENV_DOT_ESCAPE
38 #endif
39 
40 #ifdef CONFIG_CMD_DNS
41 #define DNS_CALLBACK "dnsip:dnsip,"
42 #else
43 #define DNS_CALLBACK
44 #endif
45 
46 #ifdef CONFIG_NET
47 #define NET_CALLBACKS \
48 	"bootfile:bootfile," \
49 	"ipaddr:ipaddr," \
50 	"gatewayip:gatewayip," \
51 	"netmask:netmask," \
52 	"serverip:serverip," \
53 	"nvlan:nvlan," \
54 	"vlan:vlan," \
55 	DNS_CALLBACK \
56 	"eth\\d?addr:ethaddr,"
57 #else
58 #define NET_CALLBACKS
59 #endif
60 
61 /*
62  * This list of callback bindings is static, but may be overridden by defining
63  * a new association in the ".callbacks" environment variable.
64  */
65 #define ENV_CALLBACK_LIST_STATIC ENV_DOT_ESCAPE ENV_CALLBACK_VAR ":callbacks," \
66 	ENV_DOT_ESCAPE ENV_FLAGS_VAR ":flags," \
67 	"baudrate:baudrate," \
68 	NET_CALLBACKS \
69 	"loadaddr:loadaddr," \
70 	SILENT_CALLBACK \
71 	SPLASHIMAGE_CALLBACK \
72 	"stdin:console,stdout:console,stderr:console," \
73 	CONFIG_ENV_CALLBACK_LIST_STATIC
74 
75 struct env_clbk_tbl {
76 	const char *name;		/* Callback name */
77 	int (*callback)(const char *name, const char *value, enum env_op op,
78 		int flags);
79 };
80 
81 void env_callback_init(ENTRY *var_entry);
82 
83 /*
84  * Define a callback that can be associated with variables.
85  * when associated through the ".callbacks" environment variable, the callback
86  * will be executed any time the variable is inserted, overwritten, or deleted.
87  */
88 #ifdef CONFIG_SPL_BUILD
89 #define U_BOOT_ENV_CALLBACK(name, callback) \
90 	static inline __maybe_unused void _u_boot_env_noop_##name(void) \
91 	{ \
92 		(void)callback; \
93 	}
94 #else
95 #define U_BOOT_ENV_CALLBACK(name, callback) \
96 	ll_entry_declare(struct env_clbk_tbl, name, env_clbk) = \
97 	{#name, callback}
98 #endif
99 
100 #endif /* __ENV_CALLBACK_H__ */
101