2 * (C) Copyright 2002-2008
3 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
5 * SPDX-License-Identifier: GPL-2.0+
15 int aes_flag; /* Is AES encryption used? */
16 uint8_t aes_key[AES_KEY_LENGTH];
20 int parse_aes_key(char *key, uint8_t *bin_key);
23 * fw_printenv() - print one or several environment variables
25 * @argc: number of variables names to be printed, prints all if 0
26 * @argv: array of variable names to be printed, if argc != 0
27 * @value_only: do not repeat the variable name, print the bare value,
28 * only one variable allowed with this option, argc must be 1
29 * @opts: encryption key, configuration file, defaults are used if NULL
32 * Uses fw_env_open, fw_getenv
35 * 0 on success, -1 on failure (modifies errno)
37 int fw_printenv(int argc, char *argv[], int value_only, struct env_opts *opts);
40 * fw_setenv() - adds or removes one variable to the environment
42 * @argc: number of strings in argv, argv[0] is variable name,
43 * argc==1 means erase variable, argc > 1 means add a variable
44 * @argv: argv[0] is variable name, argv[1..argc-1] are concatenated separated
45 * by single blank and set as the new value of the variable
46 * @opts: how to retrieve environment from flash, defaults are used if NULL
49 * Uses fw_env_open, fw_env_write, fw_env_close
52 * 0 on success, -1 on failure (modifies errno)
55 * EROFS - some variables ("ethaddr", "serial#") cannot be modified
57 int fw_setenv(int argc, char *argv[], struct env_opts *opts);
60 * fw_parse_script() - adds or removes multiple variables with a batch script
62 * @fname: batch script file name
63 * @opts: encryption key, configuration file, defaults are used if NULL
66 * Uses fw_env_open, fw_env_write, fw_env_close
69 * 0 success, -1 on failure (modifies errno)
73 * key [ [space]+ value]
75 * lines starting with '#' treated as comment
77 * A variable without value will be deleted. Any number of spaces are allowed
78 * between key and value. The value starts with the first non-space character
79 * and ends with newline. No comments allowed on these lines. Spaces inside
80 * the value are preserved verbatim.
88 * foo spaces are copied verbatim
90 * # delete variable bar
94 int fw_parse_script(char *fname, struct env_opts *opts);
98 * fw_env_open() - read enviroment from flash into RAM cache
100 * @opts: encryption key, configuration file, defaults are used if NULL
103 * 0 on success, -1 on failure (modifies errno)
105 int fw_env_open(struct env_opts *opts);
108 * fw_getenv() - lookup variable in the RAM cache
110 * @name: variable to be searched
112 * pointer to start of value, NULL if not found
114 char *fw_getenv(char *name);
117 * fw_env_write() - modify a variable held in the RAM cache
120 * @value: delete variable if NULL, otherwise create or overwrite the variable
122 * This is called in sequence to update the environment in RAM without updating
123 * the copy in flash after each set
126 * 0 on success, -1 on failure (modifies errno)
129 * EROFS - some variables ("ethaddr", "serial#") cannot be modified
131 int fw_env_write(char *name, char *value);
134 * fw_env_close - write the environment from RAM cache back to flash
136 * @opts: encryption key, configuration file, defaults are used if NULL
139 * 0 on success, -1 on failure (modifies errno)
141 int fw_env_close(struct env_opts *opts);
143 unsigned long crc32(unsigned long, const unsigned char *, unsigned);