binman: doc: Remove incomplete sentence
[platform/kernel/u-boot.git] / cmd / bootefi.c
1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3  *  EFI application loader
4  *
5  *  Copyright (c) 2016 Alexander Graf
6  */
7
8 #define LOG_CATEGORY LOGC_EFI
9
10 #include <common.h>
11 #include <bootm.h>
12 #include <charset.h>
13 #include <command.h>
14 #include <dm.h>
15 #include <efi_loader.h>
16 #include <efi_selftest.h>
17 #include <env.h>
18 #include <errno.h>
19 #include <image.h>
20 #include <log.h>
21 #include <malloc.h>
22 #include <asm/global_data.h>
23 #include <linux/libfdt.h>
24 #include <linux/libfdt_env.h>
25 #include <mapmem.h>
26 #include <memalign.h>
27 #include <asm-generic/sections.h>
28 #include <linux/linkage.h>
29
30 DECLARE_GLOBAL_DATA_PTR;
31
32 static struct efi_device_path *bootefi_image_path;
33 static struct efi_device_path *bootefi_device_path;
34 static void *image_addr;
35 static size_t image_size;
36
37 /**
38  * efi_get_image_parameters() - return image parameters
39  *
40  * @img_addr:           address of loaded image in memory
41  * @img_size:           size of loaded image
42  */
43 void efi_get_image_parameters(void **img_addr, size_t *img_size)
44 {
45         *img_addr = image_addr;
46         *img_size = image_size;
47 }
48
49 /**
50  * efi_clear_bootdev() - clear boot device
51  */
52 static void efi_clear_bootdev(void)
53 {
54         efi_free_pool(bootefi_device_path);
55         efi_free_pool(bootefi_image_path);
56         bootefi_device_path = NULL;
57         bootefi_image_path = NULL;
58         image_addr = NULL;
59         image_size = 0;
60 }
61
62 /**
63  * efi_set_bootdev() - set boot device
64  *
65  * This function is called when a file is loaded, e.g. via the 'load' command.
66  * We use the path to this file to inform the UEFI binary about the boot device.
67  *
68  * @dev:                device, e.g. "MMC"
69  * @devnr:              number of the device, e.g. "1:2"
70  * @path:               path to file loaded
71  * @buffer:             buffer with file loaded
72  * @buffer_size:        size of file loaded
73  */
74 void efi_set_bootdev(const char *dev, const char *devnr, const char *path,
75                      void *buffer, size_t buffer_size)
76 {
77         struct efi_device_path *device, *image;
78         efi_status_t ret;
79
80         log_debug("dev=%s, devnr=%s, path=%s, buffer=%p, size=%zx\n", dev,
81                   devnr, path, buffer, buffer_size);
82
83         /* Forget overwritten image */
84         if (buffer + buffer_size >= image_addr &&
85             image_addr + image_size >= buffer)
86                 efi_clear_bootdev();
87
88         /* Remember only PE-COFF and FIT images */
89         if (efi_check_pe(buffer, buffer_size, NULL) != EFI_SUCCESS) {
90                 if (IS_ENABLED(CONFIG_FIT) &&
91                     !fit_check_format(buffer, IMAGE_SIZE_INVAL)) {
92                         /*
93                          * FIT images of type EFI_OS are started via command
94                          * bootm. We should not use their boot device with the
95                          * bootefi command.
96                          */
97                         buffer = 0;
98                         buffer_size = 0;
99                 } else {
100                         log_debug("- not remembering image\n");
101                         return;
102                 }
103         }
104
105         /* efi_set_bootdev() is typically called repeatedly, recover memory */
106         efi_clear_bootdev();
107
108         image_addr = buffer;
109         image_size = buffer_size;
110
111         ret = efi_dp_from_name(dev, devnr, path, &device, &image);
112         if (ret == EFI_SUCCESS) {
113                 bootefi_device_path = device;
114                 if (image) {
115                         /* FIXME: image should not contain device */
116                         struct efi_device_path *image_tmp = image;
117
118                         efi_dp_split_file_path(image, &device, &image);
119                         efi_free_pool(image_tmp);
120                 }
121                 bootefi_image_path = image;
122                 log_debug("- boot device %pD\n", device);
123                 if (image)
124                         log_debug("- image %pD\n", image);
125         } else {
126                 log_debug("- efi_dp_from_name() failed, err=%lx\n", ret);
127                 efi_clear_bootdev();
128         }
129 }
130
131 /**
132  * efi_env_set_load_options() - set load options from environment variable
133  *
134  * @handle:             the image handle
135  * @env_var:            name of the environment variable
136  * @load_options:       pointer to load options (output)
137  * Return:              status code
138  */
139 static efi_status_t efi_env_set_load_options(efi_handle_t handle,
140                                              const char *env_var,
141                                              u16 **load_options)
142 {
143         const char *env = env_get(env_var);
144         size_t size;
145         u16 *pos;
146         efi_status_t ret;
147
148         *load_options = NULL;
149         if (!env)
150                 return EFI_SUCCESS;
151         size = sizeof(u16) * (utf8_utf16_strlen(env) + 1);
152         pos = calloc(size, 1);
153         if (!pos)
154                 return EFI_OUT_OF_RESOURCES;
155         *load_options = pos;
156         utf8_utf16_strcpy(&pos, env);
157         ret = efi_set_load_options(handle, size, *load_options);
158         if (ret != EFI_SUCCESS) {
159                 free(*load_options);
160                 *load_options = NULL;
161         }
162         return ret;
163 }
164
165 #if !CONFIG_IS_ENABLED(GENERATE_ACPI_TABLE)
166
167 /**
168  * copy_fdt() - Copy the device tree to a new location available to EFI
169  *
170  * The FDT is copied to a suitable location within the EFI memory map.
171  * Additional 12 KiB are added to the space in case the device tree needs to be
172  * expanded later with fdt_open_into().
173  *
174  * @fdtp:       On entry a pointer to the flattened device tree.
175  *              On exit a pointer to the copy of the flattened device tree.
176  *              FDT start
177  * Return:      status code
178  */
179 static efi_status_t copy_fdt(void **fdtp)
180 {
181         unsigned long fdt_ram_start = -1L, fdt_pages;
182         efi_status_t ret = 0;
183         void *fdt, *new_fdt;
184         u64 new_fdt_addr;
185         uint fdt_size;
186         int i;
187
188         for (i = 0; i < CONFIG_NR_DRAM_BANKS; i++) {
189                 u64 ram_start = gd->bd->bi_dram[i].start;
190                 u64 ram_size = gd->bd->bi_dram[i].size;
191
192                 if (!ram_size)
193                         continue;
194
195                 if (ram_start < fdt_ram_start)
196                         fdt_ram_start = ram_start;
197         }
198
199         /*
200          * Give us at least 12 KiB of breathing room in case the device tree
201          * needs to be expanded later.
202          */
203         fdt = *fdtp;
204         fdt_pages = efi_size_in_pages(fdt_totalsize(fdt) + 0x3000);
205         fdt_size = fdt_pages << EFI_PAGE_SHIFT;
206
207         ret = efi_allocate_pages(EFI_ALLOCATE_ANY_PAGES,
208                                  EFI_ACPI_RECLAIM_MEMORY, fdt_pages,
209                                  &new_fdt_addr);
210         if (ret != EFI_SUCCESS) {
211                 log_err("ERROR: Failed to reserve space for FDT\n");
212                 goto done;
213         }
214         new_fdt = (void *)(uintptr_t)new_fdt_addr;
215         memcpy(new_fdt, fdt, fdt_totalsize(fdt));
216         fdt_set_totalsize(new_fdt, fdt_size);
217
218         *fdtp = (void *)(uintptr_t)new_fdt_addr;
219 done:
220         return ret;
221 }
222
223 /**
224  * get_config_table() - get configuration table
225  *
226  * @guid:       GUID of the configuration table
227  * Return:      pointer to configuration table or NULL
228  */
229 static void *get_config_table(const efi_guid_t *guid)
230 {
231         size_t i;
232
233         for (i = 0; i < systab.nr_tables; i++) {
234                 if (!guidcmp(guid, &systab.tables[i].guid))
235                         return systab.tables[i].table;
236         }
237         return NULL;
238 }
239
240 #endif /* !CONFIG_IS_ENABLED(GENERATE_ACPI_TABLE) */
241
242 /**
243  * efi_install_fdt() - install device tree
244  *
245  * If fdt is not EFI_FDT_USE_INTERNAL, the device tree located at that memory
246  * address will will be installed as configuration table, otherwise the device
247  * tree located at the address indicated by environment variable fdt_addr or as
248  * fallback fdtcontroladdr will be used.
249  *
250  * On architectures using ACPI tables device trees shall not be installed as
251  * configuration table.
252  *
253  * @fdt:        address of device tree or EFI_FDT_USE_INTERNAL to use the
254  *              the hardware device tree as indicated by environment variable
255  *              fdt_addr or as fallback the internal device tree as indicated by
256  *              the environment variable fdtcontroladdr
257  * Return:      status code
258  */
259 efi_status_t efi_install_fdt(void *fdt)
260 {
261         /*
262          * The EBBR spec requires that we have either an FDT or an ACPI table
263          * but not both.
264          */
265 #if CONFIG_IS_ENABLED(GENERATE_ACPI_TABLE)
266         if (fdt) {
267                 log_warning("WARNING: Can't have ACPI table and device tree - ignoring DT.\n");
268                 return EFI_SUCCESS;
269         }
270 #else
271         struct bootm_headers img = { 0 };
272         efi_status_t ret;
273
274         if (fdt == EFI_FDT_USE_INTERNAL) {
275                 const char *fdt_opt;
276                 uintptr_t fdt_addr;
277
278                 /* Look for device tree that is already installed */
279                 if (get_config_table(&efi_guid_fdt))
280                         return EFI_SUCCESS;
281                 /* Check if there is a hardware device tree */
282                 fdt_opt = env_get("fdt_addr");
283                 /* Use our own device tree as fallback */
284                 if (!fdt_opt) {
285                         fdt_opt = env_get("fdtcontroladdr");
286                         if (!fdt_opt) {
287                                 log_err("ERROR: need device tree\n");
288                                 return EFI_NOT_FOUND;
289                         }
290                 }
291                 fdt_addr = hextoul(fdt_opt, NULL);
292                 if (!fdt_addr) {
293                         log_err("ERROR: invalid $fdt_addr or $fdtcontroladdr\n");
294                         return EFI_LOAD_ERROR;
295                 }
296                 fdt = map_sysmem(fdt_addr, 0);
297         }
298
299         /* Install device tree */
300         if (fdt_check_header(fdt)) {
301                 log_err("ERROR: invalid device tree\n");
302                 return EFI_LOAD_ERROR;
303         }
304
305         /* Prepare device tree for payload */
306         ret = copy_fdt(&fdt);
307         if (ret) {
308                 log_err("ERROR: out of memory\n");
309                 return EFI_OUT_OF_RESOURCES;
310         }
311
312         if (image_setup_libfdt(&img, fdt, 0, NULL)) {
313                 log_err("ERROR: failed to process device tree\n");
314                 return EFI_LOAD_ERROR;
315         }
316
317         /* Create memory reservations as indicated by the device tree */
318         efi_carve_out_dt_rsv(fdt);
319
320         efi_try_purge_kaslr_seed(fdt);
321
322         if (CONFIG_IS_ENABLED(EFI_TCG2_PROTOCOL_MEASURE_DTB)) {
323                 ret = efi_tcg2_measure_dtb(fdt);
324                 if (ret == EFI_SECURITY_VIOLATION) {
325                         log_err("ERROR: failed to measure DTB\n");
326                         return ret;
327                 }
328         }
329
330         /* Install device tree as UEFI table */
331         ret = efi_install_configuration_table(&efi_guid_fdt, fdt);
332         if (ret != EFI_SUCCESS) {
333                 log_err("ERROR: failed to install device tree\n");
334                 return ret;
335         }
336 #endif /* GENERATE_ACPI_TABLE */
337
338         return EFI_SUCCESS;
339 }
340
341 /**
342  * do_bootefi_exec() - execute EFI binary
343  *
344  * The image indicated by @handle is started. When it returns the allocated
345  * memory for the @load_options is freed.
346  *
347  * @handle:             handle of loaded image
348  * @load_options:       load options
349  * Return:              status code
350  *
351  * Load the EFI binary into a newly assigned memory unwinding the relocation
352  * information, install the loaded image protocol, and call the binary.
353  */
354 static efi_status_t do_bootefi_exec(efi_handle_t handle, void *load_options)
355 {
356         efi_status_t ret;
357         efi_uintn_t exit_data_size = 0;
358         u16 *exit_data = NULL;
359
360         /* On ARM switch from EL3 or secure mode to EL2 or non-secure mode */
361         switch_to_non_secure_mode();
362
363         /*
364          * The UEFI standard requires that the watchdog timer is set to five
365          * minutes when invoking an EFI boot option.
366          *
367          * Unified Extensible Firmware Interface (UEFI), version 2.7 Errata A
368          * 7.5. Miscellaneous Boot Services - EFI_BOOT_SERVICES.SetWatchdogTimer
369          */
370         ret = efi_set_watchdog(300);
371         if (ret != EFI_SUCCESS) {
372                 log_err("ERROR: Failed to set watchdog timer\n");
373                 goto out;
374         }
375
376         /* Call our payload! */
377         ret = EFI_CALL(efi_start_image(handle, &exit_data_size, &exit_data));
378         if (ret != EFI_SUCCESS) {
379                 log_err("## Application failed, r = %lu\n",
380                         ret & ~EFI_ERROR_MASK);
381                 if (exit_data) {
382                         log_err("## %ls\n", exit_data);
383                         efi_free_pool(exit_data);
384                 }
385         }
386
387         efi_restore_gd();
388
389 out:
390         free(load_options);
391
392         if (IS_ENABLED(CONFIG_EFI_LOAD_FILE2_INITRD)) {
393                 if (efi_initrd_deregister() != EFI_SUCCESS)
394                         log_err("Failed to remove loadfile2 for initrd\n");
395         }
396
397         /* Control is returned to U-Boot, disable EFI watchdog */
398         efi_set_watchdog(0);
399
400         return ret;
401 }
402
403 /**
404  * do_efibootmgr() - execute EFI boot manager
405  *
406  * Return:      status code
407  */
408 static int do_efibootmgr(void)
409 {
410         efi_handle_t handle;
411         efi_status_t ret;
412         void *load_options;
413
414         ret = efi_bootmgr_load(&handle, &load_options);
415         if (ret != EFI_SUCCESS) {
416                 log_notice("EFI boot manager: Cannot load any image\n");
417                 return CMD_RET_FAILURE;
418         }
419
420         ret = do_bootefi_exec(handle, load_options);
421
422         if (ret != EFI_SUCCESS)
423                 return CMD_RET_FAILURE;
424
425         return CMD_RET_SUCCESS;
426 }
427
428 /**
429  * do_bootefi_image() - execute EFI binary
430  *
431  * Set up memory image for the binary to be loaded, prepare device path, and
432  * then call do_bootefi_exec() to execute it.
433  *
434  * @image_opt:  string with image start address
435  * @size_opt:   string with image size or NULL
436  * Return:      status code
437  */
438 static int do_bootefi_image(const char *image_opt, const char *size_opt)
439 {
440         void *image_buf;
441         unsigned long addr, size;
442         efi_status_t ret;
443
444 #ifdef CONFIG_CMD_BOOTEFI_HELLO
445         if (!strcmp(image_opt, "hello")) {
446                 image_buf = __efi_helloworld_begin;
447                 size = __efi_helloworld_end - __efi_helloworld_begin;
448                 efi_clear_bootdev();
449         } else
450 #endif
451         {
452                 addr = strtoul(image_opt, NULL, 16);
453                 /* Check that a numeric value was passed */
454                 if (!addr)
455                         return CMD_RET_USAGE;
456                 image_buf = map_sysmem(addr, 0);
457
458                 if (size_opt) {
459                         size = strtoul(size_opt, NULL, 16);
460                         if (!size)
461                                 return CMD_RET_USAGE;
462                         efi_clear_bootdev();
463                 } else {
464                         if (image_buf != image_addr) {
465                                 log_err("No UEFI binary known at %s\n",
466                                         image_opt);
467                                 return CMD_RET_FAILURE;
468                         }
469                         size = image_size;
470                 }
471         }
472         ret = efi_run_image(image_buf, size);
473
474         if (ret != EFI_SUCCESS)
475                 return CMD_RET_FAILURE;
476
477         return CMD_RET_SUCCESS;
478 }
479
480 /**
481  * efi_run_image() - run loaded UEFI image
482  *
483  * @source_buffer:      memory address of the UEFI image
484  * @source_size:        size of the UEFI image
485  * Return:              status code
486  */
487 efi_status_t efi_run_image(void *source_buffer, efi_uintn_t source_size)
488 {
489         efi_handle_t mem_handle = NULL, handle;
490         struct efi_device_path *file_path = NULL;
491         struct efi_device_path *msg_path;
492         efi_status_t ret, ret2;
493         u16 *load_options;
494
495         if (!bootefi_device_path || !bootefi_image_path) {
496                 log_debug("Not loaded from disk\n");
497                 /*
498                  * Special case for efi payload not loaded from disk,
499                  * such as 'bootefi hello' or for example payload
500                  * loaded directly into memory via JTAG, etc:
501                  */
502                 file_path = efi_dp_from_mem(EFI_RESERVED_MEMORY_TYPE,
503                                             (uintptr_t)source_buffer,
504                                             source_size);
505                 /*
506                  * Make sure that device for device_path exist
507                  * in load_image(). Otherwise, shell and grub will fail.
508                  */
509                 ret = efi_install_multiple_protocol_interfaces(&mem_handle,
510                                                                &efi_guid_device_path,
511                                                                file_path, NULL);
512                 if (ret != EFI_SUCCESS)
513                         goto out;
514                 msg_path = file_path;
515         } else {
516                 file_path = efi_dp_append(bootefi_device_path,
517                                           bootefi_image_path);
518                 msg_path = bootefi_image_path;
519                 log_debug("Loaded from disk\n");
520         }
521
522         log_info("Booting %pD\n", msg_path);
523
524         ret = EFI_CALL(efi_load_image(false, efi_root, file_path, source_buffer,
525                                       source_size, &handle));
526         if (ret != EFI_SUCCESS) {
527                 log_err("Loading image failed\n");
528                 goto out;
529         }
530
531         /* Transfer environment variable as load options */
532         ret = efi_env_set_load_options(handle, "bootargs", &load_options);
533         if (ret != EFI_SUCCESS)
534                 goto out;
535
536         ret = do_bootefi_exec(handle, load_options);
537
538 out:
539         ret2 = efi_uninstall_multiple_protocol_interfaces(mem_handle,
540                                                           &efi_guid_device_path,
541                                                           file_path, NULL);
542         efi_free_pool(file_path);
543         return (ret != EFI_SUCCESS) ? ret : ret2;
544 }
545
546 #ifdef CONFIG_CMD_BOOTEFI_SELFTEST
547 static efi_status_t bootefi_run_prepare(const char *load_options_path,
548                 struct efi_device_path *device_path,
549                 struct efi_device_path *image_path,
550                 struct efi_loaded_image_obj **image_objp,
551                 struct efi_loaded_image **loaded_image_infop)
552 {
553         efi_status_t ret;
554         u16 *load_options;
555
556         ret = efi_setup_loaded_image(device_path, image_path, image_objp,
557                                      loaded_image_infop);
558         if (ret != EFI_SUCCESS)
559                 return ret;
560
561         /* Transfer environment variable as load options */
562         return efi_env_set_load_options((efi_handle_t)*image_objp,
563                                         load_options_path,
564                                         &load_options);
565 }
566
567 /**
568  * bootefi_test_prepare() - prepare to run an EFI test
569  *
570  * Prepare to run a test as if it were provided by a loaded image.
571  *
572  * @image_objp:         pointer to be set to the loaded image handle
573  * @loaded_image_infop: pointer to be set to the loaded image protocol
574  * @path:               dummy file path used to construct the device path
575  *                      set in the loaded image protocol
576  * @load_options_path:  name of a U-Boot environment variable. Its value is
577  *                      set as load options in the loaded image protocol.
578  * Return:              status code
579  */
580 static efi_status_t bootefi_test_prepare
581                 (struct efi_loaded_image_obj **image_objp,
582                  struct efi_loaded_image **loaded_image_infop, const char *path,
583                  const char *load_options_path)
584 {
585         efi_status_t ret;
586
587         /* Construct a dummy device path */
588         bootefi_device_path = efi_dp_from_mem(EFI_RESERVED_MEMORY_TYPE, 0, 0);
589         if (!bootefi_device_path)
590                 return EFI_OUT_OF_RESOURCES;
591
592         bootefi_image_path = efi_dp_from_file(NULL, path);
593         if (!bootefi_image_path) {
594                 ret = EFI_OUT_OF_RESOURCES;
595                 goto failure;
596         }
597
598         ret = bootefi_run_prepare(load_options_path, bootefi_device_path,
599                                   bootefi_image_path, image_objp,
600                                   loaded_image_infop);
601         if (ret == EFI_SUCCESS)
602                 return ret;
603
604 failure:
605         efi_clear_bootdev();
606         return ret;
607 }
608
609 /**
610  * do_efi_selftest() - execute EFI selftest
611  *
612  * Return:      status code
613  */
614 static int do_efi_selftest(void)
615 {
616         struct efi_loaded_image_obj *image_obj;
617         struct efi_loaded_image *loaded_image_info;
618         efi_status_t ret;
619
620         ret = bootefi_test_prepare(&image_obj, &loaded_image_info,
621                                    "\\selftest", "efi_selftest");
622         if (ret != EFI_SUCCESS)
623                 return CMD_RET_FAILURE;
624
625         /* Execute the test */
626         ret = EFI_CALL(efi_selftest(&image_obj->header, &systab));
627         efi_restore_gd();
628         free(loaded_image_info->load_options);
629         if (ret != EFI_SUCCESS)
630                 efi_delete_handle(&image_obj->header);
631         else
632                 ret = efi_delete_handle(&image_obj->header);
633
634         return ret != EFI_SUCCESS;
635 }
636 #endif /* CONFIG_CMD_BOOTEFI_SELFTEST */
637
638 /**
639  * do_bootefi() - execute `bootefi` command
640  *
641  * @cmdtp:      table entry describing command
642  * @flag:       bitmap indicating how the command was invoked
643  * @argc:       number of arguments
644  * @argv:       command line arguments
645  * Return:      status code
646  */
647 static int do_bootefi(struct cmd_tbl *cmdtp, int flag, int argc,
648                       char *const argv[])
649 {
650         efi_status_t ret;
651         char *img_addr, *img_size, *str_copy, *pos;
652         void *fdt;
653
654         if (argc < 2)
655                 return CMD_RET_USAGE;
656
657         /* Initialize EFI drivers */
658         ret = efi_init_obj_list();
659         if (ret != EFI_SUCCESS) {
660                 log_err("Error: Cannot initialize UEFI sub-system, r = %lu\n",
661                         ret & ~EFI_ERROR_MASK);
662                 return CMD_RET_FAILURE;
663         }
664
665         if (argc > 2) {
666                 uintptr_t fdt_addr;
667
668                 fdt_addr = hextoul(argv[2], NULL);
669                 fdt = map_sysmem(fdt_addr, 0);
670         } else {
671                 fdt = EFI_FDT_USE_INTERNAL;
672         }
673         ret = efi_install_fdt(fdt);
674         if (ret == EFI_INVALID_PARAMETER)
675                 return CMD_RET_USAGE;
676         else if (ret != EFI_SUCCESS)
677                 return CMD_RET_FAILURE;
678
679         if (IS_ENABLED(CONFIG_CMD_BOOTEFI_BOOTMGR)) {
680                 if (!strcmp(argv[1], "bootmgr"))
681                         return do_efibootmgr();
682         }
683 #ifdef CONFIG_CMD_BOOTEFI_SELFTEST
684         if (!strcmp(argv[1], "selftest"))
685                 return do_efi_selftest();
686 #endif
687         str_copy = strdup(argv[1]);
688         if (!str_copy) {
689                 log_err("Out of memory\n");
690                 return CMD_RET_FAILURE;
691         }
692         pos = str_copy;
693         img_addr = strsep(&pos, ":");
694         img_size = strsep(&pos, ":");
695         ret = do_bootefi_image(img_addr, img_size);
696         free(str_copy);
697
698         return ret;
699 }
700
701 #ifdef CONFIG_SYS_LONGHELP
702 static char bootefi_help_text[] =
703         "<image address>[:<image size>] [<fdt address>]\n"
704         "  - boot EFI payload\n"
705 #ifdef CONFIG_CMD_BOOTEFI_HELLO
706         "bootefi hello\n"
707         "  - boot a sample Hello World application stored within U-Boot\n"
708 #endif
709 #ifdef CONFIG_CMD_BOOTEFI_SELFTEST
710         "bootefi selftest [fdt address]\n"
711         "  - boot an EFI selftest application stored within U-Boot\n"
712         "    Use environment variable efi_selftest to select a single test.\n"
713         "    Use 'setenv efi_selftest list' to enumerate all tests.\n"
714 #endif
715 #ifdef CONFIG_CMD_BOOTEFI_BOOTMGR
716         "bootefi bootmgr [fdt address]\n"
717         "  - load and boot EFI payload based on BootOrder/BootXXXX variables.\n"
718         "\n"
719         "    If specified, the device tree located at <fdt address> gets\n"
720         "    exposed as EFI configuration table.\n"
721 #endif
722         ;
723 #endif
724
725 U_BOOT_CMD(
726         bootefi, 4, 0, do_bootefi,
727         "Boots an EFI payload from memory",
728         bootefi_help_text
729 );