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 <log.h>
77 #include <malloc.h>
78 #include <asm/global_data.h>
79 #include <jffs2/load_kernel.h>
80 #include <linux/list.h>
81 #include <linux/ctype.h>
82 #include <linux/err.h>
83 #include <linux/mtd/mtd.h>
84 
85 #if defined(CONFIG_CMD_NAND)
86 #include <linux/mtd/rawnand.h>
87 #include <nand.h>
88 #endif
89 
90 #if defined(CONFIG_CMD_ONENAND)
91 #include <linux/mtd/onenand.h>
92 #include <onenand_uboot.h>
93 #endif
94 
95 DECLARE_GLOBAL_DATA_PTR;
96 
97 /* special size referring to all the remaining space in a partition */
98 #define SIZE_REMAINING		(~0llu)
99 
100 /* special offset value, it is used when not provided by user
101  *
102  * this value is used temporarily during parsing, later such offests
103  * are recalculated */
104 #define OFFSET_NOT_SPECIFIED	(~0llu)
105 
106 /* minimum partition size */
107 #define MIN_PART_SIZE		4096
108 
109 /* this flag needs to be set in part_info struct mask_flags
110  * field for read-only partitions */
111 #define MTD_WRITEABLE_CMD		1
112 
113 /* default values for mtdids and mtdparts variables */
114 #if !defined(MTDIDS_DEFAULT)
115 #ifdef CONFIG_MTDIDS_DEFAULT
116 #define MTDIDS_DEFAULT CONFIG_MTDIDS_DEFAULT
117 #else
118 #define MTDIDS_DEFAULT NULL
119 #endif
120 #endif
121 #if !defined(MTDPARTS_DEFAULT)
122 #ifdef CONFIG_MTDPARTS_DEFAULT
123 #define MTDPARTS_DEFAULT CONFIG_MTDPARTS_DEFAULT
124 #else
125 #define MTDPARTS_DEFAULT NULL
126 #endif
127 #endif
128 #if defined(CONFIG_SYS_MTDPARTS_RUNTIME)
129 extern void board_mtdparts_default(const char **mtdids, const char **mtdparts);
130 #endif
131 static const char *mtdids_default = MTDIDS_DEFAULT;
132 static const char *mtdparts_default = MTDPARTS_DEFAULT;
133 
134 /* copies of last seen 'mtdids', 'mtdparts' and 'partition' env variables */
135 #define MTDIDS_MAXLEN		128
136 #define MTDPARTS_MAXLEN		512
137 #define PARTITION_MAXLEN	16
138 static char last_ids[MTDIDS_MAXLEN + 1];
139 static char last_parts[MTDPARTS_MAXLEN + 1];
140 static char last_partition[PARTITION_MAXLEN + 1];
141 
142 /* low level jffs2 cache cleaning routine */
143 extern void jffs2_free_cache(struct part_info *part);
144 
145 /* mtdids mapping list, filled by parse_ids() */
146 static struct list_head mtdids;
147 
148 /* device/partition list, parse_cmdline() parses into here */
149 static struct list_head devices;
150 
151 /* current active device and partition number */
152 struct mtd_device *current_mtd_dev = NULL;
153 u8 current_mtd_partnum = 0;
154 
155 u8 use_defaults;
156 
157 static struct part_info* mtd_part_info(struct mtd_device *dev, unsigned int part_num);
158 
159 /* command line only routines */
160 static struct mtdids* id_find_by_mtd_id(const char *mtd_id, unsigned int mtd_id_len);
161 static int device_del(struct mtd_device *dev);
162 
163 /**
164  * Parses a string into a number.  The number stored at ptr is
165  * potentially suffixed with K (for kilobytes, or 1024 bytes),
166  * M (for megabytes, or 1048576 bytes), or G (for gigabytes, or
167  * 1073741824).  If the number is suffixed with K, M, or G, then
168  * the return value is the number multiplied by one kilobyte, one
169  * megabyte, or one gigabyte, respectively.
170  *
171  * @param ptr where parse begins
172  * @param retptr output pointer to next char after parse completes (output)
173  * @return resulting unsigned int
174  */
memsize_parse(const char * const ptr,const char ** retptr)175 static u64 memsize_parse (const char *const ptr, const char **retptr)
176 {
177 	u64 ret = simple_strtoull(ptr, (char **)retptr, 0);
178 
179 	switch (**retptr) {
180 		case 'G':
181 		case 'g':
182 			ret <<= 10;
183 			/* Fallthrough */
184 		case 'M':
185 		case 'm':
186 			ret <<= 10;
187 			/* Fallthrough */
188 		case 'K':
189 		case 'k':
190 			ret <<= 10;
191 			(*retptr)++;
192 			/* Fallthrough */
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  */
memsize_format(char * buf,u64 size)211 static void memsize_format(char *buf, u64 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, "%llug", size/SIZE_GB);
219 	else if ((size % SIZE_MB) == 0)
220 		sprintf(buf, "%llum", size/SIZE_MB);
221 	else if (size % SIZE_KB == 0)
222 		sprintf(buf, "%lluk", size/SIZE_KB);
223 	else
224 		sprintf(buf, "%llu", 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  */
index_partitions(void)232 static void index_partitions(void)
233 {
234 	u16 mtddevnum;
235 	struct part_info *part;
236 	struct list_head *dentry;
237 	struct mtd_device *dev;
238 
239 	debug("--- index partitions ---\n");
240 
241 	if (current_mtd_dev) {
242 		mtddevnum = 0;
243 		list_for_each(dentry, &devices) {
244 			dev = list_entry(dentry, struct mtd_device, link);
245 			if (dev == current_mtd_dev) {
246 				mtddevnum += current_mtd_partnum;
247 				env_set_ulong("mtddevnum", mtddevnum);
248 				debug("=> mtddevnum %d,\n", mtddevnum);
249 				break;
250 			}
251 			mtddevnum += dev->num_parts;
252 		}
253 
254 		part = mtd_part_info(current_mtd_dev, current_mtd_partnum);
255 		if (part) {
256 			env_set("mtddevname", part->name);
257 
258 			debug("=> mtddevname %s\n", part->name);
259 		} else {
260 			env_set("mtddevname", NULL);
261 
262 			debug("=> mtddevname NULL\n");
263 		}
264 	} else {
265 		env_set("mtddevnum", NULL);
266 		env_set("mtddevname", NULL);
267 
268 		debug("=> mtddevnum NULL\n=> mtddevname NULL\n");
269 	}
270 }
271 
272 /**
273  * Save current device and partition in environment variable 'partition'.
274  */
current_save(void)275 static void current_save(void)
276 {
277 	char buf[16];
278 
279 	debug("--- current_save ---\n");
280 
281 	if (current_mtd_dev) {
282 		sprintf(buf, "%s%d,%d", MTD_DEV_TYPE(current_mtd_dev->id->type),
283 					current_mtd_dev->id->num, current_mtd_partnum);
284 
285 		env_set("partition", buf);
286 		strncpy(last_partition, buf, 16);
287 
288 		debug("=> partition %s\n", buf);
289 	} else {
290 		env_set("partition", NULL);
291 		last_partition[0] = '\0';
292 
293 		debug("=> partition NULL\n");
294 	}
295 	index_partitions();
296 }
297 
298 
299 /**
300  * Produce a mtd_info given a type and num.
301  *
302  * @param type mtd type
303  * @param num mtd number
304  * @param mtd a pointer to an mtd_info instance (output)
305  * @return 0 if device is valid, 1 otherwise
306  */
get_mtd_info(u8 type,u8 num,struct mtd_info ** mtd)307 static int get_mtd_info(u8 type, u8 num, struct mtd_info **mtd)
308 {
309 	char mtd_dev[16];
310 
311 	sprintf(mtd_dev, "%s%d", MTD_DEV_TYPE(type), num);
312 	*mtd = get_mtd_device_nm(mtd_dev);
313 	if (IS_ERR(*mtd)) {
314 		printf("Device %s not found!\n", mtd_dev);
315 		return 1;
316 	}
317 	put_mtd_device(*mtd);
318 
319 	return 0;
320 }
321 
322 /**
323  * Performs sanity check for supplied flash partition.
324  * Table of existing MTD flash devices is searched and partition device
325  * is located. Alignment with the granularity of nand erasesize is verified.
326  *
327  * @param id of the parent device
328  * @param part partition to validate
329  * @return 0 if partition is valid, 1 otherwise
330  */
part_validate_eraseblock(struct mtdids * id,struct part_info * part)331 static int part_validate_eraseblock(struct mtdids *id, struct part_info *part)
332 {
333 	struct mtd_info *mtd = NULL;
334 	int i, j;
335 	ulong start;
336 	u64 offset, size;
337 
338 	if (get_mtd_info(id->type, id->num, &mtd))
339 		return 1;
340 
341 	part->sector_size = mtd->erasesize;
342 
343 	if (!mtd->numeraseregions) {
344 		/*
345 		 * Only one eraseregion (NAND, SPI-NAND, OneNAND or uniform NOR),
346 		 * checking for alignment is easy here
347 		 */
348 		offset = part->offset;
349 		if (do_div(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 		size = part->size;
357 		if (do_div(size, mtd->erasesize)) {
358 			printf("%s%d: partition (%s) size alignment incorrect\n",
359 			       MTD_DEV_TYPE(id->type), id->num, part->name);
360 			return 1;
361 		}
362 	} else {
363 		/*
364 		 * Multiple eraseregions (non-uniform NOR),
365 		 * checking for alignment is more complex here
366 		 */
367 
368 		/* Check start alignment */
369 		for (i = 0; i < mtd->numeraseregions; i++) {
370 			start = mtd->eraseregions[i].offset;
371 			for (j = 0; j < mtd->eraseregions[i].numblocks; j++) {
372 				if (part->offset == start)
373 					goto start_ok;
374 				start += mtd->eraseregions[i].erasesize;
375 			}
376 		}
377 
378 		printf("%s%d: partition (%s) start offset alignment incorrect\n",
379 		       MTD_DEV_TYPE(id->type), id->num, part->name);
380 		return 1;
381 
382 	start_ok:
383 
384 		/* Check end/size alignment */
385 		for (i = 0; i < mtd->numeraseregions; i++) {
386 			start = mtd->eraseregions[i].offset;
387 			for (j = 0; j < mtd->eraseregions[i].numblocks; j++) {
388 				if ((part->offset + part->size) == start)
389 					goto end_ok;
390 				start += mtd->eraseregions[i].erasesize;
391 			}
392 		}
393 		/* Check last sector alignment */
394 		if ((part->offset + part->size) == start)
395 			goto end_ok;
396 
397 		printf("%s%d: partition (%s) size alignment incorrect\n",
398 		       MTD_DEV_TYPE(id->type), id->num, part->name);
399 		return 1;
400 
401 	end_ok:
402 		return 0;
403 	}
404 
405 	return 0;
406 }
407 
408 
409 /**
410  * Performs sanity check for supplied partition. Offset and size are
411  * verified to be within valid range. Partition type is checked and
412  * part_validate_eraseblock() is called with the argument 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  */
part_validate(struct mtdids * id,struct part_info * part)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 %08llx beyond flash size %08llx\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 partition 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  */
part_del(struct mtd_device * dev,struct part_info * part)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  */
part_delall(struct list_head * head)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  */
part_sort_add(struct mtd_device * dev,struct part_info * part)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  */
part_add(struct mtd_device * dev,struct part_info * part)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  */
part_parse(const char * const partdef,const char ** ret,struct part_info ** retpart)604 static int part_parse(const char *const partdef, const char **ret, struct part_info **retpart)
605 {
606 	struct part_info *part;
607 	u64 size;
608 	u64 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 (%llx)\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 		snprintf(part->name, name_len, "0x%08llx@0x%08llx", 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%08llx offset 0x%08llx 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  */
mtd_device_validate(u8 type,u8 num,u64 * size)722 static int mtd_device_validate(u8 type, u8 num, u64 *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  */
device_delall(struct list_head * head)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  */
device_del(struct mtd_device * dev)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  */
device_find(u8 type,u8 num)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  */
device_add(struct mtd_device * dev)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  */
device_parse(const char * const mtd_dev,const char ** ret,struct mtd_device ** retdev)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;
851 	const char *pend;
852 	LIST_HEAD(tmp_list);
853 	struct list_head *entry, *n;
854 	u16 num_parts;
855 	u64 offset;
856 	int err = 1;
857 
858 	debug("===device_parse===\n");
859 
860 	assert(retdev);
861 	*retdev = NULL;
862 
863 	if (ret)
864 		*ret = NULL;
865 
866 	/* fetch <mtd-id> */
867 	mtd_id = p = mtd_dev;
868 	if (!(p = strchr(mtd_id, ':'))) {
869 		printf("no <mtd-id> identifier\n");
870 		return 1;
871 	}
872 	mtd_id_len = p - mtd_id + 1;
873 	p++;
874 
875 	/* verify if we have a valid device specified */
876 	if ((id = id_find_by_mtd_id(mtd_id, mtd_id_len - 1)) == NULL) {
877 		printf("invalid mtd device '%.*s'\n", mtd_id_len - 1, mtd_id);
878 		return 1;
879 	}
880 
881 	pend = strchr(p, ';');
882 	debug("dev type = %d (%s), dev num = %d, mtd-id = %s\n",
883 			id->type, MTD_DEV_TYPE(id->type),
884 			id->num, id->mtd_id);
885 	debug("parsing partitions %.*s\n", (int)(pend ? pend - p : strlen(p)), p);
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 	debug("\ntotal partitions: %d\n", num_parts);
925 
926 	/* check for next device presence */
927 	if (p) {
928 		if (*p == ';') {
929 			if (ret)
930 				*ret = ++p;
931 		} else if (*p == '\0') {
932 			if (ret)
933 				*ret = p;
934 		} else {
935 			printf("unexpected character '%c' at the end of device\n", *p);
936 			if (ret)
937 				*ret = NULL;
938 			return 1;
939 		}
940 	}
941 
942 	/* allocate memory for mtd_device structure */
943 	if ((dev = (struct mtd_device *)malloc(sizeof(struct mtd_device))) == NULL) {
944 		printf("out of memory\n");
945 		return 1;
946 	}
947 	memset(dev, 0, sizeof(struct mtd_device));
948 	dev->id = id;
949 	dev->num_parts = 0; /* part_sort_add increments num_parts */
950 	INIT_LIST_HEAD(&dev->parts);
951 	INIT_LIST_HEAD(&dev->link);
952 
953 	/* move partitions from tmp_list to dev->parts */
954 	list_for_each_safe(entry, n, &tmp_list) {
955 		part = list_entry(entry, struct part_info, link);
956 		list_del(entry);
957 		if (part_sort_add(dev, part) != 0) {
958 			device_del(dev);
959 			return 1;
960 		}
961 	}
962 
963 	*retdev = dev;
964 
965 	debug("===\n\n");
966 	return 0;
967 }
968 
969 /**
970  * Initialize global device list.
971  *
972  * @return 0 on success, 1 otherwise
973  */
mtd_devices_init(void)974 static int mtd_devices_init(void)
975 {
976 	last_parts[0] = '\0';
977 	current_mtd_dev = NULL;
978 	current_save();
979 
980 	return device_delall(&devices);
981 }
982 
983 /*
984  * Search global mtdids list and find id of requested type and number.
985  *
986  * @return pointer to the id if it exists, NULL otherwise
987  */
id_find(u8 type,u8 num)988 static struct mtdids* id_find(u8 type, u8 num)
989 {
990 	struct list_head *entry;
991 	struct mtdids *id;
992 
993 	list_for_each(entry, &mtdids) {
994 		id = list_entry(entry, struct mtdids, link);
995 
996 		if ((id->type == type) && (id->num == num))
997 			return id;
998 	}
999 
1000 	return NULL;
1001 }
1002 
1003 /**
1004  * Search global mtdids list and find id of a requested mtd_id.
1005  *
1006  * Note: first argument is not null terminated.
1007  *
1008  * @param mtd_id string containing requested mtd_id
1009  * @param mtd_id_len length of supplied mtd_id
1010  * @return pointer to the id if it exists, NULL otherwise
1011  */
id_find_by_mtd_id(const char * mtd_id,unsigned int mtd_id_len)1012 static struct mtdids* id_find_by_mtd_id(const char *mtd_id, unsigned int mtd_id_len)
1013 {
1014 	struct list_head *entry;
1015 	struct mtdids *id;
1016 
1017 	debug("--- id_find_by_mtd_id: '%.*s' (len = %d)\n",
1018 			mtd_id_len, mtd_id, mtd_id_len);
1019 
1020 	list_for_each(entry, &mtdids) {
1021 		id = list_entry(entry, struct mtdids, link);
1022 
1023 		debug("entry: '%s' (len = %zu)\n",
1024 				id->mtd_id, strlen(id->mtd_id));
1025 
1026 		if (mtd_id_len != strlen(id->mtd_id))
1027 			continue;
1028 		if (strncmp(id->mtd_id, mtd_id, mtd_id_len) == 0)
1029 			return id;
1030 	}
1031 
1032 	return NULL;
1033 }
1034 
1035 /**
1036  * Parse device id string <dev-id> := 'nand'|'nor'|'onenand'|'spi-nand'<dev-num>,
1037  * return device type and number.
1038  *
1039  * @param id string describing device id
1040  * @param ret_id output pointer to next char after parse completes (output)
1041  * @param dev_type parsed device type (output)
1042  * @param dev_num parsed device number (output)
1043  * @return 0 on success, 1 otherwise
1044  */
mtd_id_parse(const char * id,const char ** ret_id,u8 * dev_type,u8 * dev_num)1045 int mtd_id_parse(const char *id, const char **ret_id, u8 *dev_type,
1046 		 u8 *dev_num)
1047 {
1048 	const char *p = id;
1049 
1050 	*dev_type = 0;
1051 	if (strncmp(p, "nand", 4) == 0) {
1052 		*dev_type = MTD_DEV_TYPE_NAND;
1053 		p += 4;
1054 	} else if (strncmp(p, "nor", 3) == 0) {
1055 		*dev_type = MTD_DEV_TYPE_NOR;
1056 		p += 3;
1057 	} else if (strncmp(p, "onenand", 7) == 0) {
1058 		*dev_type = MTD_DEV_TYPE_ONENAND;
1059 		p += 7;
1060 	} else if (strncmp(p, "spi-nand", 8) == 0) {
1061 		*dev_type = MTD_DEV_TYPE_SPINAND;
1062 		p += 8;
1063 	} else {
1064 		printf("incorrect device type in %s\n", id);
1065 		return 1;
1066 	}
1067 
1068 	if (!isdigit(*p)) {
1069 		printf("incorrect device number in %s\n", id);
1070 		return 1;
1071 	}
1072 
1073 	*dev_num = simple_strtoul(p, (char **)&p, 0);
1074 	if (ret_id)
1075 		*ret_id = p;
1076 	return 0;
1077 }
1078 
1079 /**
1080  * Process all devices and generate corresponding mtdparts string describing
1081  * all partitions on all devices.
1082  *
1083  * @param buf output buffer holding generated mtdparts string (output)
1084  * @param buflen buffer size
1085  * @return 0 on success, 1 otherwise
1086  */
generate_mtdparts(char * buf,u32 buflen)1087 static int generate_mtdparts(char *buf, u32 buflen)
1088 {
1089 	struct list_head *pentry, *dentry;
1090 	struct mtd_device *dev;
1091 	struct part_info *part, *prev_part;
1092 	char *p = buf;
1093 	char tmpbuf[32];
1094 	u64 size, offset;
1095 	u32 len, part_cnt;
1096 	u32 maxlen = buflen - 1;
1097 
1098 	debug("--- generate_mtdparts ---\n");
1099 
1100 	if (list_empty(&devices)) {
1101 		buf[0] = '\0';
1102 		return 0;
1103 	}
1104 
1105 	list_for_each(dentry, &devices) {
1106 		dev = list_entry(dentry, struct mtd_device, link);
1107 
1108 		/* copy mtd_id */
1109 		len = strlen(dev->id->mtd_id) + 1;
1110 		if (len > maxlen)
1111 			goto cleanup;
1112 		memcpy(p, dev->id->mtd_id, len - 1);
1113 		p += len - 1;
1114 		*(p++) = ':';
1115 		maxlen -= len;
1116 
1117 		/* format partitions */
1118 		prev_part = NULL;
1119 		part_cnt = 0;
1120 		list_for_each(pentry, &dev->parts) {
1121 			part = list_entry(pentry, struct part_info, link);
1122 			size = part->size;
1123 			offset = part->offset;
1124 			part_cnt++;
1125 
1126 			/* partition size */
1127 			memsize_format(tmpbuf, size);
1128 			len = strlen(tmpbuf);
1129 			if (len > maxlen)
1130 				goto cleanup;
1131 			memcpy(p, tmpbuf, len);
1132 			p += len;
1133 			maxlen -= len;
1134 
1135 
1136 			/* add offset only when there is a gap between
1137 			 * partitions */
1138 			if ((!prev_part && (offset != 0)) ||
1139 					(prev_part && ((prev_part->offset + prev_part->size) != part->offset))) {
1140 
1141 				memsize_format(tmpbuf, offset);
1142 				len = strlen(tmpbuf) + 1;
1143 				if (len > maxlen)
1144 					goto cleanup;
1145 				*(p++) = '@';
1146 				memcpy(p, tmpbuf, len - 1);
1147 				p += len - 1;
1148 				maxlen -= len;
1149 			}
1150 
1151 			/* copy name only if user supplied */
1152 			if(!part->auto_name) {
1153 				len = strlen(part->name) + 2;
1154 				if (len > maxlen)
1155 					goto cleanup;
1156 
1157 				*(p++) = '(';
1158 				memcpy(p, part->name, len - 2);
1159 				p += len - 2;
1160 				*(p++) = ')';
1161 				maxlen -= len;
1162 			}
1163 
1164 			/* ro mask flag */
1165 			if (part->mask_flags && MTD_WRITEABLE_CMD) {
1166 				len = 2;
1167 				if (len > maxlen)
1168 					goto cleanup;
1169 				*(p++) = 'r';
1170 				*(p++) = 'o';
1171 				maxlen -= 2;
1172 			}
1173 
1174 			/* print ',' separator if there are other partitions
1175 			 * following */
1176 			if (dev->num_parts > part_cnt) {
1177 				if (1 > maxlen)
1178 					goto cleanup;
1179 				*(p++) = ',';
1180 				maxlen--;
1181 			}
1182 			prev_part = part;
1183 		}
1184 		/* print ';' separator if there are other devices following */
1185 		if (dentry->next != &devices) {
1186 			if (1 > maxlen)
1187 				goto cleanup;
1188 			*(p++) = ';';
1189 			maxlen--;
1190 		}
1191 	}
1192 
1193 	/* we still have at least one char left, as we decremented maxlen at
1194 	 * the begining */
1195 	*p = '\0';
1196 
1197 	return 0;
1198 
1199 cleanup:
1200 	last_parts[0] = '\0';
1201 	return 1;
1202 }
1203 
1204 /**
1205  * Call generate_mtdparts to process all devices and generate corresponding
1206  * mtdparts string, save it in mtdparts environment variable.
1207  *
1208  * @param buf output buffer holding generated mtdparts string (output)
1209  * @param buflen buffer size
1210  * @return 0 on success, 1 otherwise
1211  */
generate_mtdparts_save(char * buf,u32 buflen)1212 static int generate_mtdparts_save(char *buf, u32 buflen)
1213 {
1214 	int ret;
1215 
1216 	ret = generate_mtdparts(buf, buflen);
1217 
1218 	if ((buf[0] != '\0') && (ret == 0))
1219 		env_set("mtdparts", buf);
1220 	else
1221 		env_set("mtdparts", NULL);
1222 
1223 	return ret;
1224 }
1225 
1226 #if defined(CONFIG_CMD_MTDPARTS_SHOW_NET_SIZES)
1227 /**
1228  * Get the net size (w/o bad blocks) of the given partition.
1229  *
1230  * @param mtd the mtd info
1231  * @param part the partition
1232  * @return the calculated net size of this partition
1233  */
net_part_size(struct mtd_info * mtd,struct part_info * part)1234 static uint64_t net_part_size(struct mtd_info *mtd, struct part_info *part)
1235 {
1236 	uint64_t i, net_size = 0;
1237 
1238 	if (!mtd->_block_isbad)
1239 		return part->size;
1240 
1241 	for (i = 0; i < part->size; i += mtd->erasesize) {
1242 		if (!mtd->_block_isbad(mtd, part->offset + i))
1243 			net_size += mtd->erasesize;
1244 	}
1245 
1246 	return net_size;
1247 }
1248 #endif
1249 
print_partition_table(void)1250 static void print_partition_table(void)
1251 {
1252 	struct list_head *dentry, *pentry;
1253 	struct part_info *part;
1254 	struct mtd_device *dev;
1255 	int part_num;
1256 
1257 	list_for_each(dentry, &devices) {
1258 		dev = list_entry(dentry, struct mtd_device, link);
1259 		/* list partitions for given device */
1260 		part_num = 0;
1261 #if defined(CONFIG_CMD_MTDPARTS_SHOW_NET_SIZES)
1262 		struct mtd_info *mtd;
1263 
1264 		if (get_mtd_info(dev->id->type, dev->id->num, &mtd))
1265 			return;
1266 
1267 		printf("\ndevice %s%d <%s>, # parts = %d\n",
1268 				MTD_DEV_TYPE(dev->id->type), dev->id->num,
1269 				dev->id->mtd_id, dev->num_parts);
1270 		printf(" #: name\t\tsize\t\tnet size\toffset\t\tmask_flags\n");
1271 
1272 		list_for_each(pentry, &dev->parts) {
1273 			u32 net_size;
1274 			char *size_note;
1275 
1276 			part = list_entry(pentry, struct part_info, link);
1277 			net_size = net_part_size(mtd, part);
1278 			size_note = part->size == net_size ? " " : " (!)";
1279 			printf("%2d: %-20s0x%08llx\t0x%08x%s\t0x%08llx\t%d\n",
1280 					part_num, part->name, part->size,
1281 					net_size, size_note, part->offset,
1282 					part->mask_flags);
1283 #else /* !defined(CONFIG_CMD_MTDPARTS_SHOW_NET_SIZES) */
1284 		printf("\ndevice %s%d <%s>, # parts = %d\n",
1285 				MTD_DEV_TYPE(dev->id->type), dev->id->num,
1286 				dev->id->mtd_id, dev->num_parts);
1287 		printf(" #: name\t\tsize\t\toffset\t\tmask_flags\n");
1288 
1289 		list_for_each(pentry, &dev->parts) {
1290 			part = list_entry(pentry, struct part_info, link);
1291 			printf("%2d: %-20s0x%08llx\t0x%08llx\t%d\n",
1292 					part_num, part->name, part->size,
1293 					part->offset, part->mask_flags);
1294 #endif /* defined(CONFIG_CMD_MTDPARTS_SHOW_NET_SIZES) */
1295 			part_num++;
1296 		}
1297 	}
1298 
1299 	if (list_empty(&devices))
1300 		printf("no partitions defined\n");
1301 }
1302 
1303 /**
1304  * Format and print out a partition list for each device from global device
1305  * list.
1306  */
1307 static void list_partitions(void)
1308 {
1309 	struct part_info *part;
1310 
1311 	debug("\n---list_partitions---\n");
1312 	print_partition_table();
1313 
1314 	/* current_mtd_dev is not NULL only when we have non empty device list */
1315 	if (current_mtd_dev) {
1316 		part = mtd_part_info(current_mtd_dev, current_mtd_partnum);
1317 		if (part) {
1318 			printf("\nactive partition: %s%d,%d - (%s) 0x%08llx @ 0x%08llx\n",
1319 					MTD_DEV_TYPE(current_mtd_dev->id->type),
1320 					current_mtd_dev->id->num, current_mtd_partnum,
1321 					part->name, part->size, part->offset);
1322 		} else {
1323 			printf("could not get current partition info\n\n");
1324 		}
1325 	}
1326 
1327 	printf("\ndefaults:\n");
1328 	printf("mtdids  : %s\n",
1329 		mtdids_default ? mtdids_default : "none");
1330 	/*
1331 	 * Using printf() here results in printbuffer overflow
1332 	 * if default mtdparts string is greater than console
1333 	 * printbuffer. Use puts() to prevent system crashes.
1334 	 */
1335 	puts("mtdparts: ");
1336 	puts(mtdparts_default ? mtdparts_default : "none");
1337 	puts("\n");
1338 }
1339 
1340 /**
1341  * Given partition identifier in form of <dev_type><dev_num>,<part_num> find
1342  * corresponding device and verify partition number.
1343  *
1344  * @param id string describing device and partition or partition name
1345  * @param dev pointer to the requested device (output)
1346  * @param part_num verified partition number (output)
1347  * @param part pointer to requested partition (output)
1348  * @return 0 on success, 1 otherwise
1349  */
1350 int find_dev_and_part(const char *id, struct mtd_device **dev,
1351 		u8 *part_num, struct part_info **part)
1352 {
1353 	struct list_head *dentry, *pentry;
1354 	u8 type, dnum, pnum;
1355 	const char *p;
1356 
1357 	debug("--- find_dev_and_part ---\nid = %s\n", id);
1358 
1359 	list_for_each(dentry, &devices) {
1360 		*part_num = 0;
1361 		*dev = list_entry(dentry, struct mtd_device, link);
1362 		list_for_each(pentry, &(*dev)->parts) {
1363 			*part = list_entry(pentry, struct part_info, link);
1364 			if (strcmp((*part)->name, id) == 0)
1365 				return 0;
1366 			(*part_num)++;
1367 		}
1368 	}
1369 
1370 	p = id;
1371 	*dev = NULL;
1372 	*part = NULL;
1373 	*part_num = 0;
1374 
1375 	if (mtd_id_parse(p, &p, &type, &dnum) != 0)
1376 		return 1;
1377 
1378 	if ((*p++ != ',') || (*p == '\0')) {
1379 		printf("no partition number specified\n");
1380 		return 1;
1381 	}
1382 	pnum = simple_strtoul(p, (char **)&p, 0);
1383 	if (*p != '\0') {
1384 		printf("unexpected trailing character '%c'\n", *p);
1385 		return 1;
1386 	}
1387 
1388 	if ((*dev = device_find(type, dnum)) == NULL) {
1389 		printf("no such device %s%d\n", MTD_DEV_TYPE(type), dnum);
1390 		return 1;
1391 	}
1392 
1393 	if ((*part = mtd_part_info(*dev, pnum)) == NULL) {
1394 		printf("no such partition\n");
1395 		*dev = NULL;
1396 		return 1;
1397 	}
1398 
1399 	*part_num = pnum;
1400 
1401 	return 0;
1402 }
1403 
1404 /**
1405  * Find and delete partition. For partition id format see find_dev_and_part().
1406  *
1407  * @param id string describing device and partition
1408  * @return 0 on success, 1 otherwise
1409  */
1410 static int delete_partition(const char *id)
1411 {
1412 	u8 pnum;
1413 	struct mtd_device *dev;
1414 	struct part_info *part;
1415 
1416 	if (find_dev_and_part(id, &dev, &pnum, &part) == 0) {
1417 
1418 		debug("delete_partition: device = %s%d, partition %d = (%s) 0x%08llx@0x%08llx\n",
1419 				MTD_DEV_TYPE(dev->id->type), dev->id->num, pnum,
1420 				part->name, part->size, part->offset);
1421 
1422 		if (part_del(dev, part) != 0)
1423 			return 1;
1424 
1425 		if (generate_mtdparts_save(last_parts, MTDPARTS_MAXLEN) != 0) {
1426 			printf("generated mtdparts too long, resetting to null\n");
1427 			return 1;
1428 		}
1429 		return 0;
1430 	}
1431 
1432 	printf("partition %s not found\n", id);
1433 	return 1;
1434 }
1435 
1436 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
1437 /**
1438  * Increase the size of the given partition so that it's net size is at least
1439  * as large as the size member and such that the next partition would start on a
1440  * good block if it were adjacent to this partition.
1441  *
1442  * @param mtd the mtd device
1443  * @param part the partition
1444  * @param next_offset pointer to the offset of the next partition after this
1445  *                    partition's size has been modified (output)
1446  */
1447 static void spread_partition(struct mtd_info *mtd, struct part_info *part,
1448 			     uint64_t *next_offset)
1449 {
1450 	uint64_t net_size, padding_size = 0;
1451 	int truncated;
1452 
1453 	mtd_get_len_incl_bad(mtd, part->offset, part->size, &net_size,
1454 			     &truncated);
1455 
1456 	/*
1457 	 * Absorb bad blocks immediately following this
1458 	 * partition also into the partition, such that
1459 	 * the next partition starts with a good block.
1460 	 */
1461 	if (!truncated) {
1462 		mtd_get_len_incl_bad(mtd, part->offset + net_size,
1463 				     mtd->erasesize, &padding_size, &truncated);
1464 		if (truncated)
1465 			padding_size = 0;
1466 		else
1467 			padding_size -= mtd->erasesize;
1468 	}
1469 
1470 	if (truncated) {
1471 		printf("truncated partition %s to %lld bytes\n", part->name,
1472 		       (uint64_t) net_size + padding_size);
1473 	}
1474 
1475 	part->size = net_size + padding_size;
1476 	*next_offset = part->offset + part->size;
1477 }
1478 
1479 /**
1480  * Adjust all of the partition sizes, such that all partitions are at least
1481  * as big as their mtdparts environment variable sizes and they each start
1482  * on a good block.
1483  *
1484  * @return 0 on success, 1 otherwise
1485  */
1486 static int spread_partitions(void)
1487 {
1488 	struct list_head *dentry, *pentry;
1489 	struct mtd_device *dev;
1490 	struct part_info *part;
1491 	struct mtd_info *mtd;
1492 	int part_num;
1493 	uint64_t cur_offs;
1494 
1495 	list_for_each(dentry, &devices) {
1496 		dev = list_entry(dentry, struct mtd_device, link);
1497 
1498 		if (get_mtd_info(dev->id->type, dev->id->num, &mtd))
1499 			return 1;
1500 
1501 		part_num = 0;
1502 		cur_offs = 0;
1503 		list_for_each(pentry, &dev->parts) {
1504 			part = list_entry(pentry, struct part_info, link);
1505 
1506 			debug("spread_partitions: device = %s%d, partition %d ="
1507 				" (%s) 0x%08llx@0x%08llx\n",
1508 				MTD_DEV_TYPE(dev->id->type), dev->id->num,
1509 				part_num, part->name, part->size,
1510 				part->offset);
1511 
1512 			if (cur_offs > part->offset)
1513 				part->offset = cur_offs;
1514 
1515 			spread_partition(mtd, part, &cur_offs);
1516 
1517 			part_num++;
1518 		}
1519 	}
1520 
1521 	index_partitions();
1522 
1523 	if (generate_mtdparts_save(last_parts, MTDPARTS_MAXLEN) != 0) {
1524 		printf("generated mtdparts too long, resetting to null\n");
1525 		return 1;
1526 	}
1527 	return 0;
1528 }
1529 #endif /* CONFIG_CMD_MTDPARTS_SPREAD */
1530 
1531 /**
1532  * The mtdparts variable tends to be long. If we need to access it
1533  * before the env is relocated, then we need to use our own stack
1534  * buffer.  gd->env_buf will be too small.
1535  *
1536  * @param buf temporary buffer pointer MTDPARTS_MAXLEN long
1537  * @return mtdparts variable string, NULL if not found
1538  */
1539 static const char *env_get_mtdparts(char *buf)
1540 {
1541 	if (gd->flags & GD_FLG_ENV_READY)
1542 		return env_get("mtdparts");
1543 	if (env_get_f("mtdparts", buf, MTDPARTS_MAXLEN) != -1)
1544 		return buf;
1545 	return NULL;
1546 }
1547 
1548 /**
1549  * Accept character string describing mtd partitions and call device_parse()
1550  * for each entry. Add created devices to the global devices list.
1551  *
1552  * @param mtdparts string specifing mtd partitions
1553  * @return 0 on success, 1 otherwise
1554  */
1555 static int parse_mtdparts(const char *const mtdparts)
1556 {
1557 	const char *p;
1558 	struct mtd_device *dev;
1559 	int err = 1;
1560 	char tmp_parts[MTDPARTS_MAXLEN];
1561 
1562 	debug("\n---parse_mtdparts---\nmtdparts = %s\n\n", mtdparts);
1563 
1564 	/* delete all devices and partitions */
1565 	if (mtd_devices_init() != 0) {
1566 		printf("could not initialise device list\n");
1567 		return err;
1568 	}
1569 
1570 	/* re-read 'mtdparts' variable, mtd_devices_init may be updating env */
1571 	p = env_get_mtdparts(tmp_parts);
1572 	if (!p)
1573 		p = mtdparts;
1574 
1575 	/* Skip the useless prefix, if any */
1576 	if (strncmp(p, "mtdparts=", 9) == 0)
1577 		p += 9;
1578 
1579 	while (*p != '\0') {
1580 		err = 1;
1581 		if ((device_parse(p, &p, &dev) != 0) || (!dev))
1582 			break;
1583 
1584 		debug("+ device: %s\t%d\t%s\n", MTD_DEV_TYPE(dev->id->type),
1585 				dev->id->num, dev->id->mtd_id);
1586 
1587 		/* check if parsed device is already on the list */
1588 		if (device_find(dev->id->type, dev->id->num) != NULL) {
1589 			printf("device %s%d redefined, please correct mtdparts variable\n",
1590 					MTD_DEV_TYPE(dev->id->type), dev->id->num);
1591 			break;
1592 		}
1593 
1594 		list_add_tail(&dev->link, &devices);
1595 		err = 0;
1596 	}
1597 	if (err == 1) {
1598 		free(dev);
1599 		device_delall(&devices);
1600 	}
1601 
1602 	return err;
1603 }
1604 
1605 /**
1606  * Parse provided string describing mtdids mapping (see file header for mtdids
1607  * variable format). Allocate memory for each entry and add all found entries
1608  * to the global mtdids list.
1609  *
1610  * @param ids mapping string
1611  * @return 0 on success, 1 otherwise
1612  */
1613 static int parse_mtdids(const char *const ids)
1614 {
1615 	const char *p = ids;
1616 	const char *mtd_id;
1617 	int mtd_id_len;
1618 	struct mtdids *id;
1619 	struct list_head *entry, *n;
1620 	struct mtdids *id_tmp;
1621 	u8 type, num;
1622 	u64 size;
1623 	int ret = 1;
1624 
1625 	debug("\n---parse_mtdids---\nmtdids = %s\n\n", ids);
1626 
1627 	/* clean global mtdids list */
1628 	list_for_each_safe(entry, n, &mtdids) {
1629 		id_tmp = list_entry(entry, struct mtdids, link);
1630 		debug("mtdids del: %d %d\n", id_tmp->type, id_tmp->num);
1631 		list_del(entry);
1632 		free(id_tmp);
1633 	}
1634 	last_ids[0] = '\0';
1635 	INIT_LIST_HEAD(&mtdids);
1636 
1637 	while(p && (*p != '\0')) {
1638 
1639 		ret = 1;
1640 		/* parse 'nor'|'nand'|'onenand'|'spi-nand'<dev-num> */
1641 		if (mtd_id_parse(p, &p, &type, &num) != 0)
1642 			break;
1643 
1644 		if (*p != '=') {
1645 			printf("mtdids: incorrect <dev-num>\n");
1646 			break;
1647 		}
1648 		p++;
1649 
1650 		/* check if requested device exists */
1651 		if (mtd_device_validate(type, num, &size) != 0)
1652 			return 1;
1653 
1654 		/* locate <mtd-id> */
1655 		mtd_id = p;
1656 		if ((p = strchr(mtd_id, ',')) != NULL) {
1657 			mtd_id_len = p - mtd_id + 1;
1658 			p++;
1659 		} else {
1660 			mtd_id_len = strlen(mtd_id) + 1;
1661 		}
1662 		if (mtd_id_len == 0) {
1663 			printf("mtdids: no <mtd-id> identifier\n");
1664 			break;
1665 		}
1666 
1667 		/* check if this id is already on the list */
1668 		int double_entry = 0;
1669 		list_for_each(entry, &mtdids) {
1670 			id_tmp = list_entry(entry, struct mtdids, link);
1671 			if ((id_tmp->type == type) && (id_tmp->num == num)) {
1672 				double_entry = 1;
1673 				break;
1674 			}
1675 		}
1676 		if (double_entry) {
1677 			printf("device id %s%d redefined, please correct mtdids variable\n",
1678 					MTD_DEV_TYPE(type), num);
1679 			break;
1680 		}
1681 
1682 		/* allocate mtdids structure */
1683 		if (!(id = (struct mtdids *)malloc(sizeof(struct mtdids) + mtd_id_len))) {
1684 			printf("out of memory\n");
1685 			break;
1686 		}
1687 		memset(id, 0, sizeof(struct mtdids) + mtd_id_len);
1688 		id->num = num;
1689 		id->type = type;
1690 		id->size = size;
1691 		id->mtd_id = (char *)(id + 1);
1692 		strncpy(id->mtd_id, mtd_id, mtd_id_len - 1);
1693 		id->mtd_id[mtd_id_len - 1] = '\0';
1694 		INIT_LIST_HEAD(&id->link);
1695 
1696 		debug("+ id %s%d\t%16lld bytes\t%s\n",
1697 				MTD_DEV_TYPE(id->type), id->num,
1698 				id->size, id->mtd_id);
1699 
1700 		list_add_tail(&id->link, &mtdids);
1701 		ret = 0;
1702 	}
1703 	if (ret == 1) {
1704 		/* clean mtdids list and free allocated memory */
1705 		list_for_each_safe(entry, n, &mtdids) {
1706 			id_tmp = list_entry(entry, struct mtdids, link);
1707 			list_del(entry);
1708 			free(id_tmp);
1709 		}
1710 		return 1;
1711 	}
1712 
1713 	return 0;
1714 }
1715 
1716 
1717 /**
1718  * Parse and initialize global mtdids mapping and create global
1719  * device/partition list.
1720  *
1721  * @return 0 on success, 1 otherwise
1722  */
1723 int mtdparts_init(void)
1724 {
1725 	static int initialized = 0;
1726 	const char *ids, *parts;
1727 	const char *current_partition;
1728 	int ids_changed;
1729 	char tmp_ep[PARTITION_MAXLEN + 1];
1730 	char tmp_parts[MTDPARTS_MAXLEN];
1731 
1732 	debug("\n---mtdparts_init---\n");
1733 	if (!initialized) {
1734 		INIT_LIST_HEAD(&mtdids);
1735 		INIT_LIST_HEAD(&devices);
1736 		memset(last_ids, 0, sizeof(last_ids));
1737 		memset(last_parts, 0, sizeof(last_parts));
1738 		memset(last_partition, 0, sizeof(last_partition));
1739 #if defined(CONFIG_SYS_MTDPARTS_RUNTIME)
1740 		board_mtdparts_default(&mtdids_default, &mtdparts_default);
1741 #endif
1742 		use_defaults = 1;
1743 		initialized = 1;
1744 	}
1745 
1746 	/* get variables */
1747 	ids = env_get("mtdids");
1748 	parts = env_get_mtdparts(tmp_parts);
1749 	current_partition = env_get("partition");
1750 
1751 	/* save it for later parsing, cannot rely on current partition pointer
1752 	 * as 'partition' variable may be updated during init */
1753 	memset(tmp_parts, 0, sizeof(tmp_parts));
1754 	memset(tmp_ep, 0, sizeof(tmp_ep));
1755 	if (current_partition)
1756 		strncpy(tmp_ep, current_partition, PARTITION_MAXLEN);
1757 
1758 	debug("last_ids  : %s\n", last_ids);
1759 	debug("env_ids   : %s\n", ids);
1760 	debug("last_parts: %s\n", last_parts);
1761 	debug("env_parts : %s\n\n", parts);
1762 
1763 	debug("last_partition : %s\n", last_partition);
1764 	debug("env_partition  : %s\n", current_partition);
1765 
1766 	/* if mtdids variable is empty try to use defaults */
1767 	if (!ids) {
1768 		if (mtdids_default) {
1769 			debug("mtdids variable not defined, using default\n");
1770 			ids = mtdids_default;
1771 			env_set("mtdids", (char *)ids);
1772 		} else {
1773 			printf("mtdids not defined, no default present\n");
1774 			return 1;
1775 		}
1776 	}
1777 	if (strlen(ids) > MTDIDS_MAXLEN - 1) {
1778 		printf("mtdids too long (> %d)\n", MTDIDS_MAXLEN);
1779 		return 1;
1780 	}
1781 
1782 	/* use defaults when mtdparts variable is not defined
1783 	 * once mtdparts is saved environment, drop use_defaults flag */
1784 	if (!parts) {
1785 		if (mtdparts_default && use_defaults) {
1786 			parts = mtdparts_default;
1787 			if (env_set("mtdparts", (char *)parts) == 0)
1788 				use_defaults = 0;
1789 		} else
1790 			printf("mtdparts variable not set, see 'help mtdparts'\n");
1791 	}
1792 
1793 	if (parts && (strlen(parts) > MTDPARTS_MAXLEN - 1)) {
1794 		printf("mtdparts too long (> %d)\n", MTDPARTS_MAXLEN);
1795 		return 1;
1796 	}
1797 
1798 	/* check if we have already parsed those mtdids */
1799 	if ((last_ids[0] != '\0') && (strcmp(last_ids, ids) == 0)) {
1800 		ids_changed = 0;
1801 	} else {
1802 		ids_changed = 1;
1803 
1804 		if (parse_mtdids(ids) != 0) {
1805 			mtd_devices_init();
1806 			return 1;
1807 		}
1808 
1809 		/* ok it's good, save new ids */
1810 		strncpy(last_ids, ids, MTDIDS_MAXLEN);
1811 	}
1812 
1813 	/* parse partitions if either mtdparts or mtdids were updated */
1814 	if (parts && ((last_parts[0] == '\0') || ((strcmp(last_parts, parts) != 0)) || ids_changed)) {
1815 		if (parse_mtdparts(parts) != 0)
1816 			return 1;
1817 
1818 		if (list_empty(&devices)) {
1819 			printf("mtdparts_init: no valid partitions\n");
1820 			return 1;
1821 		}
1822 
1823 		/* ok it's good, save new parts */
1824 		strncpy(last_parts, parts, MTDPARTS_MAXLEN);
1825 
1826 		/* reset first partition from first dev from the list as current */
1827 		current_mtd_dev = list_entry(devices.next, struct mtd_device, link);
1828 		current_mtd_partnum = 0;
1829 		current_save();
1830 
1831 		debug("mtdparts_init: current_mtd_dev  = %s%d, current_mtd_partnum = %d\n",
1832 				MTD_DEV_TYPE(current_mtd_dev->id->type),
1833 				current_mtd_dev->id->num, current_mtd_partnum);
1834 	}
1835 
1836 	/* mtdparts variable was reset to NULL, delete all devices/partitions */
1837 	if (!parts && (last_parts[0] != '\0'))
1838 		return mtd_devices_init();
1839 
1840 	/* do not process current partition if mtdparts variable is null */
1841 	if (!parts)
1842 		return 0;
1843 
1844 	/* is current partition set in environment? if so, use it */
1845 	if ((tmp_ep[0] != '\0') && (strcmp(tmp_ep, last_partition) != 0)) {
1846 		struct part_info *p;
1847 		struct mtd_device *cdev;
1848 		u8 pnum;
1849 
1850 		debug("--- getting current partition: %s\n", tmp_ep);
1851 
1852 		if (find_dev_and_part(tmp_ep, &cdev, &pnum, &p) == 0) {
1853 			current_mtd_dev = cdev;
1854 			current_mtd_partnum = pnum;
1855 			current_save();
1856 		}
1857 	} else if (env_get("partition") == NULL) {
1858 		debug("no partition variable set, setting...\n");
1859 		current_save();
1860 	}
1861 
1862 	return 0;
1863 }
1864 
1865 /**
1866  * Return pointer to the partition of a requested number from a requested
1867  * device.
1868  *
1869  * @param dev device that is to be searched for a partition
1870  * @param part_num requested partition number
1871  * @return pointer to the part_info, NULL otherwise
1872  */
1873 static struct part_info* mtd_part_info(struct mtd_device *dev, unsigned int part_num)
1874 {
1875 	struct list_head *entry;
1876 	struct part_info *part;
1877 	int num;
1878 
1879 	if (!dev)
1880 		return NULL;
1881 
1882 	debug("\n--- mtd_part_info: partition number %d for device %s%d (%s)\n",
1883 			part_num, MTD_DEV_TYPE(dev->id->type),
1884 			dev->id->num, dev->id->mtd_id);
1885 
1886 	if (part_num >= dev->num_parts) {
1887 		printf("invalid partition number %d for device %s%d (%s)\n",
1888 				part_num, MTD_DEV_TYPE(dev->id->type),
1889 				dev->id->num, dev->id->mtd_id);
1890 		return NULL;
1891 	}
1892 
1893 	/* locate partition number, return it */
1894 	num = 0;
1895 	list_for_each(entry, &dev->parts) {
1896 		part = list_entry(entry, struct part_info, link);
1897 
1898 		if (part_num == num++) {
1899 			return part;
1900 		}
1901 	}
1902 
1903 	return NULL;
1904 }
1905 
1906 /***************************************************/
1907 /* U-Boot commands				   */
1908 /***************************************************/
1909 /* command line only */
1910 /**
1911  * Routine implementing u-boot chpart command. Sets new current partition based
1912  * on the user supplied partition id. For partition id format see find_dev_and_part().
1913  *
1914  * @param cmdtp command internal data
1915  * @param flag command flag
1916  * @param argc number of arguments supplied to the command
1917  * @param argv arguments list
1918  * @return 0 on success, 1 otherwise
1919  */
1920 static int do_chpart(struct cmd_tbl *cmdtp, int flag, int argc,
1921 		     char *const argv[])
1922 {
1923 /* command line only */
1924 	struct mtd_device *dev;
1925 	struct part_info *part;
1926 	u8 pnum;
1927 
1928 	if (mtdparts_init() !=0)
1929 		return 1;
1930 
1931 	if (argc < 2) {
1932 		printf("no partition id specified\n");
1933 		return 1;
1934 	}
1935 
1936 	if (find_dev_and_part(argv[1], &dev, &pnum, &part) != 0)
1937 		return 1;
1938 
1939 	current_mtd_dev = dev;
1940 	current_mtd_partnum = pnum;
1941 	current_save();
1942 
1943 	printf("partition changed to %s%d,%d\n",
1944 			MTD_DEV_TYPE(dev->id->type), dev->id->num, pnum);
1945 
1946 	return 0;
1947 }
1948 
1949 /**
1950  * Routine implementing u-boot mtdparts command. Initialize/update default global
1951  * partition list and process user partition request (list, add, del).
1952  *
1953  * @param cmdtp command internal data
1954  * @param flag command flag
1955  * @param argc number of arguments supplied to the command
1956  * @param argv arguments list
1957  * @return 0 on success, 1 otherwise
1958  */
1959 static int do_mtdparts(struct cmd_tbl *cmdtp, int flag, int argc,
1960 		       char *const argv[])
1961 {
1962 	if (argc == 2) {
1963 		if (strcmp(argv[1], "default") == 0) {
1964 			env_set("mtdids", NULL);
1965 			env_set("mtdparts", NULL);
1966 			env_set("partition", NULL);
1967 			use_defaults = 1;
1968 
1969 			mtdparts_init();
1970 			return 0;
1971 		} else if (strcmp(argv[1], "delall") == 0) {
1972 			/* this may be the first run, initialize lists if needed */
1973 			mtdparts_init();
1974 
1975 			env_set("mtdparts", NULL);
1976 
1977 			/* mtd_devices_init() calls current_save() */
1978 			return mtd_devices_init();
1979 		}
1980 	}
1981 
1982 	/* make sure we are in sync with env variables */
1983 	if (mtdparts_init() != 0)
1984 		return 1;
1985 
1986 	if (argc == 1) {
1987 		list_partitions();
1988 		return 0;
1989 	}
1990 
1991 	/* mtdparts add <mtd-dev> <size>[@<offset>] <name> [ro] */
1992 	if (((argc == 5) || (argc == 6)) && (strncmp(argv[1], "add", 3) == 0)) {
1993 #define PART_ADD_DESC_MAXLEN 64
1994 		char tmpbuf[PART_ADD_DESC_MAXLEN];
1995 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
1996 		struct mtd_info *mtd;
1997 		uint64_t next_offset;
1998 #endif
1999 		u8 type, num, len;
2000 		struct mtd_device *dev;
2001 		struct mtd_device *dev_tmp;
2002 		struct mtdids *id;
2003 		struct part_info *p;
2004 
2005 		if (mtd_id_parse(argv[2], NULL, &type, &num) != 0)
2006 			return 1;
2007 
2008 		if ((id = id_find(type, num)) == NULL) {
2009 			printf("no such device %s defined in mtdids variable\n", argv[2]);
2010 			return 1;
2011 		}
2012 
2013 		len = strlen(id->mtd_id) + 1;	/* 'mtd_id:' */
2014 		len += strlen(argv[3]);		/* size@offset */
2015 		len += strlen(argv[4]) + 2;	/* '(' name ')' */
2016 		if (argv[5] && (strlen(argv[5]) == 2))
2017 			len += 2;		/* 'ro' */
2018 
2019 		if (len >= PART_ADD_DESC_MAXLEN) {
2020 			printf("too long partition description\n");
2021 			return 1;
2022 		}
2023 		sprintf(tmpbuf, "%s:%s(%s)%s",
2024 				id->mtd_id, argv[3], argv[4], argv[5] ? argv[5] : "");
2025 		debug("add tmpbuf: %s\n", tmpbuf);
2026 
2027 		if ((device_parse(tmpbuf, NULL, &dev) != 0) || (!dev))
2028 			return 1;
2029 
2030 		debug("+ %s\t%d\t%s\n", MTD_DEV_TYPE(dev->id->type),
2031 				dev->id->num, dev->id->mtd_id);
2032 
2033 		p = list_entry(dev->parts.next, struct part_info, link);
2034 
2035 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
2036 		if (get_mtd_info(dev->id->type, dev->id->num, &mtd))
2037 			return 1;
2038 
2039 		if (!strcmp(&argv[1][3], ".spread")) {
2040 			spread_partition(mtd, p, &next_offset);
2041 			debug("increased %s to %llu bytes\n", p->name, p->size);
2042 		}
2043 #endif
2044 
2045 		dev_tmp = device_find(dev->id->type, dev->id->num);
2046 		if (dev_tmp == NULL) {
2047 			device_add(dev);
2048 		} else if (part_add(dev_tmp, p) != 0) {
2049 			/* merge new partition with existing ones*/
2050 			device_del(dev);
2051 			return 1;
2052 		}
2053 
2054 		if (generate_mtdparts_save(last_parts, MTDPARTS_MAXLEN) != 0) {
2055 			printf("generated mtdparts too long, resetting to null\n");
2056 			return 1;
2057 		}
2058 
2059 		return 0;
2060 	}
2061 
2062 	/* mtdparts del part-id */
2063 	if ((argc == 3) && (strcmp(argv[1], "del") == 0)) {
2064 		debug("del: part-id = %s\n", argv[2]);
2065 
2066 		return delete_partition(argv[2]);
2067 	}
2068 
2069 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
2070 	if ((argc == 2) && (strcmp(argv[1], "spread") == 0))
2071 		return spread_partitions();
2072 #endif /* CONFIG_CMD_MTDPARTS_SPREAD */
2073 
2074 	return CMD_RET_USAGE;
2075 }
2076 
2077 /***************************************************/
2078 U_BOOT_CMD(
2079 	chpart,	2,	0,	do_chpart,
2080 	"change active partition",
2081 	"part-id\n"
2082 	"    - change active partition (e.g. part-id = nand0,1)"
2083 );
2084 
2085 #ifdef CONFIG_SYS_LONGHELP
2086 static char mtdparts_help_text[] =
2087 	"\n"
2088 	"    - list partition table\n"
2089 	"mtdparts delall\n"
2090 	"    - delete all partitions\n"
2091 	"mtdparts del part-id\n"
2092 	"    - delete partition (e.g. part-id = nand0,1)\n"
2093 	"mtdparts add <mtd-dev> <size>[@<offset>] [<name>] [ro]\n"
2094 	"    - add partition\n"
2095 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
2096 	"mtdparts add.spread <mtd-dev> <size>[@<offset>] [<name>] [ro]\n"
2097 	"    - add partition, padding size by skipping bad blocks\n"
2098 #endif
2099 	"mtdparts default\n"
2100 	"    - reset partition table to defaults\n"
2101 #if defined(CONFIG_CMD_MTDPARTS_SPREAD)
2102 	"mtdparts spread\n"
2103 	"    - adjust the sizes of the partitions so they are\n"
2104 	"      at least as big as the mtdparts variable specifies\n"
2105 	"      and they each start on a good block\n\n"
2106 #else
2107 	"\n"
2108 #endif /* CONFIG_CMD_MTDPARTS_SPREAD */
2109 	"-----\n\n"
2110 	"this command uses three environment variables:\n\n"
2111 	"'partition' - keeps current partition identifier\n\n"
2112 	"partition  := <part-id>\n"
2113 	"<part-id>  := <dev-id>,part_num\n\n"
2114 	"'mtdids' - linux kernel mtd device id <-> u-boot device id mapping\n\n"
2115 	"mtdids=<idmap>[,<idmap>,...]\n\n"
2116 	"<idmap>    := <dev-id>=<mtd-id>\n"
2117 	"<dev-id>   := 'nand'|'nor'|'onenand'|'spi-nand'<dev-num>\n"
2118 	"<dev-num>  := mtd device number, 0...\n"
2119 	"<mtd-id>   := unique device tag used by linux kernel to find mtd device (mtd->name)\n\n"
2120 	"'mtdparts' - partition list\n\n"
2121 	"mtdparts=mtdparts=<mtd-def>[;<mtd-def>...]\n\n"
2122 	"<mtd-def>  := <mtd-id>:<part-def>[,<part-def>...]\n"
2123 	"<mtd-id>   := unique device tag used by linux kernel to find mtd device (mtd->name)\n"
2124 	"<part-def> := <size>[@<offset>][<name>][<ro-flag>]\n"
2125 	"<size>     := standard linux memsize OR '-' to denote all remaining space\n"
2126 	"<offset>   := partition start offset within the device\n"
2127 	"<name>     := '(' NAME ')'\n"
2128 	"<ro-flag>  := when set to 'ro' makes partition read-only (not used, passed to kernel)";
2129 #endif
2130 
2131 U_BOOT_CMD(
2132 	mtdparts,	6,	0,	do_mtdparts,
2133 	"define flash/nand partitions", mtdparts_help_text
2134 );
2135 /***************************************************/
2136