common/cmd_mtdparts.c

   1 /*
   2  * (C) Copyright 2002
   3  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
   4  *
   5  * (C) Copyright 2002
   6  * Robert Schwebel, Pengutronix, <r.schwebel@pengutronix.de>
   7  *
   8  * (C) Copyright 2003
   9  * Kai-Uwe Bloem, Auerswald GmbH & Co KG, <linux-development@auerswald.de>
  10  *
  11  * (C) Copyright 2005
  12  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
  13  *
  14  *   Added support for reading flash partition table from environment.
  15  *   Parsing routines are based on driver/mtd/cmdline.c from the linux 2.4
  16  *   kernel tree.
  17  *
  18  * (C) Copyright 2008
  19  * Harald Welte, OpenMoko, Inc., Harald Welte <laforge@openmoko.org>
  20  *
  21  *   $Id: cmdlinepart.c,v 1.17 2004/11/26 11:18:47 lavinen Exp $
  22  *   Copyright 2002 SYSGO Real-Time Solutions GmbH
  23  *
  24  * SPDX-License-Identifier:     GPL-2.0+
  25  */
  26
  27 /*
  28  * Three environment variables are used by the parsing routines:
  29  *
  30  * 'partition' - keeps current partition identifier
  31  *
  32  * partition  := <part-id>
  33  * <part-id>  := <dev-id>,part_num
  34  *
  35  *
  36  * 'mtdids' - linux kernel mtd device id <-> u-boot device id mapping
  37  *
  38  * mtdids=<idmap>[,<idmap>,...]
  39  *
  40  * <idmap>    := <dev-id>=<mtd-id>
  41  * <dev-id>   := 'nand'|'nor'|'onenand'<dev-num>
  42  * <dev-num>  := mtd device number, 0...
  43  * <mtd-id>   := unique device tag used by linux kernel to find mtd device (mtd->name)
  44  *
  45  *
  46  * 'mtdparts' - partition list
  47  *
  48  * mtdparts=mtdparts=<mtd-def>[;<mtd-def>...]
  49  *
  50  * <mtd-def>  := <mtd-id>:<part-def>[,<part-def>...]
  51  * <mtd-id>   := unique device tag used by linux kernel to find mtd device (mtd->name)
  52  * <part-def> := <size>[@<offset>][<name>][<ro-flag>]
  53  * <size>     := standard linux memsize OR '-' to denote all remaining space
  54  * <offset>   := partition start offset within the device
  55  * <name>     := '(' NAME ')'
  56  * <ro-flag>  := when set to 'ro' makes partition read-only (not used, passed to kernel)
  57  *
  58  * Notes:
  59  * - each <mtd-id> used in mtdparts must albo exist in 'mtddis' mapping
  60  * - if the above variables are not set defaults for a given target are used
  61  *
  62  * Examples:
  63  *
  64  * 1 NOR Flash, with 1 single writable partition:
  65  * mtdids=nor0=edb7312-nor
  66  * mtdparts=mtdparts=edb7312-nor:-
  67  *
  68  * 1 NOR Flash with 2 partitions, 1 NAND with one
  69  * mtdids=nor0=edb7312-nor,nand0=edb7312-nand
  70  * mtdparts=mtdparts=edb7312-nor:256k(ARMboot)ro,-(root);edb7312-nand:-(home)
  71  *
  72  */
  73
  74 #include <common.h>
  75 #include <command.h>
  76 #include <malloc.h>
  77 #include <jffs2/load_kernel.h>
  78 #include <linux/list.h>
  79 #include <linux/ctype.h>
  80 #include <linux/err.h>
  81 #include <linux/mtd/mtd.h>
  82
  83 #if defined(CONFIG_CMD_NAND)
  84 #include <linux/mtd/nand.h>
  85 #include <nand.h>
  86 #endif
  87
  88 #if defined(CONFIG_CMD_ONENAND)
  89 #include <linux/mtd/onenand.h>
  90 #include <onenand_uboot.h>
  91 #endif
  92
  93 DECLARE_GLOBAL_DATA_PTR;
  94
  95 /* special size referring to all the remaining space in a partition */
  96 #define SIZE_REMAINING          (~0llu)
  97
  98 /* special offset value, it is used when not provided by user
  99  *
 100  * this value is used temporarily during parsing, later such offests
 101  * are recalculated */
 102 #define OFFSET_NOT_SPECIFIED    (~0llu)
 103
 104 /* minimum partition size */
 105 #define MIN_PART_SIZE           4096
 106
 107 /* this flag needs to be set in part_info struct mask_flags
 108  * field for read-only partitions */
 109 #define MTD_WRITEABLE_CMD               1
 110
 111 /* default values for mtdids and mtdparts variables */
 112 #if defined(MTDIDS_DEFAULT)
 113 static const char *const mtdids_default = MTDIDS_DEFAULT;
 114 #else
 115 static const char *const mtdids_default = NULL;
 116 #endif
 117
 118 #if defined(MTDPARTS_DEFAULT)
 119 static const char *const mtdparts_default = MTDPARTS_DEFAULT;
 120 #else
 121 static const char *const mtdparts_default = NULL;
 122 #endif
 123
 124 /* copies of last seen 'mtdids', 'mtdparts' and 'partition' env variables */
 125 #define MTDIDS_MAXLEN           128
 126 #define MTDPARTS_MAXLEN         512
 127 #define PARTITION_MAXLEN        16
 128 static char last_ids[MTDIDS_MAXLEN];
 129 static char last_parts[MTDPARTS_MAXLEN];
 130 static char last_partition[PARTITION_MAXLEN];
 131
 132 /* low level jffs2 cache cleaning routine */
 133 extern void jffs2_free_cache(struct part_info *part);
 134
 135 /* mtdids mapping list, filled by parse_ids() */
 136 static struct list_head mtdids;
 137
 138 /* device/partition list, parse_cmdline() parses into here */
 139 static struct list_head devices;
 140
 141 /* current active device and partition number */
 142 struct mtd_device *current_mtd_dev = NULL;
 143 u8 current_mtd_partnum = 0;
 144
 145 static struct part_info* mtd_part_info(struct mtd_device *dev, unsigned int part_num);
 146
 147 /* command line only routines */
 148 static struct mtdids* id_find_by_mtd_id(const char *mtd_id, unsigned int mtd_id_len);
 149 static int device_del(struct mtd_device *dev);
 150
 151 /**
 152  * Parses a string into a number.  The number stored at ptr is
 153  * potentially suffixed with K (for kilobytes, or 1024 bytes),
 154  * M (for megabytes, or 1048576 bytes), or G (for gigabytes, or
 155  * 1073741824).  If the number is suffixed with K, M, or G, then
 156  * the return value is the number multiplied by one kilobyte, one
 157  * megabyte, or one gigabyte, respectively.
 158  *
 159  * @param ptr where parse begins
 160  * @param retptr output pointer to next char after parse completes (output)
 161  * @return resulting unsigned int
 162  */
 163 static u64 memsize_parse (const char *const ptr, const char **retptr)
 164 {
 165         u64 ret = simple_strtoull(ptr, (char **)retptr, 0);
 166
 167         switch (**retptr) {
 168                 case 'G':
 169                 case 'g':
 170                         ret <<= 10;
 171                 case 'M':
 172                 case 'm':
 173                         ret <<= 10;
 174                 case 'K':
 175                 case 'k':
 176                         ret <<= 10;
 177                         (*retptr)++;
 178                 default:
 179                         break;
 180         }
 181
 182         return ret;
 183 }
 184
 185 /**
 186  * Format string describing supplied size. This routine does the opposite job
 187  * to memsize_parse(). Size in bytes is converted to string and if possible
 188  * shortened by using k (kilobytes), m (megabytes) or g (gigabytes) suffix.
 189  *
 190  * Note, that this routine does not check for buffer overflow, it's the caller
 191  * who must assure enough space.
 192  *
 193  * @param buf output buffer
 194  * @param size size to be converted to string
 195  */
 196 static void memsize_format(char *buf, u64 size)
 197 {
 198 #define SIZE_GB ((u32)1024*1024*1024)
 199 #define SIZE_MB ((u32)1024*1024)
 200 #define SIZE_KB ((u32)1024)
 201
 202         if ((size % SIZE_GB) == 0)
 203                 sprintf(buf, "%llug", size/SIZE_GB);
 204         else if ((size % SIZE_MB) == 0)
 205                 sprintf(buf, "%llum", size/SIZE_MB);
 206         else if (size % SIZE_KB == 0)
 207                 sprintf(buf, "%lluk", size/SIZE_KB);
 208         else
 209                 sprintf(buf, "%llu", size);
 210 }
 211
 212 /**
 213  * This routine does global indexing of all partitions. Resulting index for
 214  * current partition is saved in 'mtddevnum'. Current partition name in
 215  * 'mtddevname'.
 216  */
 217 static void index_partitions(void)
 218 {
 219         u16 mtddevnum;
 220         struct part_info *part;
 221         struct list_head *dentry;
 222         struct mtd_device *dev;
 223
 224         debug("--- index partitions ---\n");
 225
 226         if (current_mtd_dev) {
 227                 mtddevnum = 0;
 228                 list_for_each(dentry, &devices) {
 229                         dev = list_entry(dentry, struct mtd_device, link);
 230                         if (dev == current_mtd_dev) {
 231                                 mtddevnum += current_mtd_partnum;
 232                                 setenv_ulong("mtddevnum", mtddevnum);
 233                                 break;
 234                         }
 235                         mtddevnum += dev->num_parts;
 236                 }
 237
 238                 part = mtd_part_info(current_mtd_dev, current_mtd_partnum);
 239                 setenv("mtddevname", part->name);
 240
 241                 debug("=> mtddevnum %d,\n=> mtddevname %s\n", mtddevnum, part->name);
 242         } else {
 243                 setenv("mtddevnum", NULL);
 244                 setenv("mtddevname", NULL);
 245
 246                 debug("=> mtddevnum NULL\n=> mtddevname NULL\n");
 247         }
 248 }
 249
 250 /**
 251  * Save current device and partition in environment variable 'partition'.
 252  */
 253 static void current_save(void)
 254 {
 255         char buf[16];
 256
 257         debug("--- current_save ---\n");
 258
 259         if (current_mtd_dev) {
 260                 sprintf(buf, "%s%d,%d", MTD_DEV_TYPE(current_mtd_dev->id->type),
 261                                         current_mtd_dev->id->num, current_mtd_partnum);
 262
 263                 setenv("partition", buf);
 264                 strncpy(last_partition, buf, 16);
 265
 266                 debug("=> partition %s\n", buf);
 267         } else {
 268                 setenv("partition", NULL);
 269                 last_partition[0] = '\0';
 270
 271                 debug("=> partition NULL\n");
 272         }
 273         index_partitions();
 274 }
 275
 276
 277 /**
 278  * Produce a mtd_info given a type and num.
 279  *
 280  * @param type mtd type
 281  * @param num mtd number
 282  * @param mtd a pointer to an mtd_info instance (output)
 283  * @return 0 if device is valid, 1 otherwise
 284  */
 285 static int get_mtd_info(u8 type, u8 num, struct mtd_info **mtd)
 286 {
 287         char mtd_dev[16];
 288
 289         sprintf(mtd_dev, "%s%d", MTD_DEV_TYPE(type), num);
 290         *mtd = get_mtd_device_nm(mtd_dev);
 291         if (IS_ERR(*mtd)) {
 292                 printf("Device %s not found!\n", mtd_dev);
 293                 return 1;
 294         }
 295         put_mtd_device(*mtd);
 296
 297         return 0;
 298 }
 299
 300 /**
 301  * Performs sanity check for supplied flash partition.
 302  * Table of existing MTD flash devices is searched and partition device
 303  * is located. Alignment with the granularity of nand erasesize is verified.
 304  *
 305  * @param id of the parent device
 306  * @param part partition to validate
 307  * @return 0 if partition is valid, 1 otherwise
 308  */
 309 static int part_validate_eraseblock(struct mtdids *id, struct part_info *part)
 310 {
 311         struct mtd_info *mtd = NULL;
 312         int i, j;
 313         ulong start;
 314         u64 offset, size;
 315
 316         if (get_mtd_info(id->type, id->num, &mtd))
 317                 return 1;
 318
 319         part->sector_size = mtd->erasesize;
 320
 321         if (!mtd->numeraseregions) {
 322                 /*
 323                  * Only one eraseregion (NAND, OneNAND or uniform NOR),
 324                  * checking for alignment is easy here
 325                  */
 326                 offset = part->offset;
 327                 if (do_div(offset, mtd->erasesize)) {
 328                         printf("%s%d: partition (%s) start offset alignment incorrect\n",
 329                                MTD_DEV_TYPE(id->type), id->num, part->name);
 330                         return 1;
 331                 }
 332
 333                 size = part->size;
 334                 if (do_div(size, mtd->erasesize)) {
 335                         printf("%s%d: partition (%s) size alignment incorrect\n",
 336                                MTD_DEV_TYPE(id->type), id->num, part->name);
 337                         return 1;
 338                 }
 339         } else {
 340                 /*
 341                  * Multiple eraseregions (non-uniform NOR),
 342                  * checking for alignment is more complex here
 343                  */
 344
 345                 /* Check start alignment */
 346                 for (i = 0; i < mtd->numeraseregions; i++) {
 347                         start = mtd->eraseregions[i].offset;
 348                         for (j = 0; j < mtd->eraseregions[i].numblocks; j++) {
 349                                 if (part->offset == start)
 350                                         goto start_ok;
 351                                 start += mtd->eraseregions[i].erasesize;
 352                         }
 353                 }
 354
 355                 printf("%s%d: partition (%s) start offset alignment incorrect\n",
 356                        MTD_DEV_TYPE(id->type), id->num, part->name);
 357                 return 1;
 358
 359         start_ok:
 360
 361                 /* Check end/size alignment */
 362                 for (i = 0; i < mtd->numeraseregions; i++) {
 363                         start = mtd->eraseregions[i].offset;
 364                         for (j = 0; j < mtd->eraseregions[i].numblocks; j++) {
 365                                 if ((part->offset + part->size) == start)
 366                                         goto end_ok;
 367                                 start += mtd->eraseregions[i].erasesize;
 368                         }
 369                 }
 370                 /* Check last sector alignment */
 371                 if ((part->offset + part->size) == start)
 372                         goto end_ok;
 373
 374                 printf("%s%d: partition (%s) size alignment incorrect\n",
 375                        MTD_DEV_TYPE(id->type), id->num, part->name);
 376                 return 1;
 377
 378         end_ok:
 379                 return 0;
 380         }
 381
 382         return 0;
 383 }
 384
 385
 386 /**
 387  * Performs sanity check for supplied partition. Offset and size are
 388  * verified to be within valid range. Partition type is checked and
 389  * part_validate_eraseblock() is called with the argument of part.
 390  *
 391  * @param id of the parent device
 392  * @param part partition to validate
 393  * @return 0 if partition is valid, 1 otherwise
 394  */
 395 static int part_validate(struct mtdids *id, struct part_info *part)
 396 {
 397         if (part->size == SIZE_REMAINING)
 398                 part->size = id->size - part->offset;
 399
 400         if (part->offset > id->size) {
 401                 printf("%s: offset %08llx beyond flash size %08llx\n",
 402                                 id->mtd_id, part->offset, id->size);
 403                 return 1;
 404         }
 405
 406         if ((part->offset + part->size) <= part->offset) {
 407                 printf("%s%d: partition (%s) size too big\n",
 408                                 MTD_DEV_TYPE(id->type), id->num, part->name);
 409                 return 1;
 410         }
 411
 412         if (part->offset + part->size > id->size) {
 413                 printf("%s: partitioning exceeds flash size\n", id->mtd_id);
 414                 return 1;
 415         }
 416
 417         /*
 418          * Now we need to check if the partition starts and ends on
 419          * sector (eraseblock) regions
 420          */
 421         return part_validate_eraseblock(id, part);
 422 }
 423
 424 /**
 425  * Delete selected partition from the partition list of the specified device.
 426  *
 427  * @param dev device to delete partition from
 428  * @param part partition to delete
 429  * @return 0 on success, 1 otherwise
 430  */
 431 static int part_del(struct mtd_device *dev, struct part_info *part)
 432 {
 433         u8 current_save_needed = 0;
 434
 435         /* if there is only one partition, remove whole device */
 436         if (dev->num_parts == 1)
 437                 return device_del(dev);
 438
 439         /* otherwise just delete this partition */
 440
 441         if (dev == current_mtd_dev) {
 442                 /* we are modyfing partitions for the current device,
 443                  * update current */
 444                 struct part_info *curr_pi;
 445                 curr_pi = mtd_part_info(current_mtd_dev, current_mtd_partnum);
 446
 447                 if (curr_pi) {
 448                         if (curr_pi == part) {
 449                                 printf("current partition deleted, resetting current to 0\n");
 450                                 current_mtd_partnum = 0;
 451                         } else if (part->offset <= curr_pi->offset) {
 452                                 current_mtd_partnum--;
 453                         }
 454                         current_save_needed = 1;
 455                 }
 456         }
 457
 458         list_del(&part->link);
 459         free(part);
 460         dev->num_parts--;
 461
 462         if (current_save_needed > 0)
 463                 current_save();
 464         else
 465                 index_partitions();
 466
 467         return 0;
 468 }
 469
 470 /**
 471  * Delete all partitions from parts head list, free memory.
 472  *
 473  * @param head list of partitions to delete
 474  */
 475 static void part_delall(struct list_head *head)
 476 {
 477         struct list_head *entry, *n;
 478         struct part_info *part_tmp;
 479
 480         /* clean tmp_list and free allocated memory */
 481         list_for_each_safe(entry, n, head) {
 482                 part_tmp = list_entry(entry, struct part_info, link);
 483
 484                 list_del(entry);
 485                 free(part_tmp);
 486         }
 487 }
 488
 489 /**
 490  * Add new partition to the supplied partition list. Make sure partitions are
 491  * sorted by offset in ascending order.
 492  *
 493  * @param head list this partition is to be added to
 494  * @param new partition to be added
 495  */
 496 static int part_sort_add(struct mtd_device *dev, struct part_info *part)
 497 {
 498         struct list_head *entry;
 499         struct part_info *new_pi, *curr_pi;
 500
 501         /* link partition to parrent dev */
 502         part->dev = dev;
 503
 504         if (list_empty(&dev->parts)) {
 505                 debug("part_sort_add: list empty\n");
 506                 list_add(&part->link, &dev->parts);
 507                 dev->num_parts++;
 508                 index_partitions();
 509                 return 0;
 510         }
 511
 512         new_pi = list_entry(&part->link, struct part_info, link);
 513
 514         /* get current partition info if we are updating current device */
 515         curr_pi = NULL;
 516         if (dev == current_mtd_dev)
 517                 curr_pi = mtd_part_info(current_mtd_dev, current_mtd_partnum);
 518
 519         list_for_each(entry, &dev->parts) {
 520                 struct part_info *pi;
 521
 522                 pi = list_entry(entry, struct part_info, link);
 523
 524                 /* be compliant with kernel cmdline, allow only one partition at offset zero */
 525                 if ((new_pi->offset == pi->offset) && (pi->offset == 0)) {
 526                         printf("cannot add second partition at offset 0\n");
 527                         return 1;
 528                 }
 529
 530                 if (new_pi->offset <= pi->offset) {
 531                         list_add_tail(&part->link, entry);
 532                         dev->num_parts++;
 533
 534                         if (curr_pi && (pi->offset <= curr_pi->offset)) {
 535                                 /* we are modyfing partitions for the current
 536                                  * device, update current */
 537                                 current_mtd_partnum++;
 538                                 current_save();
 539                         } else {
 540                                 index_partitions();
 541                         }
 542                         return 0;
 543                 }
 544         }
 545
 546         list_add_tail(&part->link, &dev->parts);
 547         dev->num_parts++;
 548         index_partitions();
 549         return 0;
 550 }
 551
 552 /**
 553  * Add provided partition to the partition list of a given device.
 554  *
 555  * @param dev device to which partition is added
 556  * @param part partition to be added
 557  * @return 0 on success, 1 otherwise
 558  */
 559 static int part_add(struct mtd_device *dev, struct part_info *part)
 560 {
 561         /* verify alignment and size */
 562         if (part_validate(dev->id, part) != 0)
 563                 return 1;
 564
 565         /* partition is ok, add it to the list */
 566         if (part_sort_add(dev, part) != 0)
 567                 return 1;
 568
 569         return 0;
 570 }
 571
 572 /**
 573  * Parse one partition definition, allocate memory and return pointer to this
 574  * location in retpart.
 575  *
 576  * @param partdef pointer to the partition definition string i.e. <part-def>
 577  * @param ret output pointer to next char after parse completes (output)
 578  * @param retpart pointer to the allocated partition (output)
 579  * @return 0 on success, 1 otherwise
 580  */
 581 static int part_parse(const char *const partdef, const char **ret, struct part_info **retpart)
 582 {
 583         struct part_info *part;
 584         u64 size;
 585         u64 offset;
 586         const char *name;
 587         int name_len;
 588         unsigned int mask_flags;
 589         const char *p;
 590
 591         p = partdef;
 592         *retpart = NULL;
 593         *ret = NULL;
 594
 595         /* fetch the partition size */
 596         if (*p == '-') {
 597                 /* assign all remaining space to this partition */
 598                 debug("'-': remaining size assigned\n");
 599                 size = SIZE_REMAINING;
 600                 p++;
 601         } else {
 602                 size = memsize_parse(p, &p);
 603                 if (size < MIN_PART_SIZE) {
 604                         printf("partition size too small (%llx)\n", size);
 605                         return 1;
 606                 }
 607         }
 608
 609         /* check for offset */
 610         offset = OFFSET_NOT_SPECIFIED;
 611         if (*p == '@') {
 612                 p++;
 613                 offset = memsize_parse(p, &p);
 614         }
 615
 616         /* now look for the name */
 617         if (*p == '(') {
 618                 name = ++p;
 619                 if ((p = strchr(name, ')')) == NULL) {
 620                         printf("no closing ) found in partition name\n");
 621                         return 1;
 622                 }
 623                 name_len = p - name + 1;
 624                 if ((name_len - 1) == 0) {
 625                         printf("empty partition name\n");
 626                         return 1;
 627                 }
 628                 p++;
 629         } else {
 630                 /* 0x00000000@0x00000000 */
 631                 name_len = 22;
 632                 name = NULL;
 633         }
 634
 635         /* test for options */
 636         mask_flags = 0;
 637         if (strncmp(p, "ro", 2) == 0) {
 638                 mask_flags |= MTD_WRITEABLE_CMD;
 639                 p += 2;
 640         }
 641
 642         /* check for next partition definition */
 643         if (*p == ',') {
 644                 if (size == SIZE_REMAINING) {
 645                         *ret = NULL;
 646                         printf("no partitions allowed after a fill-up partition\n");
 647                         return 1;
 648                 }
 649                 *ret = ++p;
 650         } else if ((*p == ';') || (*p == '\0')) {
 651                 *ret = p;
 652         } else {
 653                 printf("unexpected character '%c' at the end of partition\n", *p);
 654                 *ret = NULL;
 655                 return 1;
 656         }
 657
 658         /*  allocate memory */
 659         part = (struct part_info *)malloc(sizeof(struct part_info) + name_len);
 660         if (!part) {
 661                 printf("out of memory\n");
 662                 return 1;
 663         }
 664         memset(part, 0, sizeof(struct part_info) + name_len);
 665         part->size = size;
 666         part->offset = offset;
 667         part->mask_flags = mask_flags;
 668         part->name = (char *)(part + 1);
 669
 670         if (name) {
 671                 /* copy user provided name */
 672                 strncpy(part->name, name, name_len - 1);
 673                 part->auto_name = 0;
 674         } else {
 675                 /* auto generated name in form of size@offset */
 676                 sprintf(part->name, "0x%08llx@0x%08llx", size, offset);
 677                 part->auto_name = 1;
 678         }
 679
 680         part->name[name_len - 1] = '\0';
 681         INIT_LIST_HEAD(&part->link);
 682
 683         debug("+ partition: name %-22s size 0x%08llx offset 0x%08llx mask flags %d\n",
 684                         part->name, part->size,
 685                         part->offset, part->mask_flags);
 686
 687         *retpart = part;
 688         return 0;
 689 }
 690
 691 /**
 692  * Check device number to be within valid range for given device type.
 693  *
 694  * @param type mtd type
 695  * @param num mtd number
 696  * @param size a pointer to the size of the mtd device (output)
 697  * @return 0 if device is valid, 1 otherwise
 698  */
 699 static int mtd_device_validate(u8 type, u8 num, u64 *size)
 700 {
 701         struct mtd_info *mtd = NULL;
 702
 703         if (get_mtd_info(type, num, &mtd))
 704                 return 1;
 705
 706         *size = mtd->size;
 707
 708         return 0;
 709 }
 710
 711 /**
 712  * Delete all mtd devices from a supplied devices list, free memory allocated for
 713  * each device and delete all device partitions.
 714  *
 715  * @return 0 on success, 1 otherwise
 716  */
 717 static int device_delall(struct list_head *head)
 718 {
 719         struct list_head *entry, *n;
 720         struct mtd_device *dev_tmp;
 721
 722         /* clean devices list */
 723         list_for_each_safe(entry, n, head) {
 724                 dev_tmp = list_entry(entry, struct mtd_device, link);
 725                 list_del(entry);
 726                 part_delall(&dev_tmp->parts);
 727                 free(dev_tmp);
 728         }
 729         INIT_LIST_HEAD(&devices);
 730
 731         return 0;
 732 }
 733
 734 /**
 735  * If provided device exists it's partitions are deleted, device is removed
 736  * from device list and device memory is freed.
 737  *
 738  * @param dev device to be deleted
 739  * @return 0 on success, 1 otherwise
 740  */
 741 static int device_del(struct mtd_device *dev)
 742 {
 743         part_delall(&dev->parts);
 744         list_del(&dev->link);
 745         free(dev);
 746
 747         if (dev == current_mtd_dev) {
 748                 /* we just deleted current device */
 749                 if (list_empty(&devices)) {
 750                         current_mtd_dev = NULL;
 751                 } else {
 752                         /* reset first partition from first dev from the
 753                          * devices list as current */
 754                         current_mtd_dev = list_entry(devices.next, struct mtd_device, link);
 755                         current_mtd_partnum = 0;
 756                 }
 757                 current_save();
 758                 return 0;
 759         }
 760
 761         index_partitions();
 762         return 0;
 763 }
 764
 765 /**
 766  * Search global device list and return pointer to the device of type and num
 767  * specified.
 768  *
 769  * @param type device type
 770  * @param num device number
 771  * @return NULL if requested device does not exist
 772  */
 773 struct mtd_device *device_find(u8 type, u8 num)
 774 {
 775         struct list_head *entry;
 776         struct mtd_device *dev_tmp;
 777
 778         list_for_each(entry, &devices) {
 779                 dev_tmp = list_entry(entry, struct mtd_device, link);
 780
 781                 if ((dev_tmp->id->type == type) && (dev_tmp->id->num == num))
 782                         return dev_tmp;
 783         }
 784
 785         return NULL;
 786 }
 787
 788 /**
 789  * Add specified device to the global device list.
 790  *
 791  * @param dev device to be added
 792  */
 793 static void device_add(struct mtd_device *dev)
 794 {
 795         u8 current_save_needed = 0;
 796
 797         if (list_empty(&devices)) {
 798                 current_mtd_dev = dev;
 799                 current_mtd_partnum = 0;
 800                 current_save_needed = 1;
 801         }
 802
 803         list_add_tail(&dev->link, &devices);
 804
 805         if (current_save_needed > 0)
 806                 current_save();
 807         else
 808                 index_partitions();
 809 }
 810
 811 /**
 812  * Parse device type, name and mtd-id. If syntax is ok allocate memory and
 813  * return pointer to the device structure.
 814  *
 815  * @param mtd_dev pointer to the device definition string i.e. <mtd-dev>
 816  * @param ret output pointer to next char after parse completes (output)
 817  * @param retdev pointer to the allocated device (output)
 818  * @return 0 on success, 1 otherwise
 819  */
 820 static int device_parse(const char *const mtd_dev, const char **ret, struct mtd_device **retdev)
 821 {
 822         struct mtd_device *dev;
 823         struct part_info *part;
 824         struct mtdids *id;
 825         const char *mtd_id;
 826         unsigned int mtd_id_len;
 827         const char *p;
 828         const char *pend;
 829         LIST_HEAD(tmp_list);
 830         struct list_head *entry, *n;
 831         u16 num_parts;
 832         u64 offset;
 833         int err = 1;
 834
 835         debug("===device_parse===\n");
 836
 837         assert(retdev);
 838         *retdev = NULL;
 839
 840         if (ret)
 841                 *ret = NULL;
 842
 843         /* fetch <mtd-id> */
 844         mtd_id = p = mtd_dev;
 845         if (!(p = strchr(mtd_id, ':'))) {
 846                 printf("no <mtd-id> identifier\n");
 847                 return 1;
 848         }
 849         mtd_id_len = p - mtd_id + 1;
 850         p++;
 851
 852         /* verify if we have a valid device specified */
 853         if ((id = id_find_by_mtd_id(mtd_id, mtd_id_len - 1)) == NULL) {
 854                 printf("invalid mtd device '%.*s'\n", mtd_id_len - 1, mtd_id);
 855                 return 1;
 856         }
 857
 858 #ifdef DEBUG
 859         pend = strchr(p, ';');
 860 #endif
 861         debug("dev type = %d (%s), dev num = %d, mtd-id = %s\n",
 862                         id->type, MTD_DEV_TYPE(id->type),
 863                         id->num, id->mtd_id);
 864         debug("parsing partitions %.*s\n", (int)(pend ? pend - p : strlen(p)), p);
 865
 866
 867         /* parse partitions */
 868         num_parts = 0;
 869
 870         offset = 0;
 871         if ((dev = device_find(id->type, id->num)) != NULL) {
 872                 /* if device already exists start at the end of the last partition */
 873                 part = list_entry(dev->parts.prev, struct part_info, link);
 874                 offset = part->offset + part->size;
 875         }
 876
 877         while (p && (*p != '\0') && (*p != ';')) {
 878                 err = 1;
 879                 if ((part_parse(p, &p, &part) != 0) || (!part))
 880                         break;
 881
 882                 /* calculate offset when not specified */
 883                 if (part->offset == OFFSET_NOT_SPECIFIED)
 884                         part->offset = offset;
 885                 else
 886                         offset = part->offset;
 887
 888                 /* verify alignment and size */
 889                 if (part_validate(id, part) != 0)
 890                         break;
 891
 892                 offset += part->size;
 893
 894                 /* partition is ok, add it to the list */
 895                 list_add_tail(&part->link, &tmp_list);
 896                 num_parts++;
 897                 err = 0;
 898         }
 899         if (err == 1) {
 900                 part_delall(&tmp_list);
 901                 return 1;
 902         }
 903
 904         if (num_parts == 0) {
 905                 printf("no partitions for device %s%d (%s)\n",
 906                                 MTD_DEV_TYPE(id->type), id->num, id->mtd_id);
 907                 return 1;
 908         }
 909
 910         debug("\ntotal partitions: %d\n", num_parts);
 911
 912         /* check for next device presence */
 913         if (p) {
 914                 if (*p == ';') {
 915                         if (ret)
 916                                 *ret = ++p;
 917                 } else if (*p == '\0') {
 918                         if (ret)
 919                                 *ret = p;
 920                 } else {
 921                         printf("unexpected character '%c' at the end of device\n", *p);
 922                         if (ret)
 923                                 *ret = NULL;
 924                         return 1;
 925                 }
 926         }
 927
 928         /* allocate memory for mtd_device structure */
 929         if ((dev = (struct mtd_device *)malloc(sizeof(struct mtd_device))) == NULL) {
 930                 printf("out of memory\n");
 931                 return 1;
 932         }
 933         memset(dev, 0, sizeof(struct mtd_device));
 934         dev->id = id;
 935         dev->num_parts = 0; /* part_sort_add increments num_parts */
 936         INIT_LIST_HEAD(&dev->parts);
 937         INIT_LIST_HEAD(&dev->link);
 938
 939         /* move partitions from tmp_list to dev->parts */
 940         list_for_each_safe(entry, n, &tmp_list) {
 941                 part = list_entry(entry, struct part_info, link);
 942                 list_del(entry);
 943                 if (part_sort_add(dev, part) != 0) {
 944                         device_del(dev);
 945                         return 1;
 946                 }
 947         }
 948
 949         *retdev = dev;
 950
 951         debug("===\n\n");
 952         return 0;
 953 }
 954
 955 /**
 956  * Initialize global device list.
 957  *
 958  * @return 0 on success, 1 otherwise
 959  */
 960 static int mtd_devices_init(void)
 961 {
 962         last_parts[0] = '\0';
 963         current_mtd_dev = NULL;
 964         current_save();
 965
 966         return device_delall(&devices);
 967 }
 968
 969 /*
 970  * Search global mtdids list and find id of requested type and number.
 971  *
 972  * @return pointer to the id if it exists, NULL otherwise
 973  */
 974 static struct mtdids* id_find(u8 type, u8 num)
 975 {
 976         struct list_head *entry;
 977         struct mtdids *id;
 978
 979         list_for_each(entry, &mtdids) {
 980                 id = list_entry(entry, struct mtdids, link);
 981
 982                 if ((id->type == type) && (id->num == num))
 983                         return id;
 984         }
 985
 986         return NULL;
 987 }
 988
 989 /**
 990  * Search global mtdids list and find id of a requested mtd_id.
 991  *
 992  * Note: first argument is not null terminated.
 993  *
 994  * @param mtd_id string containing requested mtd_id
 995  * @param mtd_id_len length of supplied mtd_id
 996  * @return pointer to the id if it exists, NULL otherwise
 997  */
 998 static struct mtdids* id_find_by_mtd_id(const char *mtd_id, unsigned int mtd_id_len)
 999 {
1000         struct list_head *entry;
1001         struct mtdids *id;
1002
1003         debug("--- id_find_by_mtd_id: '%.*s' (len = %d)\n",
1004                         mtd_id_len, mtd_id, mtd_id_len);
1005
1006         list_for_each(entry, &mtdids) {
1007                 id = list_entry(entry, struct mtdids, link);
1008
1009                 debug("entry: '%s' (len = %zu)\n",
1010                                 id->mtd_id, strlen(id->mtd_id));
1011
1012                 if (mtd_id_len != strlen(id->mtd_id))
1013                         continue;
1014                 if (strncmp(id->mtd_id, mtd_id, mtd_id_len) == 0)
1015                         return id;
1016         }
1017
1018         return NULL;
1019 }
1020
1021 /**
1022  * Parse device id string <dev-id> := 'nand'|'nor'|'onenand'<dev-num>,
1023  * return device type and number.
1024  *
1025  * @param id string describing device id
1026  * @param ret_id output pointer to next char after parse completes (output)
1027  * @param dev_type parsed device type (output)
1028  * @param dev_num parsed device number (output)
1029  * @return 0 on success, 1 otherwise
1030  */
1031 int mtd_id_parse(const char *id, const char **ret_id, u8 *dev_type,
1032                  u8 *dev_num)
1033 {
1034         const char *p = id;
1035
1036         *dev_type = 0;
1037         if (strncmp(p, "nand", 4) == 0) {
1038                 *dev_type = MTD_DEV_TYPE_NAND;
1039                 p += 4;
1040         } else if (strncmp(p, "nor", 3) == 0) {
1041                 *dev_type = MTD_DEV_TYPE_NOR;
1042                 p += 3;
1043         } else if (strncmp(p, "onenand", 7) == 0) {
1044                 *dev_type = MTD_DEV_TYPE_ONENAND;
1045                 p += 7;
1046         } else {
1047                 printf("incorrect device type in %s\n", id);
1048                 return 1;
1049         }
1050
1051         if (!isdigit(*p)) {
1052                 printf("incorrect device number in %s\n", id);
1053                 return 1;
1054         }
1055
1056         *dev_num = simple_strtoul(p, (char **)&p, 0);
1057         if (ret_id)
1058                 *ret_id = p;
1059         return 0;
1060 }
1061
1062 /**
1063  * Process all devices and generate corresponding mtdparts string describing
1064  * all partitions on all devices.
1065  *
1066  * @param buf output buffer holding generated mtdparts string (output)
1067  * @param buflen buffer size
1068  * @return 0 on success, 1 otherwise
1069  */
1070 static int generate_mtdparts(char *buf, u32 buflen)
1071 {
1072         struct list_head *pentry, *dentry;
1073         struct mtd_device *dev;
1074         struct part_info *part, *prev_part;
1075         char *p = buf;
1076         char tmpbuf[32];
1077         u64 size, offset;
1078         u32 len, part_cnt;
1079         u32 maxlen = buflen - 1;
1080
1081         debug("--- generate_mtdparts ---\n");
1082
1083         if (list_empty(&devices)) {
1084                 buf[0] = '\0';
1085                 return 0;
1086         }
1087
1088         sprintf(p, "mtdparts=");
1089         p += 9;
1090
1091         list_for_each(dentry, &devices) {
1092                 dev = list_entry(dentry, struct mtd_device, link);
1093
1094                 /* copy mtd_id */
1095                 len = strlen(dev->id->mtd_id) + 1;
1096                 if (len > maxlen)
1097                         goto cleanup;
1098                 memcpy(p, dev->id->mtd_id, len - 1);
1099                 p += len - 1;
1100                 *(p++) = ':';
1101                 maxlen -= len;
1102
1103                 /* format partitions */
1104                 prev_part = NULL;
1105                 part_cnt = 0;
1106                 list_for_each(pentry, &dev->parts) {
1107                         part = list_entry(pentry, struct part_info, link);
1108                         size = part->size;
1109                         offset = part->offset;
1110                         part_cnt++;
1111
1112                         /* partition size */
1113                         memsize_format(tmpbuf, size);
1114                         len = strlen(tmpbuf);
1115                         if (len > maxlen)
1116                                 goto cleanup;
1117                         memcpy(p, tmpbuf, len);
1118                         p += len;
1119                         maxlen -= len;
1120
1121
1122                         /* add offset only when there is a gap between
1123                          * partitions */
1124                         if ((!prev_part && (offset != 0)) ||
1125                                         (prev_part && ((prev_part->offset + prev_part->size) != part->offset))) {
1126
1127                                 memsize_format(tmpbuf, offset);
1128                                 len = strlen(tmpbuf) + 1;
1129                                 if (len > maxlen)
1130                                         goto cleanup;
1131                                 *(p++) = '@';
1132                                 memcpy(p, tmpbuf, len - 1);
1133                                 p += len - 1;
1134                                 maxlen -= len;
1135                         }
1136
1137                         /* copy name only if user supplied */
1138                         if(!part->auto_name) {
1139                                 len = strlen(part->name) + 2;
1140                                 if (len > maxlen)
1141                                         goto cleanup;
1142
1143                                 *(p++) = '(';
1144                                 memcpy(p, part->name, len - 2);
1145                                 p += len - 2;
1146                                 *(p++) = ')';
1147                                 maxlen -= len;
1148                         }
1149
1150                         /* ro mask flag */
1151                         if (part->mask_flags && MTD_WRITEABLE_CMD) {
1152                                 len = 2;
1153                                 if (len > maxlen)
1154                                         goto cleanup;
1155                                 *(p++) = 'r';
1156                                 *(p++) = 'o';
1157                                 maxlen -= 2;
1158                         }
1159
1160                         /* print ',' separator if there are other partitions
1161                          * following */
1162                         if (dev->num_parts > part_cnt) {
1163                                 if (1 > maxlen)
1164                                         goto cleanup;
1165                                 *(p++) = ',';
1166                                 maxlen--;
1167                         }
1168                         prev_part = part;
1169                 }
1170                 /* print ';' separator if there are other devices following */
1171                 if (dentry->next != &devices) {
1172                         if (1 > maxlen)
1173                                 goto cleanup;
1174                         *(p++) = ';';
1175                         maxlen--;
1176                 }
1177         }
1178
1179         /* we still have at least one char left, as we decremented maxlen at
1180          * the begining */
1181         *p = '\0';
1182
1183         return 0;
1184
1185 cleanup:
1186         last_parts[0] = '\0';
1187         return 1;
1188 }
1189
1190 /**
1191  * Call generate_mtdparts to process all devices and generate corresponding
1192  * mtdparts string, save it in mtdparts environment variable.
1193  *
1194  * @param buf output buffer holding generated mtdparts string (output)
1195  * @param buflen buffer size
1196  * @return 0 on success, 1 otherwise
1197  */
1198 static int generate_mtdparts_save(char *buf, u32 buflen)
1199 {
1200         int ret;
1201
1202         ret = generate_mtdparts(buf, buflen);
1203
1204         if ((buf[0] != '\0') && (ret == 0))
1205                 setenv("mtdparts", buf);
1206         else
1207                 setenv("mtdparts", NULL);
1208
1209         return ret;
1210 }
1211
1212 #if defined(CONFIG_CMD_MTDPARTS_SHOW_NET_SIZES)
1213 /**
1214  * Get the net size (w/o bad blocks) of the given partition.
1215  *
1216  * @param mtd the mtd info
1217  * @param part the partition
1218  * @return the calculated net size of this partition
1219  */
1220 static uint64_t net_part_size(struct mtd_info *mtd, struct part_info *part)
1221 {
1222         uint64_t i, net_size = 0;
1223
1224         if (!mtd->block_isbad)
1225                 return part->size;
1226
1227         for (i = 0; i < part->size; i += mtd->erasesize) {
1228                 if (!mtd->block_isbad(mtd, part->offset + i))
1229                         net_size += mtd->erasesize;
1230         }
1231
1232         return net_size;
1233 }
1234 #endif
1235
1236 static void show_ecc_stats(struct mtd_device *dev)
1237 {
1238         struct mtd_info *mtd;
1239
1240         if (get_mtd_info(dev->id->type, dev->id->num, &mtd))
1241                 return;
1242
1243         printf("ECC stats for device %s:\n", mtd->name);
1244         printf("  corrected bit flips:\t%4u\n", mtd->ecc_stats.corrected);
1245         printf("  uncorrectable errors:\t%4u\n", mtd->ecc_stats.failed);
1246 }
1247
1248 static void print_partition_table(void)
1249 {
1250         struct list_head *dentry, *pentry;
1251         struct part_info *part;
1252         struct mtd_device *dev;
1253         int part_num;
1254
1255         list_for_each(dentry, &devices) {
1256                 dev = list_entry(dentry, struct mtd_device, link);
1257                 /* list partitions for given device */
1258                 part_num = 0;
1259 #if defined(CONFIG_CMD_MTDPARTS_SHOW_NET_SIZES)
1260                 struct mtd_info *mtd;
1261
1262                 if (get_mtd_info(dev->id->type, dev->id->num, &mtd))
1263                         return;
1264
1265                 printf("\ndevice %s%d <%s>, # parts = %d\n",
1266                                 MTD_DEV_TYPE(dev->id->type), dev->id->num,
1267                                 dev->id->mtd_id, dev->num_parts);
1268                 printf(" #: name\t\tsize\t\tnet size\toffset\t\tmask_flags\n");
1269
1270                 list_for_each(pentry, &dev->parts) {
1271                         u32 net_size;
1272                         char *size_note;
1273
1274                         part = list_entry(pentry, struct part_info, link);
1275                         net_size = net_part_size(mtd, part);
1276                         size_note = part->size == net_size ? " " : " (!)";
1277                         printf("%2d: %-20s0x%08x\t0x%08x%s\t0x%08x\t%d\n",
1278                                         part_num, part->name, part->size,
1279                                         net_size, size_note, part->offset,
1280                                         part->mask_flags);
1281 #else /* !defined(CONFIG_CMD_MTDPARTS_SHOW_NET_SIZES) */
1282                 printf("\ndevice %s%d <%s>, # parts = %d\n",
1283                                 MTD_DEV_TYPE(dev->id->type), dev->id->num,
1284                                 dev->id->mtd_id, dev->num_parts);
1285                 printf(" #: name\t\tsize\t\toffset\t\tmask_flags\n");
1286
1287                 list_for_each(pentry, &dev->parts) {
1288                         part = list_entry(pentry, struct part_info, link);
1289                         printf("%2d: %-20s0x%08llx\t0x%08llx\t%d\n",
1290                                         part_num, part->name, part->size,
1291                                         part->offset, part->mask_flags);
1292 #endif /* defined(CONFIG_CMD_MTDPARTS_SHOW_NET_SIZES) */
1293                         part_num++;
1294                 }
1295                 show_ecc_stats(dev);
1296         }
1297
1298         if (list_empty(&devices))
1299                 printf("no partitions defined\n");
1300 }
1301
1302 /**
1303  * Format and print out a partition list for each device from global device
1304  * list.
1305  */
1306 static void list_partitions(void)
1307 {
1308         struct part_info *part;
1309
1310         debug("\n---list_partitions---\n");
1311         print_partition_table();
1312
1313         /* current_mtd_dev is not NULL only when we have non empty device list */
1314         if (current_mtd_dev) {
1315                 part = mtd_part_info(current_mtd_dev, current_mtd_partnum);
1316                 if (part) {
1317                         printf("\nactive partition: %s%d,%d - (%s) 0x%08llx @ 0x%08llx\n",
1318                                         MTD_DEV_TYPE(current_mtd_dev->id->type),
1319                                         current_mtd_dev->id->num, current_mtd_partnum,
1320                                         part->name, part->size, part->offset);
1321                 } else {
1322                         printf("could not get current partition info\n\n");
1323                 }
1324         }
1325
1326         printf("\ndefaults:\n");
1327         printf("mtdids  : %s\n",
1328                 mtdids_default ? mtdids_default : "none");
1329         /*
1330          * Using printf() here results in printbuffer overflow
1331          * if default mtdparts string is greater than console
1332          * printbuffer. Use puts() to prevent system crashes.
1333          */
1334         puts("mtdparts: ");
1335         puts(mtdparts_default ? mtdparts_default : "none");
1336         puts("\n");
1337 }
1338
1339 /**
1340  * Given partition identifier in form of <dev_type><dev_num>,<part_num> find
1341  * corresponding device and verify partition number.
1342  *
1343  * @param id string describing device and partition or partition name
1344  * @param dev pointer to the requested device (output)
1345  * @param part_num verified partition number (output)
1346  * @param part pointer to requested partition (output)
1347  * @return 0 on success, 1 otherwise
1348  */
1349 int find_dev_and_part(const char *id, struct mtd_device **dev,
1350                 u8 *part_num, struct part_info **part)
1351 {
1352         struct list_head *dentry, *pentry;
1353         u8 type, dnum, pnum;
1354         const char *p;
1355
1356         debug("--- find_dev_and_part ---\nid = %s\n", id);
1357
1358         list_for_each(dentry, &devices) {
1359                 *part_num = 0;
1360                 *dev = list_entry(dentry, struct mtd_device, link);
1361                 list_for_each(pentry, &(*dev)->parts) {
1362                         *part = list_entry(pentry, struct part_info, link);
1363                         if (strcmp((*part)->name, id) == 0)
1364                                 return 0;
1365                         (*part_num)++;
1366                 }
1367         }
1368
1369         p = id;
1370         *dev = NULL;
1371         *part = NULL;
1372         *part_num = 0;
1373
1374         if (mtd_id_parse(p, &p, &type, &dnum) != 0)
1375                 return 1;
1376
1377         if ((*p++ != ',') || (*p == '\0')) {
1378                 printf("no partition number specified\n");
1379                 return 1;
1380         }
1381         pnum = simple_strtoul(p, (char **)&p, 0);
1382         if (*p != '\0') {
1383                 printf("unexpected trailing character '%c'\n", *p);
1384                 return 1;
1385         }
1386
1387         if ((*dev = device_find(type, dnum)) == NULL) {
1388                 printf("no such device %s%d\n", MTD_DEV_TYPE(type), dnum);
1389                 return 1;
1390         }
1391
1392         if ((*part = mtd_part_info(*dev, pnum)) == NULL) {
1393                 printf("no such partition\n");
1394                 *dev = NULL;
1395                 return 1;
1396         }
1397
1398         *part_num = pnum;
1399
1400         return 0;
1401 }
1402
1403 /**
1404  * Find and delete partition. For partition id format see find_dev_and_part().
1405  *
1406  * @param id string describing device and partition
1407  * @return 0 on success, 1 otherwise
1408  */
1409 static int delete_partition(const char *id)
1410 {
1411         u8 pnum;
1412         struct mtd_device *dev;
1413         struct part_info *part;
1414
1415         if (find_dev_and_part(id, &dev, &pnum, &part) == 0) {
1416
1417                 debug("delete_partition: device = %s%d, partition %d = (%s) 0x%08llx@0x%08llx\n",
1418                                 MTD_DEV_TYPE(dev->id->type), dev->id->num, pnum,
1419                                 part->name, part->size, part->offset);
1420
1421                 if (part_del(dev, part) != 0)
1422                         return CMD_RET_FAILURE;
1423
1424                 if (generate_mtdparts_save(last_parts, MTDPARTS_MAXLEN) != 0) {
1425                         printf("generated mtdparts too long, resetting to null\n");
1426                         return CMD_RET_FAILURE;
1427                 }
1428                 return CMD_RET_SUCCESS;
1429         }
1430
1431         printf("partition %s not found\n", id);
1432         return CMD_RET_FAILURE;
1433 }
1434
1435 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
1436 /**
1437  * Increase the size of the given partition so that it's net size is at least
1438  * as large as the size member and such that the next partition would start on a
1439  * good block if it were adjacent to this partition.
1440  *
1441  * @param mtd the mtd device
1442  * @param part the partition
1443  * @param next_offset pointer to the offset of the next partition after this
1444  *                    partition's size has been modified (output)
1445  */
1446 static void spread_partition(struct mtd_info *mtd, struct part_info *part,
1447                              uint64_t *next_offset)
1448 {
1449         uint64_t net_size, padding_size = 0;
1450         int truncated;
1451
1452         mtd_get_len_incl_bad(mtd, part->offset, part->size, &net_size,
1453                              &truncated);
1454
1455         /*
1456          * Absorb bad blocks immediately following this
1457          * partition also into the partition, such that
1458          * the next partition starts with a good block.
1459          */
1460         if (!truncated) {
1461                 mtd_get_len_incl_bad(mtd, part->offset + net_size,
1462                                      mtd->erasesize, &padding_size, &truncated);
1463                 if (truncated)
1464                         padding_size = 0;
1465                 else
1466                         padding_size -= mtd->erasesize;
1467         }
1468
1469         if (truncated) {
1470                 printf("truncated partition %s to %lld bytes\n", part->name,
1471                        (uint64_t) net_size + padding_size);
1472         }
1473
1474         part->size = net_size + padding_size;
1475         *next_offset = part->offset + part->size;
1476 }
1477
1478 /**
1479  * Adjust all of the partition sizes, such that all partitions are at least
1480  * as big as their mtdparts environment variable sizes and they each start
1481  * on a good block.
1482  *
1483  * @return 0 on success, 1 otherwise
1484  */
1485 static int spread_partitions(void)
1486 {
1487         struct list_head *dentry, *pentry;
1488         struct mtd_device *dev;
1489         struct part_info *part;
1490         struct mtd_info *mtd;
1491         int part_num;
1492         uint64_t cur_offs;
1493
1494         list_for_each(dentry, &devices) {
1495                 dev = list_entry(dentry, struct mtd_device, link);
1496
1497                 if (get_mtd_info(dev->id->type, dev->id->num, &mtd))
1498                         return CMD_RET_FAILURE;
1499
1500                 part_num = 0;
1501                 cur_offs = 0;
1502                 list_for_each(pentry, &dev->parts) {
1503                         part = list_entry(pentry, struct part_info, link);
1504
1505                         debug("spread_partitions: device = %s%d, partition %d ="
1506                                 " (%s) 0x%08x@0x%08x\n",
1507                                 MTD_DEV_TYPE(dev->id->type), dev->id->num,
1508                                 part_num, part->name, part->size,
1509                                 part->offset);
1510
1511                         if (cur_offs > part->offset)
1512                                 part->offset = cur_offs;
1513
1514                         spread_partition(mtd, part, &cur_offs);
1515
1516                         part_num++;
1517                 }
1518         }
1519
1520         index_partitions();
1521
1522         if (generate_mtdparts_save(last_parts, MTDPARTS_MAXLEN) != 0) {
1523                 printf("generated mtdparts too long, resetting to null\n");
1524                 return CMD_RET_FAILURE;
1525         }
1526         return CMD_RET_SUCCESS;
1527 }
1528 #endif /* CONFIG_CMD_MTDPARTS_SPREAD */
1529
1530 /**
1531  * Accept character string describing mtd partitions and call device_parse()
1532  * for each entry. Add created devices to the global devices list.
1533  *
1534  * @param mtdparts string specifing mtd partitions
1535  * @return 0 on success, 1 otherwise
1536  */
1537 static int parse_mtdparts(const char *const mtdparts)
1538 {
1539         const char *p = mtdparts;
1540         struct mtd_device *dev;
1541         int err = 1;
1542         char tmp_parts[MTDPARTS_MAXLEN];
1543
1544         debug("\n---parse_mtdparts---\nmtdparts = %s\n\n", p);
1545
1546         /* delete all devices and partitions */
1547         if (mtd_devices_init() != 0) {
1548                 printf("could not initialise device list\n");
1549                 return err;
1550         }
1551
1552         /* re-read 'mtdparts' variable, mtd_devices_init may be updating env */
1553         if (gd->flags & GD_FLG_ENV_READY) {
1554                 p = getenv("mtdparts");
1555         } else {
1556                 p = tmp_parts;
1557                 getenv_f("mtdparts", tmp_parts, MTDPARTS_MAXLEN);
1558         }
1559
1560         if (strncmp(p, "mtdparts=", 9) != 0) {
1561                 printf("mtdparts variable doesn't start with 'mtdparts='\n");
1562                 return err;
1563         }
1564         p += 9;
1565
1566         while (p && (*p != '\0')) {
1567                 err = 1;
1568                 if ((device_parse(p, &p, &dev) != 0) || (!dev))
1569                         break;
1570
1571                 debug("+ device: %s\t%d\t%s\n", MTD_DEV_TYPE(dev->id->type),
1572                                 dev->id->num, dev->id->mtd_id);
1573
1574                 /* check if parsed device is already on the list */
1575                 if (device_find(dev->id->type, dev->id->num) != NULL) {
1576                         printf("device %s%d redefined, please correct mtdparts variable\n",
1577                                         MTD_DEV_TYPE(dev->id->type), dev->id->num);
1578                         break;
1579                 }
1580
1581                 list_add_tail(&dev->link, &devices);
1582                 err = 0;
1583         }
1584         if (err == 1) {
1585                 device_delall(&devices);
1586                 return 1;
1587         }
1588
1589         return 0;
1590 }
1591
1592 /**
1593  * Parse provided string describing mtdids mapping (see file header for mtdids
1594  * variable format). Allocate memory for each entry and add all found entries
1595  * to the global mtdids list.
1596  *
1597  * @param ids mapping string
1598  * @return 0 on success, 1 otherwise
1599  */
1600 static int parse_mtdids(const char *const ids)
1601 {
1602         const char *p = ids;
1603         const char *mtd_id;
1604         int mtd_id_len;
1605         struct mtdids *id;
1606         struct list_head *entry, *n;
1607         struct mtdids *id_tmp;
1608         u8 type, num;
1609         u64 size;
1610         int ret = 1;
1611
1612         debug("\n---parse_mtdids---\nmtdids = %s\n\n", ids);
1613
1614         /* clean global mtdids list */
1615         list_for_each_safe(entry, n, &mtdids) {
1616                 id_tmp = list_entry(entry, struct mtdids, link);
1617                 debug("mtdids del: %d %d\n", id_tmp->type, id_tmp->num);
1618                 list_del(entry);
1619                 free(id_tmp);
1620         }
1621         last_ids[0] = '\0';
1622         INIT_LIST_HEAD(&mtdids);
1623
1624         while(p && (*p != '\0')) {
1625
1626                 ret = 1;
1627                 /* parse 'nor'|'nand'|'onenand'<dev-num> */
1628                 if (mtd_id_parse(p, &p, &type, &num) != 0)
1629                         break;
1630
1631                 if (*p != '=') {
1632                         printf("mtdids: incorrect <dev-num>\n");
1633                         break;
1634                 }
1635                 p++;
1636
1637                 /* check if requested device exists */
1638                 if (mtd_device_validate(type, num, &size) != 0)
1639                         return 1;
1640
1641                 /* locate <mtd-id> */
1642                 mtd_id = p;
1643                 if ((p = strchr(mtd_id, ',')) != NULL) {
1644                         mtd_id_len = p - mtd_id + 1;
1645                         p++;
1646                 } else {
1647                         mtd_id_len = strlen(mtd_id) + 1;
1648                 }
1649                 if (mtd_id_len == 0) {
1650                         printf("mtdids: no <mtd-id> identifier\n");
1651                         break;
1652                 }
1653
1654                 /* check if this id is already on the list */
1655                 int double_entry = 0;
1656                 list_for_each(entry, &mtdids) {
1657                         id_tmp = list_entry(entry, struct mtdids, link);
1658                         if ((id_tmp->type == type) && (id_tmp->num == num)) {
1659                                 double_entry = 1;
1660                                 break;
1661                         }
1662                 }
1663                 if (double_entry) {
1664                         printf("device id %s%d redefined, please correct mtdids variable\n",
1665                                         MTD_DEV_TYPE(type), num);
1666                         break;
1667                 }
1668
1669                 /* allocate mtdids structure */
1670                 if (!(id = (struct mtdids *)malloc(sizeof(struct mtdids) + mtd_id_len))) {
1671                         printf("out of memory\n");
1672                         break;
1673                 }
1674                 memset(id, 0, sizeof(struct mtdids) + mtd_id_len);
1675                 id->num = num;
1676                 id->type = type;
1677                 id->size = size;
1678                 id->mtd_id = (char *)(id + 1);
1679                 strncpy(id->mtd_id, mtd_id, mtd_id_len - 1);
1680                 id->mtd_id[mtd_id_len - 1] = '\0';
1681                 INIT_LIST_HEAD(&id->link);
1682
1683                 debug("+ id %s%d\t%16lld bytes\t%s\n",
1684                                 MTD_DEV_TYPE(id->type), id->num,
1685                                 id->size, id->mtd_id);
1686
1687                 list_add_tail(&id->link, &mtdids);
1688                 ret = 0;
1689         }
1690         if (ret == 1) {
1691                 /* clean mtdids list and free allocated memory */
1692                 list_for_each_safe(entry, n, &mtdids) {
1693                         id_tmp = list_entry(entry, struct mtdids, link);
1694                         list_del(entry);
1695                         free(id_tmp);
1696                 }
1697                 return 1;
1698         }
1699
1700         return 0;
1701 }
1702
1703 /**
1704  * Parse and initialize global mtdids mapping and create global
1705  * device/partition list.
1706  *
1707  * @return 0 on success, 1 otherwise
1708  */
1709 int mtdparts_init(void)
1710 {
1711         static int initialized = 0;
1712         const char *ids, *parts;
1713         const char *current_partition;
1714         int ids_changed;
1715         char tmp_ep[PARTITION_MAXLEN];
1716         char tmp_parts[MTDPARTS_MAXLEN];
1717
1718         debug("\n---mtdparts_init---\n");
1719         if (!initialized) {
1720                 INIT_LIST_HEAD(&mtdids);
1721                 INIT_LIST_HEAD(&devices);
1722                 memset(last_ids, 0, MTDIDS_MAXLEN);
1723                 memset(last_parts, 0, MTDPARTS_MAXLEN);
1724                 memset(last_partition, 0, PARTITION_MAXLEN);
1725                 initialized = 1;
1726         }
1727
1728         /* get variables */
1729         ids = getenv("mtdids");
1730         /*
1731          * The mtdparts variable tends to be long. If we need to access it
1732          * before the env is relocated, then we need to use our own stack
1733          * buffer.  gd->env_buf will be too small.
1734          */
1735         if (gd->flags & GD_FLG_ENV_READY) {
1736                 parts = getenv("mtdparts");
1737         } else {
1738                 parts = tmp_parts;
1739                 getenv_f("mtdparts", tmp_parts, MTDPARTS_MAXLEN);
1740         }
1741         current_partition = getenv("partition");
1742
1743         /* save it for later parsing, cannot rely on current partition pointer
1744          * as 'partition' variable may be updated during init */
1745         tmp_ep[0] = '\0';
1746         if (current_partition)
1747                 strncpy(tmp_ep, current_partition, PARTITION_MAXLEN);
1748
1749         debug("last_ids  : %s\n", last_ids);
1750         debug("env_ids   : %s\n", ids);
1751         debug("last_parts: %s\n", last_parts);
1752         debug("env_parts : %s\n\n", parts);
1753
1754         debug("last_partition : %s\n", last_partition);
1755         debug("env_partition  : %s\n", current_partition);
1756
1757         /* if mtdids varible is empty try to use defaults */
1758         if (!ids) {
1759                 if (mtdids_default) {
1760                         debug("mtdids variable not defined, using default\n");
1761                         ids = mtdids_default;
1762                         setenv("mtdids", (char *)ids);
1763                 } else {
1764                         printf("mtdids not defined, no default present\n");
1765                         return 1;
1766                 }
1767         }
1768         if (strlen(ids) > MTDIDS_MAXLEN - 1) {
1769                 printf("mtdids too long (> %d)\n", MTDIDS_MAXLEN);
1770                 return 1;
1771         }
1772
1773         /* do no try to use defaults when mtdparts variable is not defined,
1774          * just check the length */
1775         if (!parts)
1776                 printf("mtdparts variable not set, see 'help mtdparts'\n");
1777
1778         if (parts && (strlen(parts) > MTDPARTS_MAXLEN - 1)) {
1779                 printf("mtdparts too long (> %d)\n", MTDPARTS_MAXLEN);
1780                 return 1;
1781         }
1782
1783         /* check if we have already parsed those mtdids */
1784         if ((last_ids[0] != '\0') && (strcmp(last_ids, ids) == 0)) {
1785                 ids_changed = 0;
1786         } else {
1787                 ids_changed = 1;
1788
1789                 if (parse_mtdids(ids) != 0) {
1790                         mtd_devices_init();
1791                         return 1;
1792                 }
1793
1794                 /* ok it's good, save new ids */
1795                 strncpy(last_ids, ids, MTDIDS_MAXLEN);
1796         }
1797
1798         /* parse partitions if either mtdparts or mtdids were updated */
1799         if (parts && ((last_parts[0] == '\0') || ((strcmp(last_parts, parts) != 0)) || ids_changed)) {
1800                 if (parse_mtdparts(parts) != 0)
1801                         return 1;
1802
1803                 if (list_empty(&devices)) {
1804                         printf("mtdparts_init: no valid partitions\n");
1805                         return 1;
1806                 }
1807
1808                 /* ok it's good, save new parts */
1809                 strncpy(last_parts, parts, MTDPARTS_MAXLEN);
1810
1811                 /* reset first partition from first dev from the list as current */
1812                 current_mtd_dev = list_entry(devices.next, struct mtd_device, link);
1813                 current_mtd_partnum = 0;
1814                 current_save();
1815
1816                 debug("mtdparts_init: current_mtd_dev  = %s%d, current_mtd_partnum = %d\n",
1817                                 MTD_DEV_TYPE(current_mtd_dev->id->type),
1818                                 current_mtd_dev->id->num, current_mtd_partnum);
1819         }
1820
1821         /* mtdparts variable was reset to NULL, delete all devices/partitions */
1822         if (!parts && (last_parts[0] != '\0'))
1823                 return mtd_devices_init();
1824
1825         /* do not process current partition if mtdparts variable is null */
1826         if (!parts)
1827                 return 0;
1828
1829         /* is current partition set in environment? if so, use it */
1830         if ((tmp_ep[0] != '\0') && (strcmp(tmp_ep, last_partition) != 0)) {
1831                 struct part_info *p;
1832                 struct mtd_device *cdev;
1833                 u8 pnum;
1834
1835                 debug("--- getting current partition: %s\n", tmp_ep);
1836
1837                 if (find_dev_and_part(tmp_ep, &cdev, &pnum, &p) == 0) {
1838                         current_mtd_dev = cdev;
1839                         current_mtd_partnum = pnum;
1840                         current_save();
1841                 }
1842         } else if (getenv("partition") == NULL) {
1843                 debug("no partition variable set, setting...\n");
1844                 current_save();
1845         }
1846
1847         return 0;
1848 }
1849
1850 /**
1851  * Return pointer to the partition of a requested number from a requested
1852  * device.
1853  *
1854  * @param dev device that is to be searched for a partition
1855  * @param part_num requested partition number
1856  * @return pointer to the part_info, NULL otherwise
1857  */
1858 static struct part_info* mtd_part_info(struct mtd_device *dev, unsigned int part_num)
1859 {
1860         struct list_head *entry;
1861         struct part_info *part;
1862         int num;
1863
1864         if (!dev)
1865                 return NULL;
1866
1867         debug("\n--- mtd_part_info: partition number %d for device %s%d (%s)\n",
1868                         part_num, MTD_DEV_TYPE(dev->id->type),
1869                         dev->id->num, dev->id->mtd_id);
1870
1871         if (part_num >= dev->num_parts) {
1872                 printf("invalid partition number %d for device %s%d (%s)\n",
1873                                 part_num, MTD_DEV_TYPE(dev->id->type),
1874                                 dev->id->num, dev->id->mtd_id);
1875                 return NULL;
1876         }
1877
1878         /* locate partition number, return it */
1879         num = 0;
1880         list_for_each(entry, &dev->parts) {
1881                 part = list_entry(entry, struct part_info, link);
1882
1883                 if (part_num == num++) {
1884                         return part;
1885                 }
1886         }
1887
1888         return NULL;
1889 }
1890
1891 /***************************************************/
1892 /* U-boot commands                                 */
1893 /***************************************************/
1894 /* command line only */
1895 /**
1896  * Routine implementing u-boot chpart command. Sets new current partition based
1897  * on the user supplied partition id. For partition id format see find_dev_and_part().
1898  *
1899  * @param cmdtp command internal data
1900  * @param flag command flag
1901  * @param argc number of arguments supplied to the command
1902  * @param argv arguments list
1903  * @return 0 on success, 1 otherwise
1904  */
1905 static int do_chpart(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
1906 {
1907 /* command line only */
1908         struct mtd_device *dev;
1909         struct part_info *part;
1910         u8 pnum;
1911
1912         if (mtdparts_init() !=0)
1913                 return CMD_RET_FAILURE;
1914
1915         if (argc < 2) {
1916                 printf("no partition id specified\n");
1917                 return CMD_RET_FAILURE;
1918         }
1919
1920         if (find_dev_and_part(argv[1], &dev, &pnum, &part) != 0)
1921                 return CMD_RET_FAILURE;
1922
1923         current_mtd_dev = dev;
1924         current_mtd_partnum = pnum;
1925         current_save();
1926
1927         printf("partition changed to %s%d,%d\n",
1928                         MTD_DEV_TYPE(dev->id->type), dev->id->num, pnum);
1929
1930         return CMD_RET_SUCCESS;
1931 }
1932
1933 /**
1934  * Routine implementing u-boot mtdparts command. Initialize/update default global
1935  * partition list and process user partition request (list, add, del).
1936  *
1937  * @param cmdtp command internal data
1938  * @param flag command flag
1939  * @param argc number of arguments supplied to the command
1940  * @param argv arguments list
1941  * @return 0 on success, 1 otherwise
1942  */
1943 static int do_mtdparts(cmd_tbl_t *cmdtp, int flag, int argc,
1944                        char * const argv[])
1945 {
1946         if (argc == 2) {
1947                 if (strcmp(argv[1], "default") == 0) {
1948                         setenv("mtdids", (char *)mtdids_default);
1949                         setenv("mtdparts", (char *)mtdparts_default);
1950                         setenv("partition", NULL);
1951
1952                         mtdparts_init();
1953                         return 0;
1954                 } else if (strcmp(argv[1], "delall") == 0) {
1955                         /* this may be the first run, initialize lists if needed */
1956                         mtdparts_init();
1957
1958                         setenv("mtdparts", NULL);
1959
1960                         /* mtd_devices_init() calls current_save() */
1961                         return mtd_devices_init() ? CMD_RET_FAILURE :
1962                                 CMD_RET_SUCCESS;
1963                 }
1964         }
1965
1966         /* make sure we are in sync with env variables */
1967         if (mtdparts_init() != 0)
1968                 return CMD_RET_FAILURE;
1969
1970         if (argc == 1) {
1971                 list_partitions();
1972                 return CMD_RET_SUCCESS;
1973         }
1974
1975         /* mtdparts add <mtd-dev> <size>[@<offset>] <name> [ro] */
1976         if (((argc == 5) || (argc == 6)) && (strncmp(argv[1], "add", 3) == 0)) {
1977 #define PART_ADD_DESC_MAXLEN 64
1978                 char tmpbuf[PART_ADD_DESC_MAXLEN];
1979 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
1980                 struct mtd_info *mtd;
1981                 uint64_t next_offset;
1982 #endif
1983                 u8 type, num, len;
1984                 struct mtd_device *dev;
1985                 struct mtd_device *dev_tmp;
1986                 struct mtdids *id;
1987                 struct part_info *p;
1988
1989                 if (mtd_id_parse(argv[2], NULL, &type, &num) != 0)
1990                         return CMD_RET_FAILURE;
1991
1992                 if ((id = id_find(type, num)) == NULL) {
1993                         printf("no such device %s defined in mtdids variable\n", argv[2]);
1994                         return CMD_RET_FAILURE;
1995                 }
1996
1997                 len = strlen(id->mtd_id) + 1;   /* 'mtd_id:' */
1998                 len += strlen(argv[3]);         /* size@offset */
1999                 len += strlen(argv[4]) + 2;     /* '(' name ')' */
2000                 if (argv[5] && (strlen(argv[5]) == 2))
2001                         len += 2;               /* 'ro' */
2002
2003                 if (len >= PART_ADD_DESC_MAXLEN) {
2004                         printf("too long partition description\n");
2005                         return CMD_RET_FAILURE;
2006                 }
2007                 sprintf(tmpbuf, "%s:%s(%s)%s",
2008                                 id->mtd_id, argv[3], argv[4], argv[5] ? argv[5] : "");
2009                 debug("add tmpbuf: %s\n", tmpbuf);
2010
2011                 if ((device_parse(tmpbuf, NULL, &dev) != 0) || (!dev))
2012                         return CMD_RET_FAILURE;
2013
2014                 debug("+ %s\t%d\t%s\n", MTD_DEV_TYPE(dev->id->type),
2015                                 dev->id->num, dev->id->mtd_id);
2016
2017                 p = list_entry(dev->parts.next, struct part_info, link);
2018
2019 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
2020                 if (get_mtd_info(dev->id->type, dev->id->num, &mtd))
2021                         return CMD_RET_FAILURE;
2022
2023                 if (!strcmp(&argv[1][3], ".spread")) {
2024                         spread_partition(mtd, p, &next_offset);
2025                         debug("increased %s to %d bytes\n", p->name, p->size);
2026                 }
2027 #endif
2028
2029                 dev_tmp = device_find(dev->id->type, dev->id->num);
2030                 if (dev_tmp == NULL) {
2031                         device_add(dev);
2032                 } else if (part_add(dev_tmp, p) != 0) {
2033                         /* merge new partition with existing ones*/
2034                         device_del(dev);
2035                         return CMD_RET_FAILURE;
2036                 }
2037
2038                 if (generate_mtdparts_save(last_parts, MTDPARTS_MAXLEN) != 0) {
2039                         printf("generated mtdparts too long, resetting to null\n");
2040                         return CMD_RET_FAILURE;
2041                 }
2042
2043                 return CMD_RET_SUCCESS;
2044         }
2045
2046         /* mtdparts del part-id */
2047         if ((argc == 3) && (strcmp(argv[1], "del") == 0)) {
2048                 debug("del: part-id = %s\n", argv[2]);
2049
2050                 return delete_partition(argv[2]);
2051         }
2052
2053 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
2054         if ((argc == 2) && (strcmp(argv[1], "spread") == 0))
2055                 return spread_partitions();
2056 #endif /* CONFIG_CMD_MTDPARTS_SPREAD */
2057
2058         return CMD_RET_USAGE;
2059 }
2060
2061 /***************************************************/
2062 U_BOOT_CMD(
2063         chpart, 2,      0,      do_chpart,
2064         "change active partition",
2065         "part-id\n"
2066         "    - change active partition (e.g. part-id = nand0,1)"
2067 );
2068
2069 #ifdef CONFIG_SYS_LONGHELP
2070 static char mtdparts_help_text[] =
2071         "\n"
2072         "    - list partition table\n"
2073         "mtdparts delall\n"
2074         "    - delete all partitions\n"
2075         "mtdparts del part-id\n"
2076         "    - delete partition (e.g. part-id = nand0,1)\n"
2077         "mtdparts add <mtd-dev> <size>[@<offset>] [<name>] [ro]\n"
2078         "    - add partition\n"
2079 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
2080         "mtdparts add.spread <mtd-dev> <size>[@<offset>] [<name>] [ro]\n"
2081         "    - add partition, padding size by skipping bad blocks\n"
2082 #endif
2083         "mtdparts default\n"
2084         "    - reset partition table to defaults\n"
2085 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
2086         "mtdparts spread\n"
2087         "    - adjust the sizes of the partitions so they are\n"
2088         "      at least as big as the mtdparts variable specifies\n"
2089         "      and they each start on a good block\n\n"
2090 #else
2091         "\n"
2092 #endif /* CONFIG_CMD_MTDPARTS_SPREAD */
2093         "-----\n\n"
2094         "this command uses three environment variables:\n\n"
2095         "'partition' - keeps current partition identifier\n\n"
2096         "partition  := <part-id>\n"
2097         "<part-id>  := <dev-id>,part_num\n\n"
2098         "'mtdids' - linux kernel mtd device id <-> u-boot device id mapping\n\n"
2099         "mtdids=<idmap>[,<idmap>,...]\n\n"
2100         "<idmap>    := <dev-id>=<mtd-id>\n"
2101         "<dev-id>   := 'nand'|'nor'|'onenand'<dev-num>\n"
2102         "<dev-num>  := mtd device number, 0...\n"
2103         "<mtd-id>   := unique device tag used by linux kernel to find mtd device (mtd->name)\n\n"
2104         "'mtdparts' - partition list\n\n"
2105         "mtdparts=mtdparts=<mtd-def>[;<mtd-def>...]\n\n"
2106         "<mtd-def>  := <mtd-id>:<part-def>[,<part-def>...]\n"
2107         "<mtd-id>   := unique device tag used by linux kernel to find mtd device (mtd->name)\n"
2108         "<part-def> := <size>[@<offset>][<name>][<ro-flag>]\n"
2109         "<size>     := standard linux memsize OR '-' to denote all remaining space\n"
2110         "<offset>   := partition start offset within the device\n"
2111         "<name>     := '(' NAME ')'\n"
2112         "<ro-flag>  := when set to 'ro' makes partition read-only (not used, passed to kernel)";
2113 #endif
2114
2115 U_BOOT_CMD(
2116         mtdparts,       6,      0,      do_mtdparts,
2117         "define flash/nand partitions", mtdparts_help_text
2118 );
2119 /***************************************************/