1 // SPDX-License-Identifier: GPL-2.0+
3 * EFI device path from u-boot device-model mapping
5 * (C) Copyright 2017 Rob Clark
14 #include <efi_loader.h>
16 #include <sandboxblockdev.h>
17 #include <asm-generic/unaligned.h>
18 #include <linux/compat.h> /* U16_MAX */
21 const efi_guid_t efi_guid_host_dev = U_BOOT_HOST_DEV_GUID;
24 /* template END node: */
25 static const struct efi_device_path END = {
26 .type = DEVICE_PATH_TYPE_END,
27 .sub_type = DEVICE_PATH_SUB_TYPE_END,
28 .length = sizeof(END),
31 /* template ROOT node: */
32 static const struct efi_device_path_vendor ROOT = {
34 .type = DEVICE_PATH_TYPE_HARDWARE_DEVICE,
35 .sub_type = DEVICE_PATH_SUB_TYPE_VENDOR,
36 .length = sizeof(ROOT),
41 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
43 * Determine if an MMC device is an SD card.
45 * @desc block device descriptor
46 * @return true if the device is an SD card
48 static bool is_sd(struct blk_desc *desc)
50 struct mmc *mmc = find_mmc_device(desc->devnum);
55 return IS_SD(mmc) != 0U;
59 static void *dp_alloc(size_t sz)
63 if (efi_allocate_pool(EFI_ALLOCATE_ANY_PAGES, sz, &buf) !=
65 debug("EFI: ERROR: out of memory in %s\n", __func__);
74 * Iterate to next block in device-path, terminating (returning NULL)
77 struct efi_device_path *efi_dp_next(const struct efi_device_path *dp)
81 if (dp->type == DEVICE_PATH_TYPE_END)
83 dp = ((void *)dp) + dp->length;
84 if (dp->type == DEVICE_PATH_TYPE_END)
86 return (struct efi_device_path *)dp;
90 * Compare two device-paths, stopping when the shorter of the two hits
91 * an End* node. This is useful to, for example, compare a device-path
92 * representing a device with one representing a file on the device, or
93 * a device with a parent device.
95 int efi_dp_match(const struct efi_device_path *a,
96 const struct efi_device_path *b)
101 ret = memcmp(&a->length, &b->length, sizeof(a->length));
105 ret = memcmp(a, b, a->length);
118 * We can have device paths that start with a USB WWID or a USB Class node,
119 * and a few other cases which don't encode the full device path with bus
122 * - MESSAGING:USB_WWID
123 * - MESSAGING:USB_CLASS
128 * See UEFI spec (section 3.1.2, about short-form device-paths)
130 static struct efi_device_path *shorten_path(struct efi_device_path *dp)
134 * TODO: Add MESSAGING:USB_WWID and MESSAGING:URI..
135 * in practice fallback.efi just uses MEDIA:HARD_DRIVE
136 * so not sure when we would see these other cases.
138 if (EFI_DP_TYPE(dp, MESSAGING_DEVICE, MSG_USB_CLASS) ||
139 EFI_DP_TYPE(dp, MEDIA_DEVICE, HARD_DRIVE_PATH) ||
140 EFI_DP_TYPE(dp, MEDIA_DEVICE, FILE_PATH))
143 dp = efi_dp_next(dp);
149 static struct efi_object *find_obj(struct efi_device_path *dp, bool short_path,
150 struct efi_device_path **rem)
152 struct efi_object *efiobj;
153 efi_uintn_t dp_size = efi_dp_instance_size(dp);
155 list_for_each_entry(efiobj, &efi_obj_list, link) {
156 struct efi_handler *handler;
157 struct efi_device_path *obj_dp;
160 ret = efi_search_protocol(efiobj,
161 &efi_guid_device_path, &handler);
162 if (ret != EFI_SUCCESS)
164 obj_dp = handler->protocol_interface;
167 if (efi_dp_match(dp, obj_dp) == 0) {
170 * Allow partial matches, but inform
173 *rem = ((void *)dp) +
174 efi_dp_instance_size(obj_dp);
177 /* Only return on exact matches */
178 if (efi_dp_instance_size(obj_dp) ==
184 obj_dp = shorten_path(efi_dp_next(obj_dp));
185 } while (short_path && obj_dp);
192 * Find an efiobj from device-path, if 'rem' is not NULL, returns the
193 * remaining part of the device path after the matched object.
195 struct efi_object *efi_dp_find_obj(struct efi_device_path *dp,
196 struct efi_device_path **rem)
198 struct efi_object *efiobj;
200 /* Search for an exact match first */
201 efiobj = find_obj(dp, false, NULL);
203 /* Then for a fuzzy match */
205 efiobj = find_obj(dp, false, rem);
207 /* And now for a fuzzy short match */
209 efiobj = find_obj(dp, true, rem);
215 * Determine the last device path node that is not the end node.
218 * @return last node before the end node if it exists
221 const struct efi_device_path *efi_dp_last_node(const struct efi_device_path *dp)
223 struct efi_device_path *ret;
225 if (!dp || dp->type == DEVICE_PATH_TYPE_END)
228 ret = (struct efi_device_path *)dp;
229 dp = efi_dp_next(dp);
234 /* get size of the first device path instance excluding end node */
235 efi_uintn_t efi_dp_instance_size(const struct efi_device_path *dp)
239 if (!dp || dp->type == DEVICE_PATH_TYPE_END)
243 dp = efi_dp_next(dp);
249 /* get size of multi-instance device path excluding end node */
250 efi_uintn_t efi_dp_size(const struct efi_device_path *dp)
252 const struct efi_device_path *p = dp;
256 while (p->type != DEVICE_PATH_TYPE_END ||
257 p->sub_type != DEVICE_PATH_SUB_TYPE_END)
258 p = (void *)p + p->length;
260 return (void *)p - (void *)dp;
263 /* copy multi-instance device path */
264 struct efi_device_path *efi_dp_dup(const struct efi_device_path *dp)
266 struct efi_device_path *ndp;
267 size_t sz = efi_dp_size(dp) + sizeof(END);
280 struct efi_device_path *efi_dp_append(const struct efi_device_path *dp1,
281 const struct efi_device_path *dp2)
283 struct efi_device_path *ret;
286 /* return an end node */
287 ret = efi_dp_dup(&END);
289 ret = efi_dp_dup(dp2);
291 ret = efi_dp_dup(dp1);
293 /* both dp1 and dp2 are non-null */
294 unsigned sz1 = efi_dp_size(dp1);
295 unsigned sz2 = efi_dp_size(dp2);
296 void *p = dp_alloc(sz1 + sz2 + sizeof(END));
300 /* the end node of the second device path has to be retained */
301 memcpy(p + sz1, dp2, sz2 + sizeof(END));
308 struct efi_device_path *efi_dp_append_node(const struct efi_device_path *dp,
309 const struct efi_device_path *node)
311 struct efi_device_path *ret;
314 ret = efi_dp_dup(&END);
316 ret = efi_dp_dup(dp);
318 size_t sz = node->length;
319 void *p = dp_alloc(sz + sizeof(END));
323 memcpy(p + sz, &END, sizeof(END));
326 /* both dp and node are non-null */
327 size_t sz = efi_dp_size(dp);
328 void *p = dp_alloc(sz + node->length + sizeof(END));
332 memcpy(p + sz, node, node->length);
333 memcpy(p + sz + node->length, &END, sizeof(END));
340 struct efi_device_path *efi_dp_create_device_node(const u8 type,
344 struct efi_device_path *ret;
346 if (length < sizeof(struct efi_device_path))
349 ret = dp_alloc(length);
353 ret->sub_type = sub_type;
354 ret->length = length;
358 struct efi_device_path *efi_dp_append_instance(
359 const struct efi_device_path *dp,
360 const struct efi_device_path *dpi)
363 struct efi_device_path *p, *ret;
368 return efi_dp_dup(dpi);
369 sz = efi_dp_size(dp);
370 szi = efi_dp_instance_size(dpi);
371 p = dp_alloc(sz + szi + 2 * sizeof(END));
375 memcpy(p, dp, sz + sizeof(END));
377 p->sub_type = DEVICE_PATH_SUB_TYPE_INSTANCE_END;
378 p = (void *)p + sizeof(END);
381 memcpy(p, &END, sizeof(END));
385 struct efi_device_path *efi_dp_get_next_instance(struct efi_device_path **dp,
389 struct efi_device_path *p;
395 sz = efi_dp_instance_size(*dp);
396 p = dp_alloc(sz + sizeof(END));
399 memcpy(p, *dp, sz + sizeof(END));
400 *dp = (void *)*dp + sz;
401 if ((*dp)->sub_type == DEVICE_PATH_SUB_TYPE_INSTANCE_END)
402 *dp = (void *)*dp + sizeof(END);
406 *size = sz + sizeof(END);
410 bool efi_dp_is_multi_instance(const struct efi_device_path *dp)
412 const struct efi_device_path *p = dp;
416 while (p->type != DEVICE_PATH_TYPE_END)
417 p = (void *)p + p->length;
418 return p->sub_type == DEVICE_PATH_SUB_TYPE_INSTANCE_END;
422 /* size of device-path not including END node for device and all parents
423 * up to the root device.
425 __maybe_unused static unsigned int dp_size(struct udevice *dev)
427 if (!dev || !dev->driver)
430 switch (dev->driver->id) {
432 case UCLASS_SIMPLE_BUS:
433 /* stop traversing parents at this point: */
436 return dp_size(dev->parent) +
437 sizeof(struct efi_device_path_mac_addr);
440 switch (dev->parent->uclass->uc_drv->id) {
443 return dp_size(dev->parent) +
444 sizeof(struct efi_device_path_atapi);
446 #if defined(CONFIG_SCSI) && defined(CONFIG_DM_SCSI)
448 return dp_size(dev->parent) +
449 sizeof(struct efi_device_path_scsi);
451 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
453 return dp_size(dev->parent) +
454 sizeof(struct efi_device_path_sd_mmc_path);
456 #if defined(CONFIG_NVME)
458 return dp_size(dev->parent) +
459 sizeof(struct efi_device_path_nvme);
461 #ifdef CONFIG_SANDBOX
464 * Sandbox's host device will be represented
465 * as vendor device with extra one byte for
468 return dp_size(dev->parent)
469 + sizeof(struct efi_device_path_vendor) + 1;
472 return dp_size(dev->parent);
475 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
477 return dp_size(dev->parent) +
478 sizeof(struct efi_device_path_sd_mmc_path);
480 case UCLASS_MASS_STORAGE:
482 return dp_size(dev->parent) +
483 sizeof(struct efi_device_path_usb_class);
485 /* just skip over unknown classes: */
486 return dp_size(dev->parent);
491 * Recursively build a device path.
493 * @buf pointer to the end of the device path
495 * @return pointer to the end of the device path
497 __maybe_unused static void *dp_fill(void *buf, struct udevice *dev)
499 if (!dev || !dev->driver)
502 switch (dev->driver->id) {
504 case UCLASS_SIMPLE_BUS: {
505 /* stop traversing parents at this point: */
506 struct efi_device_path_vendor *vdp = buf;
512 struct efi_device_path_mac_addr *dp =
513 dp_fill(buf, dev->parent);
514 struct eth_pdata *pdata = dev->platdata;
516 dp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
517 dp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_MAC_ADDR;
518 dp->dp.length = sizeof(*dp);
519 memset(&dp->mac, 0, sizeof(dp->mac));
520 /* We only support IPv4 */
521 memcpy(&dp->mac, &pdata->enetaddr, ARP_HLEN);
529 switch (dev->parent->uclass->uc_drv->id) {
530 #ifdef CONFIG_SANDBOX
532 /* stop traversing parents at this point: */
533 struct efi_device_path_vendor *dp = buf;
534 struct blk_desc *desc = dev_get_uclass_platdata(dev);
536 dp_fill(buf, dev->parent);
539 dp->dp.type = DEVICE_PATH_TYPE_HARDWARE_DEVICE;
540 dp->dp.sub_type = DEVICE_PATH_SUB_TYPE_VENDOR;
541 dp->dp.length = sizeof(*dp) + 1;
542 memcpy(&dp->guid, &efi_guid_host_dev,
544 dp->vendor_data[0] = desc->devnum;
545 return &dp->vendor_data[1];
550 struct efi_device_path_atapi *dp =
551 dp_fill(buf, dev->parent);
552 struct blk_desc *desc = dev_get_uclass_platdata(dev);
554 dp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
555 dp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_ATAPI;
556 dp->dp.length = sizeof(*dp);
557 dp->logical_unit_number = desc->devnum;
558 dp->primary_secondary = IDE_BUS(desc->devnum);
559 dp->slave_master = desc->devnum %
560 (CONFIG_SYS_IDE_MAXDEVICE /
561 CONFIG_SYS_IDE_MAXBUS);
565 #if defined(CONFIG_SCSI) && defined(CONFIG_DM_SCSI)
567 struct efi_device_path_scsi *dp =
568 dp_fill(buf, dev->parent);
569 struct blk_desc *desc = dev_get_uclass_platdata(dev);
571 dp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
572 dp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_SCSI;
573 dp->dp.length = sizeof(*dp);
574 dp->logical_unit_number = desc->lun;
575 dp->target_id = desc->target;
579 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
581 struct efi_device_path_sd_mmc_path *sddp =
582 dp_fill(buf, dev->parent);
583 struct blk_desc *desc = dev_get_uclass_platdata(dev);
585 sddp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
586 sddp->dp.sub_type = is_sd(desc) ?
587 DEVICE_PATH_SUB_TYPE_MSG_SD :
588 DEVICE_PATH_SUB_TYPE_MSG_MMC;
589 sddp->dp.length = sizeof(*sddp);
590 sddp->slot_number = dev->seq;
594 #if defined(CONFIG_NVME)
596 struct efi_device_path_nvme *dp =
597 dp_fill(buf, dev->parent);
600 dp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
601 dp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_NVME;
602 dp->dp.length = sizeof(*dp);
603 nvme_get_namespace_id(dev, &ns_id, dp->eui64);
604 memcpy(&dp->ns_id, &ns_id, sizeof(ns_id));
609 debug("%s(%u) %s: unhandled parent class: %s (%u)\n",
610 __FILE__, __LINE__, __func__,
611 dev->name, dev->parent->uclass->uc_drv->id);
612 return dp_fill(buf, dev->parent);
615 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
617 struct efi_device_path_sd_mmc_path *sddp =
618 dp_fill(buf, dev->parent);
619 struct mmc *mmc = mmc_get_mmc_dev(dev);
620 struct blk_desc *desc = mmc_get_blk_desc(mmc);
622 sddp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
623 sddp->dp.sub_type = is_sd(desc) ?
624 DEVICE_PATH_SUB_TYPE_MSG_SD :
625 DEVICE_PATH_SUB_TYPE_MSG_MMC;
626 sddp->dp.length = sizeof(*sddp);
627 sddp->slot_number = dev->seq;
632 case UCLASS_MASS_STORAGE:
633 case UCLASS_USB_HUB: {
634 struct efi_device_path_usb_class *udp =
635 dp_fill(buf, dev->parent);
636 struct usb_device *udev = dev_get_parent_priv(dev);
637 struct usb_device_descriptor *desc = &udev->descriptor;
639 udp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
640 udp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_USB_CLASS;
641 udp->dp.length = sizeof(*udp);
642 udp->vendor_id = desc->idVendor;
643 udp->product_id = desc->idProduct;
644 udp->device_class = desc->bDeviceClass;
645 udp->device_subclass = desc->bDeviceSubClass;
646 udp->device_protocol = desc->bDeviceProtocol;
651 debug("%s(%u) %s: unhandled device class: %s (%u)\n",
652 __FILE__, __LINE__, __func__,
653 dev->name, dev->driver->id);
654 return dp_fill(buf, dev->parent);
659 static unsigned dp_part_size(struct blk_desc *desc, int part)
666 int ret = blk_find_device(desc->if_type, desc->devnum, &dev);
669 dev = desc->bdev->parent;
670 dpsize = dp_size(dev);
673 dpsize = sizeof(ROOT) + sizeof(struct efi_device_path_usb);
676 if (part == 0) /* the actual disk, not a partition */
679 if (desc->part_type == PART_TYPE_ISO)
680 dpsize += sizeof(struct efi_device_path_cdrom_path);
682 dpsize += sizeof(struct efi_device_path_hard_drive_path);
688 * Create a device node for a block device partition.
690 * @buf buffer to which the device path is written
691 * @desc block device descriptor
692 * @part partition number, 0 identifies a block device
694 static void *dp_part_node(void *buf, struct blk_desc *desc, int part)
696 disk_partition_t info;
698 part_get_info(desc, part, &info);
700 if (desc->part_type == PART_TYPE_ISO) {
701 struct efi_device_path_cdrom_path *cddp = buf;
703 cddp->boot_entry = part;
704 cddp->dp.type = DEVICE_PATH_TYPE_MEDIA_DEVICE;
705 cddp->dp.sub_type = DEVICE_PATH_SUB_TYPE_CDROM_PATH;
706 cddp->dp.length = sizeof(*cddp);
707 cddp->partition_start = info.start;
708 cddp->partition_size = info.size;
712 struct efi_device_path_hard_drive_path *hddp = buf;
714 hddp->dp.type = DEVICE_PATH_TYPE_MEDIA_DEVICE;
715 hddp->dp.sub_type = DEVICE_PATH_SUB_TYPE_HARD_DRIVE_PATH;
716 hddp->dp.length = sizeof(*hddp);
717 hddp->partition_number = part;
718 hddp->partition_start = info.start;
719 hddp->partition_end = info.size;
720 if (desc->part_type == PART_TYPE_EFI)
721 hddp->partmap_type = 2;
723 hddp->partmap_type = 1;
725 switch (desc->sig_type) {
728 hddp->signature_type = 0;
729 memset(hddp->partition_signature, 0,
730 sizeof(hddp->partition_signature));
733 hddp->signature_type = 1;
734 memset(hddp->partition_signature, 0,
735 sizeof(hddp->partition_signature));
736 memcpy(hddp->partition_signature, &desc->mbr_sig,
737 sizeof(desc->mbr_sig));
740 hddp->signature_type = 2;
741 memcpy(hddp->partition_signature, &desc->guid_sig,
742 sizeof(hddp->partition_signature));
753 * Create a device path for a block device or one of its partitions.
755 * @buf buffer to which the device path is written
756 * @desc block device descriptor
757 * @part partition number, 0 identifies a block device
759 static void *dp_part_fill(void *buf, struct blk_desc *desc, int part)
764 int ret = blk_find_device(desc->if_type, desc->devnum, &dev);
767 dev = desc->bdev->parent;
768 buf = dp_fill(buf, dev);
772 * We *could* make a more accurate path, by looking at if_type
773 * and handling all the different cases like we do for non-
774 * legacy (i.e. CONFIG_BLK=y) case. But most important thing
775 * is just to have a unique device-path for if_type+devnum.
776 * So map things to a fictitious USB device.
778 struct efi_device_path_usb *udp;
780 memcpy(buf, &ROOT, sizeof(ROOT));
784 udp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
785 udp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_USB;
786 udp->dp.length = sizeof(*udp);
787 udp->parent_port_number = desc->if_type;
788 udp->usb_interface = desc->devnum;
792 if (part == 0) /* the actual disk, not a partition */
795 return dp_part_node(buf, desc, part);
798 /* Construct a device-path from a partition on a block device: */
799 struct efi_device_path *efi_dp_from_part(struct blk_desc *desc, int part)
803 start = buf = dp_alloc(dp_part_size(desc, part) + sizeof(END));
807 buf = dp_part_fill(buf, desc, part);
809 *((struct efi_device_path *)buf) = END;
815 * Create a device node for a block device partition.
817 * @buf buffer to which the device path is written
818 * @desc block device descriptor
819 * @part partition number, 0 identifies a block device
821 struct efi_device_path *efi_dp_part_node(struct blk_desc *desc, int part)
826 if (desc->part_type == PART_TYPE_ISO)
827 dpsize = sizeof(struct efi_device_path_cdrom_path);
829 dpsize = sizeof(struct efi_device_path_hard_drive_path);
830 buf = dp_alloc(dpsize);
832 dp_part_node(buf, desc, part);
838 * path_to_uefi() - convert UTF-8 path to an UEFI style path
840 * Convert UTF-8 path to a UEFI style path (i.e. with backslashes as path
841 * separators and UTF-16).
843 * @src: source buffer
844 * @uefi: target buffer, possibly unaligned
846 static void path_to_uefi(void *uefi, const char *src)
851 * efi_set_bootdev() calls this routine indirectly before the UEFI
852 * subsystem is initialized. So we cannot assume unaligned access to be
858 s32 code = utf8_get(&src);
862 else if (code == '/')
864 utf16_put(code, &pos);
870 * If desc is NULL, this creates a path with only the file component,
871 * otherwise it creates a full path with both device and file components
873 struct efi_device_path *efi_dp_from_file(struct blk_desc *desc, int part,
876 struct efi_device_path_file_path *fp;
878 size_t dpsize = 0, fpsize;
881 dpsize = dp_part_size(desc, part);
883 fpsize = sizeof(struct efi_device_path) +
884 2 * (utf8_utf16_strlen(path) + 1);
885 if (fpsize > U16_MAX)
890 start = buf = dp_alloc(dpsize + sizeof(END));
895 buf = dp_part_fill(buf, desc, part);
899 fp->dp.type = DEVICE_PATH_TYPE_MEDIA_DEVICE;
900 fp->dp.sub_type = DEVICE_PATH_SUB_TYPE_FILE_PATH;
901 fp->dp.length = (u16)fpsize;
902 path_to_uefi(fp->str, path);
905 *((struct efi_device_path *)buf) = END;
911 struct efi_device_path *efi_dp_from_eth(void)
913 #ifndef CONFIG_DM_ETH
914 struct efi_device_path_mac_addr *ndp;
919 assert(eth_get_dev());
922 dpsize += dp_size(eth_get_dev());
924 dpsize += sizeof(ROOT);
925 dpsize += sizeof(*ndp);
928 start = buf = dp_alloc(dpsize + sizeof(END));
933 buf = dp_fill(buf, eth_get_dev());
935 memcpy(buf, &ROOT, sizeof(ROOT));
939 ndp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
940 ndp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_MAC_ADDR;
941 ndp->dp.length = sizeof(*ndp);
942 ndp->if_type = 1; /* Ethernet */
943 memcpy(ndp->mac.addr, eth_get_ethaddr(), ARP_HLEN);
947 *((struct efi_device_path *)buf) = END;
953 /* Construct a device-path for memory-mapped image */
954 struct efi_device_path *efi_dp_from_mem(uint32_t memory_type,
955 uint64_t start_address,
956 uint64_t end_address)
958 struct efi_device_path_memory *mdp;
961 start = buf = dp_alloc(sizeof(*mdp) + sizeof(END));
966 mdp->dp.type = DEVICE_PATH_TYPE_HARDWARE_DEVICE;
967 mdp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MEMORY;
968 mdp->dp.length = sizeof(*mdp);
969 mdp->memory_type = memory_type;
970 mdp->start_address = start_address;
971 mdp->end_address = end_address;
974 *((struct efi_device_path *)buf) = END;
980 * efi_dp_split_file_path() - split of relative file path from device path
982 * Given a device path indicating a file on a device, separate the device
983 * path in two: the device path of the actual device and the file path
984 * relative to this device.
986 * @full_path: device path including device and file path
987 * @device_path: path of the device
988 * @file_path: relative path of the file or NULL if there is none
989 * Return: status code
991 efi_status_t efi_dp_split_file_path(struct efi_device_path *full_path,
992 struct efi_device_path **device_path,
993 struct efi_device_path **file_path)
995 struct efi_device_path *p, *dp, *fp = NULL;
999 dp = efi_dp_dup(full_path);
1001 return EFI_OUT_OF_RESOURCES;
1003 while (!EFI_DP_TYPE(p, MEDIA_DEVICE, FILE_PATH)) {
1010 return EFI_OUT_OF_RESOURCES;
1011 p->type = DEVICE_PATH_TYPE_END;
1012 p->sub_type = DEVICE_PATH_SUB_TYPE_END;
1013 p->length = sizeof(*p);
1022 * efi_dp_from_name() - convert U-Boot device and file path to device path
1024 * @dev: U-Boot device, e.g. 'mmc'
1025 * @devnr: U-Boot device number, e.g. 1 for 'mmc:1'
1026 * @path: file path relative to U-Boot device, may be NULL
1027 * @device: pointer to receive device path of the device
1028 * @file: pointer to receive device path for the file
1029 * Return: status code
1031 efi_status_t efi_dp_from_name(const char *dev, const char *devnr,
1033 struct efi_device_path **device,
1034 struct efi_device_path **file)
1037 struct blk_desc *desc = NULL;
1038 disk_partition_t fs_partition;
1040 char filename[32] = { 0 }; /* dp->str is u16[32] long */
1044 return EFI_INVALID_PARAMETER;
1046 is_net = !strcmp(dev, "Net");
1048 part = blk_get_device_part_str(dev, devnr, &desc, &fs_partition,
1050 if (part < 0 || !desc)
1051 return EFI_INVALID_PARAMETER;
1054 *device = efi_dp_from_part(desc, part);
1058 *device = efi_dp_from_eth();
1065 snprintf(filename, sizeof(filename), "%s", path);
1066 /* DOS style file path: */
1068 while ((s = strchr(s, '/')))
1070 *file = efi_dp_from_file(is_net ? NULL : desc, part, filename);
1073 return EFI_INVALID_PARAMETER;