disk/part.c

   1 // SPDX-License-Identifier: GPL-2.0+
   2 /*
   3  * (C) Copyright 2001
   4  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
   5  */
   6
   7 #include <common.h>
   8 #include <blk.h>
   9 #include <command.h>
  10 #include <env.h>
  11 #include <errno.h>
  12 #include <ide.h>
  13 #include <log.h>
  14 #include <malloc.h>
  15 #include <part.h>
  16 #include <ubifs_uboot.h>
  17
  18 #undef  PART_DEBUG
  19
  20 #ifdef  PART_DEBUG
  21 #define PRINTF(fmt,args...)     printf (fmt ,##args)
  22 #else
  23 #define PRINTF(fmt,args...)
  24 #endif
  25
  26 /* Check all partition types */
  27 #define PART_TYPE_ALL           -1
  28
  29 static struct part_driver *part_driver_lookup_type(struct blk_desc *dev_desc)
  30 {
  31         struct part_driver *drv =
  32                 ll_entry_start(struct part_driver, part_driver);
  33         const int n_ents = ll_entry_count(struct part_driver, part_driver);
  34         struct part_driver *entry;
  35
  36         if (dev_desc->part_type == PART_TYPE_UNKNOWN) {
  37                 for (entry = drv; entry != drv + n_ents; entry++) {
  38                         int ret;
  39
  40                         ret = entry->test(dev_desc);
  41                         if (!ret) {
  42                                 dev_desc->part_type = entry->part_type;
  43                                 return entry;
  44                         }
  45                 }
  46         } else {
  47                 for (entry = drv; entry != drv + n_ents; entry++) {
  48                         if (dev_desc->part_type == entry->part_type)
  49                                 return entry;
  50                 }
  51         }
  52
  53         /* Not found */
  54         return NULL;
  55 }
  56
  57 #ifdef CONFIG_HAVE_BLOCK_DEVICE
  58 static struct blk_desc *get_dev_hwpart(const char *ifname, int dev, int hwpart)
  59 {
  60         struct blk_desc *dev_desc;
  61         int ret;
  62
  63         dev_desc = blk_get_devnum_by_typename(ifname, dev);
  64         if (!dev_desc) {
  65                 debug("%s: No device for iface '%s', dev %d\n", __func__,
  66                       ifname, dev);
  67                 return NULL;
  68         }
  69         ret = blk_dselect_hwpart(dev_desc, hwpart);
  70         if (ret) {
  71                 debug("%s: Failed to select h/w partition: err-%d\n", __func__,
  72                       ret);
  73                 return NULL;
  74         }
  75
  76         return dev_desc;
  77 }
  78
  79 struct blk_desc *blk_get_dev(const char *ifname, int dev)
  80 {
  81         return get_dev_hwpart(ifname, dev, 0);
  82 }
  83 #else
  84 struct blk_desc *get_dev_hwpart(const char *ifname, int dev, int hwpart)
  85 {
  86         return NULL;
  87 }
  88
  89 struct blk_desc *blk_get_dev(const char *ifname, int dev)
  90 {
  91         return NULL;
  92 }
  93 #endif
  94
  95 #ifdef CONFIG_HAVE_BLOCK_DEVICE
  96
  97 /* ------------------------------------------------------------------------- */
  98 /*
  99  * reports device info to the user
 100  */
 101
 102 #ifdef CONFIG_LBA48
 103 typedef uint64_t lba512_t;
 104 #else
 105 typedef lbaint_t lba512_t;
 106 #endif
 107
 108 /*
 109  * Overflowless variant of (block_count * mul_by / 2**right_shift)
 110  * when 2**right_shift > mul_by
 111  */
 112 static lba512_t lba512_muldiv(lba512_t block_count, lba512_t mul_by,
 113                               int right_shift)
 114 {
 115         lba512_t bc_quot, bc_rem;
 116
 117         /* x * m / d == x / d * m + (x % d) * m / d */
 118         bc_quot = block_count >> right_shift;
 119         bc_rem  = block_count - (bc_quot << right_shift);
 120         return bc_quot * mul_by + ((bc_rem * mul_by) >> right_shift);
 121 }
 122
 123 void dev_print (struct blk_desc *dev_desc)
 124 {
 125         lba512_t lba512; /* number of blocks if 512bytes block size */
 126
 127         if (dev_desc->type == DEV_TYPE_UNKNOWN) {
 128                 puts ("not available\n");
 129                 return;
 130         }
 131
 132         switch (dev_desc->if_type) {
 133         case IF_TYPE_SCSI:
 134                 printf ("(%d:%d) Vendor: %s Prod.: %s Rev: %s\n",
 135                         dev_desc->target,dev_desc->lun,
 136                         dev_desc->vendor,
 137                         dev_desc->product,
 138                         dev_desc->revision);
 139                 break;
 140         case IF_TYPE_ATAPI:
 141         case IF_TYPE_IDE:
 142         case IF_TYPE_SATA:
 143                 printf ("Model: %s Firm: %s Ser#: %s\n",
 144                         dev_desc->vendor,
 145                         dev_desc->revision,
 146                         dev_desc->product);
 147                 break;
 148         case IF_TYPE_SD:
 149         case IF_TYPE_MMC:
 150         case IF_TYPE_USB:
 151         case IF_TYPE_NVME:
 152         case IF_TYPE_PVBLOCK:
 153         case IF_TYPE_HOST:
 154                 printf ("Vendor: %s Rev: %s Prod: %s\n",
 155                         dev_desc->vendor,
 156                         dev_desc->revision,
 157                         dev_desc->product);
 158                 break;
 159         case IF_TYPE_VIRTIO:
 160                 printf("%s VirtIO Block Device\n", dev_desc->vendor);
 161                 break;
 162         case IF_TYPE_DOC:
 163                 puts("device type DOC\n");
 164                 return;
 165         case IF_TYPE_UNKNOWN:
 166                 puts("device type unknown\n");
 167                 return;
 168         default:
 169                 printf("Unhandled device type: %i\n", dev_desc->if_type);
 170                 return;
 171         }
 172         puts ("            Type: ");
 173         if (dev_desc->removable)
 174                 puts ("Removable ");
 175         switch (dev_desc->type & 0x1F) {
 176         case DEV_TYPE_HARDDISK:
 177                 puts ("Hard Disk");
 178                 break;
 179         case DEV_TYPE_CDROM:
 180                 puts ("CD ROM");
 181                 break;
 182         case DEV_TYPE_OPDISK:
 183                 puts ("Optical Device");
 184                 break;
 185         case DEV_TYPE_TAPE:
 186                 puts ("Tape");
 187                 break;
 188         default:
 189                 printf ("# %02X #", dev_desc->type & 0x1F);
 190                 break;
 191         }
 192         puts ("\n");
 193         if (dev_desc->lba > 0L && dev_desc->blksz > 0L) {
 194                 ulong mb, mb_quot, mb_rem, gb, gb_quot, gb_rem;
 195                 lbaint_t lba;
 196
 197                 lba = dev_desc->lba;
 198
 199                 lba512 = (lba * (dev_desc->blksz/512));
 200                 /* round to 1 digit */
 201                 /* 2048 = (1024 * 1024) / 512 MB */
 202                 mb = lba512_muldiv(lba512, 10, 11);
 203
 204                 mb_quot = mb / 10;
 205                 mb_rem  = mb - (10 * mb_quot);
 206
 207                 gb = mb / 1024;
 208                 gb_quot = gb / 10;
 209                 gb_rem  = gb - (10 * gb_quot);
 210 #ifdef CONFIG_LBA48
 211                 if (dev_desc->lba48)
 212                         printf ("            Supports 48-bit addressing\n");
 213 #endif
 214 #if defined(CONFIG_SYS_64BIT_LBA)
 215                 printf ("            Capacity: %lu.%lu MB = %lu.%lu GB (%llu x %lu)\n",
 216                         mb_quot, mb_rem,
 217                         gb_quot, gb_rem,
 218                         lba,
 219                         dev_desc->blksz);
 220 #else
 221                 printf ("            Capacity: %lu.%lu MB = %lu.%lu GB (%lu x %lu)\n",
 222                         mb_quot, mb_rem,
 223                         gb_quot, gb_rem,
 224                         (ulong)lba,
 225                         dev_desc->blksz);
 226 #endif
 227         } else {
 228                 puts ("            Capacity: not available\n");
 229         }
 230 }
 231 #endif
 232
 233 #ifdef CONFIG_HAVE_BLOCK_DEVICE
 234
 235 void part_init(struct blk_desc *dev_desc)
 236 {
 237         struct part_driver *drv =
 238                 ll_entry_start(struct part_driver, part_driver);
 239         const int n_ents = ll_entry_count(struct part_driver, part_driver);
 240         struct part_driver *entry;
 241
 242         blkcache_invalidate(dev_desc->if_type, dev_desc->devnum);
 243
 244         dev_desc->part_type = PART_TYPE_UNKNOWN;
 245         for (entry = drv; entry != drv + n_ents; entry++) {
 246                 int ret;
 247
 248                 ret = entry->test(dev_desc);
 249                 debug("%s: try '%s': ret=%d\n", __func__, entry->name, ret);
 250                 if (!ret) {
 251                         dev_desc->part_type = entry->part_type;
 252                         break;
 253                 }
 254         }
 255 }
 256
 257 static void print_part_header(const char *type, struct blk_desc *dev_desc)
 258 {
 259 #if CONFIG_IS_ENABLED(MAC_PARTITION) || \
 260         CONFIG_IS_ENABLED(DOS_PARTITION) || \
 261         CONFIG_IS_ENABLED(ISO_PARTITION) || \
 262         CONFIG_IS_ENABLED(AMIGA_PARTITION) || \
 263         CONFIG_IS_ENABLED(EFI_PARTITION)
 264         puts ("\nPartition Map for ");
 265         switch (dev_desc->if_type) {
 266         case IF_TYPE_IDE:
 267                 puts ("IDE");
 268                 break;
 269         case IF_TYPE_SATA:
 270                 puts ("SATA");
 271                 break;
 272         case IF_TYPE_SCSI:
 273                 puts ("SCSI");
 274                 break;
 275         case IF_TYPE_ATAPI:
 276                 puts ("ATAPI");
 277                 break;
 278         case IF_TYPE_USB:
 279                 puts ("USB");
 280                 break;
 281         case IF_TYPE_DOC:
 282                 puts ("DOC");
 283                 break;
 284         case IF_TYPE_MMC:
 285                 puts ("MMC");
 286                 break;
 287         case IF_TYPE_HOST:
 288                 puts ("HOST");
 289                 break;
 290         case IF_TYPE_NVME:
 291                 puts ("NVMe");
 292                 break;
 293         case IF_TYPE_PVBLOCK:
 294                 puts("PV BLOCK");
 295                 break;
 296         case IF_TYPE_VIRTIO:
 297                 puts("VirtIO");
 298                 break;
 299         case IF_TYPE_EFI_MEDIA:
 300                 puts("EFI");
 301                 break;
 302         default:
 303                 puts("UNKNOWN");
 304                 break;
 305         }
 306         printf (" device %d  --   Partition Type: %s\n\n",
 307                         dev_desc->devnum, type);
 308 #endif /* any CONFIG_..._PARTITION */
 309 }
 310
 311 void part_print(struct blk_desc *dev_desc)
 312 {
 313         struct part_driver *drv;
 314
 315         drv = part_driver_lookup_type(dev_desc);
 316         if (!drv) {
 317                 printf("## Unknown partition table type %x\n",
 318                        dev_desc->part_type);
 319                 return;
 320         }
 321
 322         PRINTF("## Testing for valid %s partition ##\n", drv->name);
 323         print_part_header(drv->name, dev_desc);
 324         if (drv->print)
 325                 drv->print(dev_desc);
 326 }
 327
 328 #endif /* CONFIG_HAVE_BLOCK_DEVICE */
 329
 330 int part_get_info(struct blk_desc *dev_desc, int part,
 331                        struct disk_partition *info)
 332 {
 333 #ifdef CONFIG_HAVE_BLOCK_DEVICE
 334         struct part_driver *drv;
 335
 336 #if CONFIG_IS_ENABLED(PARTITION_UUIDS)
 337         /* The common case is no UUID support */
 338         info->uuid[0] = 0;
 339 #endif
 340 #ifdef CONFIG_PARTITION_TYPE_GUID
 341         info->type_guid[0] = 0;
 342 #endif
 343
 344         drv = part_driver_lookup_type(dev_desc);
 345         if (!drv) {
 346                 debug("## Unknown partition table type %x\n",
 347                       dev_desc->part_type);
 348                 return -EPROTONOSUPPORT;
 349         }
 350         if (!drv->get_info) {
 351                 PRINTF("## Driver %s does not have the get_info() method\n",
 352                        drv->name);
 353                 return -ENOSYS;
 354         }
 355         if (drv->get_info(dev_desc, part, info) == 0) {
 356                 PRINTF("## Valid %s partition found ##\n", drv->name);
 357                 return 0;
 358         }
 359 #endif /* CONFIG_HAVE_BLOCK_DEVICE */
 360
 361         return -ENOENT;
 362 }
 363
 364 int part_get_info_whole_disk(struct blk_desc *dev_desc,
 365                              struct disk_partition *info)
 366 {
 367         info->start = 0;
 368         info->size = dev_desc->lba;
 369         info->blksz = dev_desc->blksz;
 370         info->bootable = 0;
 371         strcpy((char *)info->type, BOOT_PART_TYPE);
 372         strcpy((char *)info->name, "Whole Disk");
 373 #if CONFIG_IS_ENABLED(PARTITION_UUIDS)
 374         info->uuid[0] = 0;
 375 #endif
 376 #ifdef CONFIG_PARTITION_TYPE_GUID
 377         info->type_guid[0] = 0;
 378 #endif
 379
 380         return 0;
 381 }
 382
 383 int blk_get_device_by_str(const char *ifname, const char *dev_hwpart_str,
 384                           struct blk_desc **dev_desc)
 385 {
 386         char *ep;
 387         char *dup_str = NULL;
 388         const char *dev_str, *hwpart_str;
 389         int dev, hwpart;
 390
 391         hwpart_str = strchr(dev_hwpart_str, '.');
 392         if (hwpart_str) {
 393                 dup_str = strdup(dev_hwpart_str);
 394                 dup_str[hwpart_str - dev_hwpart_str] = 0;
 395                 dev_str = dup_str;
 396                 hwpart_str++;
 397         } else {
 398                 dev_str = dev_hwpart_str;
 399                 hwpart = 0;
 400         }
 401
 402         dev = hextoul(dev_str, &ep);
 403         if (*ep) {
 404                 printf("** Bad device specification %s %s **\n",
 405                        ifname, dev_str);
 406                 dev = -EINVAL;
 407                 goto cleanup;
 408         }
 409
 410         if (hwpart_str) {
 411                 hwpart = hextoul(hwpart_str, &ep);
 412                 if (*ep) {
 413                         printf("** Bad HW partition specification %s %s **\n",
 414                             ifname, hwpart_str);
 415                         dev = -EINVAL;
 416                         goto cleanup;
 417                 }
 418         }
 419
 420         *dev_desc = get_dev_hwpart(ifname, dev, hwpart);
 421         if (!(*dev_desc) || ((*dev_desc)->type == DEV_TYPE_UNKNOWN)) {
 422                 debug("** Bad device %s %s **\n", ifname, dev_hwpart_str);
 423                 dev = -ENODEV;
 424                 goto cleanup;
 425         }
 426
 427 #ifdef CONFIG_HAVE_BLOCK_DEVICE
 428         /*
 429          * Updates the partition table for the specified hw partition.
 430          * Always should be done, otherwise hw partition 0 will return stale
 431          * data after displaying a non-zero hw partition.
 432          */
 433         part_init(*dev_desc);
 434 #endif
 435
 436 cleanup:
 437         free(dup_str);
 438         return dev;
 439 }
 440
 441 #define PART_UNSPECIFIED -2
 442 #define PART_AUTO -1
 443 int blk_get_device_part_str(const char *ifname, const char *dev_part_str,
 444                              struct blk_desc **dev_desc,
 445                              struct disk_partition *info, int allow_whole_dev)
 446 {
 447         int ret;
 448         const char *part_str;
 449         char *dup_str = NULL;
 450         const char *dev_str;
 451         int dev;
 452         char *ep;
 453         int p;
 454         int part;
 455         struct disk_partition tmpinfo;
 456
 457 #ifdef CONFIG_SANDBOX
 458         /*
 459          * Special-case a pseudo block device "hostfs", to allow access to the
 460          * host's own filesystem.
 461          */
 462         if (0 == strcmp(ifname, "hostfs")) {
 463                 *dev_desc = NULL;
 464                 info->start = 0;
 465                 info->size = 0;
 466                 info->blksz = 0;
 467                 info->bootable = 0;
 468                 strcpy((char *)info->type, BOOT_PART_TYPE);
 469                 strcpy((char *)info->name, "Sandbox host");
 470 #if CONFIG_IS_ENABLED(PARTITION_UUIDS)
 471                 info->uuid[0] = 0;
 472 #endif
 473 #ifdef CONFIG_PARTITION_TYPE_GUID
 474                 info->type_guid[0] = 0;
 475 #endif
 476
 477                 return 0;
 478         }
 479 #endif
 480
 481 #ifdef CONFIG_CMD_UBIFS
 482         /*
 483          * Special-case ubi, ubi goes through a mtd, rather than through
 484          * a regular block device.
 485          */
 486         if (0 == strcmp(ifname, "ubi")) {
 487                 if (!ubifs_is_mounted()) {
 488                         printf("UBIFS not mounted, use ubifsmount to mount volume first!\n");
 489                         return -EINVAL;
 490                 }
 491
 492                 *dev_desc = NULL;
 493                 memset(info, 0, sizeof(*info));
 494                 strcpy((char *)info->type, BOOT_PART_TYPE);
 495                 strcpy((char *)info->name, "UBI");
 496 #if CONFIG_IS_ENABLED(PARTITION_UUIDS)
 497                 info->uuid[0] = 0;
 498 #endif
 499                 return 0;
 500         }
 501 #endif
 502
 503         /* If no dev_part_str, use bootdevice environment variable */
 504         if (!dev_part_str || !strlen(dev_part_str) ||
 505             !strcmp(dev_part_str, "-"))
 506                 dev_part_str = env_get("bootdevice");
 507
 508         /* If still no dev_part_str, it's an error */
 509         if (!dev_part_str) {
 510                 printf("** No device specified **\n");
 511                 ret = -ENODEV;
 512                 goto cleanup;
 513         }
 514
 515         /* Separate device and partition ID specification */
 516         part_str = strchr(dev_part_str, ':');
 517         if (part_str) {
 518                 dup_str = strdup(dev_part_str);
 519                 dup_str[part_str - dev_part_str] = 0;
 520                 dev_str = dup_str;
 521                 part_str++;
 522         } else {
 523                 dev_str = dev_part_str;
 524         }
 525
 526         /* Look up the device */
 527         dev = blk_get_device_by_str(ifname, dev_str, dev_desc);
 528         if (dev < 0) {
 529                 ret = dev;
 530                 goto cleanup;
 531         }
 532
 533         /* Convert partition ID string to number */
 534         if (!part_str || !*part_str) {
 535                 part = PART_UNSPECIFIED;
 536         } else if (!strcmp(part_str, "auto")) {
 537                 part = PART_AUTO;
 538         } else {
 539                 /* Something specified -> use exactly that */
 540                 part = (int)hextoul(part_str, &ep);
 541                 /*
 542                  * Less than whole string converted,
 543                  * or request for whole device, but caller requires partition.
 544                  */
 545                 if (*ep || (part == 0 && !allow_whole_dev)) {
 546                         printf("** Bad partition specification %s %s **\n",
 547                             ifname, dev_part_str);
 548                         ret = -ENOENT;
 549                         goto cleanup;
 550                 }
 551         }
 552
 553         /*
 554          * No partition table on device,
 555          * or user requested partition 0 (entire device).
 556          */
 557         if (((*dev_desc)->part_type == PART_TYPE_UNKNOWN) ||
 558             (part == 0)) {
 559                 if (!(*dev_desc)->lba) {
 560                         printf("** Bad device size - %s %s **\n", ifname,
 561                                dev_str);
 562                         ret = -EINVAL;
 563                         goto cleanup;
 564                 }
 565
 566                 /*
 567                  * If user specified a partition ID other than 0,
 568                  * or the calling command only accepts partitions,
 569                  * it's an error.
 570                  */
 571                 if ((part > 0) || (!allow_whole_dev)) {
 572                         printf("** No partition table - %s %s **\n", ifname,
 573                                dev_str);
 574                         ret = -EPROTONOSUPPORT;
 575                         goto cleanup;
 576                 }
 577
 578                 (*dev_desc)->log2blksz = LOG2((*dev_desc)->blksz);
 579
 580                 part_get_info_whole_disk(*dev_desc, info);
 581
 582                 ret = 0;
 583                 goto cleanup;
 584         }
 585
 586         /*
 587          * Now there's known to be a partition table,
 588          * not specifying a partition means to pick partition 1.
 589          */
 590         if (part == PART_UNSPECIFIED)
 591                 part = 1;
 592
 593         /*
 594          * If user didn't specify a partition number, or did specify something
 595          * other than "auto", use that partition number directly.
 596          */
 597         if (part != PART_AUTO) {
 598                 ret = part_get_info(*dev_desc, part, info);
 599                 if (ret) {
 600                         printf("** Invalid partition %d **\n", part);
 601                         goto cleanup;
 602                 }
 603         } else {
 604                 /*
 605                  * Find the first bootable partition.
 606                  * If none are bootable, fall back to the first valid partition.
 607                  */
 608                 part = 0;
 609                 for (p = 1; p <= MAX_SEARCH_PARTITIONS; p++) {
 610                         ret = part_get_info(*dev_desc, p, info);
 611                         if (ret)
 612                                 continue;
 613
 614                         /*
 615                          * First valid partition, or new better partition?
 616                          * If so, save partition ID.
 617                          */
 618                         if (!part || info->bootable)
 619                                 part = p;
 620
 621                         /* Best possible partition? Stop searching. */
 622                         if (info->bootable)
 623                                 break;
 624
 625                         /*
 626                          * We now need to search further for best possible.
 627                          * If we what we just queried was the best so far,
 628                          * save the info since we over-write it next loop.
 629                          */
 630                         if (part == p)
 631                                 tmpinfo = *info;
 632                 }
 633                 /* If we found any acceptable partition */
 634                 if (part) {
 635                         /*
 636                          * If we searched all possible partition IDs,
 637                          * return the first valid partition we found.
 638                          */
 639                         if (p == MAX_SEARCH_PARTITIONS + 1)
 640                                 *info = tmpinfo;
 641                 } else {
 642                         printf("** No valid partitions found **\n");
 643                         goto cleanup;
 644                 }
 645         }
 646         if (strncmp((char *)info->type, BOOT_PART_TYPE, sizeof(info->type)) != 0) {
 647                 printf("** Invalid partition type \"%.32s\""
 648                         " (expect \"" BOOT_PART_TYPE "\")\n",
 649                         info->type);
 650                 ret  = -EINVAL;
 651                 goto cleanup;
 652         }
 653
 654         (*dev_desc)->log2blksz = LOG2((*dev_desc)->blksz);
 655
 656         ret = part;
 657         goto cleanup;
 658
 659 cleanup:
 660         free(dup_str);
 661         return ret;
 662 }
 663
 664 int part_get_info_by_name_type(struct blk_desc *dev_desc, const char *name,
 665                                struct disk_partition *info, int part_type)
 666 {
 667         struct part_driver *part_drv;
 668         int ret;
 669         int i;
 670
 671         part_drv = part_driver_lookup_type(dev_desc);
 672         if (!part_drv)
 673                 return -1;
 674
 675         if (!part_drv->get_info) {
 676                 log_debug("## Driver %s does not have the get_info() method\n",
 677                           part_drv->name);
 678                 return -ENOSYS;
 679         }
 680
 681         for (i = 1; i < part_drv->max_entries; i++) {
 682                 ret = part_drv->get_info(dev_desc, i, info);
 683                 if (ret != 0) {
 684                         /* no more entries in table */
 685                         break;
 686                 }
 687                 if (strcmp(name, (const char *)info->name) == 0) {
 688                         /* matched */
 689                         return i;
 690                 }
 691         }
 692
 693         return -ENOENT;
 694 }
 695
 696 int part_get_info_by_name(struct blk_desc *dev_desc, const char *name,
 697                           struct disk_partition *info)
 698 {
 699         return part_get_info_by_name_type(dev_desc, name, info, PART_TYPE_ALL);
 700 }
 701
 702 /**
 703  * Get partition info from device number and partition name.
 704  *
 705  * Parse a device number and partition name string in the form of
 706  * "devicenum.hwpartnum#partition_name", for example "0.1#misc". devicenum and
 707  * hwpartnum are both optional, defaulting to 0. If the partition is found,
 708  * sets dev_desc and part_info accordingly with the information of the
 709  * partition with the given partition_name.
 710  *
 711  * @param[in] dev_iface Device interface
 712  * @param[in] dev_part_str Input string argument, like "0.1#misc"
 713  * @param[out] dev_desc Place to store the device description pointer
 714  * @param[out] part_info Place to store the partition information
 715  * @return 0 on success, or a negative on error
 716  */
 717 static int part_get_info_by_dev_and_name(const char *dev_iface,
 718                                          const char *dev_part_str,
 719                                          struct blk_desc **dev_desc,
 720                                          struct disk_partition *part_info)
 721 {
 722         char *dup_str = NULL;
 723         const char *dev_str, *part_str;
 724         int ret;
 725
 726         /* Separate device and partition name specification */
 727         if (dev_part_str)
 728                 part_str = strchr(dev_part_str, '#');
 729         else
 730                 part_str = NULL;
 731
 732         if (part_str) {
 733                 dup_str = strdup(dev_part_str);
 734                 dup_str[part_str - dev_part_str] = 0;
 735                 dev_str = dup_str;
 736                 part_str++;
 737         } else {
 738                 return -EINVAL;
 739         }
 740
 741         ret = blk_get_device_by_str(dev_iface, dev_str, dev_desc);
 742         if (ret < 0)
 743                 goto cleanup;
 744
 745         ret = part_get_info_by_name(*dev_desc, part_str, part_info);
 746         if (ret < 0)
 747                 printf("Could not find \"%s\" partition\n", part_str);
 748
 749 cleanup:
 750         free(dup_str);
 751         return ret;
 752 }
 753
 754 int part_get_info_by_dev_and_name_or_num(const char *dev_iface,
 755                                          const char *dev_part_str,
 756                                          struct blk_desc **dev_desc,
 757                                          struct disk_partition *part_info,
 758                                          int allow_whole_dev)
 759 {
 760         int ret;
 761
 762         /* Split the part_name if passed as "$dev_num#part_name". */
 763         ret = part_get_info_by_dev_and_name(dev_iface, dev_part_str,
 764                                             dev_desc, part_info);
 765         if (ret >= 0)
 766                 return ret;
 767         /*
 768          * Couldn't lookup by name, try looking up the partition description
 769          * directly.
 770          */
 771         ret = blk_get_device_part_str(dev_iface, dev_part_str,
 772                                       dev_desc, part_info, allow_whole_dev);
 773         if (ret < 0)
 774                 printf("Couldn't find partition %s %s\n",
 775                        dev_iface, dev_part_str);
 776         return ret;
 777 }
 778
 779 void part_set_generic_name(const struct blk_desc *dev_desc,
 780         int part_num, char *name)
 781 {
 782         char *devtype;
 783
 784         switch (dev_desc->if_type) {
 785         case IF_TYPE_IDE:
 786         case IF_TYPE_SATA:
 787         case IF_TYPE_ATAPI:
 788                 devtype = "hd";
 789                 break;
 790         case IF_TYPE_SCSI:
 791                 devtype = "sd";
 792                 break;
 793         case IF_TYPE_USB:
 794                 devtype = "usbd";
 795                 break;
 796         case IF_TYPE_DOC:
 797                 devtype = "docd";
 798                 break;
 799         case IF_TYPE_MMC:
 800         case IF_TYPE_SD:
 801                 devtype = "mmcsd";
 802                 break;
 803         default:
 804                 devtype = "xx";
 805                 break;
 806         }
 807
 808         sprintf(name, "%s%c%d", devtype, 'a' + dev_desc->devnum, part_num);
 809 }