xref: /openbmc/u-boot/include/env_callback.h (revision c9aa831e)
1 /*
2  * (C) Copyright 2012
3  * Joe Hershberger, National Instruments, joe.hershberger@ni.com
4  *
5  * See file CREDITS for list of people who contributed to this
6  * project.
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License as
10  * published by the Free Software Foundation; either version 2 of
11  * the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
21  * MA 02111-1307 USA
22  */
23 
24 #ifndef __ENV_CALLBACK_H__
25 #define __ENV_CALLBACK_H__
26 
27 #include <env_flags.h>
28 #include <linker_lists.h>
29 #include <search.h>
30 
31 #define ENV_CALLBACK_VAR ".callbacks"
32 
33 /* Board configs can define additional static callback bindings */
34 #ifndef CONFIG_ENV_CALLBACK_LIST_STATIC
35 #define CONFIG_ENV_CALLBACK_LIST_STATIC
36 #endif
37 
38 #ifdef CONFIG_SILENT_CONSOLE
39 #define SILENT_CALLBACK "silent:silent,"
40 #else
41 #define SILENT_CALLBACK
42 #endif
43 
44 #ifdef CONFIG_SPLASHIMAGE_GUARD
45 #define SPLASHIMAGE_CALLBACK "splashimage:splashimage,"
46 #else
47 #define SPLASHIMAGE_CALLBACK
48 #endif
49 
50 /*
51  * This list of callback bindings is static, but may be overridden by defining
52  * a new association in the ".callbacks" environment variable.
53  */
54 #define ENV_CALLBACK_LIST_STATIC ENV_CALLBACK_VAR ":callbacks," \
55 	ENV_FLAGS_VAR ":flags," \
56 	"baudrate:baudrate," \
57 	"bootfile:bootfile," \
58 	"loadaddr:loadaddr," \
59 	SILENT_CALLBACK \
60 	SPLASHIMAGE_CALLBACK \
61 	"stdin:console,stdout:console,stderr:console," \
62 	CONFIG_ENV_CALLBACK_LIST_STATIC
63 
64 struct env_clbk_tbl {
65 	const char *name;		/* Callback name */
66 	int (*callback)(const char *name, const char *value, enum env_op op,
67 		int flags);
68 };
69 
70 struct env_clbk_tbl *find_env_callback(const char *);
71 void env_callback_init(ENTRY *var_entry);
72 
73 /*
74  * Define a callback that can be associated with variables.
75  * when associated through the ".callbacks" environment variable, the callback
76  * will be executed any time the variable is inserted, overwritten, or deleted.
77  */
78 #ifdef CONFIG_SPL_BUILD
79 #define U_BOOT_ENV_CALLBACK(name, callback) \
80 	static inline void _u_boot_env_noop_##name(void) \
81 	{ \
82 		(void)callback; \
83 	}
84 #else
85 #define U_BOOT_ENV_CALLBACK(name, callback) \
86 	ll_entry_declare(struct env_clbk_tbl, name, env_clbk) = \
87 	{#name, callback}
88 #endif
89 
90 #endif /* __ENV_CALLBACK_H__ */
91