xref: /openbmc/u-boot/include/env_callback.h (revision 2f3f477b)
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 #define ETHADDR_WILDCARD "\\d?"
37 #else
38 #define ENV_DOT_ESCAPE
39 #define ETHADDR_WILDCARD
40 #endif
41 
42 #ifdef CONFIG_CMD_DNS
43 #define DNS_CALLBACK "dnsip:dnsip,"
44 #else
45 #define DNS_CALLBACK
46 #endif
47 
48 #ifdef CONFIG_NET
49 #define NET_CALLBACKS \
50 	"bootfile:bootfile," \
51 	"ipaddr:ipaddr," \
52 	"gatewayip:gatewayip," \
53 	"netmask:netmask," \
54 	"serverip:serverip," \
55 	"nvlan:nvlan," \
56 	"vlan:vlan," \
57 	DNS_CALLBACK \
58 	"eth" ETHADDR_WILDCARD "addr:ethaddr,"
59 #else
60 #define NET_CALLBACKS
61 #endif
62 
63 /*
64  * This list of callback bindings is static, but may be overridden by defining
65  * a new association in the ".callbacks" environment variable.
66  */
67 #define ENV_CALLBACK_LIST_STATIC ENV_DOT_ESCAPE ENV_CALLBACK_VAR ":callbacks," \
68 	ENV_DOT_ESCAPE ENV_FLAGS_VAR ":flags," \
69 	"baudrate:baudrate," \
70 	NET_CALLBACKS \
71 	"loadaddr:loadaddr," \
72 	SILENT_CALLBACK \
73 	SPLASHIMAGE_CALLBACK \
74 	"stdin:console,stdout:console,stderr:console," \
75 	CONFIG_ENV_CALLBACK_LIST_STATIC
76 
77 struct env_clbk_tbl {
78 	const char *name;		/* Callback name */
79 	int (*callback)(const char *name, const char *value, enum env_op op,
80 		int flags);
81 };
82 
83 void env_callback_init(ENTRY *var_entry);
84 
85 /*
86  * Define a callback that can be associated with variables.
87  * when associated through the ".callbacks" environment variable, the callback
88  * will be executed any time the variable is inserted, overwritten, or deleted.
89  */
90 #ifdef CONFIG_SPL_BUILD
91 #define U_BOOT_ENV_CALLBACK(name, callback) \
92 	static inline __maybe_unused void _u_boot_env_noop_##name(void) \
93 	{ \
94 		(void)callback; \
95 	}
96 #else
97 #define U_BOOT_ENV_CALLBACK(name, callback) \
98 	ll_entry_declare(struct env_clbk_tbl, name, env_clbk) = \
99 	{#name, callback}
100 #endif
101 
102 #endif /* __ENV_CALLBACK_H__ */
103