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