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