1 // SPDX-License-Identifier: GPL-2.0+
3 * Integrate UEFI variables to u-boot env interface
5 * Copyright (c) 2018 AKASHI Takahiro, Linaro Limited
11 #include <efi_loader.h>
12 #include <efi_variable.h>
20 #include <linux/kernel.h>
23 * From efi_variable.c,
25 * Mapping between UEFI variables and u-boot variables:
27 * efi_$guid_$varname = {attributes}(type)value
34 {EFI_VARIABLE_NON_VOLATILE, "NV"},
35 {EFI_VARIABLE_BOOTSERVICE_ACCESS, "BS"},
36 {EFI_VARIABLE_RUNTIME_ACCESS, "RT"},
37 {EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS, "AW"},
38 {EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS, "AT"},
39 {EFI_VARIABLE_READ_ONLY, "RO"},
46 /* signature database */
47 {EFI_GLOBAL_VARIABLE_GUID, "EFI_GLOBAL_VARIABLE_GUID"},
48 {EFI_IMAGE_SECURITY_DATABASE_GUID, "EFI_IMAGE_SECURITY_DATABASE_GUID"},
49 /* certificate type */
50 {EFI_CERT_SHA256_GUID, "EFI_CERT_SHA256_GUID"},
51 {EFI_CERT_X509_GUID, "EFI_CERT_X509_GUID"},
52 {EFI_CERT_TYPE_PKCS7_GUID, "EFI_CERT_TYPE_PKCS7_GUID"},
55 static const char unknown_guid[] = "";
58 * efi_guid_to_str() - convert guid to readable name
61 * Return: string for GUID
63 * convert guid to readable name
65 static const char *efi_guid_to_str(const efi_guid_t *guid)
69 for (i = 0; i < ARRAY_SIZE(efi_guid_text); i++)
70 if (!guidcmp(guid, &efi_guid_text[i].guid))
71 return efi_guid_text[i].text;
77 * efi_dump_single_var() - show information about a UEFI variable
79 * @name: Name of the variable
81 * @verbose: if true, dump data
83 * Show information encoded in one UEFI variable
85 static void efi_dump_single_var(u16 *name, const efi_guid_t *guid, bool verbose)
97 ret = efi_get_variable_int(name, guid, &attributes, &size, data, &time);
98 if (ret == EFI_BUFFER_TOO_SMALL) {
103 ret = efi_get_variable_int(name, guid, &attributes, &size,
106 if (ret == EFI_NOT_FOUND) {
107 printf("Error: \"%ls\" not defined\n", name);
110 if (ret != EFI_SUCCESS)
113 rtc_to_tm(time, &tm);
114 printf("%ls:\n %pUl %s\n", name, guid, efi_guid_to_str(guid));
115 if (attributes & EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS)
116 printf(" %04d-%02d-%02d %02d:%02d:%02d\n", tm.tm_year,
117 tm.tm_mon, tm.tm_mday, tm.tm_hour, tm.tm_min, tm.tm_sec);
119 for (count = 0, i = 0; i < ARRAY_SIZE(efi_var_attrs); i++)
120 if (attributes & efi_var_attrs[i].mask) {
124 puts(efi_var_attrs[i].text);
126 printf(", DataSize = 0x%zx\n", size);
128 print_hex_dump(" ", DUMP_PREFIX_OFFSET, 16, 1,
135 static bool match_name(int argc, char *const argv[], u16 *var_name16)
142 buflen = utf16_utf8_strlen(var_name16) + 1;
143 buf = calloc(1, buflen);
148 utf16_utf8_strcpy(&p, var_name16);
150 for (i = 0; i < argc; argc--, argv++) {
151 if (!strcmp(buf, argv[i])) {
164 * efi_dump_var_all() - show information about all the UEFI variables
166 * @argc: Number of arguments (variables)
167 * @argv: Argument (variable name) array
168 * @verbose: if true, dump data
169 * Return: CMD_RET_SUCCESS on success, or CMD_RET_RET_FAILURE
171 * Show information encoded in all the UEFI variables
173 static int efi_dump_var_all(int argc, char *const argv[],
174 const efi_guid_t *guid_p, bool verbose)
177 efi_uintn_t buf_size, size;
183 var_name16 = malloc(buf_size);
185 return CMD_RET_FAILURE;
190 ret = EFI_CALL(efi_get_next_variable_name(&size, var_name16,
192 if (ret == EFI_NOT_FOUND)
194 if (ret == EFI_BUFFER_TOO_SMALL) {
196 p = realloc(var_name16, buf_size);
199 return CMD_RET_FAILURE;
202 ret = EFI_CALL(efi_get_next_variable_name(&size,
206 if (ret != EFI_SUCCESS) {
208 return CMD_RET_FAILURE;
211 if (guid_p && guidcmp(guid_p, &guid))
213 if (!argc || match_name(argc, argv, var_name16)) {
215 efi_dump_single_var(var_name16, &guid, verbose);
220 if (!match && argc == 1)
221 printf("Error: \"%s\" not defined\n", argv[0]);
223 return CMD_RET_SUCCESS;
227 * do_env_print_efi() - show information about UEFI variables
229 * @cmdtp: Command table
230 * @flag: Command flag
231 * @argc: Number of arguments
232 * @argv: Argument array
233 * Return: CMD_RET_SUCCESS on success, or CMD_RET_RET_FAILURE
235 * This function is for "env print -e" or "printenv -e" command:
236 * => env print -e [-n] [-guid <guid> | -all] [var [...]]
237 * If one or more variable names are specified, show information
238 * named UEFI variables, otherwise show all the UEFI variables.
240 int do_env_print_efi(struct cmd_tbl *cmdtp, int flag, int argc,
243 const efi_guid_t *guid_p = NULL;
247 /* Initialize EFI drivers */
248 ret = efi_init_obj_list();
249 if (ret != EFI_SUCCESS) {
250 printf("Error: Cannot initialize UEFI sub-system, r = %lu\n",
251 ret & ~EFI_ERROR_MASK);
252 return CMD_RET_FAILURE;
255 for (argc--, argv++; argc > 0 && argv[0][0] == '-'; argc--, argv++) {
256 if (!strcmp(argv[0], "-guid")) {
260 return CMD_RET_USAGE;
263 if (uuid_str_to_bin(argv[0], guid.b,
264 UUID_STR_FORMAT_GUID))
265 return CMD_RET_USAGE;
266 guid_p = (const efi_guid_t *)guid.b;
267 } else if (!strcmp(argv[0], "-n")) {
270 return CMD_RET_USAGE;
274 /* enumerate and show all UEFI variables */
275 return efi_dump_var_all(argc, argv, guid_p, verbose);
279 * append_value() - encode UEFI variable's value
280 * @bufp: Buffer of encoded UEFI variable's value
281 * @sizep: Size of buffer
282 * @data: data to be encoded into the value
283 * Return: 0 on success, -1 otherwise
285 * Interpret a given data string and append it to buffer.
286 * Buffer will be realloc'ed if necessary.
288 * Currently supported formats are:
289 * =0x0123...: Hexadecimal number
290 * =H0123...: Hexadecimal-byte array
291 * ="...", =S"..." or <string>:
294 static int append_value(char **bufp, size_t *sizep, char *data)
296 char *tmp_buf = NULL, *new_buf = NULL, *value;
297 unsigned long len = 0;
299 if (!strncmp(data, "=0x", 2)) { /* hexadecimal number */
306 unsigned long hex_value;
311 if ((len & 0x1)) /* not multiple of two */
322 /* convert hex hexadecimal number */
323 if (strict_strtoul(data, 16, &hex_value) < 0)
326 tmp_buf = malloc(len);
331 tmp_data.u8 = hex_value;
332 hex_ptr = &tmp_data.u8;
333 } else if (len == 2) {
334 tmp_data.u16 = hex_value;
335 hex_ptr = &tmp_data.u16;
336 } else if (len == 4) {
337 tmp_data.u32 = hex_value;
338 hex_ptr = &tmp_data.u32;
340 tmp_data.u64 = hex_value;
341 hex_ptr = &tmp_data.u64;
343 memcpy(tmp_buf, hex_ptr, len);
346 } else if (!strncmp(data, "=H", 2)) { /* hexadecimal-byte array */
349 if (len & 0x1) /* not multiple of two */
353 tmp_buf = malloc(len);
357 if (hex2bin((u8 *)tmp_buf, data, len) < 0) {
358 printf("Error: illegal hexadecimal string\n");
364 } else { /* string */
365 if (!strncmp(data, "=\"", 2) || !strncmp(data, "=S\"", 3)) {
371 len = strlen(data) - 1;
372 if (data[len] != '"')
380 new_buf = realloc(*bufp, *sizep + len);
384 memcpy(new_buf + *sizep, value, len);
395 * do_env_set_efi() - set UEFI variable
397 * @cmdtp: Command table
398 * @flag: Command flag
399 * @argc: Number of arguments
400 * @argv: Argument array
401 * Return: CMD_RET_SUCCESS on success, or CMD_RET_RET_FAILURE
403 * This function is for "env set -e" or "setenv -e" command:
404 * => env set -e [-guid guid][-nv][-bs][-rt][-at][-a][-v]
405 * [-i address,size] var, or
407 * Encode values specified and set given UEFI variable.
408 * If no value is specified, delete the variable.
410 int do_env_set_efi(struct cmd_tbl *cmdtp, int flag, int argc,
413 char *var_name, *value, *ep;
418 bool default_guid, verbose, value_on_memory;
419 u16 *var_name16 = NULL, *p;
424 return CMD_RET_USAGE;
426 /* Initialize EFI drivers */
427 ret = efi_init_obj_list();
428 if (ret != EFI_SUCCESS) {
429 printf("Error: Cannot initialize UEFI sub-system, r = %lu\n",
430 ret & ~EFI_ERROR_MASK);
431 return CMD_RET_FAILURE;
435 * attributes = EFI_VARIABLE_BOOTSERVICE_ACCESS |
436 * EFI_VARIABLE_RUNTIME_ACCESS;
441 guid = efi_global_variable_guid;
444 value_on_memory = false;
445 for (argc--, argv++; argc > 0 && argv[0][0] == '-'; argc--, argv++) {
446 if (!strcmp(argv[0], "-guid")) {
448 return CMD_RET_USAGE;
452 if (uuid_str_to_bin(argv[0], guid.b,
453 UUID_STR_FORMAT_GUID)) {
454 return CMD_RET_USAGE;
456 default_guid = false;
457 } else if (!strcmp(argv[0], "-bs")) {
458 attributes |= EFI_VARIABLE_BOOTSERVICE_ACCESS;
459 } else if (!strcmp(argv[0], "-rt")) {
460 attributes |= EFI_VARIABLE_RUNTIME_ACCESS;
461 } else if (!strcmp(argv[0], "-nv")) {
462 attributes |= EFI_VARIABLE_NON_VOLATILE;
463 } else if (!strcmp(argv[0], "-at")) {
465 EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS;
466 } else if (!strcmp(argv[0], "-a")) {
467 attributes |= EFI_VARIABLE_APPEND_WRITE;
468 } else if (!strcmp(argv[0], "-i")) {
469 /* data comes from memory */
471 return CMD_RET_USAGE;
475 addr = simple_strtoul(argv[0], &ep, 16);
477 return CMD_RET_USAGE;
479 /* 0 should be allowed for delete */
480 size = simple_strtoul(++ep, NULL, 16);
482 value_on_memory = true;
483 } else if (!strcmp(argv[0], "-v")) {
486 return CMD_RET_USAGE;
490 return CMD_RET_USAGE;
494 if (!strcmp(var_name, "db") || !strcmp(var_name, "dbx") ||
495 !strcmp(var_name, "dbt"))
496 guid = efi_guid_image_security_database;
498 guid = efi_global_variable_guid;
502 printf("GUID: %pUl %s\n", &guid,
503 efi_guid_to_str((const efi_guid_t *)&guid));
504 printf("Attributes: 0x%x\n", attributes);
509 value = map_sysmem(addr, 0);
511 for (argc--, argv++; argc > 0; argc--, argv++)
512 if (append_value(&value, &size, argv[0]) < 0) {
513 printf("## Failed to process an argument, %s\n",
515 ret = CMD_RET_FAILURE;
519 if (size && verbose) {
521 print_hex_dump(" ", DUMP_PREFIX_OFFSET,
522 16, 1, value, size, true);
525 len = utf8_utf16_strnlen(var_name, strlen(var_name));
526 var_name16 = malloc((len + 1) * 2);
528 printf("## Out of memory\n");
529 ret = CMD_RET_FAILURE;
533 utf8_utf16_strncpy(&p, var_name, len + 1);
535 ret = efi_set_variable_int(var_name16, &guid, attributes, size, value,
538 if (ret == EFI_SUCCESS) {
539 ret = CMD_RET_SUCCESS;
545 msg = " (not found)";
547 case EFI_WRITE_PROTECTED:
548 msg = " (read only)";
550 case EFI_INVALID_PARAMETER:
551 msg = " (invalid parameter)";
553 case EFI_SECURITY_VIOLATION:
554 msg = " (validation failed)";
556 case EFI_OUT_OF_RESOURCES:
557 msg = " (out of memory)";
563 printf("## Failed to set EFI variable%s\n", msg);
564 ret = CMD_RET_FAILURE;