common/env_common.c

   1 /*
   2  * (C) Copyright 2000-2010
   3  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
   4  *
   5  * (C) Copyright 2001 Sysgo Real-Time Solutions, GmbH <www.elinos.com>
   6  * Andreas Heppel <aheppel@sysgo.de>
   7  *
   8  * SPDX-License-Identifier:     GPL-2.0+
   9  */
  10
  11 #include <common.h>
  12 #include <command.h>
  13 #include <environment.h>
  14 #include <linux/stddef.h>
  15 #include <search.h>
  16 #include <errno.h>
  17 #include <malloc.h>
  18
  19 DECLARE_GLOBAL_DATA_PTR;
  20
  21 /************************************************************************
  22  * Default settings to be used when no valid environment is found
  23  */
  24 #include <env_default.h>
  25
  26 struct hsearch_data env_htab = {
  27         .change_ok = env_flags_validate,
  28 };
  29
  30 static uchar __env_get_char_spec(int index)
  31 {
  32         return *((uchar *)(gd->env_addr + index));
  33 }
  34 uchar env_get_char_spec(int)
  35         __attribute__((weak, alias("__env_get_char_spec")));
  36
  37 static uchar env_get_char_init(int index)
  38 {
  39         /* if crc was bad, use the default environment */
  40         if (gd->env_valid)
  41                 return env_get_char_spec(index);
  42         else
  43                 return default_environment[index];
  44 }
  45
  46 uchar env_get_char_memory(int index)
  47 {
  48         return *env_get_addr(index);
  49 }
  50
  51 uchar env_get_char(int index)
  52 {
  53         /* if relocated to RAM */
  54         if (gd->flags & GD_FLG_RELOC)
  55                 return env_get_char_memory(index);
  56         else
  57                 return env_get_char_init(index);
  58 }
  59
  60 const uchar *env_get_addr(int index)
  61 {
  62         if (gd->env_valid)
  63                 return (uchar *)(gd->env_addr + index);
  64         else
  65                 return &default_environment[index];
  66 }
  67
  68 /*
  69  * Read an environment variable as a boolean
  70  * Return -1 if variable does not exist (default to true)
  71  */
  72 int getenv_yesno(const char *var)
  73 {
  74         char *s = getenv(var);
  75
  76         if (s == NULL)
  77                 return -1;
  78         return (*s == '1' || *s == 'y' || *s == 'Y' || *s == 't' || *s == 'T') ?
  79                 1 : 0;
  80 }
  81
  82 /*
  83  * Look up the variable from the default environment
  84  */
  85 char *getenv_default(const char *name)
  86 {
  87         char *ret_val;
  88         unsigned long really_valid = gd->env_valid;
  89         unsigned long real_gd_flags = gd->flags;
  90
  91         /* Pretend that the image is bad. */
  92         gd->flags &= ~GD_FLG_ENV_READY;
  93         gd->env_valid = 0;
  94         ret_val = getenv(name);
  95         gd->env_valid = really_valid;
  96         gd->flags = real_gd_flags;
  97         return ret_val;
  98 }
  99
 100 void set_default_env(const char *s)
 101 {
 102         int flags = 0;
 103
 104         if (sizeof(default_environment) > ENV_SIZE) {
 105                 puts("*** Error - default environment is too large\n\n");
 106                 return;
 107         }
 108
 109         if (s) {
 110                 if (*s == '!') {
 111                         printf("*** Warning - %s, "
 112                                 "using default environment\n\n",
 113                                 s + 1);
 114                 } else {
 115                         flags = H_INTERACTIVE;
 116                         puts(s);
 117                 }
 118         } else {
 119                 puts("Using default environment\n\n");
 120         }
 121
 122         if (himport_r(&env_htab, (char *)default_environment,
 123                         sizeof(default_environment), '\0', flags,
 124                         0, NULL) == 0)
 125                 error("Environment import failed: errno = %d\n", errno);
 126
 127         gd->flags |= GD_FLG_ENV_READY;
 128 }
 129
 130
 131 /* [re]set individual variables to their value in the default environment */
 132 int set_default_vars(int nvars, char * const vars[])
 133 {
 134         /*
 135          * Special use-case: import from default environment
 136          * (and use \0 as a separator)
 137          */
 138         return himport_r(&env_htab, (const char *)default_environment,
 139                                 sizeof(default_environment), '\0',
 140                                 H_NOCLEAR | H_INTERACTIVE, nvars, vars);
 141 }
 142
 143 #ifndef CONFIG_SPL_BUILD
 144 /*
 145  * Check if CRC is valid and (if yes) import the environment.
 146  * Note that "buf" may or may not be aligned.
 147  */
 148 int env_import(const char *buf, int check)
 149 {
 150         env_t *ep = (env_t *)buf;
 151
 152         if (check) {
 153                 uint32_t crc;
 154
 155                 memcpy(&crc, &ep->crc, sizeof(crc));
 156
 157                 if (crc32(0, ep->data, ENV_SIZE) != crc) {
 158                         set_default_env("!bad CRC");
 159                         return 0;
 160                 }
 161         }
 162
 163         if (himport_r(&env_htab, (char *)ep->data, ENV_SIZE, '\0', 0,
 164                         0, NULL)) {
 165                 gd->flags |= GD_FLG_ENV_READY;
 166                 return 1;
 167         }
 168
 169         error("Cannot import environment: errno = %d\n", errno);
 170
 171         set_default_env("!import failed");
 172
 173         return 0;
 174 }
 175 #endif
 176
 177 void env_relocate(void)
 178 {
 179 #if defined(CONFIG_NEEDS_MANUAL_RELOC)
 180         env_reloc();
 181         env_htab.change_ok += gd->reloc_off;
 182 #endif
 183         if (gd->env_valid == 0) {
 184 #if defined(CONFIG_ENV_IS_NOWHERE) || defined(CONFIG_SPL_BUILD)
 185                 /* Environment not changable */
 186                 set_default_env(NULL);
 187 #else
 188                 bootstage_error(BOOTSTAGE_ID_NET_CHECKSUM);
 189                 set_default_env("!bad CRC");
 190 #endif
 191         } else {
 192                 env_relocate_spec();
 193         }
 194 }
 195
 196 #if defined(CONFIG_AUTO_COMPLETE) && !defined(CONFIG_SPL_BUILD)
 197 int env_complete(char *var, int maxv, char *cmdv[], int bufsz, char *buf)
 198 {
 199         ENTRY *match;
 200         int found, idx;
 201
 202         idx = 0;
 203         found = 0;
 204         cmdv[0] = NULL;
 205
 206         while ((idx = hmatch_r(var, idx, &match, &env_htab))) {
 207                 int vallen = strlen(match->key) + 1;
 208
 209                 if (found >= maxv - 2 || bufsz < vallen)
 210                         break;
 211
 212                 cmdv[found++] = buf;
 213                 memcpy(buf, match->key, vallen);
 214                 buf += vallen;
 215                 bufsz -= vallen;
 216         }
 217
 218         qsort(cmdv, found, sizeof(cmdv[0]), strcmp_compar);
 219
 220         if (idx)
 221                 cmdv[found++] = "...";
 222
 223         cmdv[found] = NULL;
 224         return found;
 225 }
 226 #endif