[people/ms/u-boot.git] / include / env_callback.h

/*
 * (C) Copyright 2012
 * Joe Hershberger, National Instruments, joe.hershberger@ni.com
 *
 * SPDX-License-Identifier:	GPL-2.0+
 */

#ifndef __ENV_CALLBACK_H__
#define __ENV_CALLBACK_H__

#include <env_flags.h>
#include <linker_lists.h>
#include <search.h>

#define ENV_CALLBACK_VAR ".callbacks"

/* Board configs can define additional static callback bindings */
#ifndef CONFIG_ENV_CALLBACK_LIST_STATIC
#define CONFIG_ENV_CALLBACK_LIST_STATIC
#endif

#ifdef CONFIG_SILENT_CONSOLE
#define SILENT_CALLBACK "silent:silent,"
#else
#define SILENT_CALLBACK
#endif

#ifdef CONFIG_SPLASHIMAGE_GUARD
#define SPLASHIMAGE_CALLBACK "splashimage:splashimage,"
#else
#define SPLASHIMAGE_CALLBACK
#endif

#ifdef CONFIG_REGEX
#define ENV_DOT_ESCAPE "\\"
#else
#define ENV_DOT_ESCAPE
#endif

#ifdef CONFIG_CMD_DNS
#define DNS_CALLBACK "dnsip:dnsip,"
#else
#define DNS_CALLBACK
#endif

#ifdef CONFIG_NET
#define NET_CALLBACKS \
	"bootfile:bootfile," \
	"ipaddr:ipaddr," \
	"gatewayip:gatewayip," \
	"netmask:netmask," \
	"serverip:serverip," \
	"nvlan:nvlan," \
	"vlan:vlan," \
	DNS_CALLBACK \
	"eth\\d?addr:ethaddr,"
#else
#define NET_CALLBACKS
#endif

/*
 * This list of callback bindings is static, but may be overridden by defining
 * a new association in the ".callbacks" environment variable.
 */
#define ENV_CALLBACK_LIST_STATIC ENV_DOT_ESCAPE ENV_CALLBACK_VAR ":callbacks," \
	ENV_DOT_ESCAPE ENV_FLAGS_VAR ":flags," \
	"baudrate:baudrate," \
	NET_CALLBACKS \
	"loadaddr:loadaddr," \
	SILENT_CALLBACK \
	SPLASHIMAGE_CALLBACK \
	"stdin:console,stdout:console,stderr:console," \
	CONFIG_ENV_CALLBACK_LIST_STATIC

struct env_clbk_tbl {
	const char *name;		/* Callback name */
	int (*callback)(const char *name, const char *value, enum env_op op,
		int flags);
};

void env_callback_init(ENTRY *var_entry);

/*
 * Define a callback that can be associated with variables.
 * when associated through the ".callbacks" environment variable, the callback
 * will be executed any time the variable is inserted, overwritten, or deleted.
 */
#ifdef CONFIG_SPL_BUILD
#define U_BOOT_ENV_CALLBACK(name, callback) \
	static inline __maybe_unused void _u_boot_env_noop_##name(void) \
	{ \
		(void)callback; \
	}
#else
#define U_BOOT_ENV_CALLBACK(name, callback) \
	ll_entry_declare(struct env_clbk_tbl, name, env_clbk) = \
	{#name, callback}
#endif

#endif /* __ENV_CALLBACK_H__ */
Commit	Line	Data
170ab110 JH	1	/*
	2	* (C) Copyright 2012
	3	* Joe Hershberger, National Instruments, joe.hershberger@ni.com
	4	*
1a459660	5	* SPDX-License-Identifier: GPL-2.0+
170ab110 JH	6	*/
	7
	8	#ifndef __ENV_CALLBACK_H__
	9	#define __ENV_CALLBACK_H__
	10
2598090b	11	#include <env_flags.h>
170ab110 JH	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
e080d545 JH	22	#ifdef CONFIG_SILENT_CONSOLE
	23	#define SILENT_CALLBACK "silent:silent,"
	24	#else
	25	#define SILENT_CALLBACK
	26	#endif
	27
c0880485 NK	28	#ifdef CONFIG_SPLASHIMAGE_GUARD
	29	#define SPLASHIMAGE_CALLBACK "splashimage:splashimage,"
	30	#else
	31	#define SPLASHIMAGE_CALLBACK
	32	#endif
	33
bdf1fe4e JH	34	#ifdef CONFIG_REGEX
	35	#define ENV_DOT_ESCAPE "\\"
	36	#else
	37	#define ENV_DOT_ESCAPE
	38	#endif
	39
fd305633 JH	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," \
6e0d26c0 JH	55	DNS_CALLBACK \
6e0d26c0 JH	56	"eth\\d?addr:ethaddr,"
fd305633 JH	57	#else
	58	#define NET_CALLBACKS
	59	#endif
	60
170ab110 JH	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	*/
bdf1fe4e JH	65	#define ENV_CALLBACK_LIST_STATIC ENV_DOT_ESCAPE ENV_CALLBACK_VAR ":callbacks," \
bdf1fe4e JH	66	ENV_DOT_ESCAPE ENV_FLAGS_VAR ":flags," \
32057717	67	"baudrate:baudrate," \
fd305633	68	NET_CALLBACKS \
1cf0a8b2	69	"loadaddr:loadaddr," \
e080d545	70	SILENT_CALLBACK \
c0880485	71	SPLASHIMAGE_CALLBACK \
849d5d9c	72	"stdin:console,stdout:console,stderr:console," \
170ab110 JH	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
170ab110 JH	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	*/
f8cfcf1b SW	88	#ifdef CONFIG_SPL_BUILD
f8cfcf1b SW	89	#define U_BOOT_ENV_CALLBACK(name, callback) \
3ea664c7	90	static inline __maybe_unused void _u_boot_env_noop_##name(void) \
f8cfcf1b SW	91	{ \
	92	(void)callback; \
	93	}
	94	#else
170ab110	95	#define U_BOOT_ENV_CALLBACK(name, callback) \
ef123c52	96	ll_entry_declare(struct env_clbk_tbl, name, env_clbk) = \
170ab110	97	{#name, callback}
f8cfcf1b	98	#endif
170ab110 JH	99
170ab110 JH	100	#endif /* __ENV_CALLBACK_H__ */