2 * Copyright (c) 2008-2010 Rui Paulo
3 * Copyright (c) 2006 Marcel Moolenaar
4 * Copyright (c) 2018 Netflix, Inc
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD$");
35 #include <sys/param.h>
36 #include <sys/reboot.h>
49 #include <bootstrap.h>
57 #include "loader_efi.h"
59 struct arch_switch archsw; /* MI/MD interface boundary */
61 EFI_GUID acpi = ACPI_TABLE_GUID;
62 EFI_GUID acpi20 = ACPI_20_TABLE_GUID;
63 EFI_GUID devid = DEVICE_PATH_PROTOCOL;
64 EFI_GUID imgid = LOADED_IMAGE_PROTOCOL;
65 EFI_GUID mps = MPS_TABLE_GUID;
66 EFI_GUID netid = EFI_SIMPLE_NETWORK_PROTOCOL;
67 EFI_GUID smbios = SMBIOS_TABLE_GUID;
68 EFI_GUID smbios3 = SMBIOS3_TABLE_GUID;
69 EFI_GUID dxe = DXE_SERVICES_TABLE_GUID;
70 EFI_GUID hoblist = HOB_LIST_TABLE_GUID;
71 EFI_GUID lzmadecomp = LZMA_DECOMPRESSION_GUID;
72 EFI_GUID mpcore = ARM_MP_CORE_INFO_TABLE_GUID;
73 EFI_GUID esrt = ESRT_TABLE_GUID;
74 EFI_GUID memtype = MEMORY_TYPE_INFORMATION_TABLE_GUID;
75 EFI_GUID debugimg = DEBUG_IMAGE_INFO_TABLE_GUID;
76 EFI_GUID fdtdtb = FDT_TABLE_GUID;
77 EFI_GUID inputid = SIMPLE_TEXT_INPUT_PROTOCOL;
80 * Number of seconds to wait for a keystroke before exiting with failure
81 * in the event no currdev is found. -2 means always break, -1 means
82 * never break, 0 means poll once and then reboot, > 0 means wait for
83 * that many seconds. "fail_timeout" can be set in the environment as
86 static int fail_timeout = 5;
89 * Current boot variable
97 EFI_DEVICE_PATH *path;
98 EFI_HANDLE *hin, *hin_end, *walker;
103 * Find all the handles that support the SIMPLE_TEXT_INPUT_PROTOCOL and
104 * do the typical dance to get the right sized buffer.
108 status = BS->LocateHandle(ByProtocol, &inputid, 0, &sz, 0);
109 if (status == EFI_BUFFER_TOO_SMALL) {
110 hin = (EFI_HANDLE *)malloc(sz);
111 status = BS->LocateHandle(ByProtocol, &inputid, 0, &sz,
113 if (EFI_ERROR(status))
116 if (EFI_ERROR(status))
120 * Look at each of the handles. If it supports the device path protocol,
121 * use it to get the device path for this handle. Then see if that
122 * device path matches either the USB device path for keyboards or the
123 * legacy device path for keyboards.
125 hin_end = &hin[sz / sizeof(*hin)];
126 for (walker = hin; walker < hin_end; walker++) {
127 status = BS->HandleProtocol(*walker, &devid, (VOID **)&path);
128 if (EFI_ERROR(status))
131 while (!IsDevicePathEnd(path)) {
133 * Check for the ACPI keyboard node. All PNP3xx nodes
134 * are keyboards of different flavors. Note: It is
135 * unclear of there's always a keyboard node when
136 * there's a keyboard controller, or if there's only one
137 * when a keyboard is detected at boot.
139 if (DevicePathType(path) == ACPI_DEVICE_PATH &&
140 (DevicePathSubType(path) == ACPI_DP ||
141 DevicePathSubType(path) == ACPI_EXTENDED_DP)) {
142 ACPI_HID_DEVICE_PATH *acpi;
144 acpi = (ACPI_HID_DEVICE_PATH *)(void *)path;
145 if ((EISA_ID_TO_NUM(acpi->HID) & 0xff00) == 0x300 &&
146 (acpi->HID & 0xffff) == PNP_EISA_ID_CONST) {
151 * Check for USB keyboard node, if present. Unlike a
152 * PS/2 keyboard, these definitely only appear when
153 * connected to the system.
155 } else if (DevicePathType(path) == MESSAGING_DEVICE_PATH &&
156 DevicePathSubType(path) == MSG_USB_CLASS_DP) {
157 USB_CLASS_DEVICE_PATH *usb;
159 usb = (USB_CLASS_DEVICE_PATH *)(void *)path;
160 if (usb->DeviceClass == 3 && /* HID */
161 usb->DeviceSubClass == 1 && /* Boot devices */
162 usb->DeviceProtocol == 1) { /* Boot keyboards */
167 path = NextDevicePathNode(path);
176 set_currdev(const char *devname)
179 env_setenv("currdev", EV_VOLATILE, devname, efi_setcurrdev, env_nounset);
180 env_setenv("loaddev", EV_VOLATILE, devname, env_noset, env_nounset);
184 set_currdev_devdesc(struct devdesc *currdev)
188 devname = efi_fmtdev(currdev);
189 printf("Setting currdev to %s\n", devname);
190 set_currdev(devname);
194 set_currdev_devsw(struct devsw *dev, int unit)
196 struct devdesc currdev;
199 currdev.d_unit = unit;
201 set_currdev_devdesc(&currdev);
205 set_currdev_pdinfo(pdinfo_t *dp)
209 * Disks are special: they have partitions. if the parent
210 * pointer is non-null, we're a partition not a full disk
211 * and we need to adjust currdev appropriately.
213 if (dp->pd_devsw->dv_type == DEVT_DISK) {
214 struct disk_devdesc currdev;
216 currdev.dd.d_dev = dp->pd_devsw;
217 if (dp->pd_parent == NULL) {
218 currdev.dd.d_unit = dp->pd_unit;
219 currdev.d_slice = -1;
220 currdev.d_partition = -1;
222 currdev.dd.d_unit = dp->pd_parent->pd_unit;
223 currdev.d_slice = dp->pd_unit;
224 currdev.d_partition = 255; /* Assumes GPT */
226 set_currdev_devdesc((struct devdesc *)&currdev);
228 set_currdev_devsw(dp->pd_devsw, dp->pd_unit);
233 sanity_check_currdev(void)
237 return (stat("/boot/defaults/loader.conf", &st) == 0 ||
238 stat("/boot/kernel/kernel", &st) == 0);
243 probe_zfs_currdev(uint64_t guid)
246 struct zfs_devdesc currdev;
248 currdev.dd.d_dev = &zfs_dev;
249 currdev.dd.d_unit = 0;
250 currdev.pool_guid = guid;
251 currdev.root_guid = 0;
252 set_currdev_devdesc((struct devdesc *)&currdev);
253 devname = efi_fmtdev(&currdev);
254 init_zfs_bootenv(devname);
256 return (sanity_check_currdev());
261 try_as_currdev(pdinfo_t *hd, pdinfo_t *pp)
267 * If there's a zpool on this device, try it as a ZFS
268 * filesystem, which has somewhat different setup than all
269 * other types of fs due to imperfect loader integration.
270 * This all stems from ZFS being both a device (zpool) and
271 * a filesystem, plus the boot env feature.
273 if (efizfs_get_guid_by_handle(pp->pd_handle, &guid))
274 return (probe_zfs_currdev(guid));
277 * All other filesystems just need the pdinfo
278 * initialized in the standard way.
280 set_currdev_pdinfo(pp);
281 return (sanity_check_currdev());
285 * Sometimes we get filenames that are all upper case
286 * and/or have backslashes in them. Filter all this out
287 * if it looks like we need to do so.
301 enum { BOOT_INFO_OK = 0, BAD_CHOICE = 1, NOT_SPECIFIC = 2 };
303 match_boot_info(EFI_LOADED_IMAGE *img __unused, char *boot_info, size_t bisz)
309 EFI_DEVICE_PATH *dp, *edp, *first_dp, *last_dp;
313 FILEPATH_DEVICE_PATH *fp;
318 * FreeBSD encodes it's boot loading path into the boot loader
319 * BootXXXX variable. We look for the last one in the path
320 * and use that to load the kernel. However, if we only fine
321 * one DEVICE_PATH, then there's nothing specific and we should
324 * In an ideal world, we'd look at the image handle we were
325 * passed, match up with the loader we are and then return the
326 * next one in the path. This would be most flexible and cover
327 * many chain booting scenarios where you need to use this
328 * boot loader to get to the next boot loader. However, that
329 * doesn't work. We rarely have the path to the image booted
330 * (just the device) so we can't count on that. So, we do the
331 * enxt best thing, we look through the device path(s) passed
332 * in the BootXXXX varaible. If there's only one, we return
333 * NOT_SPECIFIC. Otherwise, we look at the last one and try to
334 * load that. If we can, we return BOOT_INFO_OK. Otherwise we
335 * return BAD_CHOICE for the caller to sort out.
337 if (bisz < sizeof(attr) + sizeof(fplen) + sizeof(CHAR16))
341 memcpy(&attr, walker, sizeof(attr));
342 walker += sizeof(attr);
343 memcpy(&fplen, walker, sizeof(fplen));
344 walker += sizeof(fplen);
345 descr = (CHAR16 *)(intptr_t)walker;
346 len = ucs2len(descr);
347 walker += (len + 1) * sizeof(CHAR16);
348 last_dp = first_dp = dp = (EFI_DEVICE_PATH *)walker;
349 edp = (EFI_DEVICE_PATH *)(walker + fplen);
350 if ((char *)edp > ep)
352 while (dp < edp && (size_t)(edp - dp) > sizeof(EFI_DEVICE_PATH)) {
353 text = efi_devpath_name(dp);
355 printf(" BootInfo Path: %S\n", text);
356 efi_free_devpath_name(text);
359 dp = (EFI_DEVICE_PATH *)((char *)dp + efi_devpath_length(dp));
363 * If there's only one item in the list, then nothing was
364 * specified. Or if the last path doesn't have a media
365 * path in it. Those show up as various VenHw() nodes
366 * which are basically opaque to us. Don't count those
367 * as something specifc.
369 if (last_dp == first_dp) {
370 printf("Ignoring Boot%04x: Only one DP found\n", boot_current);
373 if (efi_devpath_to_media_path(last_dp) == NULL) {
374 printf("Ignoring Boot%04x: No Media Path\n", boot_current);
379 * OK. At this point we either have a good path or a bad one.
382 pp = efiblk_get_pdinfo_by_device_path(last_dp);
384 printf("Ignoring Boot%04x: Device Path not found\n", boot_current);
387 set_currdev_pdinfo(pp);
388 if (!sanity_check_currdev()) {
389 printf("Ignoring Boot%04x: sanity check failed\n", boot_current);
394 * OK. We've found a device that matches, next we need to check the last
395 * component of the path. If it's a file, then we set the default kernel
396 * to that. Otherwise, just use this as the default root.
398 * Reminder: we're running very early, before we've parsed the defaults
399 * file, so we may need to have a hack override.
401 dp = efi_devpath_last_node(last_dp);
402 if (DevicePathType(dp) != MEDIA_DEVICE_PATH ||
403 DevicePathSubType(dp) != MEDIA_FILEPATH_DP) {
404 printf("Using Boot%04x for root partition\n", boot_current);
405 return (BOOT_INFO_OK); /* use currdir, default kernel */
407 fp = (FILEPATH_DEVICE_PATH *)dp;
408 ucs2_to_utf8(fp->PathName, &kernel);
409 if (kernel == NULL) {
410 printf("Not using Boot%04x: can't decode kernel\n", boot_current);
413 if (*kernel == '\\' || isupper(*kernel))
415 if (stat(kernel, &st) != 0) {
417 printf("Not using Boot%04x: can't find %s\n", boot_current,
421 setenv("kernel", kernel, 1);
423 text = efi_devpath_name(last_dp);
425 printf("Using Boot%04x %S + %s\n", boot_current, text,
427 efi_free_devpath_name(text);
430 return (BOOT_INFO_OK);
434 * Look at the passed-in boot_info, if any. If we find it then we need
435 * to see if we can find ourselves in the boot chain. If we can, and
436 * there's another specified thing to boot next, assume that the file
437 * is loaded from / and use that for the root filesystem. If can't
438 * find the specified thing, we must fail the boot. If we're last on
439 * the list, then we fallback to looking for the first available /
440 * candidate (ZFS, if there's a bootable zpool, otherwise a UFS
441 * partition that has either /boot/defaults/loader.conf on it or
442 * /boot/kernel/kernel (the default kernel) that we can use.
444 * We always fail if we can't find the right thing. However, as
445 * a concession to buggy UEFI implementations, like u-boot, if
446 * we have determined that the host is violating the UEFI boot
447 * manager protocol, we'll signal the rest of the program that
448 * a drop to the OK boot loader prompt is possible.
451 find_currdev(EFI_LOADED_IMAGE *img, bool do_bootmgr, bool is_last,
452 char *boot_info, size_t boot_info_sz)
455 EFI_DEVICE_PATH *devpath, *copy;
465 * First choice: if rootdev is already set, use that, even if
468 rootdev = getenv("rootdev");
469 if (rootdev != NULL) {
470 printf("Setting currdev to configured rootdev %s\n", rootdev);
471 set_currdev(rootdev);
476 * Second choice: If we can find out image boot_info, and there's
477 * a follow-on boot image in that boot_info, use that. In this
478 * case root will be the partition specified in that image and
479 * we'll load the kernel specified by the file path. Should there
480 * not be a filepath, we use the default. This filepath overrides
484 rv = match_boot_info(img, boot_info, boot_info_sz);
486 case BOOT_INFO_OK: /* We found it */
488 case BAD_CHOICE: /* specified file not found -> error */
489 /* XXX do we want to have an escape hatch for last in boot order? */
491 } /* Nothing specified, try normal match */
496 * Did efi_zfs_probe() detect the boot pool? If so, use the zpool
497 * it found, if it's sane. ZFS is the only thing that looks for
498 * disks and pools to boot. This may change in the future, however,
499 * if we allow specifying which pool to boot from via UEFI variables
500 * rather than the bootenv stuff that FreeBSD uses today.
502 if (pool_guid != 0) {
503 printf("Trying ZFS pool\n");
504 if (probe_zfs_currdev(pool_guid))
507 #endif /* EFI_ZFS_BOOT */
510 * Try to find the block device by its handle based on the
511 * image we're booting. If we can't find a sane partition,
512 * search all the other partitions of the disk. We do not
513 * search other disks because it's a violation of the UEFI
514 * boot protocol to do so. We fail and let UEFI go on to
515 * the next candidate.
517 dp = efiblk_get_pdinfo_by_handle(img->DeviceHandle);
519 text = efi_devpath_name(dp->pd_devpath);
521 printf("Trying ESP: %S\n", text);
522 efi_free_devpath_name(text);
524 set_currdev_pdinfo(dp);
525 if (sanity_check_currdev())
527 if (dp->pd_parent != NULL) {
528 pdinfo_t *espdp = dp;
530 STAILQ_FOREACH(pp, &dp->pd_part, pd_link) {
531 /* Already tried the ESP */
535 * Roll up the ZFS special case
536 * for those partitions that have
539 text = efi_devpath_name(pp->pd_devpath);
541 printf("Trying: %S\n", text);
542 efi_free_devpath_name(text);
544 if (try_as_currdev(dp, pp))
551 * Try the device handle from our loaded image first. If that
552 * fails, use the device path from the loaded image and see if
553 * any of the nodes in that path match one of the enumerated
554 * handles. Currently, this handle list is only for netboot.
556 if (efi_handle_lookup(img->DeviceHandle, &dev, &unit, &extra) == 0) {
557 set_currdev_devsw(dev, unit);
558 if (sanity_check_currdev())
563 devpath = efi_lookup_image_devpath(IH);
564 while (devpath != NULL) {
565 h = efi_devpath_handle(devpath);
572 if (efi_handle_lookup(h, &dev, &unit, &extra) == 0) {
573 set_currdev_devsw(dev, unit);
574 if (sanity_check_currdev())
578 devpath = efi_lookup_devpath(h);
579 if (devpath != NULL) {
580 copy = efi_devpath_trim(devpath);
590 interactive_interrupt(const char *msg)
592 time_t now, then, last;
595 now = then = getsecs();
597 if (fail_timeout == -2) /* Always break to OK */
599 if (fail_timeout == -1) /* Never break to OK */
603 printf("press any key to interrupt reboot in %d seconds\r",
604 fail_timeout - (int)(now - then));
608 /* XXX no pause or timeout wait for char */
612 } while (now - then < fail_timeout);
617 parse_args(int argc, CHAR16 *argv[])
624 * Parse the args to set the console settings, etc
625 * boot1.efi passes these in, if it can read /boot.config or /boot/config
626 * or iPXE may be setup to pass these in. Or the optional argument in the
627 * boot environment was used to pass these arguments in (in which case
628 * neither /boot.config nor /boot/config are consulted).
630 * Loop through the args, and for each one that contains an '=' that is
631 * not the first character, add it to the environment. This allows
632 * loader and kernel env vars to be passed on the command line. Convert
633 * args from UCS-2 to ASCII (16 to 8 bit) as they are copied (though this
634 * method is flawed for non-ASCII characters).
637 for (i = 1; i < argc; i++) {
638 cpy16to8(argv[i], var, sizeof(var));
639 howto |= boot_parse_arg(var);
646 setenv_int(const char *key, int val)
650 snprintf(buf, sizeof(buf), "%d", val);
655 * Parse ConOut (the list of consoles active) and see if we can find a
656 * serial port and/or a video port. It would be nice to also walk the
657 * ACPI name space to map the UID for the serial port to a port. The
658 * latter is especially hard.
661 parse_uefi_con_out(void)
664 int vid_seen = 0, com_seen = 0, seen = 0;
667 EFI_DEVICE_PATH *node;
668 ACPI_HID_DEVICE_PATH *acpi;
669 UART_DEVICE_PATH *uart;
674 rv = efi_global_getenv("ConOut", buf, &sz);
675 if (rv != EFI_SUCCESS)
678 node = (EFI_DEVICE_PATH *)buf;
679 while ((char *)node < ep) {
681 if (DevicePathType(node) == ACPI_DEVICE_PATH &&
682 DevicePathSubType(node) == ACPI_DP) {
683 /* Check for Serial node */
685 if (EISA_ID_TO_NUM(acpi->HID) == 0x501) {
686 setenv_int("efi_8250_uid", acpi->UID);
689 } else if (DevicePathType(node) == MESSAGING_DEVICE_PATH &&
690 DevicePathSubType(node) == MSG_UART_DP) {
693 setenv_int("efi_com_speed", uart->BaudRate);
694 } else if (DevicePathType(node) == ACPI_DEVICE_PATH &&
695 DevicePathSubType(node) == ACPI_ADR_DP) {
696 /* Check for AcpiAdr() Node for video */
698 } else if (DevicePathType(node) == HARDWARE_DEVICE_PATH &&
699 DevicePathSubType(node) == HW_PCI_DP) {
701 * Note, vmware fusion has a funky console device
702 * PciRoot(0x0)/Pci(0xf,0x0)
703 * which we can only detect at the end since we also
705 * PciRoot(0x0)/Pci(0x1f,0x0)/Serial(0x1)
706 * so only match it if it's last.
710 node = NextDevicePathNode(node); /* Skip the end node */
712 if (pci_pending && vid_seen == 0)
716 * Truth table for RB_MULTIPLE | RB_SERIAL
718 * 0 Use only video console
719 * RB_SERIAL Use only serial console
720 * RB_MULTIPLE Use both video and serial console
721 * (but video is primary so gets rc messages)
722 * both Use both video and serial console
723 * (but serial is primary so gets rc messages)
725 * Try to honor this as best we can. If only one of serial / video
726 * found, then use that. Otherwise, use the first one we found.
727 * This also implies if we found nothing, default to video.
730 if (vid_seen && com_seen) {
732 if (com_seen < vid_seen)
741 main(int argc, CHAR16 *argv[])
744 int howto, i, uhowto;
746 bool has_kbd, is_last;
748 EFI_DEVICE_PATH *imgpath;
751 size_t sz, bosz = 0, bisz = 0;
752 UINT16 boot_order[100];
753 char boot_info[4096];
754 EFI_LOADED_IMAGE *img;
758 archsw.arch_autoload = efi_autoload;
759 archsw.arch_getdev = efi_getdev;
760 archsw.arch_copyin = efi_copyin;
761 archsw.arch_copyout = efi_copyout;
762 archsw.arch_readin = efi_readin;
764 /* Note this needs to be set before ZFS init. */
765 archsw.arch_zfs_probe = efi_zfs_probe;
768 /* Get our loaded image protocol interface structure. */
769 BS->HandleProtocol(IH, &imgid, (VOID**)&img);
772 /* Tell ZFS probe code where we booted from */
773 efizfs_set_preferred(img->DeviceHandle);
775 /* Init the time source */
778 has_kbd = has_keyboard();
781 * XXX Chicken-and-egg problem; we want to have console output
782 * early, but some console attributes may depend on reading from
783 * eg. the boot device, which we can't do yet. We can use
784 * printf() etc. once this is done.
786 setenv("console", "efi", 1);
790 * Initialise the block cache. Set the upper limit.
792 bcache_init(32768, 512);
794 howto = parse_args(argc, argv);
795 if (!has_kbd && (howto & RB_PROBE))
796 howto |= RB_SERIAL | RB_MULTIPLE;
798 uhowto = parse_uefi_con_out();
801 * We now have two notions of console. howto should be viewed as
802 * overrides. If console is already set, don't set it again.
805 #define SERIAL_ONLY RB_SERIAL
806 #define VID_SER_BOTH RB_MULTIPLE
807 #define SER_VID_BOTH (RB_SERIAL | RB_MULTIPLE)
808 #define CON_MASK (RB_SERIAL | RB_MULTIPLE)
809 if (strcmp(getenv("console"), "efi") == 0) {
810 if ((howto & CON_MASK) == 0) {
811 /* No override, uhowto is controlling and efi cons is perfect */
812 howto = howto | (uhowto & CON_MASK);
813 setenv("console", "efi", 1);
814 } else if ((howto & CON_MASK) == (uhowto & CON_MASK)) {
815 /* override matches what UEFI told us, efi console is perfect */
816 setenv("console", "efi", 1);
817 } else if ((uhowto & (CON_MASK)) != 0) {
819 * We detected a serial console on ConOut. All possible
820 * overrides include serial. We can't really override what efi
821 * gives us, so we use it knowing it's the best choice.
823 setenv("console", "efi", 1);
826 * We detected some kind of serial in the override, but ConOut
827 * has no serial, so we have to sort out which case it really is.
829 switch (howto & CON_MASK) {
831 setenv("console", "comconsole", 1);
834 setenv("console", "efi comconsole", 1);
837 setenv("console", "comconsole efi", 1);
839 /* case VIDEO_ONLY can't happen -- it's the first if above */
845 * howto is set now how we want to export the flags to the kernel, so
846 * set the env based on it.
848 boot_howto_to_env(howto);
850 if (efi_copy_init()) {
851 printf("failed to allocate staging area\n");
852 return (EFI_BUFFER_TOO_SMALL);
855 if ((s = getenv("fail_timeout")) != NULL)
856 fail_timeout = strtol(s, NULL, 10);
859 * Scan the BLOCK IO MEDIA handles then
860 * march through the device switch probing for things.
862 i = efipart_inithandles();
863 if (i != 0 && i != ENOENT) {
864 printf("efipart_inithandles failed with ERRNO %d, expect "
868 for (i = 0; devsw[i] != NULL; i++)
869 if (devsw[i]->dv_init != NULL)
870 (devsw[i]->dv_init)();
872 printf("%s\n", bootprog_info);
873 printf(" Command line arguments:");
874 for (i = 0; i < argc; i++)
875 printf(" %S", argv[i]);
878 printf(" EFI version: %d.%02d\n", ST->Hdr.Revision >> 16,
879 ST->Hdr.Revision & 0xffff);
880 printf(" EFI Firmware: %S (rev %d.%02d)\n", ST->FirmwareVendor,
881 ST->FirmwareRevision >> 16, ST->FirmwareRevision & 0xffff);
882 printf(" Console: %s (%#x)\n", getenv("console"), howto);
886 /* Determine the devpath of our image so we can prefer it. */
887 text = efi_devpath_name(img->FilePath);
889 printf(" Load Path: %S\n", text);
890 efi_setenv_freebsd_wcs("LoaderPath", text);
891 efi_free_devpath_name(text);
894 rv = BS->HandleProtocol(img->DeviceHandle, &devid, (void **)&imgpath);
895 if (rv == EFI_SUCCESS) {
896 text = efi_devpath_name(imgpath);
898 printf(" Load Device: %S\n", text);
899 efi_setenv_freebsd_wcs("LoaderDev", text);
900 efi_free_devpath_name(text);
904 uefi_boot_mgr = true;
906 sz = sizeof(boot_current);
907 rv = efi_global_getenv("BootCurrent", &boot_current, &sz);
908 if (rv == EFI_SUCCESS)
909 printf(" BootCurrent: %04x\n", boot_current);
911 boot_current = 0xffff;
912 uefi_boot_mgr = false;
915 sz = sizeof(boot_order);
916 rv = efi_global_getenv("BootOrder", &boot_order, &sz);
917 if (rv == EFI_SUCCESS) {
918 printf(" BootOrder:");
919 for (i = 0; i < sz / sizeof(boot_order[0]); i++)
920 printf(" %04x%s", boot_order[i],
921 boot_order[i] == boot_current ? "[*]" : "");
923 is_last = boot_order[(sz / sizeof(boot_order[0])) - 1] == boot_current;
925 } else if (uefi_boot_mgr) {
927 * u-boot doesn't set BootOrder, but otherwise participates in the
928 * boot manager protocol. So we fake it here and don't consider it
931 bosz = sizeof(boot_order[0]);
932 boot_order[0] = boot_current;
937 * Next, find the boot info structure the UEFI boot manager is
938 * supposed to setup. We need this so we can walk through it to
939 * find where we are in the booting process and what to try to
943 snprintf(buf, sizeof(buf), "Boot%04X", boot_current);
944 sz = sizeof(boot_info);
945 rv = efi_global_getenv(buf, &boot_info, &sz);
946 if (rv == EFI_SUCCESS)
949 uefi_boot_mgr = false;
953 * Disable the watchdog timer. By default the boot manager sets
954 * the timer to 5 minutes before invoking a boot option. If we
955 * want to return to the boot manager, we have to disable the
956 * watchdog timer and since we're an interactive program, we don't
957 * want to wait until the user types "quit". The timer may have
958 * fired by then. We don't care if this fails. It does not prevent
959 * normal functioning in any way...
961 BS->SetWatchdogTimer(0, 0, 0, NULL);
964 * Try and find a good currdev based on the image that was booted.
965 * It might be desirable here to have a short pause to allow falling
966 * through to the boot loader instead of returning instantly to follow
967 * the boot protocol and also allow an escape hatch for users wishing
968 * to try something different.
970 if (find_currdev(img, uefi_boot_mgr, is_last, boot_info, bisz) != 0)
971 if (!interactive_interrupt("Failed to find bootable partition"))
972 return (EFI_NOT_FOUND);
974 efi_init_environment();
976 #if !defined(__arm__)
977 for (k = 0; k < ST->NumberOfTableEntries; k++) {
978 guid = &ST->ConfigurationTable[k].VendorGuid;
979 if (!memcmp(guid, &smbios, sizeof(EFI_GUID))) {
982 snprintf(buf, sizeof(buf), "%p",
983 ST->ConfigurationTable[k].VendorTable);
984 setenv("hint.smbios.0.mem", buf, 1);
985 smbios_detect(ST->ConfigurationTable[k].VendorTable);
991 interact(); /* doesn't return */
993 return (EFI_SUCCESS); /* keep compiler happy */
996 COMMAND_SET(poweroff, "poweroff", "power off the system", command_poweroff);
999 command_poweroff(int argc __unused, char *argv[] __unused)
1003 for (i = 0; devsw[i] != NULL; ++i)
1004 if (devsw[i]->dv_cleanup != NULL)
1005 (devsw[i]->dv_cleanup)();
1007 RS->ResetSystem(EfiResetShutdown, EFI_SUCCESS, 0, NULL);
1013 COMMAND_SET(reboot, "reboot", "reboot the system", command_reboot);
1016 command_reboot(int argc, char *argv[])
1020 for (i = 0; devsw[i] != NULL; ++i)
1021 if (devsw[i]->dv_cleanup != NULL)
1022 (devsw[i]->dv_cleanup)();
1024 RS->ResetSystem(EfiResetCold, EFI_SUCCESS, 0, NULL);
1030 COMMAND_SET(quit, "quit", "exit the loader", command_quit);
1033 command_quit(int argc, char *argv[])
1039 COMMAND_SET(memmap, "memmap", "print memory map", command_memmap);
1042 command_memmap(int argc, char *argv[])
1045 EFI_MEMORY_DESCRIPTOR *map, *p;
1051 static char *types[] = {
1057 "RuntimeServicesCode",
1058 "RuntimeServicesData",
1059 "ConventionalMemory",
1061 "ACPIReclaimMemory",
1064 "MemoryMappedIOPortSpace",
1069 status = BS->GetMemoryMap(&sz, 0, &key, &dsz, &dver);
1070 if (status != EFI_BUFFER_TOO_SMALL) {
1071 printf("Can't determine memory map size\n");
1075 status = BS->GetMemoryMap(&sz, map, &key, &dsz, &dver);
1076 if (EFI_ERROR(status)) {
1077 printf("Can't read memory map\n");
1082 snprintf(line, sizeof(line), "%23s %12s %12s %8s %4s\n",
1083 "Type", "Physical", "Virtual", "#Pages", "Attr");
1085 if (pager_output(line)) {
1090 for (i = 0, p = map; i < ndesc;
1091 i++, p = NextMemoryDescriptor(p, dsz)) {
1092 printf("%23s %012jx %012jx %08jx ", types[p->Type],
1093 (uintmax_t)p->PhysicalStart, (uintmax_t)p->VirtualStart,
1094 (uintmax_t)p->NumberOfPages);
1095 if (p->Attribute & EFI_MEMORY_UC)
1097 if (p->Attribute & EFI_MEMORY_WC)
1099 if (p->Attribute & EFI_MEMORY_WT)
1101 if (p->Attribute & EFI_MEMORY_WB)
1103 if (p->Attribute & EFI_MEMORY_UCE)
1105 if (p->Attribute & EFI_MEMORY_WP)
1107 if (p->Attribute & EFI_MEMORY_RP)
1109 if (p->Attribute & EFI_MEMORY_XP)
1111 if (pager_output("\n"))
1119 COMMAND_SET(configuration, "configuration", "print configuration tables",
1120 command_configuration);
1123 guid_to_string(EFI_GUID *guid)
1125 static char buf[40];
1127 sprintf(buf, "%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x",
1128 guid->Data1, guid->Data2, guid->Data3, guid->Data4[0],
1129 guid->Data4[1], guid->Data4[2], guid->Data4[3], guid->Data4[4],
1130 guid->Data4[5], guid->Data4[6], guid->Data4[7]);
1135 command_configuration(int argc, char *argv[])
1140 snprintf(line, sizeof(line), "NumberOfTableEntries=%lu\n",
1141 (unsigned long)ST->NumberOfTableEntries);
1143 if (pager_output(line)) {
1148 for (i = 0; i < ST->NumberOfTableEntries; i++) {
1152 guid = &ST->ConfigurationTable[i].VendorGuid;
1153 if (!memcmp(guid, &mps, sizeof(EFI_GUID)))
1154 printf("MPS Table");
1155 else if (!memcmp(guid, &acpi, sizeof(EFI_GUID)))
1156 printf("ACPI Table");
1157 else if (!memcmp(guid, &acpi20, sizeof(EFI_GUID)))
1158 printf("ACPI 2.0 Table");
1159 else if (!memcmp(guid, &smbios, sizeof(EFI_GUID)))
1160 printf("SMBIOS Table %p",
1161 ST->ConfigurationTable[i].VendorTable);
1162 else if (!memcmp(guid, &smbios3, sizeof(EFI_GUID)))
1163 printf("SMBIOS3 Table");
1164 else if (!memcmp(guid, &dxe, sizeof(EFI_GUID)))
1165 printf("DXE Table");
1166 else if (!memcmp(guid, &hoblist, sizeof(EFI_GUID)))
1167 printf("HOB List Table");
1168 else if (!memcmp(guid, &lzmadecomp, sizeof(EFI_GUID)))
1169 printf("LZMA Compression");
1170 else if (!memcmp(guid, &mpcore, sizeof(EFI_GUID)))
1171 printf("ARM MpCore Information Table");
1172 else if (!memcmp(guid, &esrt, sizeof(EFI_GUID)))
1173 printf("ESRT Table");
1174 else if (!memcmp(guid, &memtype, sizeof(EFI_GUID)))
1175 printf("Memory Type Information Table");
1176 else if (!memcmp(guid, &debugimg, sizeof(EFI_GUID)))
1177 printf("Debug Image Info Table");
1178 else if (!memcmp(guid, &fdtdtb, sizeof(EFI_GUID)))
1179 printf("FDT Table");
1181 printf("Unknown Table (%s)", guid_to_string(guid));
1182 snprintf(line, sizeof(line), " at %p\n",
1183 ST->ConfigurationTable[i].VendorTable);
1184 if (pager_output(line))
1193 COMMAND_SET(mode, "mode", "change or display EFI text modes", command_mode);
1196 command_mode(int argc, char *argv[])
1204 SIMPLE_TEXT_OUTPUT_INTERFACE *conout;
1205 extern void HO(void);
1207 conout = ST->ConOut;
1210 mode = strtol(argv[1], &cp, 0);
1211 if (cp[0] != '\0') {
1212 printf("Invalid mode\n");
1215 status = conout->QueryMode(conout, mode, &cols, &rows);
1216 if (EFI_ERROR(status)) {
1217 printf("invalid mode %d\n", mode);
1220 status = conout->SetMode(conout, mode);
1221 if (EFI_ERROR(status)) {
1222 printf("couldn't set mode %d\n", mode);
1225 sprintf(rowenv, "%u", (unsigned)rows);
1226 setenv("LINES", rowenv, 1);
1227 HO(); /* set cursor */
1231 printf("Current mode: %d\n", conout->Mode->Mode);
1232 for (i = 0; i <= conout->Mode->MaxMode; i++) {
1233 status = conout->QueryMode(conout, i, &cols, &rows);
1234 if (EFI_ERROR(status))
1236 printf("Mode %d: %u columns, %u rows\n", i, (unsigned)cols,
1241 printf("Select a mode with the command \"mode <number>\"\n");
1246 #ifdef LOADER_FDT_SUPPORT
1247 extern int command_fdt_internal(int argc, char *argv[]);
1250 * Since proper fdt command handling function is defined in fdt_loader_cmd.c,
1251 * and declaring it as extern is in contradiction with COMMAND_SET() macro
1252 * (which uses static pointer), we're defining wrapper function, which
1253 * calls the proper fdt handling routine.
1256 command_fdt(int argc, char *argv[])
1259 return (command_fdt_internal(argc, argv));
1262 COMMAND_SET(fdt, "fdt", "flattened device tree handling", command_fdt);
1266 * Chain load another efi loader.
1269 command_chain(int argc, char *argv[])
1271 EFI_GUID LoadedImageGUID = LOADED_IMAGE_PROTOCOL;
1272 EFI_HANDLE loaderhandle;
1273 EFI_LOADED_IMAGE *loaded_image;
1276 struct devdesc *dev;
1282 command_errmsg = "wrong number of arguments";
1288 if ((fd = open(name, O_RDONLY)) < 0) {
1289 command_errmsg = "no such file";
1293 if (fstat(fd, &st) < -1) {
1294 command_errmsg = "stat failed";
1299 status = BS->AllocatePool(EfiLoaderCode, (UINTN)st.st_size, &buf);
1300 if (status != EFI_SUCCESS) {
1301 command_errmsg = "failed to allocate buffer";
1305 if (read(fd, buf, st.st_size) != st.st_size) {
1306 command_errmsg = "error while reading the file";
1307 (void)BS->FreePool(buf);
1312 status = BS->LoadImage(FALSE, IH, NULL, buf, st.st_size, &loaderhandle);
1313 (void)BS->FreePool(buf);
1314 if (status != EFI_SUCCESS) {
1315 command_errmsg = "LoadImage failed";
1318 status = BS->HandleProtocol(loaderhandle, &LoadedImageGUID,
1319 (void **)&loaded_image);
1325 for (i = 2; i < argc; i++)
1326 len += strlen(argv[i]) + 1;
1328 len *= sizeof (*argp);
1329 loaded_image->LoadOptions = argp = malloc (len);
1330 loaded_image->LoadOptionsSize = len;
1331 for (i = 2; i < argc; i++) {
1332 char *ptr = argv[i];
1334 *(argp++) = *(ptr++);
1340 if (efi_getdev((void **)&dev, name, (const char **)&path) == 0) {
1342 struct zfs_devdesc *z_dev;
1344 struct disk_devdesc *d_dev;
1347 switch (dev->d_dev->dv_type) {
1350 z_dev = (struct zfs_devdesc *)dev;
1351 loaded_image->DeviceHandle =
1352 efizfs_get_handle_by_guid(z_dev->pool_guid);
1356 loaded_image->DeviceHandle =
1357 efi_find_handle(dev->d_dev, dev->d_unit);
1360 hd = efiblk_get_pdinfo(dev);
1361 if (STAILQ_EMPTY(&hd->pd_part)) {
1362 loaded_image->DeviceHandle = hd->pd_handle;
1365 d_dev = (struct disk_devdesc *)dev;
1366 STAILQ_FOREACH(pd, &hd->pd_part, pd_link) {
1368 * d_partition should be 255
1370 if (pd->pd_unit == (uint32_t)d_dev->d_slice) {
1371 loaded_image->DeviceHandle =
1381 status = BS->StartImage(loaderhandle, NULL, NULL);
1382 if (status != EFI_SUCCESS) {
1383 command_errmsg = "StartImage failed";
1384 free(loaded_image->LoadOptions);
1385 loaded_image->LoadOptions = NULL;
1386 status = BS->UnloadImage(loaded_image);
1390 return (CMD_ERROR); /* not reached */
1393 COMMAND_SET(chain, "chain", "chain load file", command_chain);