uboot/include/env_callback.h
<<
>>
Prefs
   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
  77struct 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
  83void 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